backnotprop/plannotator
开发工具把编码 Agent 的计划和代码 diff 放进本地浏览器里批注,意见一键回传给 Agent。
如果你已经在终端里用编码 Agent,并且主要靠滚动窗口读它的计划和 diff,Plannotator 改的正是这一步:计划、HTML 产物和改动会打开在浏览器页面里供你批注,意见作为输入回给 Agent,不用再重新打字复述。
解决什么问题
用 Claude Code、Codex 或 Gemini CLI 时,常见流程是:Agent 给出计划,你在终端里翻完,再用文字写修改意见;看 diff 要么在终端里硬看,要么换到另一个代码评审工具,而且你针对某几行的想法和真正动手改代码的 Agent 之间没有联系。Plannotator 补上这层联系:计划、规格文档、HTML 产物或 diff 在本地浏览器界面打开,你在行内或具体代码行上留言,整批反馈交回给 Agent 执行。
有什么不同
核心是反馈的来回。批注不是给你自己留的文档,而是直接成为 Agent 的输入;所以它走 hook 和命令集成,而不是让你另开一个独立应用,也所以同一个界面能覆盖计划审阅、HTML 产物和代码评审,包括本地改动和 GitHub/GitLab PR,README 还点名了 GitButler、Jujutsu 和 Perforce 等版本控制环境。它还提供共享审阅和 Inbox,把多个 Agent 或团队的待处理内容按需求分组。
代价是它包住你的 Agent 工作流,而不是跟工作流并肩而立。安装器会自动检测已装的 Agent,并写入 hook、skills 和斜杠命令,所以顺畅路径假设你的宿主 Agent 支持这套接线。README 也提供 --minimal 只装二进制到 ~/.local/bin 的路径,但之后每个 Agent 的配置要自己完成。界面体验依赖工具打开的浏览器标签,而非 IDE。
隐私部分值得读清楚,而不是想当然。计划和 diff 默认留在本地,但每次打开审阅界面都会向 GitHub 查询最新版本,且目前没有关闭选项;本地 Git 评审在特定操作时还会向配置的 origin 发起查询。这不涉及审阅内容,但某些团队会想知道这些流量。远端检查可以通过命令行参数、环境变量或配置项关掉。真正让内容离开本机的是网络功能,例如 URL 批注默认经 Jina Reader 抓取公共页面,以及通过你已登录的 CLI 拉取 PR 数据。
谁值得试
适合:本来就用终端 Agent 做计划,希望把“批计划”和“批 diff”变成同一个习惯,并且不介意安装器往 Agent 配置里写 hook 和命令的开发者;也适合想要浏览器里带行级评论、且评论能回到编码 Agent 的评审者。
不适合:想要一个脱离 Agent 循环、通用且不绑定具体 Agent 的代码评审工具的人,或者要求安装只碰一个二进制、不改宿主配置的人。最小安装能避开第二条,但配置负担落到你自己身上。在沙箱里用的人要预期额外配置:一位评论者表示,在沙箱中运行需要设置 PLANNOTATOR_REMOTE=1,并允许应用目录和端口后才能跑通,说明特定环境可能需要补接线。
使用条件与边界
安装是首要的可见成本:一个安装器覆盖 macOS、Linux、WSL 和 Windows,之后还需要按 Agent 完成最后一步,详细说明见安装文档。安装器视选项会联系 GitHub、npm 等服务,离线或出口受限的机器需要用最小安装并自行接线。
日常维护也要算进去。发布包带 SHA256 sidecar,从 v0.17.2 起提供 SLSA 来源证明;但 README 明确说 SBOM 是整个 monorepo 的构建输入清单,不是单个二进制的运行时清单,所以不能把它当成某个二进制依赖的现成审计。普通卸载会保留计划、历史和设置,彻底删除需要输入确认词;卸载始终包含宿主集成,如果某个 Agent 的插件管理器坏了,清理会被卡住。
HotRepo 点评
HotRepo 的记录很少:该项目在 2026-10-24 的日榜上是 9,614 星(当天 +24),2026-10-25 是 9,617(+20),此前没有可比的历史,因此仅凭这两次快照无法判断热度是否持久。决策点不在流行度而在适配:采用前先核对隐私与网络行为,并确认你的 Agent 在安装器的检测名单里,因为正是这套 hook 与命令接线决定工作流能不能跑起来。
Hacker News 讨论
本文由 AI 根据项目 README 生成,更新于 2026年10月25日,以项目官方文档为准。