赛博鸡蛋
指南目录(34 篇)

通用

WorkBuddy 自定义模型教程:接入火山方舟、硅基流动与 models.json 配置

腾讯云桌面智能体 WorkBuddy 支持在「自定义模型」中接入火山方舟、硅基流动、阿里云百炼等第三方兼容 API,调用费用直接走外部平台免费额度,不消耗 WorkBuddy 内置积分。注意它的接口地址需要填带 /chat/completions 的完整路径。

适用对象
已安装 WorkBuddy、希望使用外部平台免费 API 额度驱动桌面与代码任务的用户
预计用时
约 5 分钟
更新时间

准备

  • 已安装 WorkBuddy 桌面客户端(国内版 workbuddy.cn 或国际版均可)
  • 火山方舟(建议先开启安心体验模式)或硅基流动、百炼的 API Key 与准确模型 ID

步骤

  1. 打开设置 → 模型 → 添加自定义模型

    启动 WorkBuddy,点击左下角头像进入 设置 → 模型,在「自定义模型」区域点击 添加模型,提供商选择 「自定义 / Custom」。使用自定义模型时,WorkBuddy 只负责本地发起请求,不会扣减客户端内置积分(顺带一提:2026 年 11 月 30 日前,内置模型里的 腾讯混元 HY4 Flash 每天也有免费额度可直接使用)。

  2. 填写以 /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)。

  3. 按模型真实能力勾选「工具调用」并保存

    展开 高级设置,按所选模型的实际支持情况勾选能力开关:

    • 工具调用:WorkBuddy 读写本地文件、执行命令依赖此项,选支持 Function Calling 的模型并勾选它;
    • 图片输入 / 推理模式:仅在模型确实支持多模态识图或思考推理时勾选(给纯文本或非思考模型误勾可能导致请求返回 400)。

    点击 保存 后回到对话界面,在模型下拉框的「自定义模型」分组选中即可。

  4. 进阶:直接编辑本地 models.json 批量添加

    需要一次录入多个模型时,可以直接编辑本地配置文件(国内版位于 ~/.workbuddy/models.json 并兼容 ~/.codebuddy/models.json;国际版位于 ~/.workbuddy-ai/models.json)。url 同样必须写 /chat/completions 完整路径,保存后若未自动刷新,彻底退出并重开一次客户端即可:

    json
    {
      "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 重新打开。

相关优惠

参考链接

相关指南

搜索优惠

提交优惠线索

粘贴官方活动页、定价页或文档链接,每日定时核验通过后发布。

无需注册,提交后可查看审核进度