WorkBuddy

WorkBuddy 是腾讯云代码助手团队开发的桌面智能体办公应用，支持通过 OpenAI 兼容的 Chat Completions 协议接入外部模型。

方式一：图形界面配置

1. 打开 WorkBuddy，点击右上角账户菜单，进入 设置 → 模型。
2. 点击 添加模型，在类型中选择 自定义。
3. 填入完整接口地址 https://console.anystarx.com/v1/chat/completions、有效 API Key 以及控制台中的完整模型 ID，点击保存。

方式二：编辑 models.json 配置文件

打开或创建用户级配置文件：

~/.workbuddy/models.json

若当前项目根目录下存在 <项目根目录>/.workbuddy/models.json，则其配置优先级高于用户主目录配置。

在文件中写入以下模型配置：

{
  "models": [
    {
      "id": "MODEL_ID",
      "name": "AnyStarX Model",
      "vendor": "Custom",
      "url": "https://console.anystarx.com/v1/chat/completions",
      "apiKey": "${ANYSTARX_API_KEY}",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": false
    }
  ],
  "availableModels": ["MODEL_ID"]
}

将 MODEL_ID 替换为控制台模型列表中的完整 ID。apiKey 字段支持使用 ${ANYSTARX_API_KEY} 语法引用系统环境变量，避免在磁盘文件中保留明文凭据。

配置要点：

• 文件格式必须保存为 UTF-8（无 BOM） 编码。
• 编辑并保存文件后，需要完全退出并重新启动 WorkBuddy 使新配置加载生效。
• 关联的 CodeBuddy 工具共享相同的配置语法，对应的配置文件路径为 ~/.codebuddy/models.json。

配置生效与验证

重启应用后，在会话窗口底部的模型下拉列表中选中刚配置的模型，发送测试指令进行验证：

请用一句话确认：AnyStarX WorkBuddy 配置成功。

常见问题排查

• 模型未展示在可用列表中：检查 models.json 语法是否合法（特别是末尾是否有不规范逗号），确认文件编码为 UTF-8 无 BOM，并确认已重新启动应用。
• 提示鉴权错误：确认 ${ANYSTARX_API_KEY} 环境变量已在系统环境中导出，或在配置文件中直接填入密钥明文进行排查。
• 提示 404 错误：核对 url 参数，确认完整包含了 /chat/completions 后缀。