【免费下载链接】plannotatorAnnotate and review coding agent plans and code diffs visually, share with your team, send feedback to agents with one click.项目地址https://gitcode.com/gh_mirrors/pl/plannotator点击查看免费下载本指南以 Plannotator 官方安装文档为主体系统讲解如何在 Claude Code、Codex、OpenCode、Kiro CLI、Pi、Amp、Droid 等 Agent 宿主上安装与配置 Plannotator并深入剖析安装器源码scripts/install.sh的底层实现从交互式向导、版本固定、二进制最小化安装、按 Agent 跳过集成到 SLSA 构建来源校验与安全卸载。读完本文你将掌握覆盖 macOS / Linux / WSL / Windows 全平台的安装、升级、定制与卸载全流程并理解每个安装选项背后的机制。安装定位插件 CLI 的双层结构Plannotator 不是独立的桌面应用而是作为编码 Agent 的插件运行先把plannotator命令安装到系统再为对应的 Agent 宿主配置 hook / 插件 / 技能。官方安装文档给出的核心流程是Install the CLI first, then configure your agent.安装器本身由三个平台脚本实现仓库中的对应源码为 scripts/install.shbash、scripts/install.ps1PowerShell与scripts/install.cmdCMD。scripts/install.test.ts中还有 2600 余行针对这三个脚本结构的自动化验证测试如hooks.json生成的 JSON 合法性、最小化安装的退出时序、各跳过选项的优先级等可作为理解安装行为的权威依据。前置要求安装器需要git它会从发布 tag 做一个sparse checkout稀疏检出来拉取技能skills与命令文件。缺少 git 时安装器会直接失败并给出清晰提示而不是静默跳过——安装脚本中的硬性检查原文是Error: git is required to install Plannotators skills and slash commands. Install git, then run this installer again.对应测试断言见 scripts/install.test.ts 中missing git is a hard failure用例。唯一的例外是后面介绍的--minimal二进制最小化模式——它跳过稀疏检出因此不需要 git。各平台一键安装macOS / Linux / WSLbashcurl -fsSL https://plannotator.ai/install.sh | bashWindows PowerShellirm https://plannotator.ai/install.ps1 | iexWindows CMDcurl -fsSL https://plannotator.ai/install.cmd -o install.cmd install.cmd del install.cmd从源码看bash 版安装器会解析宿主平台与架构uname -s区分 darwin / linuxuname -m区分 x64 / arm64见 scripts/install.sh 的case $(uname -s)与case $(uname -m)随后从 GitHub Releases 下载对应的plannotator-${os}-${arch}二进制到$HOME/.local/bin/plannotator。PowerShell 与 CMD 版在 Windows 上会检测PROCESSOR_ARCHITECTURE/PROCESSOR_ARCHITEW6432以选择原生 ARM64 或 x64 二进制测试install.cmd selects platform based on PROCESSOR_ARCHITECTURE专门守护这一点PowerShell 安装器还会把安装目录加入用户级PATH。如果$HOME/.local/bin不在PATH中脚本会打印对应的 shell 配置建议~/.zshrc或~/.bashrc。交互式向导Guided install在终端中首次运行时安装器会询问两个问题是否安装额外技能compound planning、setup-goal、visual explainer——回答 yes 会启动npx skills add让你在它的 UI 里选择哪些 Agent 获得这些技能。若额外技能已安装此问题自动跳过。是否让某些技能可被模型直接调用——回答 yes 会打开一个选择器macOS/Linux/PowerShell 上用空格切换勾选CMD 安装器用数字切换。被选中的技能会从它们已安装的副本中移除disable-model-invocation并将 Codex sidecar 同步翻转为匹配状态其余技能保持仅限用户调用。源码层面的实现细节scripts/install.sh 的 Guided install 区块回答保存在data dir/install-prefs变量PREFS_FILE后续静默重跑时直接复用传--reconfigure可重新打开向导。自动化安装不受影响没有终端CI、脚本的运行从不询问直接采用默认值不装额外技能、不开放模型调用。自动化可用--extras/--no-extras/--model-invocable list/--non-interactive显式选择。每个交互式提问都有超时上限默认 30 秒可用PLANNOTATOR_PROMPT_TIMEOUT调整设为 0 表示无限等待。这是为了防止检测到 /dev/tty 但无人值守的场景如docker run -t卡死安装——超时后自动采用安全的否默认值而不是把yes默认值强加给无人终端。只有向导真的收集到人工回答或通过 flag 显式设置时回答才会写入 prefs超时得到的合成默认值不会被持久化以免污染后续真正的交互式安装。交互式安装的参数一览参数作用--extras不询问直接安装额外技能--no-extras不询问直接跳过额外技能--model-invocable list将逗号分隔的技能名开放给模型调用或用none表示全部保持用户调用--non-interactive即使在终端中也绝不询问使用 flag → 历史回答 → 默认值的顺序--reconfigure即使已有历史回答也重新打开向导固定安装指定版本从v0.17.2 起版本固定获得完整支持——该版本是第一个携带原生 ARM64 Windows 二进制与 SLSA 构建来源声明attestation的发布。bashcurl -fsSL https://plannotator.ai/install.sh | bash -s -- --version vX.Y.ZPowerShell ([scriptblock]::Create((irm https://plannotator.ai/install.ps1))) -Version vX.Y.ZCMDcurl -fsSL https://plannotator.ai/install.cmd -o install.cmd install.cmd --version vX.Y.Z del install.cmd源码中的相关机制版本号会自动规范化不带v前缀的 tag如1.2.3会被补成v1.2.3与install.cmd行为保持一致。安装脚本通过version_ge基于sort -V版本排序比较 tag。当启用了 SLSA 校验时若解析出的 tag 早于MIN_ATTESTED_VERSIONv0.17.2会在下载前就快速失败并给出明确提示而不是下载完再撞上晦涩的gh: no attestations found见 scripts/install.sh 顶部的常量定义与预检逻辑。固定到 v0.17.2 之前的 tag对 macOS、Linux、x64 Windows 的默认安装可能仍可用但ARM64 Windows 主机会得到 404来源校验也会被拒绝。二进制最小化安装--minimal传--minimal别名--binary-only时只安装plannotator二进制本身——不装 sem 语义差异 sidecar、不装 CallDiff runtime、不装 agent-terminal runtime也不装 Claude、Codex、OpenCode、Gemini、Kiro 的任何技能、hook、斜杠命令或配置。唯一安装的就是二进制Windows PowerShell 安装器还会把安装目录加入用户PATH。由于跳过了稀疏检出最小化模式不要求 git。curl -fsSL https://plannotator.ai/install.sh | bash -s -- --minimal ([scriptblock]::Create((irm https://plannotator.ai/install.ps1))) -Minimalcurl -fsSL https://plannotator.ai/install.cmd -o install.cmd install.cmd --minimal del install.cmd源码层面的保证均有测试守护--minimal的提前退出必须发生在二进制移动到位mv $tmp_file $INSTALL_DIR/plannotator之后、sidecar 下载 / Agent 集成 / 技能检出 / 配置写入之前确保最小化名副其实且不留下任何$HOME/.local/bin之外的持久状态。对curl … | bash管道也可以改用环境变量PLANNOTATOR_MINIMAL1来开启传--no-minimal可强制在该变量已设置的情况下仍做完整安装。跳过单个 Agent 集成想要完整安装、但不需要某个 Agent 的集成每个集成都有独立的退出开关。安装器遵循跳过 不写入原则跳过只是不写该 Agent 的 home 目录从不删除先前安装已接好的集成并且会如实汇报状态例如打印Codex: detected, skipped (--skip-codex)绝不会谎报未检测到。Flag作用对象--skip-codex即使检测到 Codex也不向 Codex home 写hooks.json/config.toml--skip-gemini同上针对~/.gemini--skip-kiro同上针对~/.kiro--skip-opencode跳过 OpenCode 命令存根与缓存清理OpenCode 无检测逻辑这是纯不写入开关bash 示例curl -fsSL https://plannotator.ai/install.sh | bash -s -- --skip-codexPowerShell 对应-SkipCodex/-SkipGemini/-SkipKiro/-SkipOpencodeWindows CMD 与 bash 一样使用--skip-*。无值守升级场景下可用环境变量PLANNOTATOR_SKIP_CODEX_INSTALL1同理_GEMINI_、_KIRO_、_OPENCODE_或在~/.plannotator/config.json中持久化{ skipInstall: { codex: true } }优先级命令行 flag 环境变量 配置文件。安装脚本用一个共享的skipInstall对象解析逻辑实现awk 抽取 逐 Agent 匹配并且显式的codex: false会被当作否决票而非忽略测试中专门断言了codex: true出现在skipInstall之外的键下时不会误触发跳过。跳过技能与斜杠命令/plannotator-*技能与斜杠命令来自发布 tag 的稀疏git clone。--skip-skills会把这次拉取变成空操作不向~/.claude/skills、~/.agents/skills、OpenCode 或 Gemini 命令目录、~/.kiro写入任何内容额外技能不再被提供技能作用域的清理扫描也会挂起。但二进制、hook、各 Agent 配置照常安装且 git 不再是硬性要求。适合安装的 tag 无法从 GitHub 拉取或技能由你自己管理的场景。curl -fsSL https://plannotator.ai/install.sh | bash -s -- --skip-skillsPowerShell 用-SkipSkills无值守运行设PLANNOTATOR_SKIP_SKILLS_INSTALL1或持久化{ skipInstall: { skills: true } }同样遵循 flag 环境变量 配置文件的优先级。安装器会如实打印Skills: skipped (...)不再声称/plannotator-*命令已就绪——被跳过的运行绝不会被误认为完整安装源码中最终横幅在跳过时显示CLAUDE CODE USERS: BINARY INSTALLED而非YOURE ALL SET!。可选组件Call flow 运行时代码审查的Call flow层使用一个固定版本、精简过的 CallDiff 运行时需要Node.js 22 或更新版本因此默认从不安装。常规路径在应用内完成Call flow 开关会列出受影响的语言与估算总量开启即同意一次性后台安装核心macOS arm64 上约 5 MB加上所需语法包无需二次确认。后续审查引入新语言时已安装的语言照常分析新包自动安装并通过安静的跳过文件通知汇报进度。每个目标在一次审查会话中只自动尝试一次失败后面板显示 Retry 动作。面板的Languages列表会展示累计安装体积并支持提前安装语言包。面向脚本或无头安装以下方式均可安装核心审查专用语言包仍在 UI 中选择flag--with-call-flowPowerShell-WithCallFlow环境变量PLANNOTATOR_INSTALL_CALLDIFF1配置文件{ installCallFlow: true }命令plannotator install-runtime call-flow--minimal永远排除它。安装脚本中的install_call_flow_runtime()严格按需下载默认情况下连精简核心都不会下载只会提示Call flow 可在应用内选择安装或运行plannotator install-runtime call-flow。同类可选组件还包括 sem 语义差异 sidecar可设PLANNOTATOR_SKIP_SEM_INSTALL1跳过其下载有超时上限慢网络不会阻塞已完成的安装与 annotate agent-terminal 运行时可设PLANNOTATOR_SKIP_AGENT_TERMINAL_INSTALL1跳过无 Node/npm 时 Plannotator 仍可安装annotate 模式只是没有集成终端。卸载plannotator uninstall会移除可识别的已安装组件同时默认保留本地 Plannotator 数据plannotator uninstall它移除常规二进制、受管的sem与 agent-terminal 运行时、安装器提供的技能与命令、受管的 hook/配置条目、可识别的全局集成以及检测到的宿主插件。共享设置只有在能安全识别出其 Plannotator 条目时才被改动自定义文件与单独安装的可选技能会被保留。如需一并删除已知的本地计划、历史、草稿、指南、设置等 Plannotator 数据使用plannotator uninstall --purgePurge 要求你在提示符下输入purge。CLI 会警告这些数据仅存于本地不会存储在 Plannotator 服务器上purge 之后无法恢复。--yes或-y可跳过确认自动化必用无交互终端时也是必需--dry-run只预览将被移除的集合不改变任何东西。卸载的源码实现见 packages/server/uninstall.ts其中包含大量安全细节宿主集成总是卸载的一部分。若某个宿主损坏或不可用导致无法安全清理命令会点名阻塞的插件管理器或配置、给出精确的手动清理指引并在删除二进制之前停下清理完成后重跑卸载。Purge 只删除配置数据目录中已知的Plannotator 条目不认识的顶层文件一律保留而非猜测自定义的外部计划保存路径或项目级集成永不删除格式错误的宿主配置按故障安全错误处理。卸载器拒绝宽泛目标文件系统根、home 目录、共享临时目录、符号链接数据目录与非目录路径通过文件系统身份inode/device比较目标因此大小写别名、符号链接、硬链接、bind mount 都无法绕过根/home/祖先检查。这些身份与包含关系检查在 await 宿主命令之后、数据删除之前会被重新验证——目录被中途调包会被拒绝。对于符号链接的专用目录把PLANNOTATOR_DATA_DIR设为解析后的真实目标再重试。若 Windows PATH 还原本身失败CLI 仍留在磁盘上并输出其完整路径供重试与手动修复 PATH。未包含plannotatorCLI 的 Pi 专用安装请使用pi remove npm:plannotator/pi-extension在限速 IP 后安装CI / 代理 / NAT 场景安装器通过查询 GitHub APIapi.github.com解析最新发布 tag。未认证的 API 请求按源 IP 限制为每小时 60 次因此在共享出口 IP企业代理、NAT/CGNAT、CI runner或同小时内反复重试/调试时安装可能失败报出不透明的Failed to fetch latest version。遇到此情况可在运行安装器前导出 token——它依次读取GITHUB_TOKEN、GH_TOKEN并在ghCLI 已认证时回退到gh auth token仅限 github.com 凭据。Personal access token 可将限额提升到 5,000/小时GitHub Actions 内置的GITHUB_TOKEN是每个仓库 1,000/小时。仓库是公开的无任何 scope 的 token 就够用——优先选用 fine-grained 或零 scope token而非宽泛的经典 PATexport GITHUB_TOKENghp_xxx curl -fsSL https://plannotator.ai/install.sh | bash或者一次性执行gh auth login——无需环境变量安装器会自动拾取 token。只有解析版本这一次 API 调用被认证发布下载与git clone不受影响。源码中这一逻辑体现在版本解析区块先尝试带Authorization头的请求仅在 HTTP 401 时匿名重试一次携带无效凭据的请求同样计入匿名 60/小时配额因此盲目对所有失败重试会双倍消耗配额。校验安装SHA256 与 SLSA 构建来源每个发布都附带 SHA256 校验和每次安装自动验证与可选的 SLSA 构建来源声明通过 Sigstore 签名并记录在公开透明度日志中。SHA256 检查是强制的、始终运行bash 安装器下载二进制后用shasum -a 256macOS或sha256sumLinux比对.sha256sidecar不一致即失败并删除临时文件。来源校验是可选的仅在你想把二进制加密关联回构建它的确切 commit 与 workflow run时才需要。它默认关闭与 rustup、brew、bun、deno、helm 等主流curl | bash安装器一致可通过三种方式开启优先级为 CLI flag 环境变量 配置文件1. 单次 flagcurl -fsSL https://plannotator.ai/install.sh | bash -s -- --verify-attestationPowerShell 对应-VerifyAttestationCMD 对应install.cmd --verify-attestation。2. 环境变量写进 shell RC 持久化export PLANNOTATOR_VERIFY_ATTESTATION13. 配置文件与 shell 无关的持久化mkdir -p ~/.plannotator echo { verifyAttestation: true } ~/.plannotator/config.json开启后安装器要求存在ghCLI但不需要gh auth login它从 GitHub 公开的 attestations API 拉取 bundle一次未认证请求用gh attestation verify --bundle验证并钉住与手动命令相同的 source ref 与 signer workflow。macOS/Linux 上提取 bundle 需要 PATH 中有 node、python3 或 jq 之一Windows 用 PowerShell。若 bundle 路径不可用或未完成安装器回退到 gh 自带的认证拉取——此时登录才有帮助。校验每次都需要网络Sigstore 信任根每次运行都重新拉取该失败被报告为连接性问题与真正的来源失败区分开。无论哪种情况安装都会硬失败而非静默跳过校验单次强制跳过用--skip-attestationbash/cmd或-SkipAttestationPowerShell。手动审计可参考 验证安装参考文档其中给出 macOS/Linux、Windows PowerShell、Windows CMD 三种平台的gh attestation verify命令以及不登录时的--bundle验证路径。Claude Code 集成插件市场安装推荐/plugin marketplace add backnotprop/plannotator /plugin install plannotatorplannotator安装后重启 Claude Code让 hook 生效。插件只提供 plan-review hook要获得/plannotator-*斜杠命令必须运行安装脚本——它会把这些命令以 Claude Code 技能形式装进~/.claude/skills见下文斜杠命令。插件内的 hook 结构在 apps/hook/hooks/hooks.json 中PreToolUseEnterPlanMode→plannotator improve-context超时 5 秒驱动 compound 技能的 improvement-hook 注入PermissionRequestExitPlanMode→plannotator超时 345600 秒承载 plan-review。手动安装不想用插件系统时把下面内容加入~/.claude/settings.json{ hooks: { PermissionRequest: [ { matcher: ExitPlanMode, hooks: [ { type: command, command: plannotator, timeout: 345600 } ] } ] } }matcher专门针对ExitPlanMode工具timeout单位为秒345600 96 小时长审查不会中途过期。安装脚本还会尊重CLAUDE_CONFIG_DIR若已设置把 hook 放到你的自定义配置目录而不是~/.claude。本地开发测试本地 checkoutclaude --plugin-dir ./apps/hook斜杠命令/plannotator-review、/plannotator-annotate、/plannotator-last由安装脚本作为 Claude Code 技能装入~/.claude/skills——Claude Code 技能可按目录名被用户调用因此命令名保持不变不再需要单独的~/.claude/commands步骤。从旧版本升级时安装器会自动删除遗留的~/.claude/commands/plannotator-*.md文件且仅在同名技能已落盘后才删除确保不会留下命令和技能都没有的真空测试legacy Claude command cleanup is guarded守护此顺序但插件市场旧的命名空间plannotator:*命令条目由 Claude Code 管理——运行一次/plugin marketplace update即可让它们从/菜单消失。可选额外技能compound planning、setup-goal、visual explainer默认不装用下面命令添加npx skills add backnotprop/plannotator/apps/skills/extra --global从源码看scripts/install.sh 技能安装区块Claude Code 消费的是apps/skills/claude/*副本动态上下文注入形式/plannotator-*直接调用二进制、无权限提示行为与旧斜杠命令一致而 Codex 走 OpenAI 共享 Agent 路径读apps/skills/core/*散文式技能体模型经自身 shell 遵循两种来源分离是因为!… 注入是 Claude Code 独有的扩展。三个核心技能plannotator-review、plannotator-annotate、plannotator-last会同时写入~/.claude/skills与~/.agents/skills后者是官方 OpenAI Agent 技能路径。OpenCode 集成把插件加入你的opencode.json{ $schema: https://opencode.ai/config.json, plugin: [plannotator/opencodelatest] }重启 OpenCode。默认情况下submit_plan仅对 OpenCode 的planagent 可用。想要仅命令模式或遗留的全 agent 行为参见 OpenCode 指南。关于斜杠命令/plannotator-review、/plannotator-annotate还需运行安装脚本curl -fsSL https://plannotator.ai/install.sh | bash这会同时清理掉缓存的插件版本安装器会删除~/.cache/opencode/node_modules/plannotator与~/.cache/opencode/packages/plannotator以及共享的 Bun 包缓存强制下次运行重新下载。插件运行时机制的细节见 apps/opencode-plugin 下的源码与测试。Kiro CLI 集成Kiro自动检测——无需额外 flag 或步骤。运行安装器时只要~/.kiro存在或kiro-cli在 PATH 上Plannotator 的 Kiro 技能就会自动安装处理方式与 Codex、Gemini 相同。任何平台都适用用你系统的安装器即可curl -fsSL https://plannotator.ai/install.sh | bash在 Windows 上安装器检查%USERPROFILE%\.kiro或 PATH 上的kiro-cli。这会安装 Kiro 技能到~/.kiro/skills、Plannotator agent 到~/.kiro/agents/plannotator.json已存在的 agent 文件从不覆盖。如果你先装 Plannotator 后装 Kiro只需重跑安装器。从源码看scripts/install.sh 的kiro_available检测与安装分支Kiro 获得来自apps/kiro-cli/skills的专属技能副本、来自apps/skills/core的共享知识技能以及来自apps/skills/extra的plannotator-setup-goal与plannotator-visual-explainer——Kiro 是额外技能唯一默认安装的作用域。技能清单与 Plannotator agent 的说明见 Kiro CLI 指南启动命令为kiro-cli chat --agent plannotator。Kilo Code官方文档标注为Coming soon即将推出。Codex 集成Codex 计划审查通过实验性的Stophook支持。这是一个渲染后审查流程当 Codex 的一轮 turn 停止时Plannotator 读取当前 transcript、提取最新计划并打开与其他集成相同的计划审查 UI。若你拒绝计划Plannotator 返回Stop继续原因让 Codex 在同一 turn 内修订计划。在 macOS、Linux、WSL 上当 Codex 已安装或~/.codex已存在时安装器自动启用 Codex hookscurl -fsSL https://plannotator.ai/install.sh | bash安装或改动 hooks 后重启 Codex Desktop。手动设置时先在~/.codex/config.toml或repo/.codex/config.toml启用 hooks[features] hooks true再在该配置层旁边添加hooks.json{ hooks: { Stop: [ { hooks: [ { type: command, command: plannotator, timeout: 345600 } ] } ] } }注意Codex 会从~/.codex/hooks.json与repo/.codex/hooks.json发现 hooks并加载所有匹配文件。Codex Desktop 场景下hooks.json中优先使用plannotator命令的绝对路径因为应用启动的进程可能不继承 shell 的PATH。Codex hooks 目前仍为实验性。当前官方 Codex hooks 文档说明 hooks 在 Windows 上被禁用因此该流程目前仅限 macOS/Linux/WSL。安装器还会把核心技能plannotator-review、plannotator-annotate、plannotator-last复制到~/.agents/skills——官方 OpenAI agent 技能路径。额外技能compound planning、setup-goal、visual explainer默认不装用下面命令添加npx skills add backnotprop/plannotator/apps/skills/extra --global你仍可随时直接使用命令!plannotator review !plannotator annotate file.md !plannotator last源码层面安装器对 Codex 的处理十分保守只在$CODEX_DIR下有真实用户配置排除仅有skills目录的纯技能 home时才认定 Codex 可用已有的hooks.json通过 node 脚本合并识别并更新受管的plannotator命令条目、保留自定义 hook、避免重复添加config.toml若使用内联 features 写法则不动并提示手动添加[features] hooks true仅在 hook 配置成功后启用。Pi 集成安装 Pi 扩展pi install npm:plannotator/pi-extension或者不安装直接试用pi -e npm:plannotator/pi-extension用pi --plan启动计划模式或会话中用/plannotator-plan-mode/CtrlAltP切换。扩展提供基于文件的计划审查、代码审查/plannotator-review、Markdown 标注/plannotator-annotate、计划期间的 bash 安全门控与执行期间的进度跟踪。Pi 集成与其它宿主不同它不是拦截内置计划模式的 hook而本身就是计划模式——注册工具、管理状态机、门控权限、承载浏览器 UI。完整讲解见 Plannotator Meets Pi。其架构要点来自该博客与仓库源码Pi 通过 jiti 在 Node.js 中加载扩展而共享服务端代码packages/server/用的是Bun.serve()因此 Pi 扩展内置了自己的node:http服务实现——相同的 API 端点与 HTML 载荷但基于createServer。计划审查服务暴露/api/plan、/api/approve、/api/deny代码审查服务暴露/api/diff、/api/diff/switch、/api/feedback。计划文件是磁盘上的普通PLAN.md支持 Markdown 复选框与[DONE:n]进度标记阶段与计划文件路径通过 Pi 的appendEntryAPI 跨会话重启持久化。Amp 集成Plannotator 的 Amp 集成目前仅命令模式添加命令面板动作用于代码审查、文件标注与标注 Amp 最新一条助手消息。先装 CLIcurl -fsSL https://plannotator.ai/install.sh | bash再装 Amp 插件mkdir -p ~/.config/amp/plugins curl -fsSL https://raw.githubusercontent.com/backnotprop/plannotator/main/apps/amp-plugin/plannotator.ts \ -o ~/.config/amp/plugins/plannotator.ts重启 Amp或从命令面板运行plugins: reload。插件源码见 apps/amp-plugin/plannotator.ts。这会添加Plannotator: Review changes Plannotator: Review changes or PR Plannotator: Annotate file Plannotator: Annotate last answer对Plannotator: Review changes or PR输入框留空表示审查本地改动或输入 PR/MR URL也支持--git、--base ref等审查参数仅会话内生效。插件对Annotate last answer使用 Amp 的线程 API 读取最新助手消息不读 transcript 日志并会探测 CLI 版本以决定走annotate-last --stdin还是临时文件回退路径。Droid 集成Plannotator 的 Droid 集成目前仅命令模式尚未拦截 Droid 的计划流程。先装 CLIcurl -fsSL https://plannotator.ai/install.sh | bash再装 Droid 插件droid plugin marketplace add https://github.com/backnotprop/plannotator droid plugin install plannotatorplannotator安装后打开一个新的 Droid 会话。这会添加以下斜杠命令/plannotator-review /plannotator-annotate file|folder|url /plannotator-last这些命令会打开浏览器版 Plannotator 审查 UI并把结果送回 Droid 会话。安装流程的源码级全景综合 scripts/install.sh 与 scripts/install.test.ts一次完整安装的内部顺序大致如下解析参数--version、--verify-attestation/--skip-attestation、--extras/--no-extras、--model-invocable、--minimal/--no-minimal、四个--skip-*、--non-interactive、--reconfigure均含互斥与取值校验。解析版本latest时查询 GitHub API带 token 优先401 才匿名重试否则规范化 tag。下载与校验下载二进制 → SHA256 强制校验 →可选SLSA 验证先尝试免登录的公开 bundle 路径再回退到 gh 认证路径gh缺失则硬失败。落盘二进制移动到位、chmod x--minimal在此刻提前退出仅打印 PATH 建议。可选 sidecarsem 语义差异、agent-terminal 运行时、Call flow 运行时均有独立跳过环境变量下载有超时上限。Codex 集成若检测到且未跳过写hooks.json合并或新建、启用[features] hooks true。插件 hook 刷新若已装 marketplace 插件重写其hooks.json。清缓存OpenCode / Bun / Pi jiti 缓存清理。向导交互式提问仅真实终端回答持久化到data dir/install-prefs。稀疏检出安装技能/命令git clone --depth 1 --filterblob:none --sparsegit sparse-checkout set apps/skills apps/kiro-cli apps/opencode-plugin/commands apps/gemini/commandsgit 2.25 时回退普通浅克隆失败时暴露真实 git 报错随后复制 Claude /~/.agents/ OpenCode / Gemini / Kiro 各作用域应用模型调用解锁执行遗留清理扫描。Gemini 配置若检测到且未跳过写 policy 与settings.jsonhooknode 合并或新建。汇总输出逐宿主打印状态含检测到但跳过的如实报告与重复 hook 警告。三个安装脚本bash / PowerShell / CMD由同一份测试套件守护关键不变量例如 hooks.json 必须用完整 exe 路径Windows 上对含空格路径做 JSON 转义、脚本必须纯 ASCII保证任意代码页下 cmd 渲染不乱码、--minimal的退出时序、跳过选项的优先级与不删除既有集成原则等——这些细节正是安装器在 CI、代理、受限网络等真实环境里保持可靠的原因。本文内容基于 installation.md 整理扩充相关配置选项可进一步参考 Configuration 文档、验证安装参考、故障排查指南 与 OpenCode 迁移指南。赞分享【免费下载链接】plannotatorAnnotate and review coding agent plans and code diffs visually, share with your team, send feedback to agents with one click.项目地址https://gitcode.com/gh_mirrors/pl/plannotator点击查看免费下载相关推荐Deepagents提升价值AI代理框架的终极指南与10个实用技巧Deepagents提升价值AI代理框架的终极指南与10个实用技巧 在当今AI技术飞速发展的时代构建智能代理系统已成为开发者面临的核心挑战。 Deepage人工智能大模型AI AgentAgent 框架自主智能体工具调用代码智能体MCP ClientsAI 技能企业级字体架构设计PingFangSC跨平台字体解决方案的5大核心技术架构企业级字体架构设计PingFangSC跨平台字体解决方案的5大核心技术架构 在当今数字化产品生态中字体渲染一致性已成为衡量前端技术架构成熟度的重要指标。Pi前端如何实战精通微信聊天数据永生WeChatMsg智能归档工具深度指南如何实战精通微信聊天数据永生WeChatMsg智能归档工具深度指南 你是否曾因手机更换而痛失珍贵聊天记录那些与家人的温馨对话、重要的工作沟通、难忘的生活片段上一篇SumatraPDF 从 PDF 提取文本GUI 对话框、命令行工具与结构化文本全解析下一篇Gin 如何把 HTML 模板与静态资源用 embed 打进单个二进制文件创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考