用途:Plannotator 是面向智能体工作流的本地浏览器评审层,把计划、代码差异和文档打开在标注 UI 中,人工批注后结构化反馈经 stdout 返回。安装为单个 plannotator 二进制加各宿主钩子,计划评审在退出计划模式时自动触发;其他场景需显式启动。会话运行在随机 localhost 端口(远程模式固定 19432),阻塞直到评审者提交反馈、批准或关闭标签页。
主要能力:支持计划评审、代码评审、文件/URL/文件夹/本地应用标注、最新助手消息标注、历史计划决策浏览、Guided Review 导出与分享、会话重开与列出。若存在名为 plannotator 的工具(如 mcp__plannotator__plannotator),应优先调用它而非 CLI;工具立即返回,调用后结束回合等待评审者决定。
常用命令:plannotator review 评审本地变更或 PR URL;plannotator annotate <file|URL|folder> 标注;plannotator last 标注最新助手消息;plannotator archive 浏览历史决策;plannotator guide export/share 导出或分享;plannotator sessions 管理会话。严格门禁用 plannotator annotate report.md --gate --json --require-approval --result-file /tmp/decision.json,退出码 0 表示批准,1 表示未批准,2 表示门禁自身失败。
限制:单文件上限 2MB;.env 被拒绝;源码文件应使用 review 而非 annotate;--base 与 --diff-type 仅适用于 git;--patch-file 不能与 PR URL、--base、--diff-type、--git/--gitbutler、--local/--no-local 组合;PR 评审需已认证的 gh 或 glab CLI,Bitbucket Cloud 需 PLANNOTATOR_BITBUCKET_TOKEN。会话可能耗时数分钟至一小时以上,需设置长超时或后台运行,不要为结束评审而杀死进程。