它是什么
Plannotator 是一个面向 AI 编程代理的本地评审界面。它不负责写代码，而是补上了「人机之间那一层审查」：当 Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、Pi 等代理给出方案、写完文档、改完代码之后，Plannotator 会在浏览器里打开一个可交互的页面，让你在原文上划线、批注、提意见，然后一键把整理好的反馈送回到代理的上下文里。
它通过插件、Hooks 和命令直接嵌进你已有的代理工作流，数据留在本机，不需要把代码或方案上传到第三方平台。README 里把它定位成「你和多代理协作之间缺失的评审层」，这个说法比较贴切——代理负责产出，你负责拍板和纠偏。
核心功能
- 计划与文档批注：对计划书、需求规格、Markdown、HTML 以及代理的中间消息做行内标注和整体评论，反馈结构化后回传代理，省去手工复制粘贴。
- 代码评审：查看本地改动或远端 PR，在 diff 上逐行留言、提出修改建议，评论同样可以直接交回给代理执行。
- 多版本控制与托管平台兼容：支持 Git、GitButler、Jujutsu（jj）、Perforce（p4），以及 GitHub、GitLab 上的 PR 评审。
- HTML 制品可视化审阅：代理生成的原型页、对比方案、可视化图表可以直接渲染出来，在真实页面上标注，而不是对着源码猜效果。
- Inbox 收件箱：把多个代理产生的决策点、原型、变体和计划汇总到一处，避免在多窗口之间来回切换漏掉待办。
- 内置 AI 辅助：审阅过程中随时就某段内容向 AI 提问，也可以让 AI 先跑一轮自动评审，把意见直接贴到 diff 上。
适用场景
- 用代理做中大型改造：代理先出实施计划，你先批注确认再让它动手，减少「一口气改完再返工」的浪费。
- 多代理并行协作：同时跑几个代理时，用 Inbox 统一收敛需要你决策的事项，保持对全局的掌控。
- 代码评审前的自检：把自己或代理的改动先在 diff 上过一遍并留下结构化意见，再提交给团队。
- 非工程视角的评审：产品、设计同学可以在渲染后的 HTML 制品上直接标注，不必读代码。
- 本地/私有环境：对数据外流敏感、但又想用云端大模型的团队，浏览器本地运行的方式更容易被接受。
上手建议
- 先确认你常用的代理在支持列表里，按官方文档把插件或 Hooks 装好，让代理在关键节点自动唤起 Plannotator。
- 从「计划评审」这个最小闭环开始：让代理先写方案，你标注几条意见回传，观察代理的响应质量，再扩展到代码评审。
- 批注尽量具体——指明位置和期望结果，比笼统地说「这里不好」对代理更有效。
- 团队协作时约定好谁的评论优先，避免多个代理同时按冲突的反馈修改同一份代码。
- 它依赖浏览器与本地端口通信，注意防火墙与端口占用；若发现唤起失败，优先排查 Hooks 是否被代理正确加载。
