Plannotator：AI 编程代理评审台

项目简介

Plannotator 是一个本地运行、基于浏览器的评审界面，服务于各类 AI 编程代理：Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、DeepSeek Harness、Pi。

它通过各代理的 hooks 和命令直接接入。当代理提出计划、生成 HTML，或者写完代码时，这些内容会在浏览器中打开，你可以逐处标注、评论，然后把反馈直接发回代理，让它据此继续工作。

主要功能

文档、计划与消息评审

可以标注计划、规格文档、代理消息和 HTML，再把反馈发回给代理。适合在实现开始之前，先对方案做一轮审阅。

代码评审

评审本地改动或远端 PR/MR：在 diff 上评论、提出代码建议，评论会回到代理。支持 Git、GitButler、Jujutsu（jj）、Perforce（p4）、GitHub 与 GitLab。

HTML 产物标注

直接对渲染后的 HTML 产物进行标注。

内置 AI

可以就正在评审的内容向 AI 提问，也可以启动 AI 评审，让它把评论发布到 diff 上。

Plannotator Inbox

一个本地窗口，代理在其中留下消息、问题、文件和带引导的评审内容，同时继续工作。你可以点选回答问题、标注文件，方便时再按发送；这段时间不会让代理会话一直挂着，回复会回到发起提问的那个会话。

plannotator inbox

Claude Code、Pi、OpenCode 通过 Plannotator 插件连接，回复会作为它们的下一轮输入。其他代理可通过 MCP 接入：plannotator inbox mcp；plannotator inbox --help 是给代理阅读的说明。

Herdr Annotate（终端内评审）

Herdr Annotate 把 Plannotator 风格的评审带进终端：在 Herdr 内标注终端文本、评审 Markdown 文档与代理回复，并把反馈作为下一条消息发回代理。标注保存在 Plannotator 数据目录中，终端评审与应用内评审会累积在一起。

herdr plugin install plannotator/herdr-annotate

如果希望独立使用，可安装 Plannotator TUI：brew install plannotator/tap/plannotator-tui。

安装与使用

完整安装步骤见官方文档：https://docs.plannotator.ai/open-source/start/installation。

标注

/plannotator-annotate README.md                  # 本地 Markdown 文件
/plannotator-annotate src/                       # 浏览并标注文件夹中的文件
/plannotator-annotate https://docs.rs/…          # 抓取并标注任意 URL
/plannotator-annotate report.html --render-html  # 按原样渲染 HTML
/plannotator-last                                # 标注代理的最后一条消息

在 Codex 上，请把斜杠命令换成 !plannotator …（例如 !plannotator review），或使用 $plannotator-* skills。

代码评审

/plannotator-review                    # 评审未提交的改动
/plannotator-review <github-pr-url>    # 评审 GitHub pull request
/plannotator-review <gitlab-mr-url>    # 评审 GitLab merge request
plannotator review --gitbutler         # 评审 GitButler 工作区
plannotator review --patch-file reading.diff # 评审静态 unified diff

Plan mode

无需命令。Plan mode 通过各 harness 的 hooks 接入：代理一旦创建计划，Markdown 评审界面就会自动打开。

CLI

plannotator sessions                   # 列出活动会话
plannotator sessions --open 1          # 在浏览器中重新打开会话
plannotator archive                    # 只读浏览已保存的计划决定

注意事项

• 不收集遥测：Plannotator 不做使用统计或分析，计划、diff、标注、草稿、历史与配置默认都保存在本地。
• 版本检查：各评审界面加载时会向 GitHub 查询最新 release，不发送计划或评审内容，但目前没有关闭该检查的设置。
• 远端查询：本地 Git 代码评审会用 git ls-remote 查询配置的 origin，以判断默认分支与基线是否过期，不会发送本地 diff；可用 plannotator review --no-git-remote-check、环境变量 PLANNOTATOR_GIT_REMOTE_CHECK=0，或在 ~/.plannotator/config.json 中设置 { "gitRemoteCheck": false } 关闭。
• 内容外发场景：URL 标注会抓取目标站点；GitHub/GitLab 评审通过已认证的 CLI 与 Git remote 获取数据；Ask AI 与评审代理会把所选问题和相关上下文发送给你配置的模型提供方；分享会把完整链接发送给你选择的渠道。
• 链接分享：开源版异步链接分享仍可用，但已进入逐步弃用状态，团队分享的主方向是 Workspaces。
• 许可证：Apache-2.0。

---

本作品整理自 GitHub 开源项目 backnotprop/plannotator，原作者 @backnotprop，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。