WorkBuddy 使用指南

WorkBuddy 是腾讯推出的桌面 AI Agent 工作台，支持本地文件处理、Skills、MCP、自动化任务和自定义模型。它可以通过 OpenAI-compatible 接口接入 TokenFlux。

下载与安装

打开 WorkBuddy 官方下载页；也可以先访问国内官网或海外官网。
选择与设备匹配的安装包：
- Apple Silicon Mac：选择 arm64。
- Intel Mac：选择 x64。
- Windows：选择 Windows 安装程序。
- 统信 UOS / 银河麒麟：按官网下载页指引，从系统应用商店安装。
macOS 打开下载的 DMG，将 WorkBuddy.app 拖入 Applications；Windows 按安装程序提示完成安装。
第一次启动时，WorkBuddy 会准备本地运行环境。保持网络连接并等待应用自动进入欢迎页，不要在此阶段强制退出。

环境准备完成后会显示欢迎页。点击登录继续。

接入 TokenFlux

1. 准备 API Key

按创建 API Key 教程创建一张 Key，并在模型广场确认该 Key 所在分组支持的模型 ID。

2. 打开自定义模型设置

头像或账户菜单。
系统设置。
模型。
点击 添加模型。

进入模型后可以看到本地配置文件路径和 添加模型 按钮。

WorkBuddy 会在模型页面显示实际的本地配置文件路径。WorkBuddy 桌面版通常使用 ~/.workbuddy/models.json；官方模型配置文档还说明了已有 ~/.codebuddy/models.json 配置的兼容迁移。

3. 填写模型配置

在提供商列表底部选择 自定义 / Custom。WorkBuddy 的自定义入口目前只支持 OpenAI-compatible API，TokenFlux 可以直接使用这一入口。

WorkBuddy 添加模型时在提供商列表中选择自定义 Custom，目标选项已用红框标出

填写配置项：

配置项	建议值
提供商	`自定义 / Custom`
接口地址	`https://tokenflux.dev/v1/chat/completions`
API Key	TokenFlux API Key
模型名称	模型广场显示的精确模型 ID，例如 `gpt-6-astra`
工具调用	开启；`gpt-6-astra` 支持 Tool Calling
图片输入	开启；允许 WorkBuddy 向模型发送图片
思考模式	开启；使用 `gpt-6-astra` 的 reasoning 能力
自定义协议	保持关闭，使用 OpenAI Chat Completions 兼容协议

WorkBuddy 中已填写 TokenFlux 接口和 gpt-6-astra 模型的自定义模型表单，必填项已用红框标出

使用完整接口地址

直接填写以 /chat/completions 结尾的完整地址。WorkBuddy 5.3.5 不会自动为 /v1 补全请求路径。

不要为 TokenFlux 开启自定义协议

开启后 WorkBuddy 会跳过标准 OpenAI Chat Completions 路径校验。该选项用于非标准网关或代理路径，TokenFlux 的标准 OpenAI-compatible 接口不需要开启。

如果使用复合 Key，模型名称还要带上分组前缀，例如 GPT/gpt-6-astra。前缀和模型 ID 必须与复合 Key 映射完全一致。

4. 保存并验证

点击保存。模型会写入 WorkBuddy 模型页面显示的本地配置文件。
保存后，确认 gpt-6-astra 出现在 已保存模型 中。
返回新任务，打开模型选择器，在 自定义模型 中选择 gpt-6-astra。
发送一条消息，例如 你好，确认所选模型能够回复。
基础对话验证成功后，再测试需要工具调用的任务，例如让 WorkBuddy 在一个临时目录中创建文本文件并读取回来。

常见问题

保存后找不到模型

重新打开模型选择器或新建任务。如果使用企业账号，管理员可能禁止成员添加个人自定义模型，需要联系企业管理员确认策略。

Agent 不会调用工具

编辑该模型并确认 工具调用 已开启，同时确认上游模型本身支持 Tool Calling。只开启客户端选项不能给不支持工具的模型增加该能力。

WorkBuddy 使用指南 ​

下载与安装 ​

登录 ​

接入 TokenFlux ​

1. 准备 API Key ​

2. 打开自定义模型设置 ​

3. 填写模型配置 ​

4. 保存并验证 ​

常见问题 ​

保存后找不到模型 ​

Agent 不会调用工具 ​

相关入口 ​