★ FEATURED ARTICLE 如何让Deep Code CLI先想清楚再动手Plan Mode规划模式从入门到实战【免费下载链接】deepcode-cliDeep Code 是专为 deepseek-v4 模型优化的终端 AI 编码助手支持深度思考、推理强度控制以及 Agent Skills。项目地址: https://gitcode.com/gh_mirrors/de/deepcode-cliDeep Code CLI 是一款专为 deepseek-v4 模型优化的终端 AI 编码助手而它的Plan Mode规划模式正是让 AI 先想清楚再动手的核心能力在真正修改任何代码之前先与你共同制定一份决策完备的实施方案。本文从零讲起带你完成 Deep Code CLI 的安装、进入 Plan Mode、走完三阶段规划流程并在实战场景中用好它。为什么需要 Plan Mode先规划再实现直接让 AI 改代码适合改错别字这类小任务但面对跨文件重构、新功能开发时常见问题是AI 没看全项目就开始动手方向跑偏缺少共识就修改来回返工成本高修改和决策混在一起事后难以追溯Plan Mode 把想清楚和动手做拆成两个阶段。官方的一组对比实验给出了直观答案同一个高难度任务下未开 Plan Mode 的会话4 张图片全部解码失败0%而开启 Plan Mode 的会话3/4 通过75%代价只是约 26% 的成本增幅一次任务约多花 0.4 元。完整实验数据见 2026-07-plan-mode-vs-non-plan.md。两步进入 Deep Code CLI 的 Plan Mode第 1 步安装并启动确认已安装 Node.js 22然后全局安装并启动npm install -g vegamo/deepcode-cli cd path/to/your/project deepcode按文档 quickstart.md 的说明在~/.deepcode/settings.json中填入模型与 API Key 即可。启动后你会看到欢迎界面第 2 步切换到规划模式有两种方式进入 Plan Mode可随时来回切换方式操作快捷键在输入框中按ShiftTab斜杠命令输入/plan命令定义见 slash-commands.ts进入后输入框右上角会显示黄色 Plan mode提示。即使你在 Plan Mode 里直接说帮我改代码AI 也只会被当作规划如何改而不会真的动手。三阶段规划流程AI 是怎么想清楚的Plan Mode 的行为由内置提示词模板 plan.md 定义AI 会按三个阶段推进环境摸底Phase 1先读文件、搜代码、查配置自己把能查到的事实查清楚而不是直接问你意图对齐Phase 2围绕你的目标提问锁定成功标准、范围边界、约束条件和关键取舍方案推敲Phase 3讨论接口设计、数据流、边界情况、测试策略直到方案决策完备每个阶段中AI 会通过AskUserQuestion工具以选择题的形式与你交互你只需要做选择不用组织语言。硬性约束只规划不动手这是 Plan Mode 最让人放心的部分。它允许读取搜索、静态分析、运行--dry-run和测试构建等不改动仓库的操作禁止编辑写入文件、跑格式化、应用补丁等任何修改行为。更关键的是权限强制限制即便你在settings.json里配置了写文件自动放行Plan Mode 也会强制把以下操作升级为每次询问权限范围说明write-in-cwd/write-out-cwd工作区内/外创建或覆写文件delete-in-cwd/delete-out-cwd删除工作区内/外文件mutate-git-log修改 Git 历史输出方案你会收到 4 个选项当 AI 认为方案已决策完备会输出一个proposed_plan块通常包含标题、Summary概述、Key Changes关键变更、Test Plan测试计划、Assumptions假设。方案输出后无需输入任何内容会自动弹出 4 个选项用数字键1-4或↑/↓ Enter选择选项作用1. implement this plan退出 Plan ModeAI 自动开始按方案写代码2. clear context and implement携带已确认方案开新会话实现避免旧对话干扰3. stay in Plan mode留在规划模式继续打磨方案Esc等效于此4. switch to Default mode回到默认模式不自动开始实现选择 2 后原会话仍可通过/resume恢复随时找回规划过程。实战三类典型场景怎么用场景 1新功能开发给用户列表加上分页和搜索功能。AI 会先摸清现有路由和数据模型再和你确认分页方式游标还是偏移、搜索范围最后输出完整方案。场景 2代码重构把 UserService 中混杂的业务逻辑拆分到独立的 service 中。AI 会先分析依赖关系和调用方给出拆分方案、迁移步骤和兼容性考虑再动手。场景 3架构评审分析当前项目的认证流程给出安全改进建议。AI 会遍历认证相关代码识别风险点以方案形式给出具体改进步骤全程不碰代码。什么时候可以跳过 Plan ModePlan Mode 并非银弹。实验结论给出了清晰的分界线✅推荐用高难度算法、架构设计、多模块协同、需要端到端验证的任务❌可跳过fix typo、改配置、3 轮对话内能搞定的低风险小改动常见疑问QPlan Mode 和 UpdatePlan 工具是一回事吗不是。Plan Mode 是对话协作模式产物是proposed_plan完整方案UpdatePlan 是实现阶段的进度清单工具用来展示任务执行到哪一步。两者可以配合方案在 Plan Mode 定稿实现过程中 AI 用 UpdatePlan 跟踪进度。Q方案不满意怎么办选 3. stay in Plan mode 继续提修改意见即可AI 会输出完整替换的新方案。满意后再选 1 或 2 进入实现。小结Deep Code CLI 的 Plan Mode 用三阶段规划 只读约束 四选一方案出口把 AI 编码从先斩后奏变成先谋后动。对于复杂任务多花两三分钟规划换来的是方向不跑偏、过程可追溯、方案可复用。建议下次接到跨文件改动或新功能需求时先按ShiftTab让 Deep Code 想清楚再动手。更多细节可参阅官方文档 plan-mode.md。【免费下载链接】deepcode-cliDeep Code 是专为 deepseek-v4 模型优化的终端 AI 编码助手支持深度思考、推理强度控制以及 Agent Skills。项目地址: https://gitcode.com/gh_mirrors/de/deepcode-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
