<# BUG分析报告：mimo-v2.5-pro 自定义模型通信故障
BUG摘要
项目 内容 BUG名称 Trae CN 自定义模型 mimo-v2.5-pro API 通信 400 错误 错误信息 Param Incorrect (Model Provider Error Code: 400, HTTP Status: 400) 严重等级 
阻塞级 — 模型完全不可用 报告日期 2026-05-19 涉及系统 Trae CN (VS Code 插件) + 小米 MiMo API ( token-plan-cn.xiaomimimo.com )
环境信息
项目 值 IDE Trae CN (VS Code 衍生版) 数据库 C:\Users\azyp\AppData\Roaming\Trae CN\User\globalStorage\state.vscdb 配置 Key 578777376099883_AI.agent.model.model_list_map 模型 mimo-v2.5-pro (小米 MiMo 团队) API 地址 https://token-plan-cn.xiaomimimo.com/v1/chat/completions 认证方式 Bearer Token (API Key) 涉及 Agent solo_coder / solo_builder / builder / code_reviewer / code_review_summary / refactor / solo_agent (共 7 个)
重现步骤
3.1 初始配置（Trae UI 添加模型）
在 Trae 设置中添加自定义模型：
- Provider : custom_openai_compatible
- Name : custom_openai_compatible//mimo-v2.5-pro
- Base URL : https://token-plan-cn.xiaomimimo.com/v1/chat/completions
- API Key : 未设置（UI 无对应输入框）
3.2 BUG 触发
在任意 Agent（如 solo_coder）中选择 mimo-v2.5-pro 模型，发送对话请求。
→ 返回 Param Incorrect (400)
3.3 多次修复验证
DB 配置经历了 5 轮修改、3 轮测试 ，均为同一错误：
轮次 修改内容 DB 状态 测试结果 1 api_key ← 真实Key, auth_type 0→1 
400 2 base_url 去掉 /chat/completions 400 3 ak ← 真实Key, auth_type 保持0, 删除 api_key 400 4 新增 model = mimo-v2.5-pro 400 5 确认 name/base_url/ak/auth_type/model 全部正确 400
根因分析
4.1 最终诊断结果
通过抓包模拟 Trae 的请求行为，定位到 根本原因 ：
Trae 发送的请求:
model = "custom_openai_compatible//mimo-v2.5-pro" ← 用
name 字段
base_url = "https://token-plan-cn.xiaomimimo.com/v1/chat/
completions"
headers = { Authorization: "Bearer <ak>" }
API 返回:
HTTP 400
{ "error": { "message": "Param Incorrect: Not supported
model custom_openai_compatible//mimo-v2.5-pro" } }
4.2 关键证据
测试1: model = "mimo-v2.5-pro" → HTTP
200 ✅
测试2: model = "custom_openai_compatible//mimo-v2.5-pro" →
HTTP 400 ❌
测试3: model = "mimo-v2.5-pro" (无 max_tokens) → HTTP
200 ✅
测试4: 全部参数 (temp/top_p/penalty) 皆齐 → HTTP
200 ✅
结论： API 只认 model = mimo-v2.5-pro ，而 Trae 发的是 model = custom_openai_compatible//mimo-v2.5-pro 。
4.3 根因定位
100 %
Trae 框架内部逻辑： 发送 API 请求时， model 参数优先使用 name 字段的值，而不是 model 字段。 model 字段虽然存在于 DB 中，但 Trae 的请求构建逻辑没有读取它。
已尝试修复方案总表
方案 修改内容 结果 失败原因 1 set_mimo_key.py v1 api_key 字段写入Key 400 Trae 不认 api_key 字段 2 set_mimo_key.py v2 auth_type 0→1 + api_key 400 Trae 运行时自动回退 auth_type 到0 3 手动 fix_mimo_key.py ak 写入Key + 删 api_key 400 Key 认证通过，但 model 参数依然错误 4 手动 fix_mimo_key.py v2 新增 model=mimo-v2.5-pro 400 Trae 忽略 model 字段，继续用 name 5 最终状态确认 6个字段全部正确 400 Trae 框架级行为，DB 配置无法覆盖
结论
不可修复原因
Trae 内部发送 API 请求时， model 参数固定使用 name 字段的值（ custom_openai_compatible//mimo-v2.5-pro ），而小米 MiMo API 不识别该格式的模型名。
这是 Trae 框架级别的写入逻辑问题 ，不是 DB 配置能解决的。所有 DB 字段（ model / api_key / auth_type ）都会被 Trae 运行时的内部逻辑覆盖或忽略。
当前 DB 状态（配置正确但无效）
name = custom_openai_compatible//mimo-v2.5-pro
base_url = https://token-plan-cn.xiaomimimo.com/v1 ✅
auth_type = 0 ✅
ak = tp- ✅
(真实 Key)
model = mimo-v2.5-pro ✅
(但 Trae 不认)
provider = custom_openai_compatible ✅
