迁移需先升级SDK至3.1.0+并验证API返回含muse_wonder_full；再改用v2接口并添加X-Muse-Mode: focus及focus_target字段，或在Muse Code启用Persistent Session；最后停用session_id透传、删除Redis缓存、按X-Muse-Retry-After-Step处理429。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
将旧项目技术栈迁移到 Muse Wonder Full 需要绕过模型层直接对接其运行时约束和 API 协议，而非简单替换 SDK 或重写提示词。
确认当前项目是否满足迁移前提
检查你的旧项目是否基于 Python 或 TypeScript 构建，且已使用 Meta Model API v2.3+ 或 Muse Code v1.8+ 的 client SDK。若仍在调用 legacy /v1/chat/completions 路径或依赖本地 Llama.cpp 封装，【必须先升级客户端 SDK 到 muse-sdk@3.1.0 或更高】，否则无法解析 Active Memory 上下文头字段与 artifact 响应结构。
验证方式：运行 curl -X GET "https://api.meta.ai/v2/models" -H "Authorization: Bearer $TOKEN"，返回中必须包含 "muse_wonder_full" 字符串且 status 为 active。
替换推理入口并启用 Active Focus 模式
方法一：通过 Meta Model API 直接调用
将原请求 URL 从 https://api.meta.ai/v1/chat/completions 改为 https://api.meta.ai/v2/chat/completions → 在 headers 中添加 X-Muse-Mode: focus → 请求 body 中必须传入 "focus_target": {"objective": "string", "constraints": ["string"]} 字段，否则 Wonder Full 会自动降级为普通 Muse Wonder 模式，失去长期任务推进能力。
方法二：在 Muse Code 中启用 Full 模式
打开 Muse Code 设置 → 进入 Agent Runtime → 将 Default Model 切换为 Muse Wonder Full → 点击「Enable Persistent Session」开关 → 此操作会自动在后台初始化一个跨对话的 Active Memory 实例，后续所有 /run、/debug、/refine 请求都将绑定该 memory_id。
重构状态管理逻辑
第一步：停用旧项目中的手动 session_id 透传机制。Muse Wonder Full 的 Active Memory 由服务端全权维护，客户端重复传入 memory_id 会导致上下文覆盖冲突，出现记忆丢失或指令混淆。
第二步：将原项目中用于缓存中间结果的 Redis key（如 "task_123_step2_output"）全部删除。Wonder Full 的 artifact 生成链路自带版本化存储，响应体中返回的 "artifact_ref": "art_xxx_v4" 可直接用于后续步骤的输入引用，无需本地持久化。
第三步：重写错误处理分支。当收到 HTTP 429 响应时，不再等待固定秒数后重试，而是提取响应头中的 X-Muse-Retry-After-Step 字段值，该值代表当前 focus 流程中阻塞点的预期解决步数，例如值为 3 表示模型正在尝试第三种方案，建议前端显示“正在切换调试路径…”而非“请求过于频繁”。
