05 计划、评审与人机交互

先问、先给计划、可批注评审后再动手写代码

1. 这个方向的插件试图解决什么问题

模型接到模糊需求时,默认倾向直接猜一种方案并开始大面积改文件;等改完才发现方向错了,回滚和返工成本远高于花半分钟确认需求或审一遍计划。

把“先对齐、再执行”真正落进终端工作流,需要三类机制:一是在需求歧义处停下来给用户结构化选择题;二是在只读模式下生成可编辑、可分块批注的实施计划;三是在长任务中把待办状态或支线旁路问答从主线程分离出来。

2. 在 Pi 里怎么体现

Pi 提供了丰富的交互底座:扩展可以通过 pi.registerTool() 把“向用户提问”或“提交计划等待审批”注册为模型可调用的阻塞工具;在 tool_call 里限制计划模式下只允许只读操作或仅写入计划草稿;并通过 ctx.ui.custom() 或本地浏览器界面承接多标签页问卷与行内批注评审。

涉及的 Pi 事件钩子与注册接口

pi.registerTool()pi.registerCommand()tool_call(计划期只读拦截)ctx.ui.custom()ctx.ui.setWidget()input

3. 代表包与生态实例

下表包名均核实自 npm、GitHub 与 pi.dev/packages(核对日期 2026-11-22)。前 3 项已上线独立机制详评页,正文不展示容易过期的静态下载量快照。

包名 分发形态 主要作用 详情 / 源码
@plannotator/pi-extension npm 为 Pi 增加基于文件的计划模式与浏览器可视化界面,支持对计划、Agent 消息和代码 PR 进行交互式批注与审批。
@juicesharp/rpiv-ask-user-question npm 注册 ask_user_question 工具,让模型在遇到不确定决策时弹出最多四题的终端结构化问卷。
@narumitw/pi-plan-mode npm 提供类似 Codex 的只读 /plan 协作模式,在批准计划前锁定项目文件写操作并支持分屏预览草稿。
pi-studio npm Pi 的双栏浏览器工作区,集成历史编辑、批注、实时预览与 tmux REPL 工作流。
@juicesharp/rpiv-todo npm 面向模型的待办清单扩展,以实时浮层渲染并在 /reload 与上下文压缩后保留状态。
pi-btw npm 通过 /btw 命令在当前会话旁开辟不污染主上下文的平行支线问答浮层。

4. 怎么装

代表包安装命令示例
pi install npm:@plannotator/pi-extension
  • @plannotator/pi-extension 依赖本地浏览器打开可视化评审界面,要求 Pi 0.79.1 或更高版本。
  • @juicesharp/rpiv-ask-user-question 完全在终端底部运行,无需浏览器环境,适合 SSH 或纯终端开发。
  • 如果同时安装 @narumitw/pi-plan-mode 与 @plannotator/pi-extension,建议明确区分两者的斜杠命令(/plan 与 /plannotator-plan-mode)。

5. 和同类怎么选

包名交互形态核心能力适用场景
@plannotator/pi-extension 浏览器可视化计划/Diff 批注 支持对计划文档、代码 Diff 和消息做行内批注、审批或打回重改 喜欢在浏览器里像审 PR 一样逐行批注计划和变更
@juicesharp/rpiv-ask-user-question 终端内结构化多题问卷 向模型提供 ask_user_question 工具,支持单选/多选/预览框/自定义输入 消除需求歧义,让模型先出带成本说明的选项再动工
@narumitw/pi-plan-mode 终端只读 /plan 协作模式 严格限制计划阶段只读项目文件,仅编辑私有草稿,批准后可切新会话执行 习惯 Codex 风格终端内分屏审计划后直接转入实现
pi-studio 双栏浏览器工作区 支持提示/回复编辑、批注、问答、实时预览与 tmux REPL 工作流 希望把 Pi 的提示词与交互工作区长期搬进双栏网页
@juicesharp/rpiv-todo 持久化终端待办浮层 给模型提供 todo 工具,状态跨 /reload 与会话压缩持续保留 多步骤任务需要清晰的终端实时清单
pi-btw 主线程外的 /btw 旁路问答 不污染主对话上下文的前提下发起临时支线提问 开发途中想顺手问一个概念或语法问题,不想打断主线任务

看完「05 计划、评审与人机交互」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)