@plannotator/pi-extension
把计划审查、消息批注与代码 PR Diff 评审从终端搬进浏览器可视化界面的交互扩展。
pi install npm:@plannotator/pi-extension pi -e npm:@plannotator/pi-extension pi.registerTool()(plannotator_submit_plan)pi.registerCommand("/plannotator-plan-mode" / "/plannotator-review" / "/plannotator-annotate" / "/plannotator-last")pi.registerFlag("--plan")pi.registerShortcut("ctrl+alt+p") 1. 是什么
@plannotator/pi-extension 是 Plannotator 官方为 Pi(及 Oh My Pi)打造的计划与代码评审扩展,要求 Pi 0.79.1 或更高版本。
它在工作目录下支持基于文件的计划模式,并自动拉起浏览器 UI 让用户对计划、回复消息和代码 Diff 做行内批注与审批。
2. 解决什么问题
模型给出几百行实施计划或一大段改代码 diff 时,在纯终端命令行里只能“全盘同意”或自己敲一大段文字解释哪几行不对。
Plannotator 把类似 GitHub PR 的逐段批注交互引入计划阶段和收尾阶段,批准前限制代码修改,打回时把精确行内意见回传给模型。
3. 作用原理(事件钩子与工具注册层)
结合计划模式开关、工具写入路径约束与 plannotator_submit_plan 阻塞工具,连接浏览器评审页面与 Pi 会话。
- 用户通过 /plannotator-plan-mode、快捷键 Ctrl+Alt+P 或启动参数 —plan 进入计划模式;项目级配置 .pi/plannotator.json 遵守 Pi 0.79+ 的 project_trust 信任机制。
- 在计划模式下,扩展放行只读调查并允许在工作目录内编写 Markdown 计划文件,同时阻断对业务源码的写入。
- 计划写完后模型调用 plannotator_submit_plan 提交文件路径,触发浏览器可视化评审界面。用户可直接批准、附带行内批注拒绝或要求修改,结果回传继续驱动后续执行(并用 [DONE:n] 标记追踪进度)。
- 非计划期也可随时调用 /plannotator-review 审本地代码变更,或用 /plannotator-annotate 批注任意 Markdown 文档。
4. 怎么装与基本配置
- 要求 Pi >= 0.79.1,且建议运行在 Node 22.23.4+ / 24.22.1+ / 26.12.1+ 或 Bun 1.4.4+。
- 支持在 Pi 空闲时自动热重载更新(可通过 PLANNOTATOR_AUTO_RELOAD=0 关闭);在 Oh My Pi 中可通过 omp plugin install @plannotator/pi-extension 安装。
5. 和同类怎么选
在三个计划与人机交互代表包中,@plannotator/pi-extension 强在浏览器端视觉化精细批注与代码 Review 一体化;另外两个主打纯终端零切换。
与同类方案的选型对照
聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。
| 对比对象 | 机制差异 | 怎么选 |
|---|---|---|
@narumitw/pi-plan-mode | 全流程留在终端 TUI 内完成只读探索、私有草稿分屏预览、结构化问答与新会话实施交接。 | 纯终端或远程 SSH 环境下无法方便弹本地浏览器时,选 @narumitw/pi-plan-mode。 |
@juicesharp/rpiv-ask-user-question | 只聚焦“模型遇到歧义时发结构化选择题”,不包含完整的只读计划模式或浏览器 Diff 批注器。 | 想要轻量级随时澄清需求、且不改变现有工作流模式时选它,或与 Plannotator 组合使用。 |
看完「@plannotator/pi-extension」后的下一步
可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)
从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频
已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)
说明:此处未向后台提交个人资料或邮件表单。配置单与实机演示视频正在制作中,你的匿名点击已计入站点热度,用于排定优先录制方向。
Coding Agent 实战交付课:如何可控地把想法做成线上产品
由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。
说明:此处未向后台提交报名或收集任何个人信息。课程模块仍在筹备阶段,你的匿名点击将作为模块排期的优先参考。