指南目录(34 篇)
通用
WorkBuddy 自定义模型教程:接入火山方舟、硅基流动与 models.json 配置
腾讯云桌面智能体 WorkBuddy 支持在「自定义模型」中接入火山方舟、硅基流动、阿里云百炼等第三方兼容 API,调用费用直接走外部平台免费额度,不消耗 WorkBuddy 内置积分。注意它的接口地址需要填带 /chat/completions 的完整路径。
- 适用对象
- 已安装 WorkBuddy、希望使用外部平台免费 API 额度驱动桌面与代码任务的用户
- 预计用时
- 约 5 分钟
- 更新时间
准备
- 已安装 WorkBuddy 桌面客户端(国内版 workbuddy.cn 或国际版均可)
- 火山方舟(建议先开启安心体验模式)或硅基流动、百炼的 API Key 与准确模型 ID
步骤
打开设置 → 模型 → 添加自定义模型
启动 WorkBuddy,点击左下角头像进入 设置 → 模型,在「自定义模型」区域点击 添加模型,提供商选择 「自定义 / Custom」。使用自定义模型时,WorkBuddy 只负责本地发起请求,不会扣减客户端内置积分(顺带一提:2026 年 11 月 30 日前,内置模型里的 腾讯混元 HY4 Flash 每天也有免费额度可直接使用)。
填写以 /chat/completions 结尾的完整接口地址
与 Cherry Studio 等只填基础地址的工具不同,WorkBuddy 的接口地址默认要求填写包含
/chat/completions的完整请求路径:- 火山方舟:
https://ark.cn-beijing.volces.com/api/v3/chat/completions - 硅基流动:
https://api.siliconflow.cn/v1/chat/completions - 阿里云百炼(北京):
https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
接着填入平台生成的 API Key,并在模型名称栏填入平台上的准确模型 ID(例如火山方舟预置的
doubao-seed-2-1-pro-260628,或硅基流动免费的XingChenAGI/Xing4.0-29B)。- 火山方舟:
按模型真实能力勾选「工具调用」并保存
展开 高级设置,按所选模型的实际支持情况勾选能力开关:
- 工具调用:WorkBuddy 读写本地文件、执行命令依赖此项,选支持 Function Calling 的模型并勾选它;
- 图片输入 / 推理模式:仅在模型确实支持多模态识图或思考推理时勾选(给纯文本或非思考模型误勾可能导致请求返回
400)。
点击 保存 后回到对话界面,在模型下拉框的「自定义模型」分组选中即可。
进阶:直接编辑本地 models.json 批量添加
需要一次录入多个模型时,可以直接编辑本地配置文件(国内版位于
~/.workbuddy/models.json并兼容~/.codebuddy/models.json;国际版位于~/.workbuddy-ai/models.json)。url同样必须写/chat/completions完整路径,保存后若未自动刷新,彻底退出并重开一次客户端即可:{ "models": [ { "id": "doubao-seed-2-1-pro-260628", "name": "豆包 Seed 2.1 Pro(火山方舟)", "vendor": "Volcengine", "url": "https://ark.cn-beijing.volces.com/api/v3/chat/completions", "apiKey": "你的火山方舟API_Key", "maxInputTokens": 128000, "supportsToolCall": true, "supportsImages": false, "supportsReasoning": true } ] }
注意事项
- 反过来如果想把 WorkBuddy 内置限免至 11 月 30 日的 HY4 Flash 或签到积分转给 Claude Code、Codex 用,可在 Magpie 中登录 WorkBuddy 账号,见 WorkBuddy 与 Qoder 接入 Magpie 教程。
- 若你在火山方舟或百炼购买的是 Coding Plan 套餐,其专属接入地址与上方普通按量接口不同,需按对应套餐文档填写。
常见问题
保存后一发消息就报 404 或 400 错误怎么办?
报 404 先检查接口地址末尾是否漏了 /chat/completions,以及模型 ID 大小写与命名空间(如硅基流动模型前缀)是否完整;报 400 多半是给不支持识图或思考的模型勾上了对应高级开关。
修改了 models.json 但模型下拉框里看不到?
检查 JSON 语法(引号、末尾多余逗号)以及必填字段 id、name、url 是否齐全,确认无误后从系统托盘完全退出 WorkBuddy 重新打开。
相关优惠
- 模型WorkBuddy腾讯混元 HY4 Flash 限免两周:OpenCode、WorkBuddy 同步开放HY4 Flash 限免至北京时间 11 月 30 日 23:59
- 新人WorkBuddyWorkBuddy 国际版新用户注册送 250 积分,每天活跃再领 30 积分注册送 250 积分,每天活跃再领 30 积分
- 折扣火山引擎豆包大模型 2.1 资源包 19 元约 440 万 Tokens,原价 38 元19 元约 440 万 Tokens(原价 38 元,半价)
- 额度WorkBuddyWorkBuddy 教育公益版:教师每月领 2000 积分,连领 12 个月教师每月领 2000 积分,连续 12 个月(共 24000 积分)
- 额度WorkBuddyWorkBuddy 每天领 100 积分:Buddy 加油站签到领每天领 100 积分
- 新人硅基流动硅基流动实名认证送 16 元代金券:全平台通用,含 Pro 模型实名认证送 16 元通用代金券
参考链接
- WorkBuddy 模型配置文档www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model
- 腾讯云 models.json 配置指南cloud.tencent.com/document/product/1831/134513
- 火山方舟 Base URL 及鉴权说明docs.volcengine.com/docs/ark/base-url-and-authentication