douyin-pc/docs/2026-09-07-14-29-plannotator-config.md

Plannotator 本机配置

调研记录

• 已安装 @plannotator/pi-extension 0.27.12，Pi 0.85.1 满足插件 README 的 Pi >= 0.79.1 要求。
• 全局 /home/rogee/.pi/agent/settings.json 的 packages 已包含 npm:@plannotator/pi-extension，无需重复安装或修改安装登记。
• 配置前全局和当前项目均无 plannotator.json。
• 依据已安装插件的 README.md 和内置 plannotator.json 配置；未修改 npm 包文件。
• PATH 中没有独立 plannotator 命令；本次使用 Pi 扩展提供的斜杠命令，不安装独立 CLI。

最终配置

全局用户配置：~/.pi/agent/plannotator.json，本机绝对路径 /home/rogee/.pi/agent/plannotator.json。

{
  "executionMode": "automatic",
  "defaults": {
    "model": null,
    "thinking": null
  },
  "phases": {
    "planning": {
      "activeTools": ["read", "ffgrep", "fffind", "plannotator_submit_plan"],
      "statusLabel": "⏸ 计划审批"
    }
  }
}

• 审批通过后在当前 Pi 会话执行，不对接外部执行器。
• 不切换模型或思考等级；继承插件内置规划与执行指令。
• 规划阶段额外启用当前环境实际提供的搜索工具，替换内置 grep/find/ls 列表；该列表不是工具安全白名单，插件保留会话已有工具。
• 配置优先级：包内默认 < 全局 ~/.pi/agent/plannotator.json < 受信任项目的 .pi/plannotator.json。

使用及迁移

1. 新环境安装 Pi >= 0.79.1，然后运行 pi install npm:@plannotator/pi-extension。
2. 本配置搜索工具来自 pi install npm:@ff-labs/pi-fff（本机已经安装）。不使用该包时，删除 activeTools 字段即可继承插件默认工具配置。
3. 将上述 JSON 保存到新环境的 ~/.pi/agent/plannotator.json，不需要绑定账号、模型或本机路径。
4. 重启 Pi 会话后输入 /plannotator-plan-mode 或按 Ctrl+Alt+P 进入规划；也可以 pi --plan 启动。
5. 告诉助手需求，助手提交计划后才会打开浏览器审批。
6. /plannotator-review 审查代码变更；/plannotator-annotate <file.md> 批注文档；/plannotator-last 批注最后一条回复。

验证边界

已核验安装登记、版本、配置 JSON 语法及关键字段。未启动交互式计划审批，也未验证浏览器审批端到端流程；需要重启后实际提交一次计划确认。