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

让编程 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 先预览。
计划阶段多花两分钟逐段批注,比代码写完再返工省事。
装之前看这几条
- 每天一次匿名 ping。隐私政策写明,每个用到的工具每天向
ping.plannotator.ai发一次匿名请求,内容只有版本、使用周数分组、工具名等,不带 ID。关闭:NO_ANON_PING=1后重启。 - 分享链接等于把内容交出去。小内容直接编码在链接里,大内容加密上传、7 天后过期,拿到完整链接的人都能读。不需要就设
PLANNOTATOR_SHARE=disabled。 - AI 功能会联系模型服务。Ask AI、Review Agents、Guided Review 会调用 AI 提供方;只想要纯批注,设
PLANNOTATOR_AI=disabled。批注网页 URL 时默认走 Jina Reader,PLANNOTATOR_JINA=0可关。 - 本地会留存反馈记录。每次提交的意见都存在
~/.plannotator/feedback/,不会自动清理;PLANNOTATOR_FEEDBACK_HISTORY=0可以不写。 - 安装脚本会改 Agent 配置。它会给检测到的 Agent 写 hook 和命令。介意的话先用
--minimal,再按需手动接入。
适合谁,不适合谁
适合习惯让 Agent 先出计划、对计划质量较真的人,也适合同时开好几个 Agent、需要一个地方集中回复它们的人。用 herdr 管终端的,可以装官方的 Herdr Annotate 插件,在终端里做同样的批注。只用 IDE 内置聊天、很少用计划模式的,收益不大;只想要一个 diff 审查 Agent,可以看站内的 Open Code Review。
最后
想试的话,先用 --minimal 装二进制,对一个现成的 Markdown 文件跑一次 plannotator annotate,觉得顺手再让安装脚本接入你常用的 Agent。