必须主动选择Plan Mode并配合结构化指令才能触发规划流程：先点击右上角「Craft」切换为「Plan」，再输入含“规划”等关键词的完整需求，审阅五步方案后确认执行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让CodeBuddy先理清思路再动手写代码，避免生成结果偏离预期、反复修改浪费时间，就必须用对Plan Mode——它不是开关一按就生效的模式，而是需要在任务发起前主动选择、配合结构化指令才能触发的协作流程。
确认当前处于Plan Mode运行环境
启动CodeBuddy IDE后，默认进入的是Craft Mode。右上角状态栏显示「Craft」字样，此时直接发指令会跳过规划环节直接执行。
点击右上角「Craft」标签，在弹出菜单中选择「Plan」——界面立即切换为Plan Mode专属布局：左侧多出「方案预览」面板，中间对话区顶部出现「分析→技术→设计→计划→开发」五步导航条。
【必须完成这一步才能启用Plan Mode全部能力，仅切换标签不输入指令，AI不会自动进入规划流程】
发出能触发Plan Mode的指令
方法一：明确声明模式+描述需求全貌
在对话框输入：“Plan Mode下，帮我实现一个支持JWT登录的用户管理系统，包含注册、登录、Token刷新、权限校验四个接口，使用Express + MongoDB，要求代码可直接运行，输出完整项目结构和每文件职责说明。”
方法二：用动词锚定规划意图
开头必须含“规划”“设计”“拆解”“分步实现”等词，例如：“请规划一个电商商品搜索页的前端实现，包含关键词输入、筛选面板、结果列表、分页组件，适配移动端，给出技术选型依据和文件分工。”
⚠️ 如果只说“写个登录页面”，即使已切到Plan Mode，AI仍可能跳过规划直接生成代码——【指令中缺少“规划”“分步”“结构”等关键词，Plan Mode形同虚设】
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
审阅并确认AI输出的执行方案
第一步：等待AI输出带编号的结构化方案，通常包含：
① 需求澄清（确认你没说错什么）
② 技术栈选型（为什么用React不用Vue）
③ 文件目录结构（src/、public/、config/怎么划分）
④ 关键模块实现路径（如登录逻辑如何串联API调用与状态管理）
⑤ 依赖安装与启动命令
第二步：逐项检查方案合理性。发现异常立刻在方案下方回复“第③步中authContext.js应放在hooks目录而非utils，请重排文件结构”。AI会修正后重新输出完整方案，不执行任何代码。
第三步：确认无误后，输入“同意方案，开始执行”——AI才真正开始生成代码、创建文件、写入内容。
利用Plan Mode处理跨文件复杂任务
上传一个含3个TSX组件和1个API路由的旧项目文件夹，然后发送指令：“在现有项目中新增订单导出功能，要求：① 前端增加‘导出Excel’按钮；② 后端新增/export接口；③ 使用SheetJS生成文件；④ 权限控制复用现有authMiddleware。请规划改动范围、影响文件、新增代码位置及测试要点。”
AI会扫描全部文件，标注需修改的5处位置（如OrderList.tsx加按钮、routes/order.ts加接口、utils/export.ts新文件等），并说明每处修改是否需同步更新TypeScript类型定义。
这一步无法在Craft Mode下完成——【没有上下文感知的全局分析能力，Craft只会随机改一个文件】
