https://godvvvzzz.github.io/tags/plan-mode/Recent content in Plan Mode on VvVzzz BlogHugo -- gohugo.iozh-cnWed, 09 Sep 2026 20:13:00 +0800https://godvvvzzz.github.io/p/plannotator/Wed, 09 Sep 2026 20:13:00 +0800https://godvvvzzz.github.io/p/plannotator/ <blockquote> <p>收录于：<a class="link" href="https://godvvvzzz.github.io/p/awesome-open-source-repos/" >开源仓库收藏夹</a></p> </blockquote> <p><strong>仓库</strong>：<a class="link" href="https://github.com/backnotprop/plannotator" target="_blank" rel="noopener" >github.com/backnotprop/plannotator</a> · <strong>站点</strong>：<a class="link" href="https://plannotator.ai" target="_blank" rel="noopener" >plannotator.ai</a> · <strong>许可</strong>：Apache-2.0 / MIT 双许可</p> <h2 id="它是什么"><a href="#%e5%ae%83%e6%98%af%e4%bb%80%e4%b9%88" class="header-anchor"></a>它是什么 </h2><p>Plannotator 是一个<strong>本地、浏览器里的 Agent 评审界面</strong>。它通过各 harness 的 hooks 和 slash 命令直接接入：</p> <ul> <li>Agent 提出 plan、或写完代码时，工作自动在浏览器打开</li> <li>你做可视化标注、批注、建议修改</li> <li>反馈结构化送回 Agent，它照着改</li> </ul> <p>覆盖三大场景：<strong>Markdown/计划评审</strong>、<strong>代码 diff 评审</strong>、<strong>HTML 产物标注</strong>。</p> <h2 id="支持的-agent"><a href="#%e6%94%af%e6%8c%81%e7%9a%84-agent" class="header-anchor"></a>支持的 Agent </h2><p>Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、<strong>Pi</strong>。</p> <p>安装器会自动检测已装 Agent 并配置 hooks、skills、slash 命令。也可以 <code>--minimal</code> 只装二进制。</p> <h2 id="核心流程"><a href="#%e6%a0%b8%e5%bf%83%e6%b5%81%e7%a8%8b" class="header-anchor"></a>核心流程 </h2><p><strong>Plan review（无需命令）</strong></p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">Agent 调用 ExitPlanMode </span></span><span class="line"><span class="cl"> → PermissionRequest hook </span></span><span class="line"><span class="cl"> → 本地 server 读 plan </span></span><span class="line"><span class="cl"> → 浏览器打开评审 UI </span></span><span class="line"><span class="cl"> → 你标注并 approve / deny </span></span><span class="line"><span class="cl"> → Approve：继续执行 </span></span><span class="line"><span class="cl"> → Deny：结构化反馈给 Agent </span></span></code></pre></div><p><strong>Code review</strong></p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">/plannotator-review </span></span><span class="line"><span class="cl"> → git diff（或按 URL 拉 PR/MR） </span></span><span class="line"><span class="cl"> → 浏览器 diff 视图 </span></span><span class="line"><span class="cl"> → 标注、stage/unstage </span></span><span class="line"><span class="cl"> → 反馈回 Agent；LGTM 即通过 </span></span></code></pre></div><p>支持 Git、GitButler、Jujutsu、Perforce，以及 GitHub PR / GitLab MR URL。</p> <h2 id="几个设计细节"><a href="#%e5%87%a0%e4%b8%aa%e8%ae%be%e8%ae%a1%e7%bb%86%e8%8a%82" class="header-anchor"></a>几个设计细节 </h2><p><strong>隐私默认本地</strong>。不收集使用遥测；plan、diff、标注、历史默认留在本机。分享、Ask AI 等网络能力边界在文档里写得很清楚。</p> <p><strong>终端版</strong>。<a class="link" href="https://github.com/plannotator/herdr-annotate" target="_blank" rel="noopener" >Herdr Annotate</a> 把同类评审带进终端，标注存同一数据目录，浏览器版与终端版可叠加。</p> <p><strong>安全发布</strong>。二进制带 SHA256 sidecar，有 SLSA provenance 与 CycloneDX SBOM attestation，可选安装时校验。</p> <p><strong>Obsidian / VS Code 集成</strong>。已批准的 plan 可自动存进 vault；VS Code 可在编辑器里看 diff 和标注。</p> <h2 id="上手"><a href="#%e4%b8%8a%e6%89%8b" class="header-anchor"></a>上手 </h2><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># macOS / Linux / WSL</span> </span></span><span class="line"><span class="cl">curl -fsSL https://plannotator.ai/install.sh <span class="p">|</span> bash </span></span></code></pre></div><p>然后在 Agent 里：</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">/plannotator-last # 标注 Agent 上一条回复 </span></span><span class="line"><span class="cl">/plannotator-review # 审当前 diff </span></span><span class="line"><span class="cl">/plannotator-annotate README.md </span></span></code></pre></div><p>Plan mode 不需要命令——下次 Agent 提 plan 会自动打开。</p> <p>Pi 用户也可以跳过安装器：<code>pi install npm:@plannotator/pi-extension</code>。</p> <h2 id="适合谁"><a href="#%e9%80%82%e5%90%88%e8%b0%81" class="header-anchor"></a>适合谁 </h2><ul> <li>不想在终端里干瞪纯文本 plan，希望「看图说话」再放行</li> <li>需要 PR 级 diff 评审，且意见要直接喂回当前 Agent 会话</li> <li>团队想把 plan 决策归档、可回溯</li> </ul> <h2 id="和收藏夹里其他项目的关系"><a href="#%e5%92%8c%e6%94%b6%e8%97%8f%e5%a4%b9%e9%87%8c%e5%85%b6%e4%bb%96%e9%a1%b9%e7%9b%ae%e7%9a%84%e5%85%b3%e7%b3%bb" class="header-anchor"></a>和收藏夹里其他项目的关系 </h2><ul> <li>在终端里同样评审 → <a class="link" href="https://godvvvzzz.github.io/p/herdr/" >herdr</a> + herdr-annotate</li> <li>被评审的 Agent 常是 → <a class="link" href="https://godvvvzzz.github.io/p/pi/" >Pi</a> / Claude Code / Codex</li> <li>想把评审放进更大工作流（Issue→Agent→Review）→ <a class="link" href="https://godvvvzzz.github.io/p/multica/" >Multica</a></li> </ul> <hr> <p><em>最后更新：2026-09-09。信息基于公开 README 与仓库状态，使用前请以官方文档为准。</em></p>