@narumitw/pi-plan-mode
在终端内复刻 Codex 风格只读 /plan 协作模式:安全探索、分屏预览计划、批准后可切新会话执行。
安装命令
pi install npm:@narumitw/pi-plan-mode 临时试用 / 替代安装命令
pi -e npm:@narumitw/pi-plan-mode 挂接事件钩子与注册入口
session_startinputbefore_agent_startcontexttool_calltool_execution_endagent_start / agent_end / agent_settledsession_before_tree / session_treethinking_level_selectui_prompt_start / ui_prompt_endsession_shutdown
pi.registerCommand("plan")pi.registerShortcut()pi.sendMessage() / sendUserMessage()pi.appendEntry()ctx.ui.setWidget() / setStatus() / setEditorText() / onTerminalInput() 1. 是什么
@narumitw/pi-plan-mode是 narumiruna 扩展集中专门负责计划协作的 Pi 扩展。
它把探索阶段与实施阶段用权限状态彻底隔开:在 /plan 模式下项目源码严格只读,模型只能反复调查代码并在私有 Markdown 草稿中打磨方案。
2. 解决什么问题
即使要求模型“先做计划别改代码”,普通对话模式下模型依然有文件写入和任意 bash 权限,经常一顺手就直接把源码改了。
同时,做完长计划后的上下文往往已经塞满调查细节;直接在同一上下文接着写代码,容易受调查噪音干扰。该扩展支持在计划批准后一键把最终计划带入一个干净的关联新会话实施。
3. 作用原理(事件钩子与工具注册层)
深度接管 Pi 生命周期钩子,在计划态拦截写工具与非只读操作、在全屏侧栏呈现私有草稿并管理会话交接。
- 通过 /plan、/plan start 或 /plan
启动计划态;扩展在 before_agent_start 与 context 钩子中注入计划阶段约束与草稿路径。 - tool_call 钩子对项目工作区执行只读校验,仅允许模型通过原生工具编辑私有的计划 Markdown 草稿;与此同时在终端侧栏(widget/分屏)实时渲染最新草稿快照。
- 支持在结构化问卷与自由讨论间来回切换而不打乱工具权限;模型确认方案完备后显式完成计划。
- 用户审阅完整计划后,可选择导出保存、继续打磨、放弃,或在当前会话或全新关联会话(支持单独指定实施阶段的目标模型与 thinking 级别)开始编码。
4. 怎么装与基本配置
- 运行 pi install npm:@narumitw/pi-plan-mode 安装。
- 常用入口为 /plan [需求描述],可在设置中为“计划期(重探索)”和“实施期(重编码/新会话)”配置不同的默认模型与推理档位。
5. 和同类怎么选
相比 Plannotator,@narumitw/pi-plan-mode 完全留在终端运行并原生内置“批准后切新会话 + 换实施模型”的执行流转。
与同类方案的选型对照
聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。
| 对比对象 | 机制差异 | 怎么选 |
|---|---|---|
@plannotator/pi-extension | 使用浏览器界面做可视化逐段批注,同时支持代码 PR Diff 批注。 | 喜欢浏览器大屏做细粒度行内批注选 Plannotator;喜欢全键盘留守终端并按计划切干净新会话执行选 @narumitw/pi-plan-mode。 |
@juicesharp/rpiv-ask-user-question | 单一结构化提问工具,没有只读文件保护和独立计划草稿管理。 | 重度功能架构调整先用 /plan;日常小改动搭配问答工具即可。 |
看完「@narumitw/pi-plan-mode」后的下一步
可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)
从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频
已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)
说明:此处未向后台提交个人资料或邮件表单。配置单与实机演示视频正在制作中,你的匿名点击已计入站点热度,用于排定优先录制方向。
Coding Agent 实战交付课:如何可控地把想法做成线上产品
由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。
说明:此处未向后台提交报名或收集任何个人信息。课程模块仍在筹备阶段,你的匿名点击将作为模块排期的优先参考。