
Agent 的计划出来了,审它的地方却只有终端
让 Agent 改一段代码,流程通常是这样:终端里敲一句需求,Agent 想一会儿,吐出一份几屏长的计划,问一句能不能动手。计划里夹着文件路径和改动清单,在终端里上下翻,看到第三屏就忘了第一屏写了什么。批了,等于没审;不批,Agent 停在原地等。
Plannotator 要解决的就是这一步:Agent 拿出计划或改完代码,先不急着执行,审阅面在浏览器里打开,计划按段落排好,代码改动按 diff 排好,逐行批注,点一下发送,意见直接回到 Agent 手里当作下一轮指令。结论先放在这里:本地运行,免费开源,数据默认只存本机。前提只有一个——已经在用一个受支持的 Agent,否则审阅面里什么也没有。
计划那么长,在浏览器里怎么审
计划审阅不需要敲命令。Agent 进入计划模式、拿出计划的那一刻,审阅面自动在浏览器里打开,这是通过各家 Agent 的钩子接进来的。计划按段落排布,选中一段文字,就能标删除、加评论,或者直接写一句替换。每一处批注都带着位置,Agent 收到的是结构化的意见,不是整段转述。

如果计划不是当场提出来的,也能在 Agent 会话里用斜杠命令主动打开:`/plannotator-annotate` 后面跟一个文件、一个文件夹或者一个网址;`/plannotator-last` 审 Agent 刚发完的上一条消息。上面这两个是 Agent 会话里的斜杠命令;系统终端里用的是不带斜杠的 `plannotator xxx` 形式,见第五节。改过的计划会留档,每一版都存着,版本之间能看 diff。
这里要承认一个质疑:多一个审阅面,是不是多一道手续。省掉的是另一道手续——以前审完计划,要把意见一句句敲回终端;现在批注写在哪里,意见就从哪里发回去,不用复制粘贴,也不用担心转述走样。
代码改完,先看 diff 再决定合不合
计划通过之后,Agent 动手改代码,改完的 diff 同样值得看一眼。`/plannotator-review` 打开的是 GitHub PR 风格的审阅页:左边文件树,中间左右对照或者上下对照的 diff,逐行能加批注,能写代码建议。文件可以在这里直接暂存或者取消暂存,审完点发送,意见回到 Agent 的会话里;觉得没问题,点通过,Agent 收到一句通过。

不只看本地没提交的改动。把 GitHub PR 或 GitLab MR 的链接交给 `/plannotator-review`,同样能打开审阅。改动特别大的时候,可以按 Guide,让 Agent 先把 diff 分成几章,重要的改动排在前面,每章配一段说明,再对照着看。审阅面本身不写代码,它只负责把意见准确地交回去,改还是 Agent 改。

好几个 Agent 同时跑,问题和交付散得到处都是
一个人同时开几个 Agent 是常事:一个在改后端,一个在调页面,还有一个跑到一半停下来问一个问题。问题散在各个终端窗口里,哪个先回、哪个还等着,全凭记忆。
Inbox 是为这种情况准备的:一个本地窗口,各家 Agent 的提问、交付、文件和分章审阅都收在这里。问题带选项的,点一下就能答;文件能直接打开批注;答完按发送,回复回到当初提问的那个会话,不用守着终端等它问完。终端里敲 `plannotator inbox` 就能打开。Claude Code、Pi 和 OpenCode 通过插件接进 Inbox,其他 Agent 走 MCP 接入。

终端和页面上,也能审
不是所有人都愿意为审一段计划切出终端。Herdr Annotate 是终端版(安装包叫 plannotator-tui),它把同一套审阅搬进终端:终端里的文字、整份 Markdown 文档、Agent 刚回完的消息,都能在终端里批注,意见同样直接发回给 Agent 当下一条消息。终端里的批注和浏览器里的批注存在同一个本地数据目录里,两边互通。

Agent 交出来的有时是一个 HTML 成品,或者一个正在本地跑的页面。在系统终端里敲 `plannotator annotate`,后面跟一个 HTML 文件,或者一个本地地址,就能在渲染出来的真实页面上批注,热重载照常工作。审的是页面本身的样子,不是源代码里的一行行标签。

