项目2026-11-17 · 智涌AI

Plannotator 是什么:在浏览器里批注 Agent 的计划和代码

Plannotator 项目头图:左侧大字「Plannotator 计划批注台」与钩子「Agent 的计划和 diff 在浏览器里逐段批注」,三张数据卡为 12,749 GitHub 星、最新版本 v0.28.66、Apache/MIT 双许可;右侧终端显示安装脚本为 Claude Code、Codex、Gemini CLI 配置 hook,以及 plannotator-review、plannotator-annotate 命令,底部提示用 NO_ANON_PING=1 关闭匿名 ping

让编程 Agent 先出计划再动手,这个习惯没问题,麻烦在审计划:计划是终端里一大段 Markdown,你只能整体回一句「第三步改一下」,Agent 也常常理解偏。Plannotator 把这一步搬进浏览器:Agent 提交计划或改完代码时自动弹出页面,你可以像改文档那样逐段划线、写批注,点一下就把整理好的反馈送回 Agent。这篇按官方 README、安装文档和隐私政策,讲它能做什么、怎么装,以及装之前要知道的几项网络行为。

它是什么

Plannotator 是一个给编程 Agent 用的本地审阅界面。Agent 在计划模式下写完计划、或者你要审一段改动时,它在本机起服务、打开浏览器页面,你在页面上批注,批注汇总成一条消息回到原来的 Agent 会话。

仓库github.com/backnotprop/plannotator
作者backnotprop(Michael Ramos)
许可证Apache-2.0 或 MIT,二选一
热度GitHub 12,749 星、1,259 fork(GitHub API,2026-11-17 北京时间)
语言 / 平台TypeScript(Bun 编译的单一二进制);macOS、Linux、WSL、Windows
最新版本v0.28.66(2026-11-16 14:53 北京时间)

解决什么问题

在终端里审 Agent 的计划和代码,常见的麻烦有三处,Plannotator 各有对应:

麻烦Plannotator 的做法
计划很长,只能整体回复,意见对不上具体段落计划模式通过 hook 自动打开批注页,逐段划线写意见,提交后作为反馈送回
审 diff 要切到 GitHub 或 IDE,评论回不到 Agent本地改动、GitHub PR、GitLab MR 都能在页面里评论,评论回到 Agent
大改动不知道从哪看起Guided Review 让 Agent 把 diff 按重要程度分成几章,先看核心改动

新版还加了 Inbox:多个 Agent 把提问、文件、待审内容留在同一个本地窗口里,你有空再逐条回复,回复送回提问的那个会话,期间不占着 Agent。

怎么用

1. 安装。官方脚本会装好 plannotator 二进制,并自动识别本机已装的 Agent,配好 hook、Skill 和斜杠命令:

# macOS / Linux / WSL
curl -fsSL https://plannotator.ai/install.sh | bash

# 只要二进制,不改任何 Agent 配置
curl -fsSL https://plannotator.ai/install.sh | bash -s -- --minimal

2. 按 Agent 补一步。Codex、Gemini CLI(需 0.36.0+)、Kiro CLI 装完即可用;Claude Code 要再装插件并重启:

/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator

OpenCode 在 opencode.json 里加 "plugin": ["@plannotator/opencode@latest"];Pi 不用脚本,直接 pi install npm:@plannotator/pi-extension。

3. 计划审阅不用敲命令。Agent 进入计划模式写出计划后,批注页自动打开。README 提到,Claude Code 2.1.287 及以上版本里,审阅期间 Claude 会先结束本轮,你的决定稍后作为新消息送达;想回到旧的等待流程,设 PLANNOTATOR_CLAUDE_MOD=0。

4. 批注文档和审代码。在 Agent 里用斜杠命令(Codex 里换成 !plannotator … 或 $plannotator-* Skill):

/plannotator-annotate README.md        # 批注本地 Markdown
/plannotator-annotate src/             # 浏览并批注整个目录
/plannotator-last                      # 批注 Agent 上一条回复
/plannotator-review                    # 审未提交的改动
/plannotator-review <github-pr-url>    # 审 GitHub PR
plannotator annotate http://localhost:5173   # 在本地运行的页面上直接批注

5. 卸载。plannotator uninstall 默认只删它装的组件,保留本地计划和历史;加 --purge 连数据一起删,--dry-run 先预览。

计划阶段多花两分钟逐段批注,比代码写完再返工省事。

装之前看这几条

适合谁,不适合谁

适合习惯让 Agent 先出计划、对计划质量较真的人,也适合同时开好几个 Agent、需要一个地方集中回复它们的人。用 herdr 管终端的,可以装官方的 Herdr Annotate 插件,在终端里做同样的批注。只用 IDE 内置聊天、很少用计划模式的,收益不大;只想要一个 diff 审查 Agent,可以看站内的 Open Code Review。

最后

想试的话,先用 --minimal 装二进制,对一个现成的 Markdown 文件跑一次 plannotator annotate,觉得顺手再让安装脚本接入你常用的 Agent。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。