# 接入 WorkBuddy/CodeBuddy

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

#### 1. 安装 WorkBuddy/CodeBuddy

- 安装并登录 WorkBuddy/CodeBuddy。
- 至少打开一次项目目录，让应用创建本地配置目录。
- 前往 [DeepSeek 开放平台](https://platform.deepseek.com/api_keys) 获取 API Key。

#### 2. 配置本地模型

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

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

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

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

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

```powershell
setx DEEPSEEK_API_KEY "<your DeepSeek API Key>"
```

然后写入以下配置：

```json
{
  "models": [
    {
      "id": "deepseek-flash",
      "name": "DeepSeek Flash",
      "vendor": "DeepSeek",
      "url": "https://api.deepseek.com/v1/chat/completions",
      "apiKey": "${DEEPSEEK_API_KEY}",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": true
    }
  ],
  "availableModels": [
    "deepseek-flash"
  ]
}
```

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

#### 3. 重启并选择模型

完全退出 WorkBuddy/CodeBuddy 后重新打开。

在模型选择器中选择：

```
DeepSeek Flash
```

#### 4. 可选：验证 API Key

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

```powershell
$env:DEEPSEEK_API_KEY="<your DeepSeek API Key>"

curl https://api.deepseek.com/v1/chat/completions `
  -H "Content-Type: application/json" `
  -H "Authorization: Bearer $env:DEEPSEEK_API_KEY" `
  -d '{"model":"deepseek-flash","messages":[{"role":"user","content":"hi"}],"stream":false}'
```

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

#### 常见问题

- `Authentication Fails` 或 `401`：检查 `apiKey` 是否为真实 DeepSeek API Key。不要把接口 URL 填到 API Key 字段。
- `未找到模型` 或 `404`：检查模型 id 是否严格写成 `deepseek-flash`。
- `读取本地模型配置失败`：检查 `models.json` 是否是合法 JSON，并保存为 UTF-8 无 BOM。
- 模型选择器中不显示：完全重启 WorkBuddy/CodeBuddy，并确认文件放在 `.codebuddy\models.json`。
- UI 中直接显示 `${DEEPSEEK_API_KEY}`：请从已设置 `DEEPSEEK_API_KEY` 的终端中重启 WorkBuddy/CodeBuddy。如果桌面端仍不展开环境变量，可以在 UI 或本地 `models.json` 中填入真实 API Key。