审完的计划还能顺手存走:VS Code 里直接在编辑器标签页里打开计划、看 diff、加批注;Obsidian、Bear、Notion 能把通过的计划存成笔记,存在自己的库里,不用再导出一份文件。
发给同事看一眼,数据还留在本机吗
计划审完想让同事看一眼,不用把文件发过去再等对方的批注发回来。分享出去的是一条链接:小的分享直接放在链接里,大的分享先加密再上传,七天后过期。同事在链接里批注完,意见导回来,交给 Agent。分享可以整个关掉:把 `PLANNOTATOR_SHARE` 设为 `disabled`。
要说清楚的是:拿到完整链接的人就能读到分享的内容,大分享虽然加密,但链接本身就是钥匙,涉密的计划别走分享链接。除了分享这一步,审阅数据默认存在本机,不经过 Plannotator 的服务器,也不做用量统计。远程模式还有一处例外:在服务器或者容器里用,服务会监听在所有网卡上,而且没有登录,谁能连上端口,谁就能用,部署时务必只对可信的网络开放端口。
它不适合谁,先说清楚
先说前提。Plannotator 本身不写代码,它只审 Agent 交出来的东西。没有装 Agent,或者 Agent 不在支持列表里,装它没有意义。支持的 Agent 包括 Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、DeepSeek Harness 和 Pi,个人助手一侧还接 Grok Bot、Muse 这类工具。装完之后,每家 Agent 还要按自己的方式补一步,仓库里有一张对照表,装哪家、补哪一步写得清楚。
再说安装方式。安装是一行命令从官网拉脚本执行,脚本再从 GitHub Release 页下载程序,完整安装还可能访问 npm。没有外网装不了;对直接执行远端脚本不放心的人,可以先看脚本内容,或者用带验证的安装方式,验证要另外装 gh 命令行工具。
还有几处限制,官方都写明了:Droid 目前只有命令,没有计划拦截,计划出来不会自动弹出审阅面;Codex 在 Windows 原生环境下的钩子还是试验性的;审阅代替不了运行和测试,代码审着没问题,跑起来仍可能出错。面向团队的 Workspaces 还在等候名单上,没上线;眼下能用的,是上面说的链接分享。
最后聊聊我的看法
这套审阅面值不值,取决于你让 Agent 干的活有多大。
改一行配置、修一个小 bug,计划一眼就能看完,审阅面就是多余的手续——终端里扫一眼就够了,切出浏览器反而慢。但计划一长、改动一多,情况就反过来:几屏文字在终端里翻,看到后面忘了前面,批了等于没审。这时候审阅面省下的不是时间,是漏掉的错误。
最用得上它的人,是同时开几个 Agent 的人,和改动牵扯面广的人。几个 Agent 的问题散在各个终端窗口里,Inbox 把它们收在一个地方,哪个先回、哪个还等着,一眼看清。改动涉及多个文件、多个模块,diff 按章节排好,重要的在前面,审起来有条理。
还有一个判断标准:你审完计划,意见能不能准确地回到 Agent 手里。以前是口头转述,写得含糊,Agent 改得也含糊。批注带着位置,意见直接当下一轮指令,这一步省掉的转述损耗,比审阅面本身的成本大得多。
它不是必需品。Agent 用得轻,装了也是闲置;用得重,没有它,审计划这一步迟早会漏东西。
安装和使用
要求 macOS、Linux 或 WSL(另有 Windows PowerShell 安装脚本),并先装好一个受支持的 Agent,终端里运行一行命令安装:
项目地址:https://github.com/backnotprop/plannotator
安装命令:curl -fsSL https://plannotator.ai/install.sh | bash
终端版:brew install plannotator/tap/plannotator-tui
如果没有外网的,可以直接我们公众号下载,会更方便!
装好后按所用 Agent 的提示补上对应的一步,再让 Agent 拿一份计划出来,审阅面会自动打开。不用时,`plannotator uninstall` 可以卸载,本地的计划、历史和设置默认会保留;要连数据一起清掉,再加 `--purge`。

