WorkBuddy 实战教程：手把手配置自定义 MiMo 模型（踩坑全记录）

WorkBuddy 实战教程手把手配置自定义 MiMo 模型踩坑全记录本文转载自 腾讯云开发者社区记录了将小米 MiMo-V2.5-Pro 模型接入 WorkBuddy 的完整过程包括 3 个典型错误、排查思路和最终解决方案。一、背景为什么要用自定义模型WorkBuddy 内置了混元、DeepSeek、Kimi 等模型但有时候我们需要接入自己申请的 API——比如拿到了小米 Token Plan 的 MiMo 模型额度想在 WorkBuddy 里直接用就需要配置自定义模型。官方文档说在models.json里加配置就行但实际操作踩了不少坑下面逐一记录。二、第一坑400 Param Incorrect按照文档格式写好models.json填入 API Key 和 URL重启 WorkBuddy 后选中模型发送消息立刻报错400 Param Incorrect排查过程先用curl直接测 API 是否通curl-s-XPOSThttps://token-plan-cn.xiaomimimo.com/v1/chat/completions\-HAuthorization: Bearer YOUR_API_KEY\-HContent-Type: application/json\-d{model:mimo-v2.5-pro,messages:[{role:user,content:hi}],max_tokens:10}返回正常说明API Key 和接口地址都没问题问题出在 WorkBuddy 发送的请求参数上。三、第二坑id和name的区别关键用 curl 分别测试两种model参数# 用小写模型名 → 正常{model:mimo-v2.5-pro,...}✅ 正常返回# 用自定义 id 名 → 400 报错{model:MiMo-V2.5-Pro,...}❌Not supported model MiMo-V2.5-Pro关键发现WorkBuddy 会把name字段的值作为model参数发给 API而不是id很多人包括我以为id是给 WorkBuddy 内部用的name只是显示名称——其实不然。四、第三坑useCustomProtocol的含义models.json里有个useCustomProtocol字段文档里提了一句非标准路径需要开启但没说清楚。我的 URL 是https://token-plan-cn.xiaomimimo.com/v1这是标准 OpenAI 兼容接口路径应该是/v1/chat/completions。useCustomProtocol: true→ WorkBuddy不会自动补路径直接把你的 URL 作为完整请求地址 →错误useCustomProtocol: false→ WorkBuddy 自动补/chat/completions→正确五、最终可用配置直接抄文件路径~/.workbuddy/models.json[{id:mimo-v2.5-pro,name:mimo-v2.5-pro,vendor:custom,url:https://token-plan-cn.xiaomimimo.com/v1,apiKey:YOUR_API_KEY_HERE}]要点总结字段怎么填原因id填 API 认识的模型名小写内部标识也要和 API 一致name和id填一样的值WorkBuddy 用name作为请求model参数vendorcustom小写大写可能校验失败useCustomProtocol标准接口填false或不填让 WorkBuddy 自动补路径model字段不要加这个字段models.json不认这个字段加了会校验失败六、调试技巧用 curl 快速定位问题遇到 400 错误不要瞎猜用 curl 直接测# 1. 先测模型名对不对curl-shttps://YOUR_API_BASE/v1/models\-HAuthorization: Bearer YOUR_KEY# 返回可用模型列表确认 model id# 2. 再测聊天接口curl-s-XPOSThttps://YOUR_API_BASE/v1/chat/completions\-HAuthorization: Bearer YOUR_KEY\-HContent-Type: application/json\-d{model:模型名,messages:[{role:user,content:hi}],max_tokens:10}哪步报错问题就在哪。七、总结WorkBuddy 自定义模型配置的核心坑在name字段会被用作 API 的model参数所以必须和 API 期望的模型名一致。标准 OpenAI 兼容接口不要开useCustomProtocol让 WorkBuddy 自动补全路径。遇到问题先用curl隔离排查确认是配置问题还是 API 问题。models.json修改后必须完全退出重启WorkBuddy 才生效。希望这篇能帮助大家少踩坑顺利用上自己想要的模型