Plannotator

项目简介

Plannotator 是一款本地运行的工具，用于审查和批注 AI 编码智能体生成的计划与代码。它会拦截计划的审批步骤，为智能体编写的代码提供差异查看器，并将结构化反馈回传给智能体。此外，它还提供面向 HTML 产物、线框图、交互原型、计划和图表的智能体技能。

核心功能

• 计划审查：自动接入智能体的计划步骤，让你在计划执行前进行批注。
• 代码审查：面向本地差异或 GitHub/GitLab PR 的 PR 式差异查看器，支持并排或统一视图以及行级批注。
• 本地运行，审查数据默认保留在本地，无使用遥测或分析。
• 版本历史保存每次计划修订并提供版本间差异，草稿自动保存可在服务器崩溃和重启后保留批注。
• 链接分享：小规模分享使用 URL 片段，较大分享和 HTML 分享使用加密短链接。
• 集成 VS Code、Obsidian、Bear 和 GitHub PR，并提供 /plannotator-annotate、/plannotator-review 和 /plannotator-last 等命令。

适用场景

• 在智能体提出的计划执行前进行审查：内联批注、标记删除、添加评论或替换内容，然后以结构化反馈批准或拒绝。
• 在提交前审查智能体编写的代码：运行 /plannotator-review 在差异查看器中查看未提交的更改，添加行级建议，并暂存或取消暂存文件。
• 通过本地数据、链接分享或托管的 Workspaces 层，与团队分享批注过的计划和代码反馈。
• 使用 /plannotator-annotate 或 /plannotator-last 批注智能体的最后一条消息，或任意 markdown、规格/计划、文件夹或 URL。

快速开始

• 在本地安装 Plannotator：curl -fsSL https://plannotator\.ai/install\.sh | bash
• 在 Claude Code 中，使用 /plugin marketplace add backnotprop/plannotator 添加市场，使用 /plugin install plannotator@plannotator 安装，然后重启 Claude Code 以激活 hooks。
• 使用 /plannotator-annotate <file|dir|url> 批注任意 markdown、规格/计划、文件夹或 URL 并发送反馈。
• 使用 /plannotator-review [PR_URL] 审查本地差异或 GitHub/GitLab 拉取请求。
• 使用 /plannotator-last 批注智能体的最后一条消息。

部署与要求

• 本地运行。
• 集成 Claude Code、OpenCode、Pi、Codex 和 VS Code；可与任何支持计划模式的智能体配合使用。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。