接入 WorkBuddy

WorkBuddy/CodeBuddy 是 AI Agent 与编程助手工具。它支持通过本地模型配置文件添加自定义模型，可以使用 OpenAI 兼容的 Chat Completions API 接入模型广场提供的模型。

1. 安装 WorkBuddy/CodeBuddy

• 安装并登录 WorkBuddy/CodeBuddy。
• 至少打开一次项目目录，让应用创建本地配置目录。
• 前往 控制台 获取 API Key。

2. 配置本地模型

创建或编辑用户级配置文件：

C:\Users\<你的用户名>\.codebuddy\models.json

如果只想让配置对某个项目生效，也可以创建项目级配置文件：

<你的项目>\.codebuddy\models.json

先将 API Key 设置为环境变量：

setx API_KEY "<API Key>"

然后写入以下配置：

{
  "models": [{
    "id": "<Model ID>",
    "name": "taihang",
    "vendor": "模型厂商名称",
    "url": "https://api.taiha.con/v1/chat/completions",
    "apiKey": "${API_KEY}",
    "maxInputTokens": 128000,
    "maxOutputTokens": 8192,
    "supportsToolCall": true,
    "supportsImages": false,
    "relatedModels": { #模型关联，可选
      "lite": "关联的轻量型模型ID",
      "reasoning": "关联的复杂推理模型ID"
    }
  },
  #更多模型配置..
  ],
  "availableModels": [
    "Model ID - 1",
    "Model ID - 2"
  ]
}

请将 models.json 保存为 UTF-8 无 BOM。部分桌面版本在读取带 UTF-8 BOM 文件头的 JSON 时，可能会读取本地模型配置失败。

3. 重启并选择模型

完全退出 WorkBuddy/CodeBuddy 后重新打开，随后在模型选择器中选择需要调用的模型。

4. 可选：验证 API Key

Windows 用户可以在 PowerShell 中验证 API Key：

$env:API_KEY="<API Key>"

curl https://api.taiha.cn/v1/chat/completions `
  -H "Content-Type: application/json" `
  -H "Authorization: Bearer $env:API_KEY" `
  -d '{"model":"<Model ID>","messages":[{"role":"user","content":"hi"}],"stream":false}'

如果请求成功，说明 API Key 和模型名都可用。

---

常见问题

Q：Authentication Fails 或 401

检查 apiKey 是否为真实 API Key。不要把接口 URL 填到 API Key 字段。

Q：未找到模型 或 404

检查模型 id 是否严格写成为模型广场中提供的模型名称，建议使用复制按钮获取正确的名称。

Q：读取本地模型配置失败

检查 models.json 是否是合法 JSON，并保存为 UTF-8 无 BOM。

Q：模型选择器中不显示

完全重启 WorkBuddy/CodeBuddy，并确认文件放在 .codebuddy\models.json。

Q：UI 中直接显示 ${API_KEY}

请从已设置 API_KEY 的终端中重启 WorkBuddy/CodeBuddy。如果桌面端仍不展开环境变量，可以在 UI 或本地 models.json 中填入真实 API Key。