oh-my-pi 计划模式（plan mode）全解：先想清楚再动手
【免费下载链接】oh-my-pi⌥ Coding agent with the IDE wired in项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-pi
oh-my-pi 是一款把 IDE 能力接入终端的编码智能体（Coding agent），它的**计划模式（plan mode）**让 AI 在动手改代码前先产出完整方案，经你确认后再执行。本文用 5 分钟讲清计划模式的原理、开关位置、自动驾驶用法与省钱技巧，新手也能快速上手。
🤔 为什么需要计划模式？
AI 写代码最怕"边想边改"：刚改一半发现方向错了，回滚成本很高。oh-my-pi 的计划模式采用**"先规划、后执行"**两段式工作流：
- 规划阶段：会话进入只读状态，智能体可以读文件、跑检索、看诊断，但不会修改代码，专注于把方案想透。
- 审批阶段：方案写入计划文件（如
xxx-plan.md），弹出审阅界面，你可以逐条确认、修改或直接批准。 - 执行阶段：批准后自动切换到执行模式，按计划清单逐步落地，并逐项验证。
这种机制特别适合重构、跨文件改动、迁移任务等"一步错步步错"的场景。
⌨️ 如何开启与切换计划模式
计划模式默认开启（配置项plan.enabled默认值为true），有三种常用姿势：
| 方式 | 操作 | 适用场景 |
|---|---|---|
| 快捷键切换 | Alt+Shift+P（app.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
一句话总结：把Alt+Shift+P养成肌肉记忆，大改动前先让 oh-my-pi 的计划模式出方案、你拍板，改错代码的概率和回滚成本都会大幅下降。
【免费下载链接】oh-my-pi⌥ Coding agent with the IDE wired in项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-pi
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
实战)
