Plannotator：与 AI 智能体保持同步的审查工作台

注释并与智能体保持同步所需的一切

收件箱界面 • 工件 • 代码审查

为计划、规范、Markdown、HTML 及其他交互式工件添加注释。审查 diff 和 PR。将反馈发送给你的智能体。

Plannotator 收件箱 · 官方网站 · 代码审查 · 可视化 HTML 技能 · Herdr 注释 ·（旧版）计划模式

Plannotator#

⭐️ 新功能：Plannotator 收件箱是你与多智能体工作之间缺失的审查层。它呈现决策、原型、变体、计划，以及保持同步所需的一切。适用于所有编码智能体和个人助理。

Plannotator 是一个面向 AI 编码智能体的本地、基于浏览器的审查界面：Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、DeepSeek Harness 和 Pi。Plannotator 收件箱也适用于个人助理（Grok Bot、Muse、Hermes、OpenClaw）。

它通过插件、钩子和命令直接接入你的智能体。当智能体提出决策、计划、HTML 或完成工作时，应用会在浏览器中打开，你进行标注、评论，并把反馈直接发送给智能体执行。

审查文档、计划和智能体消息#

为计划、规范、消息、HTML 添加注释，然后把反馈发送给智能体。

演示：使用 Pi 进行计划审查

代码审查#

审查本地更改或远程 PR。在 diff 上评论、建议代码。你的评论会回到智能体。支持 Git、GitButler、Jujutsu（jj）、Perforce（p4）、GitHub 和 GitLab。

内置 AI：就可审查的任何内容向 AI 提问，或启动 AI 审查并将评论发布到 diff。

注释 HTML 工件#

Plannotator 收件箱#

Plannotator 收件箱是一个本地窗口，你的智能体在此留下消息、问题、文件和引导式审查，同时继续工作。点击即可回答一个问题，注释一个文件，准备好时按发送。你做这些时不会让任何智能体会话保持打开，你的回复会回到提问的会话。

plannotator inbox

Claude Code、Pi 和 OpenCode 通过 Plannotator 插件连接，你的回复会作为它们的下一轮输入到达。任何其他智能体可通过 MCP 使用 plannotator inbox mcp 访问，plannotator inbox --help 是智能体读取的指南。观看演示 · 收件箱更多信息 · 文档

Herdr 注释：终端中的 Plannotator#

Herdr 注释将 Plannotator 风格的审查带到终端：在 Herdr 内注释终端文本、审查整个 Markdown 文档及编码智能体的回复，并将反馈作为下一条消息直接发回智能体。适用于 Claude Code、Codex、Pi、Copilot CLI 和 Droid 的回复。注释保存在 Plannotator 数据目录中，因此终端审查与应用审查会累积叠加。

herdr plugin install plannotator/herdr-annotate

更喜欢独立使用？Plannotator TUI 驱动文档审查，无需 Herdr 即可运行：brew install plannotator/tap/plannotator-tui。

命令#

在 Codex 上，把斜杠命令换成 !plannotator …（例如 !plannotator review）或 $plannotator-* 技能。

注释#

/plannotator-annotate README.md # 本地 markdown 文件
/plannotator-annotate src/ # 浏览并注释文件夹中的文件
/plannotator-annotate https://docs.rs/… # 抓取并注释任意 URL
/plannotator-annotate report.html --render-html # 按原样渲染 HTML，而不是转换
/plannotator-last # 注释智能体最后一条消息

需要一个真实文档来试用？把产品需求文档模板和填写好的示例复制为 Markdown。

代码审查#

/plannotator-review # 审查未提交的更改
/plannotator-review <github-pr-url> # 审查 GitHub 拉取请求
/plannotator-review <gitlab-mr-url> # 审查 GitLab 合并请求
plannotator review --gitbutler # 审查活跃的 GitButler 工作区
plannotator review --patch-file reading.diff # 审查调用方提供的静态统一 diff

GitButler 用户可以审查整个工作区、一个堆栈或一个分支层。参见 GitButler 工作流指南。

计划模式#

无需命令。计划模式通过各 harness 的钩子接入。每当智能体创建计划，Markdown 审查界面就会为你打开。

CLI#

plannotator sessions # 列出活跃的 Plannotator 会话
plannotator sessions --open 1 # 在浏览器中重新打开会话
plannotator archive # 以只读方式浏览已保存的计划决策

隐私与网络行为#

