接入 WorkBuddy/CodeBuddy

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

1. 安装 WorkBuddy/CodeBuddy

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

2. 配置本地模型

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

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

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

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

先将 PingToken API Token 设置为环境变量：

setx PINGTOKEN_API_KEY "<你的 PingToken API Token>"

然后写入以下配置：

{
    "models": [
        {
            "id": "deepseek-v4-pro",
            "name": "DeepSeek V4 Pro",
            "vendor": "PingToken",
            "url": "https://pingtoken.cn/api/v1/chat/completions",
            "apiKey": "${PINGTOKEN_API_KEY}",
            "maxInputTokens": 128000,
            "maxOutputTokens": 8192,
            "supportsToolCall": true,
            "supportsImages": false,
            "relatedModels": {
                "lite": "deepseek-v4-flash",
                "reasoning": "deepseek-v4-pro"
            }
        },
        {
            "id": "deepseek-v4-flash",
            "name": "DeepSeek V4 Flash",
            "vendor": "PingToken",
            "url": "https://pingtoken.cn/api/v1/chat/completions",
            "apiKey": "${PINGTOKEN_API_KEY}",
            "maxInputTokens": 128000,
            "maxOutputTokens": 8192,
            "supportsToolCall": true,
            "supportsImages": false
        }
    ],
    "availableModels": [
        "deepseek-v4-pro",
        "deepseek-v4-flash"
    ]
}

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

3. 重启并选择模型

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

在模型选择器中选择：

• DeepSeek V4 Pro
• DeepSeek V4 Flash

4. 可选：验证 API Token

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

$env:PINGTOKEN_API_KEY="<你的 PingToken API Token>"

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

常见问题

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