WorkBuddy 接入第三方大模型全攻略：以火山云 Ark 为例，解锁 12 个免费模型

WorkBuddy 接入第三方大模型全攻略：以火山云 Ark 为例，解锁 12 个免费模型

前言

WorkBuddy 作为腾讯出品的全场景 AI 办公工作台，默认内置了混元、Auto 等模型。但很多用户不知道的是，WorkBuddy 支持 OpenAI 兼容提供者，可以接入任何兼容 OpenAI API 格式的第三方大模型服务。

本文将以**火山云（Volcengine Ark）**为例，手把手教你如何将 12 个大模型接入 WorkBuddy，包括 DeepSeek-V4、Kimi-K2.6、GLM-5.2 等，彻底告别积分焦虑。

一、前置准备

1.1 获取火山云 API 资源

火山云 Ark 提供 OpenAI 兼容的 API 端点，你需要准备以下三样东西：

1.2 12 个可用模型一览

二、配置文件详解

2.1 找到配置文件

WorkBuddy 的 OpenAI 兼容提供者配置存储在：

提示：WorkBuddy 使用 CODEBUDDY_CONFIG_DIR 环境变量决定配置目录。默认指向 ~/.workbuddy。

2.2 完整配置示例

2.3 配置字段说明

三、踩坑避雷指南

坑 1：URL 必须以 /chat/completions 结尾

WorkBuddy 会直接向配置的 URL 发送 POST 请求，不会自动拼接路径。如果你的 Base URL 是 https://ark.cn-beijing.volces.com/api/coding/v3，必须写成完整的：

坑 2：不要配置 availableModels 白名单

models.json 里有一个 availableModels 字段，它是一个白名单过滤器。一旦配置了，WorkBuddy 就只显示列表里的模型，内置的 Auto / 混元等默认模型会被全部隐藏。

正确做法：不要写 availableModels 字段，让所有模型（内置 + 自定义）都可见。

坑 3：环境变量 ${VAR} 不适用于 API Key

虽然 models.json 支持 ${VAR} 格式的环境变量引用，但 WorkBuddy 只解析进程级环境变量（process.env），不解析 settings.json 中的 env 字段。所以 apiKey 只能用明文，无法通过 settings.json 注入。

坑 4：遇到"每日限额"报错

火山云不同模型走不同的额度通道。如果你用 deepseek-v4-pro 遇到"明天重置"报错，切换到 doubao-seed-2.0-pro 或 kimi-k2.6 即可——它们走不同通道，不会触发同一个每日限额。

四、验证配置是否生效

配置完成后，WorkBuddy 支持热重载（约 1 秒自动同步）。打开模型下拉列表，如果能看到所有配置的模型，说明接入成功。

如果看不到，试试：

1. 切换一次模型下拉
2. 重启 WorkBuddy 客户端
3. 检查 JSON 格式是否正确（可以用 python -m json.tool models.json 验证）

五、总结

接入第三方模型后，WorkBuddy 的功能边界被大大扩展：

• 省钱：使用火山云等免费/低成本的 API，不再依赖 WorkBuddy 积分
• 灵活：12 个模型各有所长，按场景切换（代码用 DeepSeek，长文档用 GLM-5.2，图片用 Doubao）
• 简单：只需一个 models.json 文件，配置一次，热加载生效

如果你有其他兼容 OpenAI API 的模型服务（如 Ollama 本地模型、OpenRouter 等），也可以按同样的方式接入。