Plannotator 不收集使用遥测或分析数据。计划、diff、注释、草稿、历史和配置默认保留在本地。

每次计划审查、注释、归档、分享门户和代码审查应用界面在加载时都会检查 GitHub 上最新的 Plannotator 版本。这不会发送任何计划或审查内容，也不会给 Plannotator 项目所有者带来使用分析数据，尽管 GitHub 会收到普通请求。目前没有针对版本检查的退出设置。本地 Git 代码审查还可能通过 git ls-remote 查询配置的 origin，以检测默认分支和过时基线；它不会发送本地 diff。该远程查询在审查打开时、页面加载其 diff 时、你切换 diff 类型或基线时（包括“Diff 已过期 · 刷新”按钮），以及按下 Fetch 时运行——从不按定时器运行，因此空闲的审查页面不会发起网络调用。可通过 plannotator review --no-git-remote-check、PLANNOTATOR_GIT_REMOTE_CHECK=0 或 ~/.plannotator/config.json 中的 { "gitRemoteCheck": false } 完全关闭；此时比较目标仅来自本地引用，“落后于 GitHub”横幅也永远不会出现。

只有当网络功能需要时，内容才会离开本地工作流：

• URL 注释会抓取请求的站点，公共页面默认通过 Jina Reader，禁用或不可用时直接抓取。
• GitHub 和 GitLab 审查使用你已认证的 CLI 和 Git 远程来获取 PR 或 MR 数据。
• Ask AI 和审查智能体会将所选问题及相关计划、文档、仓库或 diff 上下文发送给你配置的提供商。当 Ask AI 由打开 Plannotator 的智能体会话回答（“Ask this session”）时，问题会发给该会话。
• 分享会把完整链接发送给你用来传递它的任何人或服务。加密短链接会把密文上传到粘贴服务。
• Workspaces 是独立的托管产品，因此开源应用的本地存储模型不适用于放在那里的内容。

隐私政策记录了这些边界以及托管网站和候补名单数据。

链接分享#

开源的异步链接分享因兼容性仍然可用，但正转向弃用支持。Workspaces 是团队分享的主要方向。尚未公布移除日期。

旧版链接分享演示：room.plannotator.ai

与队友分享计划，他们可以自行注释。导入他们的反馈并直接发回给你的智能体。

小型 Markdown 分享会压缩到 URL 片段中。该片段不包含在浏览器对分享门户的请求中，但未加密。任何拥有完整链接的人或消息服务都能读取共享内容。门户主机仍会收到普通请求元数据。

大型 Markdown 和原始 HTML 分享使用短链接服务。分享载荷在上传前用 AES-256-GCM 加密，服务器只存储密文，密钥保存在 URL 片段中而非粘贴请求中。任何拥有完整链接的人都能解密。托管粘贴 7 天后过期。

与 PrivateBin 相同的模式。粘贴服务可自托管。

可通过 PLANNOTATOR_SHARE=disabled 完全禁用分享。

Workspaces 是托管团队协作的主要路径。

安装#

一个安装器覆盖几乎所有智能体。它安装 plannotator 二进制文件，自动检测已安装的智能体，并为每个智能体配置钩子、技能和斜杠命令：

# macOS / Linux / WSL
curl -fsSL https://plannotator.ai/install.sh | bash

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

安装器从 GitHub Releases 下载二进制文件。完整安装还可能联系 GitHub 以解析发布版本和智能体文件，联系 Ataraxy-Labs/sem 以获取可选的 sem 辅助进程，以及联系 npm 以获取 Pi、选定额外技能或受管智能体终端运行时。固定 --version 只会跳过 GitHub API 发布版本解析，不会跳过发布下载。完整网络边界见隐私政策。

只想要二进制文件、不要其他内容？传入 --minimal（或 export PLANNOTATOR_MINIMAL=1），仅将 plannotator 二进制安装到 ~/.local/bin，跳过所有技能、钩子、斜杠命令和每个智能体的配置：

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

然后完成你所使用智能体的步骤：

更新：再次运行安装器即可更新二进制文件和斜杠命令。如果 claude 命令在 PATH 中，它还会更新已安装的 Claude Code 插件（用 --skip-claude-plugin 退出）；否则运行 claude plugin marketplace update plannotator，然后 claude plugin update plannotator@plannotator，再重启 Claude Code（仅刷新市场不会更新插件）。Pi：pi update --extensions（普通 pi update 只更新 Pi）。

