WorkBuddy

在 WorkBuddy 中配置 AIHubMix：添加 Custom 模型后使用 AIHubMix 支持的任意模型。

WorkBuddy 可以添加自定义 OpenAI 兼容模型。把 AIHubMix 配进去后，就能在 WorkBuddy 的模型选择器里调用 AIHubMix 支持的 GPT、Claude、Gemini、DeepSeek、GLM 等模型。

​

准备工作

• WorkBuddy 已安装，并且可以正常打开。
• 在 AIHubMix 控制台 创建好的 API Key，格式通常是 sk-***。
• 要使用的模型 ID，例如 gpt-5.5、gemini-3.5-flash、deepseek-v4.1-flash。模型 ID 建议直接从 AIHubMix 模型列表复制。

​

前端界面配置 AIHubMix 模型

打开 WorkBuddy，在输入框右下角点击当前模型选择器，例如 Auto。也可以从「设置 → 模型」（英文界面为 Settings → Models）进入同一页面。

把模型列表拉到底部，点击「配置自定义模型」（英文界面为 Configure custom models）。

点击「+ 添加模型」（英文界面为 Add Model），然后在 Provider 下拉框里选择 Custom。

接着填写这几项：

• Endpoint：通常填 https://aihubmix.com/v1。如果主地址暂时不可用，改成备用地址 https://api.inferera.com/v1。
• 「自定义协议」开关：保持关闭（默认即为关闭）。关闭时平台会自动补全 /chat/completions，因此 Endpoint 只需填写 https://aihubmix.com/v1。
• API Key：填你在 AIHubMix 控制台 创建的 Key。
• Model Name：填要用的模型 ID，例如 gpt-5.5。
• Advanced Settings：按模型能力勾选。需要工具调用就开 Tool Calling；模型支持看图就开 Image Input；推理模型可以开 Reasoning。

填好后点击 Save。

保存后回到模型列表，在 Custom Models 区域选择刚添加的模型。

​

通过配置文件添加模型

WorkBuddy 的自定义模型会保存到本地 models.json。如果不想从前端界面里逐项填写，可以编辑这个文件：

%USERPROFILE%\.workbuddy\models.json

在 macOS 和 Linux 上，路径是 ~/.workbuddy/models.json。旧路径 ~/.codebuddy/models.json（Windows 下为 %USERPROFILE%\.codebuddy\models.json）仍然可用。

文件内容是一个模型数组。下面是 AIHubMix 的示例配置：

[
  {
    "id": "gpt-5.5",
    "name": "gpt-5.5",
    "vendor": "Custom",
    "url": "https://aihubmix.com/v1",
    "apiKey": "sk-***",
    "supportsToolCall": true,
    "supportsImages": true,
    "supportsReasoning": true,
    "useCustomProtocol": false
  }
]

如果当前 API 主地址不可用，把 url 改成备用地址即可：

"url": "https://api.inferera.com/v1"

字段含义和前端界面里的选项基本一致：id / name 填模型 ID，vendor 使用 Custom，apiKey 填 AIHubMix Key，supportsImages 对应 Image Input，supportsToolCall 对应 Tool Calling，supportsReasoning 对应推理模式，gpt-5.5 支持（思考过程由服务端隐藏，仅计入用量），保持 true。useCustomProtocol 对应「自定义协议」开关，false 表示关闭，此时平台会自动补全 /chat/completions，保持 false 即可。改完后重启 WorkBuddy，或重新打开模型选择器查看。

​

验证效果

选中自定义模型后，发一条简单消息测试一下，比如让 WorkBuddy 简短介绍 AIHubMix。能正常回复，就说明配置已经生效。

如果配置时开启了 Image Input，可以再上传一张图片，让 WorkBuddy 根据图片内容回答。这样能顺手确认图片输入能力已经生效。

​

常见问题

为什么要选择 Custom？ AIHubMix 提供的是 OpenAI 兼容接口，需要手动填写 Endpoint、API Key 和 Model Name。选择内置供应商时，WorkBuddy 可能会自动使用对方平台自己的接口地址。

保存后看不到模型怎么办？ 重新打开模型选择器，滑到 Custom Models 区域。如果还是没有出现，检查是否点了 Save，以及 Model Name 是否为空。手动改配置文件时，检查 %USERPROFILE%\.workbuddy\models.json 是否是合法 JSON。

请求失败怎么办？ 检查 Endpoint 是否带 /v1，API Key 是否完整，Model Name 是否和 AIHubMix 模型 ID 一致。若主地址不可用，可将 Endpoint 改为 https://api.inferera.com/v1。

更新时间：2026-10-27