oh-my-pi 计划模式（plan mode）全解：先想清楚再动手
oh-my-pi 计划模式plan mode全解先想清楚再动手【免费下载链接】oh-my-pi⌥ Coding agent with the IDE wired in项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-pioh-my-pi 是一款把 IDE 能力接入终端的编码智能体Coding agent它的**计划模式plan mode**让 AI 在动手改代码前先产出完整方案经你确认后再执行。本文用 5 分钟讲清计划模式的原理、开关位置、自动驾驶用法与省钱技巧新手也能快速上手。 为什么需要计划模式AI 写代码最怕边想边改刚改一半发现方向错了回滚成本很高。oh-my-pi 的计划模式采用**先规划、后执行**两段式工作流规划阶段会话进入只读状态智能体可以读文件、跑检索、看诊断但不会修改代码专注于把方案想透。审批阶段方案写入计划文件如xxx-plan.md弹出审阅界面你可以逐条确认、修改或直接批准。执行阶段批准后自动切换到执行模式按计划清单逐步落地并逐项验证。这种机制特别适合重构、跨文件改动、迁移任务等一步错步步错的场景。⌨️ 如何开启与切换计划模式计划模式默认开启配置项plan.enabled默认值为true有三种常用姿势方式操作适用场景快捷键切换AltShiftPapp.plan.toggle交互中随时进出计划模式启动即进入设置plan.defaultOnStartup: true每次新会话默认先规划命令行参数--plan-yolo见下文无头/自动化场景相关配置文档见 docs/settings.md快捷键清单见 docs/keybindings.md。 计划模式的工作流程进入计划模式后智能体会收到专门的系统提示见 packages/coding-agent/src/prompts/system/plan-mode-reference.md核心要求是一次性写出完整计划包含剩余执行顺序、具体文件与符号、验证命令、风险与边界情况用 todo 工具拆解 5–9 个步骤每步一个明确目标加验证方式排除写文档、发版说明等杂项计划只是检查点写完计划后立即继续推进而不是停在交作业状态。当方案成形智能体通过虚拟设备xd://propose提交审批详见 docs/resolve-tool-runtime.md终端随即弹出计划审阅界面你批准后会发生两件值得注意的事会话自动命名——计划标题会被写入会话名方便日后在会话树中找回见 docs/session-tree-plan.md计划文件被保护——已批准的计划成为执行期的参考基准智能体被约束继续执行而不是推倒重来实现位于 packages/coding-agent/src/plan-mode/。 一键自动驾驶--plan-yolo嫌手动审批麻烦用--plan-yolo参数可以让整条流水线自动跑完启动即强制进入只读计划模式模型第一次提交计划时自动批准自动切换到执行模型开始实现默认smol角色可用--plan-yolo-into id指定。完整参数说明见 docs/cli-reference.md。 省钱小技巧搭配 prewalk 使用计划批准后进入执行阶段oh-my-pi 还支持--prewalk参数当计划的 todo 清单就绪、出现第一次编辑/写入时自动切换到一个更快更便宜的模型来照单执行。简单说就是用强模型想清楚 → 用便宜模型干完活这对控制 token 成本非常友好配合计划模式是官方推荐的组合拳prewalk.enabled默认关闭需要手动开启。❓ 新手常见问题Q1计划模式下问问题会超时吗不会。计划模式激活期间ask工具的超时会被完全禁用你可以安心等 AI 追问细节见 docs/tools/ask.md。Q2计划模式下能用隔离子代理isolated task吗不能。isolated参数只在计划模式关闭时才存在——因为规划阶段本来就不该动代码见 docs/tools/task.md。Q3批准后计划会过期吗计划文件会持久化。即使会话压缩compaction后内容丢失系统提示也会强制智能体重新读取计划文件继续执行不会半途而废。 延伸阅读官方文档docs/cli-reference.md、docs/settings.md计划模式源码packages/coding-agent/src/plan-mode/计划模式提示词packages/coding-agent/src/prompts/system/plan-mode-active.md审批 UI 组件packages/coding-agent/src/modes/components/plan-review-overlay.ts一句话总结把AltShiftP养成肌肉记忆大改动前先让 oh-my-pi 的计划模式出方案、你拍板改错代码的概率和回滚成本都会大幅下降。【免费下载链接】oh-my-pi⌥ Coding agent with the IDE wired in项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-pi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考