进阶 api-docs.deepseek.com 2026-10-13 22:45:35 · 21 阅读
第38章 在 WorkBuddy/CodeBuddy 中集成 DeepSeek
第38章：集成 WorkBuddy/CodeBuddy
WorkBuddy/CodeBuddy 是一款 AI 智能体与编程助手。它支持通过本地模型配置文件自定义模型，DeepSeek V4 可通过兼容 OpenAI 的 Chat Completions API 接入。
1. 安装 WorkBuddy/CodeBuddy
安装并登录 WorkBuddy/CodeBuddy。
首次打开一个项目文件夹，以便应用创建本地配置目录。
从 DeepSeek 平台获取 API Key。
2. 配置本地模型
创建或编辑用户级配置文件：
C:\Users\\.codebuddy\models.json
若仅对单个项目应用配置，请创建项目级配置文件：\.codebuddy\models.json
首先将 DeepSeek API Key 设为环境变量： setx DEEPSEEK_API_KEY ""
然后添加以下配置： {
"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"
]
}
请以无 BOM 的 UTF-8 格式保存 models.json。某些桌面版本可能无法读取带有 UTF-8 BOM 头的本地模型配置文件。 3. 重启并选择模型 完全退出 WorkBuddy/CodeBuddy，然后重新打开。 在模型选择器中选择： DeepSeek Flash
4. 可选：验证 API Key Windows 用户可在 PowerShell 中验证 API Key： $env: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 和模型名称都有效。 故障排查 认证失败或 401：检查 apiKey 是否为你真实的 DeepSeek API Key。不要把 API 地址填到 API Key 字段里。 模型未找到或 404：检查模型 id 是否正好是 deepseek-flash。 读取本地模型配置失败：检查 models.json 是否为合法的 JSON，并以 UTF-8 无 BOM 格式保存。 模型没有出现在选择器中：彻底重启 WorkBuddy/CodeBuddy，并确认文件已放在 .codebuddy\models.json 路径下。 界面中直接显示 ${DEEPSEEK_API_KEY}：在已设置 DEEPSEEK_API_KEY 环境变量的终端中重启 WorkBuddy/CodeBuddy。如果桌面界面仍然无法解析环境变量，请在界面或本地 models.json 中直接填入实际的 API Key。
若仅对单个项目应用配置，请创建项目级配置文件：
首先将 DeepSeek API Key 设为环境变量： setx DEEPSEEK_API_KEY "
然后添加以下配置： {
"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"
]
}
请以无 BOM 的 UTF-8 格式保存 models.json。某些桌面版本可能无法读取带有 UTF-8 BOM 头的本地模型配置文件。 3. 重启并选择模型 完全退出 WorkBuddy/CodeBuddy，然后重新打开。 在模型选择器中选择： DeepSeek Flash
4. 可选：验证 API Key Windows 用户可在 PowerShell 中验证 API Key： $env: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 和模型名称都有效。 故障排查 认证失败或 401：检查 apiKey 是否为你真实的 DeepSeek API Key。不要把 API 地址填到 API Key 字段里。 模型未找到或 404：检查模型 id 是否正好是 deepseek-flash。 读取本地模型配置失败：检查 models.json 是否为合法的 JSON，并以 UTF-8 无 BOM 格式保存。 模型没有出现在选择器中：彻底重启 WorkBuddy/CodeBuddy，并确认文件已放在 .codebuddy\models.json 路径下。 界面中直接显示 ${DEEPSEEK_API_KEY}：在已设置 DEEPSEEK_API_KEY 环境变量的终端中重启 WorkBuddy/CodeBuddy。如果桌面界面仍然无法解析环境变量，请在界面或本地 models.json 中直接填入实际的 API Key。
