backnotprop/plannotator

Plannotator – 以AI代理为中心的标注与审查工具

它是什么

• 一个本地运行的、基于浏览器（以及终端）的UI，让您可以对多种AI编码代理（Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、Pi）进行标注、审查和发送反馈。
• 它通过接入代理的命令/技能系统来工作。当代理生成计划、HTML工件或完成的代码时，Plannotator会打开一个网页（或TUI），您可以在其中进行内联评论，然后将评论作为代理的下一条消息推送回去。

关键功能

领域	您可以做什么
计划与文档审查	打开Markdown计划、规格说明或任何URL，进行内联标注，批准或拒绝计划。代理会收到结构化反馈并可以修改计划。
代码审查	审查本地差异、未提交的更改或来自GitHub/GitLab的远程PR/MR。支持Git、GitButler、Jujutsu（jj）、Perforce（p4）。对行进行标注，暂存/取消暂存文件，并将“LGTM”或详细评论发送回代理。
HTML工件审查	渲染任意HTML（或原始HTML）并对渲染视图进行标注。
终端UI（Herdr Annotate）	一个用于Herdr终端编辑器的TUI插件，将相同的标注体验带到命令行。还提供独立的TUI（plannotator-tui）。
Ask-AI与AI驱动的审查	在UI内，您可以向配置的LLM询问有关您正在审查内容的问题，或启动AI生成的审查，自动将评论发布到差异中。
分享	通过短链接（AES-256-GCM加密负载）导出计划或标注文档，或将小型Markdown直接嵌入URL片段。旧版链接分享UI仍然存在，但正在被托管的Workspaces产品取代。
集成	VS Code webview、Obsidian库自动保存、Bear笔记以及SSH/devcontainer端口处理。

支持的代理（开箱即用）

• Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、Pi。
• 安装程序会自动检测哪些代理存在，并为每个代理创建必要的钩子、斜杠命令或技能。

安装

# macOS / Linux / WSL – 一行安装脚本
curl -fsSL https://plannotator.ai/install.sh | bash

# Windows PowerShell
irm https://plannotator.ai/install.ps1 | iex

• 脚本从GitHub Releases下载plannotator二进制文件，检测已安装的代理，并写入所需的配置文件（钩子、插件、斜杠命令等）。
• --minimal（或PLANNOTATOR_MINIMAL=1）仅安装二进制文件，让您手动添加代理特定的部分。
• 安装程序完成后，请按照README中简短的每个代理的“安装后”表格，复制插件文件、运行市场命令，或直接开始使用代理（Codex、Gemini、Kiro无需额外步骤）。

典型工作流程

1. 计划模式 – 无需命令。当您的代理生成计划时，Plannotator会自动打开浏览器标签页。
2. 标注 – 添加评论、批准或拒绝。反馈会发送回代理会话。
3. 代码审查 – 运行 /plannotator-review（或等效技能）打开差异查看器，进行标注，然后将审查发送回代理。
4. HTML审查 – 使用 /plannotator-annotate <file.html> --render-html 查看并评论渲染后的页面。
5. 终端 – 在Herdr内运行 herdr plugin install plannotator/herdr-annotate，并在TUI中使用相同的命令。

隐私与网络行为

• 默认情况下，所有计划、差异、标注和设置都保留在您的机器上；不收集任何遥测数据。
• 唯一的外发请求是：
  • 一次性检查GitHub上最新的Plannotator版本（可通过--no-git-remote-check或PLANNOTATOR_GIT_REMOTE_CHECK=0禁用）。
  • 当您标注远程网页时，可选的URL获取（默认通过Jina Reader）。
  • 当您使用Ask AI或AI生成的审查时，调用您配置的LLM提供商——仅发送所选问题和相关上下文。
  • 共享服务：短链接上传在客户端加密负载；服务器仅存储密文。
• README中链接了详细的隐私政策。

卸载 / 清除

plannotator uninstall          # 移除二进制文件、钩子、配置，但保留您的本地数据
plannotator uninstall --purge # 在确认提示后删除所有Plannotator拥有的数据

这两个命令都防止意外数据丢失（它们拒绝删除根/主目录，要求明确的purge措辞，并提供试运行模式）。

谁可能受益？

• 使用LLM驱动的编码助手并希望在代理继续之前进行人在回路审查步骤的开发者。
• 需要共享带标注的计划或代码审查而不暴露整个仓库的团队（加密短链接共享或即将推出的Workspaces产品）。
• 喜欢可视化差异/标注UI但仍希望反馈能被其AI代理自动消费的用户。

结论 Plannotator通过将计划、规格、代码差异和HTML工件转化为一个直接与底层编码代理对话的交互式审查界面，弥合了AI生成输出与人工监督之间的差距。它是一个真正的开源软件项目，旨在提高AI辅助开发的安全性和生产力。

---

SUMMARY: Plannotator是一个开源的、本地运行的浏览器（和终端）UI，让您可以对AI编码代理（Claude Code、Codex、Copilot CLI、Gemini等）生成的计划、规格、代码差异和HTML工件进行标注。标注会作为结构化反馈发送回代理，实现人在环审查步骤。它支持Git/GitHub/GitLab，与VS Code、Obsidian、Bear集成，并提供加密链接共享。安装是一行脚本，可自动检测代理；所有数据默认保留在本地，除非您明确共享。

TITLE: Plannotator – 面向AI编码代理的交互式标注与审查UI