backnotprop/plannotator

Plannotator – 面向 AI 编码助手的本地浏览器式评审 UI

是什么 – Plannotator 是一个仅限桌面使用（无需云服务）的工具，当 AI 驱动的编码助手（Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、Pi 等）生成计划、HTML 或完成代码时，会自动打开一个 Web UI（或通过 Herdr Annotate 使用终端 UI）。您可以在内容上添加注释，对差异进行评论，并将反馈发送回助手，以便其修改输出。

核心功能

• 计划/文档评审 – 可对 Markdown 计划、规格说明或通过 URL 获取的页面进行注释。UI 显示内联评论和“发送反馈”按钮。
• 代码评审 – 支持本地变更或远程 PR/MR URL（GitHub、GitLab、GitButler、Perforce）。显示文件树和并排差异，可评论、暂存/取消暂存，以及回复“LGTM”。
• HTML 资产评审 – 渲染原始 HTML，允许您在发送反馈前进行标记。
• AI 在环中 – 您可以向连接的 LLM 提问关于评审内容的问题，或启动 AI 生成的评审，自动发布评论。
• 终端模式 – Herdr Annotate 插件将相同 UI 带入终端（通过 Herdr TUI）。也可独立使用 plannotator-tui 作为终端 UI。

工作原理

1. 助手触发一个钩子（例如 ExitPlanMode）。
2. Plannotator 的本地服务器接收计划或差异。
3. 您的默认浏览器打开评审 UI。
4. 您完成注释后，工具通过相同钩子将结构化响应发送回，使助手可以继续或修改。

安装

• 适用于 macOS、Linux、WSL 和 Windows PowerShell 的一键安装脚本，自动下载 plannotator 二进制文件，检测已安装的助手，并写入必要的钩子/技能/命令。
• --minimal 标志仅安装二进制文件，不包含任何助手特定的集成。
• 安装后，按各助手的简要步骤操作（如为 Amp 复制插件文件、为 Claude Code 添加市场条目等）——README 提供了每个助手的详细设置链接。

使用快捷键

/plannotator-annotate README.md                # 注释本地文件
/plannotator-annotate https://example.com     # 获取并注释 URL
/plannotator-review                           # 审查当前 git 差异
/plannotator-review https://github.com/...    # 审查 PR/MR
/plannotator-last                             # 注释助手的上一次回复
plannotator sessions                          # 列出/打开保存的会话

（对于 Codex，命令前缀为 ! 或 $。）

集成

• VS Code Webview、Obsidian 仓库自动保存、Bear 笔记、GitHub/GitLab PR 获取、GitButler 工作区、Perforce、远程 SSH/开发容器端口转发。
• 所有集成均为可选；核心 UI 无需任何集成即可运行。

隐私与网络

• 无遥测；所有计划、差异、注释和设置均保留在本地机器上，除非您明确共享。
• 网络调用仅在请求外部资源时发生：获取 URL（默认通过 Jina Reader）、从 GitHub/GitLab 拉取 PR 数据、向配置的 LLM 提供商发送问题，或使用可选的链接共享服务（使用 AES-256-GCM 在客户端加密大负载）。
• 安装程序会检查 GitHub 上的最新版本，但不会传输您的任何内容。

共享

• 小型 Markdown 片段编码在 URL 片段中（任何拥有链接的人都可查看）。
• 大型负载使用短链接服务，仅存储密文；解密密钥位于片段中。
• 提及了用于团队协作的托管“工作区”产品，但开源应用始终保持完全本地化。

安全

• 每个二进制发布均附带 SHA-256 校验和和 SLSA 证明。
• 每个发布均附带 CycloneDX SBOM 和 Grype 扫描；README 提供了验证命令的链接。

卸载 / 彻底清除

• plannotator uninstall 删除二进制文件和配置，但保留本地数据。
• plannotator uninstall --purge 在确认提示后清除所有 Plannotator 数据。

总结 – Plannotator 是一个专注的本地托管 UI，让开发者在使用 AI 编码助手时保持“人类在环中”，提供计划评审、代码差异注释和 HTML 资产反馈，而无需将专有代码发送给任何第三方服务。