Qwen Code的规划模式是先输出带编号步骤、依赖关系和验证点的文本执行计划，再确认执行；需v2.3.0+版本、TaoToken网关调用、提示词含显式规划动词三前提，且受跨worktree路径隔离、环境变量不参与推理、敏感操作需手动授权等边界约束。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
什么是Qwen Code的规划模式
当你在终端输入qwen-code --plan或在VS Code插件中点击“生成执行计划”时，Qwen Code不会立刻写代码，而是先输出一份带编号步骤、明确依赖关系和回滚点的文本方案，比如“①读取config.yaml → ②检查env.production是否存在 → ③若不存在则创建并写入API_BASE_URL字段 → ④验证字段可被Python dotenv加载”。这种模式专为需要预审、多人协作或高风险变更的场景设计，不是所有请求都会触发——只有当提示词中出现“分步”“先确认再执行”“列出所有影响”等强规划意图时，模型才启用该路径。
触发规划模式的三个硬性前提
第一步：确保你使用的是 Qwen Code v2.3.0 或更高版本。低于此版本的 CLI 不识别 --plan 参数，会直接报错 unknown flag: --plan。
第二步：必须通过 TaoToken 统一网关调用模型，且 Base URL 指向支持规划协议的 endpoint（如 https://taotoken.net/api/v1/workflow）。直接连本地 Ollama 或 HuggingFace Inference API 的请求会被降级为普通对话流，【规划结构将完全丢失】。
第三步：提示词中至少包含一个显式规划动词。例如“请分三步说明如何迁移数据库”“列出所有需要修改的文件及其顺序”“先评估风险再给操作步骤”。仅写“帮我重构UserService”不会激活规划模式，模型默认走代码生成路径。
规划模式下不可绕过的三类边界
方法一：跨 Git Worktree 的路径不可见
规划阶段生成的文件路径，始终基于当前激活 worktree 的根目录解析。如果你在 git worktree list 显示的 worktrees/feature/auth 下运行规划命令，模型输出的“修改 src/auth/handler.py”是有效的；但若该文件实际只存在于 main 分支而未 cherry-pick 到当前 worktree，执行阶段会报 No such file。这并非模型错误，而是规划上下文与物理文件系统存在天然隔离。
Qwen 视频智能分析基础客户端（免费版），基于 Qwen 3.5 Plus 多模态模型对本地视频进行内容分析，支持场景描述与基础内容理解，采用默认抽帧频率和提示词，适合快速概览视频，API Key 读取自 ~/.skill-platform/skill-platform.json 的 skills 配置。
方法二：环境变量不参与规划推理
Qwen Code 规划模式读取的是静态项目结构（git ls-files + find . -name "*.py"），不会执行 source .env && echo $DB_HOST 获取运行时值。因此，任何依赖 $ENV 动态拼接路径或配置名的操作（如“把日志写到 $LOG_DIR/app.log”），规划结果里只会写死为 LOG_DIR/app.log，执行时才由 Shell 展开。务必在规划输出后手动校验变量是否已注入。
方法三：敏感操作必须显式授权
当规划步骤中出现 rm -rf、chmod 777、curl -X POST https://prod-api/flush 等动作时，Qwen Code 不会自动执行，而是暂停并等待你在控制台输入 confirm --force。此时若跳过确认直接敲回车，整个工作流将终止，且【已执行的前置步骤不会自动回滚】。
验证规划是否真正生效
① 在终端执行：qwen-code --plan "添加JWT校验中间件到Express路由"。
② 观察输出首行是否为“✅ 执行计划已生成”，且后续内容含编号步骤、箭头依赖符号（→）、以及明确的“验证点”描述（如“验证：运行 npm test -- --testPathPattern=auth.spec.ts”）。
③ 若首行为“? 正在生成代码…”或输出直接以 Python/JS 代码块开头，则说明规划模式未触发，需返回第二步检查 TaoToken 配置或重写提示词。