在 Claude Code 2.1.287 或更新版本上，计划审查、代码审查和注释不会让 Claude 等待：Claude 结束当前轮次，你的决定稍后作为消息到达。设置 PLANNOTATOR_CLAUDE_MOD=0 可回到经典流程。

完整演练见安装文档。

卸载#

安全默认值会移除已识别的 Plannotator 安装组件，并保留你的本地计划、历史、草稿、指南和设置：

plannotator uninstall

使用 --purge 可一并彻底移除已知的本地 Plannotator 数据：

plannotator uninstall --purge

清除操作要求在提示符输入 purge，并会说明数据仅存于本地：它不存储在 Plannotator 服务器上，且无法恢复。自动化时可传入 --yes（或 -y）；非交互式移除在没有该参数时会拒绝运行。使用 --dry-run 可预览已识别的工作内容而不做更改。宿主集成始终是卸载的一部分。如果损坏或不可用的宿主阻止安全清理，命令会指出阻塞的插件管理器或配置，给出精确的手动清理说明，并在删除二进制文件前停止。完成清理后重新运行卸载。当智能体的配置文件无法读取（其他工具的配置同理），或由它未安装的钩子仍在运行 Plannotator 时，它也会保留二进制文件。错误信息会指出文件、工具以及该怎么做。你自己添加的 plannotator-inbox 条目，或为单个项目安装的 Claude Code 或 Droid 插件，会被指出如何移除，且不会因此保留二进制文件。

这些机制让普通的确认默认值为否，让不可逆结果需要更强的明确字词，同时仍为包管理器和脚本提供常规的非交互标志。

该命令覆盖常规的 macOS、Linux、WSL 和 Windows 二进制位置；受管的 sem 辅助进程和智能体终端运行时；安装器技能、命令、钩子、策略、缓存和可识别的 Amp/Kiro 文件；以及通过宿主 CLI 检测到的 Claude Code、Copilot CLI、Droid、Pi 和 VS Code 安装。共享 JSONC 设置会被精确编辑，而严格 JSON 更新会保留文件的缩进、行尾和末尾换行风格。自定义或无法识别的文件、单独安装的可选技能、项目本地集成、外部计划保存位置和无效配置会被保留（格式错误的宿主配置属于故障安全错误）。如果清理报告错误，CLI 仍可用于安全重试，其 Windows PATH 条目会尽可能保留或恢复。如果 PATH 恢复本身失败，输出会给出完整 CLI 路径以便重试，并要求手动修复 PATH。为安全起见，清除操作会拒绝文件系统根目录、主目录、共享临时目录、符号链接的数据目录以及非目录数据路径。现有路径按文件系统标识比较，因此大小写别名、符号链接、硬链接和绑定挂载都无法绕过根/主目录/祖先检查。该标识和每项包含性防护都会在等待宿主命令之后、同步数据移除块之前立即重新验证；被替换的数据目录会被拒绝，既不触碰旧数据也不触碰替换数据。如果你的专用数据目录是符号链接，请将 PLANNOTATOR_DATA_DIR 指向其解析后的目标后重试。

如果你只安装了独立的 Pi 扩展而没有 plannotator CLI，请使用 pi remove npm:@plannotator/pi-extension。

Claude Code：手动钩子设置（不使用插件系统）#

添加到 ~/.claude/settings.json：

{
  "hooks": {
    "PermissionRequest": [
      {
        "matcher": "ExitPlanMode",
        "hooks": [
          {
            "type": "command",
            "command": "plannotator",
            "timeout": 345600
          }
        ]
      }
    ]
  }
}

固定特定版本#

curl -fsSL https://plannotator.ai/install.sh | bash -s -- --version vX.Y.Z

