WorkBuddy/CodeBuddy 自定义接入第三方 API 实战教程（以 Qwen3.5 为例）

在使用 WorkBuddy 或 CodeBuddy 时官方模型有时无法满足特定需求。通过修改本地配置文件接入第三方 API如阿里云 DashScope、私有部署模型等是一个非常实用的功能。但在配置过程中很多用户会遇到PowerShell 测试报错或软件内模型无响应的问题。本文将还原真实的踩坑过程提供一份经过验证的“保姆级”配置教程。️ 第一步准备正确的models.json文件这是最关键的一步。WorkBuddy 的配置文件不是简单的数组而是一个包含models和availableModels的对象。1. 找到配置文件Windows:C:\Users\你的用户名\.workbuddy\models.json(或.codebuddy)macOS/Linux:~/.workbuddy/models.json2. 写入标准配置请确保你的 JSON 格式严格如下注意url必须以/v1/chat/completions结尾{ models: [ { id: qwen3.5-35b-a3b, name: Qwen3.5-35B-A3B, vendor: Custom, url: https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions, apiKey: sk-你的真实APIKey, maxInputTokens: 32768, maxOutputTokens: 8192, supportsToolCall: true, supportsImages: false, supportsReasoning: true, useCustomProtocol: true } ], availableModels: [ qwen3.5-35b-a3b ] }⚠️ 避坑指南id必须与 API 服务商要求的模型名称完全一致区分大小写。availableModels中的 ID 必须与上面models里的id一一对应否则软件无法识别。availableModels数据也可以不配置不然模型只有自定义[ { id: qwen3.5-35b-a3b, name: Qwen3.5-35B-A3B, vendor: Custom, url: https://地址/v1/chat/completions, apiKey: sk-APIKEY, maxInputTokens: 32768, maxOutputTokens: 8192, supportsToolCall: true, supportsImages: false, supportsReasoning: true, useCustomProtocol: true }, { id: deepseek-v4-flash, name: deepseek-v4-flash, vendor: Custom, url: https://地址/v1, apiKey: sk-APIKEY, supportsToolCall: true, supportsImages: false, supportsReasoning: false, useCustomProtocol: false } ]也可以在workbuddy配置 第二步使用 PowerShell 验证接口连通性在重启软件前强烈建议使用 PowerShell 测试接口是否通畅。很多“配置无效”的问题其实是网络或 Key 的问题。❌ 常见错误示范直接使用字符串传参会导致如下报错无法绑定参数 Headers。无法将 System.String 类型的值转换为 System.Collections.IDictionary 类型。✅ 正确测试命令请复制以下脚本替换为你的真实 URL 和 Key# 1. 定义变量 $apiKey sk-你的真实Key $url https://你的API地址/v1/chat/completions # 2. 构造请求体 (注意model字段要和json配置里的id一致) $body { model qwen3.5-35b-a3b messages ( { role user; content 你好请回复ok } ) } | ConvertTo-Json -Depth 4 # 3. 发送请求 try { $response Invoke-RestMethod -Uri $url -Method Post -Headers { Authorization Bearer $apiKey; Content-Type application/json } -Body $body Write-Host ✅ 测试成功API返回内容 -ForegroundColor Green Write-Host $response.choices[0].message.content } catch { Write-Host ❌ 测试失败 -ForegroundColor Red Write-Host $_.Exception.Message }如果看到绿色的“测试成功”并返回了内容说明网络和 Key 均无误。两种方式都可以$apiKey sk-apikey $url https://地址/v1/chat/completions $body { model qwen3.5-35b-a3b messages ( { role user; content 你好请回复ok } ) } | ConvertTo-Json -Depth 4 Invoke-RestMethod -Uri $url -Method Post -Headers { Authorization Bearer $apiKey Content-Type application/json } -Body $body 第三步重启与验证彻底关闭WorkBuddy/CodeBuddy确保托盘区图标也退出。重新打开软件。在对话框右下角的模型选择列表中找到你配置的Qwen3.5-35B-A3B。发送一条消息进行测试。如图所示当你能成功收到模型的回复时说明自定义接入大功告成 总结接入第三方模型的核心在于JSON 结构的完整性和URL 路径的准确性。希望这篇教程能帮你少走弯路