场景：AI Agent 疯狂写代码，你敢直接 merge 吗？Plannotator 让审查变得像点外卖一样简单

AI 编码 Agent 的发展速度让人瞠目结舌——Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode……每次对话动辄生成几百行代码，甚至一整个项目的初始架构。但一个尴尬的问题也随之而来：Agent 写代码的速度远超人类审查的能力。

你让 Claude Code 重构一个模块，它 30 秒写完；你让 Codex 提一个 PR，它瞬间生成 diff。而你——作为人类——只能在终端里对着满屏的代码，一个一个字符地看，生怕漏掉什么 bug。更糟的是，很多 Agent 生成的计划（Plan）你连看都没看就直接 y 确认了。

Plannotator（GitHub 6815⭐，Apache-2.0/MIT 双许可）正是为了解决这个鸿沟而生的：一个本地运行、浏览器展示的 AI 编码 Agent 审查界面。它不是又一个 SaaS 审查平台，而是在你自己的机器上运行，直接接管 Agent → 人的反馈环路。

场景：为什么你需要一个「Agent 审查桌面」

想象一下你日常和 Claude Code 协作的场景：

1. 你输入需求，Agent 给出实现计划
2. 你在终端看到一段 Markdown 格式的计划，滚动好几屏
3. 你粗略扫一眼，输入 y 确认
4. Agent 开始写代码，创建/修改了十几个文件
5. 写完就完事了——除非你主动用 diff 或 git status 去检查

最大的问题在于：终端文本不是人类友好的审查界面。没有高亮、没有行内注释、没有文件树、不能逐行标记有问题。面对一个 AI 生成的 500 行 diff，你几乎没有能力做有效审查。

Plannotator 改变了这一切：当 Agent 退出计划模式或完成代码修改时，Plannotator 会在你的浏览器中打开一个完整的审查界面——计划可以逐段标注，diff 有侧边栏文件树，每个文件可以逐行评论，所有反馈直接送回 Agent 让它修改。

安装：一条命令，九种 Agent 全支持

Plannotator 的安装极其简洁。一条命令同时完成三件事：安装 plannotator 二进制、自动检测已安装的 Agent、配置 hooks/skills/slash commands：

curl -fsSL https://plannotator.ai/install.sh | bash

Plannotator 支持以下 9 种 Agent（覆盖了当前主流 AI 编码工具的全景）：

对于 Claude Code 没有插件系统的旧版本，也可以通过手动配置 hook 实现：

{
  "hooks": {
    "PermissionRequest": [
      {
        "matcher": "ExitPlanMode",
        "hooks": [{
          "type": "command",
          "command": "plannotator",
          "timeout": 345600
        }]
      }
    ]
  }
}

两大核心工作流：审查计划和审查代码

计划审查（Plan Review）

当你让 Claude Code 进入计划模式（Plan Mode）生成实现方案时，Plannotator 会自动接管离开计划模式的时刻：

Agent 调用 ExitPlanMode
  → PermissionRequest hook 触发
  → 本地服务器读取 plan 内容
  → 浏览器自动打开审查 UI
  → 你可以在每条内容上做标注（Annotate）
  → 批准：Agent 继续执行
  → 驳回：结构化反馈发给 Agent，它自动修改
  → 再次审查时能看到 plan 的 diff，清晰对比改动

这个流程让「审查后再执行」不再是空话。你可以逐段阅读 Agent 的计划，用鼠标选中文本加上注释，然后一次性反馈——Agent 会根据你的标注修改计划，再次呈现给你。

代码审查（Code Review）

当 Agent 完成代码修改后，输入：

/plannotator-review

Plannotator 会抓取当前 uncommitted 的 git diff，在浏览器中打开完整的代码审查界面——左侧文件树、右侧 side-by-side diff、每行都可以添加注释。你的注释直接送回 Agent 让它修改。

也支持 GitHub PR 和 GitLab MR：

/plannotator-review https://github.com/owner/repo/pull/123

这意味着你可以让 AI Agent 写代码，然后自己在 Plannotator 的 UI 里像在 GitHub 上做 Code Review 一样审查，最后把反馈丢回给 Agent 修改——人和 Agent 的真正协作闭环。

其他实用命令

/plannotator-annotate README.md              # 审查本地 Markdown 文件
/plannotator-annotate src/                   # 浏览并审查整个目录
/plannotator-annotate report.html --render-html  # 渲染 HTML 再审查
/plannotator-last                             # 审查 Agent 最后一条消息

SSH 远程和 VS Code

如果你在远程服务器或 devcontainer 中运行 Agent，Plannotator 会自动检测 SSH 会话并切换到固定端口模式。设置环境变量：

export PLANNOTATOR_REMOTE=1
export PLANNOTATOR_PORT=9999

然后在 ~/.ssh/config 中做端口转发，浏览器就能直连远程机器的审查界面。

Plannotator 还提供了 VS Code 扩展（从 Marketplace 安装），可以将计划直接显示在编辑器标签页中，diff 内联呈现，注释从编辑器边栏直接添加——对已经习惯 VS Code 的开发者来说体验非常统一。

协作与隐私

Plannotator 的协作功能非常有趣：通过 room.plannotator.ai，你可以将审查中的计划/代码共享给团队成员。小计划直接编码在 URL 的 hash 中（零服务器），大计划使用 AES-256-GCM 加密后存储在短链接服务中，密钥始终留在 URL fragment 中——服务器只存密文。整个模型和 PrivateBin 一致，并且可以自行部署。

禁用的方法也很简单：PLANNOTATOR_SHARE=disabled。

安全验证

每个发布的二进制文件都附带了 SHA256 sidecar，并且从 v0.17.2 起提供 SLSA provenance 认证。安装时可以用 --verify-attestation 参数验证完整性：

curl -fsSL https://plannotator.ai/install.sh | bash -s -- --verify-attestation

为什么选择 Plannotator 而非其他方案

市面上有不少 AI Code Review 工具（CodeRabbit、Cubic、Greptile），但它们大多是 SaaS 服务——代码要上传到第三方服务器，审查流程是自动化的而非交互式的。Plannotator 走的是完全不同的路线：

• 全本地运行：所有代码和计划都在你的机器上，不会离开你的网络
• 双向交互：不是「AI 自动检查 → 给你报告」，而是「你审查 → 反馈 Agent → Agent 修改 → 你再确认」
• Agent 原生集成：hook/plugin/skill 三种方式深度嵌入 Agent 的工作流，无需切换上下文
• 9 种 Agent 覆盖：无论你用 Claude Code、Codex 还是 Copilot CLI，安装流程一致

总结

Plannotator 解决的是一个随着 AI 编码 Agent 普及而日益尖锐的问题：当代码生成速度超过人类审查能力时，如何保证代码质量。它没有选择构建另一个 SaaS 审查平台，而是提供了一个本地、开源、双向交互的审查界面——让人类在 AI 编码工作流中重新占据「把关者」的角色。

如果你经常和 AI 编码 Agent 协作，常常在终端里对着大段代码感到力不从心，Plannotator 可能是你一直在等的那块拼图。从 curl -fsSL https://plannotator.ai/install.sh | bash 开始，只需一条命令就能体验到完整的计划审查 + 代码审查工作流。

相关链接

• GitHub 仓库
• 官方网站
• 安装指南
• 协作门户