10 个编码 Agent 共用一块批注面板:Plannotator 把人按回回路里

10 个编码 Agent 共用一块批注面板:Plannotator 把人按回回路里

1周前
duguying
5 阅读
来源:GitHub

多 Agent 并行干活之后,新的瓶颈是人看不清它们在干什么。Plannotator 用一个本地浏览器面板把计划、diff 和 HTML 制品拉回人眼前,标注一键回灌给 Agent,还不阻塞它继续干活。

相关标签

#GitHub#Trending#AgentTools#开源

多 Agent 并行干活之后,一个新的瓶颈出现了:人看不清它们在干什么。Agent 一次改十几个文件、写一份计划、生成一版 HTML 原型,然后停下来等一句”可以”。而你能做的往往只有两个选项——在终端里翻 diff,或者直接点通过。中间那层”看懂、标注、给具体意见”的动作,被压缩掉了。

Plannotator 就是补这一层的。它是一个跑在本地的、基于浏览器的评审面板,通过插件、hook 和斜杠命令直接插进你的编码 Agent:当 Agent 提出一个决策、写出一份计划、生成 HTML,或者刚干完活,界面会自动在浏览器里打开,你在上面画标注、写评论,一键把意见送回去让它接着改。

覆盖的 Agent 名单已经排到十个以上:Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、DeepSeek Harness、Pi。安装器会自己探测本机装了哪些 Agent,然后各自配好 hook、技能和命令。最近一版还把 Grok Bot 一类的云端 Agent 纳入配对范围,Hermes、OpenClaw、Muse Code 则可以通过 Plannotator Inbox 参与。

三个核心场景分工很清楚。文档与计划审阅:计划、规格、消息、HTML 制品都能标,标注完直接回传给 Agent,不再需要把”第 3 段第二句那个方案不行”翻译成一段模糊的提示词。代码评审:本地改动或远端 PR 都能评,可以对着 diff 写评论、提建议,评论原路回到 Agent——底层支持 Git、GitButler、Jujutsu(jj)、Perforce,以及 GitHub 和 GitLab。制品标注:这个是对着”Agent 给你三个方案让你挑”的场景做的,可以直接在页面上圈。

Plan mode 不需要额外命令。它通过各家 harness 的 hook 挂进去,只要 Agent 创建了计划,markdown 评审界面就自己弹出。命令行侧还有 plannotator sessions 列会话、--open 重开、plannotator archive 只读浏览历史决策,方便回溯”当初为什么选这个方案”。

最近一周的版本迭代很密,v0.28.64 落在 11-13。往前看几个版本能看出方向:v0.28.63 加了把 Grok Bot 和其他云端 Agent 从设置里配对、线程置顶与打标签、把 PR 面板改成表格并支持批量合并;v0.28.62 让从 Inbox 启动的 Agent 支持 Windows、启动时可选模型和 effort 档位、用”你自己的话”给 Agent 写规则、把线程里的决策直接发到对应 PR 上;v0.28.61 则修了更新时连 Claude Code 插件一起更新、以及”一段对话被显示成两个 Agent”的问题。

一个容易被忽略的细节:在 Claude Code 2.1.287 及以上版本,计划评审、代码评审和标注不再让 Claude 阻塞等待——它先结束这一轮,你的决定稍后作为一条消息送达。想退回老流程就设 PLANNOTATOR_CLAUDE_MOD=0。这个改动其实是把”人在回路里”做成了异步:不打断 Agent 干活,但人也没有被绕过。

隐私边界写得比大多数同类工具都细。项目不收集任何使用遥测或分析数据,计划、diff、标注、草稿、历史和配置默认全部留在本地。界面每次加载会向 GitHub 查一次最新版本(不携带任何计划或评审内容,但目前没有关闭开关)。本地 Git 评审会调 git ls-remote 探测默认分支和基线是否过期,这个请求只在打开评审、加载 diff、切换对比基准和点 Fetch 时触发,不走定时器,闲置页面不发任何网络请求;要彻底关掉可以用 plannotator review --no-git-remote-check 或配置项 gitRemoteCheck: false。内容只有在用到联网功能时才离开本地:URL 标注会去抓目标站点,GitHub/GitLab 评审走你已认证的 CLI,Ask AI 会把选中的上下文发给配置的模型服务商。

分享功能分了两档:小的 markdown 压缩进 URL fragment,不上传但也没加密;大文件走短链,上传前用 AES-256-GCM 加密,服务端只存密文,密钥放在 fragment 里不随请求发送,托管粘贴 7 天过期,跟 PrivateBin 一个模型,粘贴服务本身可自托管。项目也坦白说这条开源链路的分享正在转成”兼容保留”,团队协作的主线是另一个托管产品 Workspaces。

对天天跟 Agent 打交道的开发者来说,这个工具解决的不是”Agent 不够聪明”,而是”人跟不上 Agent 的手速”。它把审批从”点通过”变回”看、标、说”,而且尽量让这个过程不阻塞对方。

仓库地址:https://github.com/backnotprop/plannotator

返回列表

更多资讯

想看更多优质内容?

浏览所有资讯