用途:在 AI 编程智能体动手写代码之前,用可视化界面审阅其实现计划;在智能体完成改动之后,标注 git diff 并回传结构化反馈。
主要能力:浏览器 UI 中查看计划,支持 delete(删除风险步骤)、insert(补充缺失步骤)、replace(修正错误方案)、comment(说明约束或验收标准)四类标注;提交 Approve 让智能体继续实现,或 Request changes 把标注作为结构化反馈回传重新规划。代码审查支持按行号标注、统一/分栏视图切换、附加图片。可将已批准计划自动保存到 Obsidian(带 YAML frontmatter 与标签)或 Bear Notes,也可通过链接与团队共享审查。
使用方式:安装 CLI 可运行 bash scripts/install.sh,加 --all 一次性配置全部 AI 工具集成。Claude Code 可用 /plugin marketplace add backnotprop/plannotator 与 /plugin install plannotator@plannotator 安装插件,或运行 bash scripts/setup-hook.sh 配置 ExitPlanMode 钩子;Gemini CLI 运行 bash scripts/setup-gemini-hook.sh;Codex CLI 运行 bash scripts/setup-codex-hook.sh;OpenCode 运行 bash scripts/setup-opencode-plugin.sh。代码审查用 bash scripts/review.sh,可传 HEAD~1 或 main...HEAD。远程/容器环境用 bash scripts/configure-remote.sh,并设置 PLANNOTATOR_REMOTE、PLANNOTATOR_PORT 等环境变量。状态检查用 bash scripts/check-status.sh。
适用场景:编码前拦截错误方案、编码后逐行审查改动、团队共享计划评审、把计划归档到笔记软件。
限制:手动 review 或 review.sh 打开的界面中,Send Feedback 不会自动送达当前智能体会话,需改用钩子驱动的计划审查,或导出标注手动粘贴回对话。代码审查需要 git 仓库,单文件需先建临时仓库。设置存于 cookie,无头浏览器无法看到。Export → Notes 的保存按钮仅在钩子模式下可用。Windows 需手动执行 PowerShell/CMD 命令。具体收费与价格暂未提供。