跳转到内容
NoviaHub 文档

桌面应用

WorkBuddy

在腾讯 WorkBuddy 的「设置 → 模型」里用「自定义」方式接入 NoviaHub 的模型。

腾讯 WorkBuddy 是一款桌面端 AI 智能体工作台。官方介绍：它面向各种职场角色，你用一句话描述需求，它就会像同事一样自主规划并执行任务，交付可以核查的结果。它内置了多种模型，也支持在「设置 → 模型」里添加自定义模型。本页用「自定义」方式接入 NoviaHub，走 OpenAI 兼容的 /chat/completions 接口。

前提条件

Section titled “前提条件”
  • 有一个 NoviaHub 账户，并且已经创建了 API 密钥，见 API 密钥。
  • 账户里有余额，见 钱包与充值。
  • 已安装 WorkBuddy 并登录 WorkBuddy 账号。

安装 WorkBuddy

Section titled “安装 WorkBuddy”

WorkBuddy 支持 macOS（Apple Silicon 和 Intel）和 Windows（x64 和 ARM64）。安装方法见官方的 Mac 安装指南 和 Windows 安装指南。

以 macOS 为例：

  1. 下载 .dmg 安装包并打开，把 Tencent WorkBuddy 图标拖进「应用程序」文件夹。
  2. 第一次打开时，如果 macOS 提示「无法打开，因为它来自身份不明的开发者」，到 系统设置 → 隐私与安全性，往下找到并点击「仍要打开」，再确认「打开」。
  3. 打开后点击登录，按提示完成登录。

配置 NoviaHub

Section titled “配置 NoviaHub”

  1. 打开 WorkBuddy 的 设置 → 模型 页面，在「自定义模型」区域点击 添加模型。

  2. 在「供应商（仅支持 OpenAI 兼容协议 API）」下拉框里选择 自定义。

  3. 按下表填写：

    项目 填写内容
    接口地址 https://noviahub.com/v1/chat/completions
    API Key 你的 NoviaHub 密钥（以 sk- 开头）
    模型名称 NoviaHub 上的模型 ID，例如 deepseek-v4-flash

  4. （可选）展开 高级配置，按模型的能力勾选：

    • 工具调用：应用内的说明是「允许模型调用智能体运行时暴露出来的工具和函数」。
    • 图片输入：模型详情的「输入类型」里有图片时再勾选。
    • 自定义协议：保持不勾选即可，原因见下方说明。

  5. 点击 测试连接，显示「连接成功」后，点击 保存。配置保存在本机。

验证

Section titled “验证”

上一步的「测试连接」会真实发送一次很短的请求（程序代码里限定最多输出 1 个 token），会在 NoviaHub 上产生一笔很小的费用。也可以直接在对话里验证：

  1. 在对话界面的模型选择器里，找到自定义模型所在的分组，选中刚才添加的模型。

  2. 发一句简单的话，例如「用一句话介绍你自己」。收到回复，说明配置成功。

  3. 到 NoviaHub 控制台的 使用日志 查看这次调用和费用。

切换和添加模型

Section titled “切换和添加模型”
  • 在对话界面的模型选择器里切换模型。
  • 回到 设置 → 模型，再添加一个自定义模型即可使用其他模型，接口地址和 API Key 照填，只改模型名称。
  • 这里用的是 Chat Completions 接口，请选择在 模型&价格 上带有「Chat」标签的模型。2026-09-28 线上的全部模型都带有这个标签。

常见问题

Section titled “常见问题”

「测试连接」提示「API Key 无效或没有权限访问该模型」 WorkBuddy 收到 401 或 403 时都会显示这句话。对 NoviaHub 来说，401 表示密钥写错，或已被禁用、已过期、额度已用完，见 API 密钥 · 密钥的四种状态；403 表示账户余额不足（insufficient_user_quota，先充值），或者这把密钥设置了模型限制、IP 白名单，见 API 密钥。

「测试连接」提示「无法连接到模型服务」 检查接口地址是否写对、电脑能否访问 https://noviahub.com。

注意事项

Section titled “注意事项”
  • 密钥只保存在本机。 按官方说明，自定义模型的配置（包括 API Key）只保存在本地的 workbuddy/models.json 里，不会上传到云端。
  • 费用由 NoviaHub 收取。 使用自定义模型时，WorkBuddy 只负责把你的输入转发给你配置的模型服务，调用费用从你的 NoviaHub 余额中扣除。
  • 旧配置仍然有效。 以前通过 ~/.codebuddy/models.json 配置的自定义模型，升级后仍然能用，也可以在界面里查看、编辑或删除。

参考资料

Section titled “参考资料”

以下资料查阅于 2026-09-28 至 2026-09-29：