& ([scriptblock]::Create((irm https://plannotator.ai/install.ps1))) -Version vX.Y.Z

试用#

了解 Plannotator 功能的最快方式，是现在就从你的智能体调用它：

/plannotator-last # 注释智能体的最后一条回复
/plannotator-review # 以 PR 风格审查当前 diff
/plannotator-annotate report.html # 注释任意文件、文件夹或 URL

（多数智能体中使用斜杠命令；Codex 中使用 $plannotator-* 技能，Amp 中使用命令面板。）

计划审查完全不需要命令。下次你的智能体提出计划时，它会自动在浏览器中打开。

工作原理#

计划审查#

智能体调用 ExitPlanMode
 -> 触发 PermissionRequest 钩子
 -> 本地服务器从钩子输入读取计划
 -> 浏览器打开审查界面
 -> 你注释并批准/拒绝
 -> 批准：智能体继续
 -> 拒绝：结构化反馈发送给智能体
 -> 智能体修改，计划 diff 显示更改内容

代码审查#

你运行 /plannotator-review
 -> git diff 捕获更改（或按 URL 获取 PR）
 -> 浏览器打开 diff 查看器
 -> 注释行、暂存/取消暂存文件
 -> 发送反馈：返回智能体会话
 -> 批准：发送 "LGTM"

集成#

• VS Code：在编辑器标签页中打开计划，内联查看 diff，从编辑器装订线添加注释。从 VS Code Marketplace 安装。
• Obsidian：自动将已批准的计划保存到 vault，带 YAML frontmatter、来自计划标题的标签，以及用于图谱连接的反向链接。在 Plannotator 的设置面板中配置。
• Bear：将计划保存为带嵌套标签和项目元数据的 Bear 笔记。
• Notion：将计划保存为共享 Notion 页面下的 Markdown 子页面。在启动 Plannotator 的环境中设置 NOTION_TOKEN，然后在设置中配置父页面。
• GitHub / GitLab：将任意 PR 或 MR URL 传给 /plannotator-review，用完整 diff 查看器、注释和文件树进行审查。

远程 / SSH / devcontainer#

Plannotator 会自动检测 SSH 会话并切换到固定端口 19432。如需其他端口，或在 devcontainer 或 Docker 中：

export PLANNOTATOR_REMOTE=1
export PLANNOTATOR_PORT=9999 # 转发此端口

VS Code devcontainer 会自动转发端口（查看 Ports 标签页）。对于原始 SSH，将以下内容添加到 ~/.ssh/config，如果你设置了 PLANNOTATOR_PORT 则使用该值：

Host your-server
  LocalForward 19432 localhost:19432

在远程模式下，服务器监听所有接口（0.0.0.0）且无登录验证，因此任何能访问该端口的人都可以使用它，即使你使用 SSH 隧道也一样。请对不受信任的网络保持端口关闭。

安全#

每个发布的二进制文件都附带 SHA256 校验文件。SLSA 来源证明自 v0.17.2 起提供。当前发布工作流还会附加 CycloneDX JSON SBOM，在证明或发布前用全新的 Grype 数据库评估它，并为发布的二进制文件和 npm tarball 生成 GitHub/Sigstore SBOM 证明。

该 SBOM 被明确标记为 monorepo 锁定构建输入和依赖的发布级 Syft 清单。它不是精确的逐二进制运行时清单：Bun 独立可执行文件不会向 Syft 暴露其捆绑的 JavaScript 包元数据。规范的安装与验证文档覆盖现有安装器路径；确切的 SBOM 新命令包含在下方，并且必须在首次启用 SBOM 的发布前复制到该 Mintlify 页面。

发布门禁会拒绝扫描器侧被忽略的匹配项，并在评估 CISA KEV 和可修复的严重发现时，将未知适用性保守地视为运行时。其显式 Grype 配置、完整 JSON 结果、数据库状态和仓库策略决定会保留为工作流证据。

要直接验证已发布的 Linux x64 二进制文件、其现有来源证明和新的 SBOM 证据：

tag=vX.Y.Z
version="${tag#v}"
mkdir -p /tmp/plannotator-release-verify
gh release download "$tag" --repo backnotprop/plannotator \
  --pattern 'plannotator-linux-x64*' \
  --pattern "plannotator-${version}-release-sbom.cdx.json*" \
  --dir /tmp/plannotator-release-verify

(cd /tmp/plannotator-release-verify && sha256sum --check plannotator-linux-x64.sha256)
(cd /tmp/plannotator-release-verify && sha256sum --check "plannotator-${version}-release-sbom.cdx.json.sha256")

gh attestation verify /tmp/plannotator-release-verify/plannotator-linux-x64 \
  --repo backnotprop/plannotator --source-ref "refs/tags/$tag" \
  --signer-workflow backnotprop/plannotator/.github/workflows/release.yml \
  --predicate-type https://slsa.dev/provenance/v1

gh attestation verify /tmp/plannotator-release-verify/plannotator-linux-x64 \
  --repo backnotprop/plannotator --source-ref "refs/tags/$tag" \
  --signer-workflow backnotprop/plannotator/.github/workflows/release.yml \
  --predicate-type https://cyclonedx.org/bom

这些是对同一工件摘要的独立声明：来源证明标识其构建者/源/工作流，而 CycloneDX 谓词描述发布级清单。发布运行手册还会用 jq -S 规范化下载的 SBOM 和已证明的谓词并进行比较。

安装时验证：

curl -fsSL https://plannotator.ai/install.sh | bash -s -- --verify-attestation

需要 gh CLI，但无需登录：安装器从 GitHub 的公共证明 API 获取证明包，并用 gh attestation verify --bundle 验证（提取过程需要 PATH 中有 node、python3 或 jq；gh 的认证获取是回退方案）。也可在 ~/.plannotator/config.json 中持久设置：

{ "verifyAttestation": true }

安装器验证仍是可选项，验证的是 SLSA 构建来源；常规安装不需要 gh。详情见规范的安装文档。

配置#

设置保存在 cookie 中（而非 localStorage），因为每次钩子调用都运行在随机端口上。你也可以通过环境变量或 ~/.plannotator/config.json 设置选项。

可选 Vim 控制#

计划和注释视图在“设置 → Vim”下提供默认关闭的 Vim 控制配置。启用后，聚焦文档并使用 j / k 一次移动一个渲染块。当 l 细化到语义层级后，j / k 在兄弟行、单元格或内联目标之间移动；h 返回包含它的目标。细化超过最深层目标会进入文本。v 启动按字符的 Visual 选择，V 选择整块。空格打开常规注释工具栏；c、d、m 和 t 选择评论、红线、标记和标签操作。相同的语义目标图驱动指针 Pinpoint 和键盘导航。在文档中按 ? 查看上下文键位参考。输入框、对话框、编辑器、Tab 以及所有指针交互保留其原生行为。当页面处于中性状态时，文档会自动获得焦点；从应用外框按 Escape 可返回文档而无需点击。Vim 控制下方还会出现一个默认关闭的 Vim HUD 开关。它使用产品演示样式显示实时目标准星和导航上下文。其右下角的按键面板可独立隐藏，而准星仍保持活动；? 仍可按需打开完整键位图。该面板显示最近处理的按键、当前块/行/词/Visual 阶段，以及命令含义，且不会捕获输入到评论或其他控件中的文本。交互契约和实现架构见 Vim 控制。

Plannotator 管理的文件默认位于 ~/.plannotator 下。部分 UI 偏好存储在功能性浏览器 cookie 中。要迁移文件（例如为了 XDG 清洁的主目录）：

export PLANNOTATOR_DATA_DIR=~/.local/share/plannotator

开发#

bun install

bun run dev:hook     # 计划审查服务器
bun run dev:review   # 代码审查编辑器
bun run dev:marketing # 营销站点（plannotator.ai）
bun run dev:vscode   # VS Code 扩展（监视模式）

构建#

bun run build         # 主要目标（hook + opencode + dsh）
bun run build:hook    # 钩子服务器的单文件 HTML
bun run build:review  # 代码审查编辑器
bun run build:opencode # OpenCode 插件
bun run build:dsh     # DeepSeek Harness 插件
bun run build:vscode  # VS Code 扩展

构建顺序很重要。钩子构建会从 apps/review/dist/ 复制预构建的 HTML。如果你更改了 packages/ui/、packages/editor/ 或 packages/review-editor/ 中的 UI 代码，请先重新构建审查应用：

bun run --cwd apps/review build && bun run build:hook

本地测试插件：

claude --plugin-dir ./apps/hook

完整二进制构建：

bun run --cwd apps/review build && bun run build:hook && \
  bun build apps/hook/server/index.ts --compile --outfile ~/.local/bin/plannotator

许可证#

Copyright 2025-2026 backnotprop

根据 Apache 2.0 或 MIT 双许可证授权，由你选择。

贡献也按相同条款双许可证授权，除非你明确声明另有规定。

关于#

与智能体保持同步并掌控智能体的工作空间——塑造、决策、规划、注释、审查代码、与团队分享，并一键将所有反馈发送给智能体。

plannotator.ai

主题：agents、claude-code、code-review、codex、obsidian、opencode、pi-mono、plan-mode、skills

资源#

Readme

发现 Apache-2.0、MIT 许可证

贡献

贡献

安全策略

安全策略

活动

Stars

10.4k stars

Watchers

24 watching

Forks

784 forks

报告仓库

Releases

Packages

Used by

Contributors

Languages