# Plannotator：给 AI 编程计划和代码加批注，把修改意见直接送回 Agent

**URL:** <https://www.sunai.net/t/topic/1555>\
**Category:** IT\
**Tags:** claude-code, 开源, 开发, 效率工具\
**Created:** [2026 年10 月 27 日 11:32 UTC](https://www.sunai.net/t/topic/1555 "2026-10-27T11:32:54Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![Logos](https://www.sunai.net/user_avatar/www.sunai.net/logos/32/2077_2.png) [@Logos](https://www.sunai.net/u/Logos)\
发布日期： [2026 年10 月 27 日 11:32 UTC](https://www.sunai.net/t/topic/1555/1 "2026-10-27T11:32:54Z")

</div>

让 AI 先写计划，再批准它动手，听起来很稳妥。但计划一长，反馈常常又变成一大段聊天：第二节保留，第三步别碰数据库，测试方案再补一下。人要反复引用原文，Agent 还得猜每句话对应哪里。

Plannotator 给这一步加了一个本地浏览器界面：直接选中计划中的文字做批注，再把意见送回编程 Agent。它也能审查代码 diff、Markdown 文档和 HTML 产物，适合想认真过一遍方案，又不想来回复制粘贴的人。

## 把意见贴在具体内容上

Plannotator 通过插件、hook 和命令接入编程 Agent。计划或待审内容在浏览器里打开后，可以逐段标注、评论，再把反馈交回 Agent 处理。相比只回复一句「这个方案不行」，批注至少能把哪里不行说清楚。

 ![Plannotator 的文档批注界面](https://i.czl.net/r2/original/2X/c/c6d0892353873f8eba532c733abc51182fcca67b.webp)

同一套界面还覆盖了代码审查：查看本地修改或远程 PR，在 diff 上评论、提出代码建议。项目支持 Git、Jujutsu、Perforce 等工作流，也接入 GitHub 和 GitLab。日常主要用 Git 的话，不必先研究其他集成。

它有意思的地方，是把「计划批准前」和「代码写完后」这两次人工检查放进了相近的操作方式里。批注不会替你判断方案对不对，但能减少把判断重新组织成提示词的麻烦。

## 怎么接进现有工具

项目支持 Claude Code、Codex、OpenCode、Gemini CLI、Pi 等多种编程 Agent，但各家的安装步骤和计划拦截能力并不完全一样。

以 Claude Code 为例，先用官方安装器安装本地程序。macOS、Linux 或 WSL 的入口是：

```bash
curl -fsSL https://plannotator.ai/install.sh | bash

```

这是下载并执行远程脚本的安装方式，执行前可以先打开脚本检查。完整安装还可能安装配套组件和修改 Agent 集成配置；只想装二进制的话，官方另有 `--minimal` 选项，但不会一并配置插件、hook 和命令。

随后在 Claude Code 中添加插件市场并安装插件：

```plaintext
/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator

```

重启 Claude Code 后，可以从这些命令试起：

```plaintext
/plannotator-last
/plannotator-review
/plannotator-annotate report.html

```

分别用于批注上一条回复、审查当前代码改动、打开指定文件做批注。计划审查接入后，会在 Agent 提交计划时自动打开浏览器。其他 Agent 请按各自的安装步骤配置，不要直接照搬 Claude Code 的命令。

## 适合什么场景

如果经常让 Agent 先出实施计划，或者会让它写规格说明、生成 HTML 页面，这种逐段反馈比「再改一改」更具体。项目还有本地 Inbox，可以集中接收 Agent 留下的问题、文件和审查请求，再把回复送回对应会话。

不过，它本质上是审阅与反馈工具。代码仍然要跑测试，方案中的假设仍然要核实。接入本地界面也不等于整个工作流都离线：模型调用、远程 PR 和可选功能各有网络边界，使用前应检查对应设置。

## 项目信息

- 主要语言：TypeScript
- License：Apache-2.0
- Star：截至 2026-10-27 约 9,700
- GitHub：[GitHub - backnotprop/plannotator: Annotate and review coding agent plans and code diffs visually, share with your team, send feedback to agents with one click. · GitHub](https://github.com/backnotprop/plannotator)
- 官网：[https://plannotator.ai/](https://plannotator.ai/)
- 安装指南：[Install Plannotator - Plannotator](https://docs.plannotator.ai/open-source/start/installation)