WorkBuddy 接入指南

在 WorkBuddy 中通过自定义 API 接入 TokenPlus，配置模型并验证任务调用。

本文依据 WorkBuddy 官方模型配置文档，介绍如何在桌面客户端中通过自定义 API 使用 TokenPlus 模型，无需手动编辑配置文件。

第一步：准备 WorkBuddy 和 TokenPlus API

从 WorkBuddy 官网下载并安装桌面客户端，登录后，按照 TokenPlus 快速入门完成注册、实名认证、充值和项目 API 密钥创建。

进入 TokenPlus 模型广场，选择支持 OpenAI Chat Completions 的模型，并复制完整模型调用标识。需要 WorkBuddy 执行工具或文件任务时，还应确认模型支持工具调用。

配置项	填写内容
提供商	`自定义 / Custom`
URL / 接口地址	`https://api.tokenplus.cn/v1/chat/completions`
API Key	在 TokenPlus 项目空间创建的完整 API 密钥
模型名 / 模型 ID	从 TokenPlus 模型详情页复制的完整模型调用标识
自定义协议	保持关闭，使用标准 Chat Completions 路径

本教程使用「自定义 / Custom」接入，不是腾讯云 Token Plan 或其他服务商的 Coding Plan。不要把 TokenPlus 密钥填入这些预置套餐的配置中。

第二步：打开自定义模型配置

点击 WorkBuddy 左侧边栏底部的头像，在用户菜单中选择「设置」。
在设置面板中选择「模型」。
在「自定义模型」区域点击「添加模型」。

在提供商选择中选择「自定义 / Custom」，而不是仅选择名称相似的预置服务商。

填写上表中的接口地址、API Key 和「模型名称」，点击「测试连接」。看到「连接成功」后，点击「保存」。

模型名用于请求时，应填写 TokenPlus 的完整模型调用标识，不要只填写展示名称。若界面另外提供显示名称字段，可以填写便于识别的名称，例如 TokenPlus - 模型名称。

本文截图来自 WorkBuddy AI 5.7.6，密钥已隐藏。截图中的模型仅用于演示，实际可用模型及能力以 TokenPlus 模型详情为准。

第三步：检查接口路径和能力

接口路径

本教程在 WorkBuddy 的 URL 字段填写完整请求地址：

https://api.tokenplus.cn/v1/chat/completions

它与其他客户端常用的 Base URL https://api.tokenplus.cn/v1 不同，请不要混淆。

WorkBuddy 默认会校验并补全标准 /chat/completions 路径。TokenPlus 使用标准接口，因此保持高级配置中的「自定义协议」关闭即可；核对最终请求地址中 /v1 和 /chat/completions 均只出现一次。

「自定义协议」开启后会直接请求填写的 URL，跳过路径校验与补全。本教程不需要开启该选项，也不需要修改 TokenPlus 的标准接口路径。

模型能力

按 TokenPlus 模型详情核对工具调用、图片输入、推理及上下文限制。标准供应商的自动能力标记不能替代对自定义模型的能力检查；如果配置界面提供相关选项，请按实际支持情况填写。

不要因为 WorkBuddy 提供更大的上下文窗口或思考强度选项，就设置超过模型上限的值。长会话与多步骤任务可能产生多次模型调用，较大的上下文也可能增加 Token 消耗，请按需要使用。

第四步：选择模型并验证

回到任务对话界面，打开模型选择器，在「自定义模型」分组中选择刚刚添加的 TokenPlus 模型。

发送简单测试消息：

请列出整理一份会议纪要需要的三个步骤，暂时不要创建或修改文件。

收到正常回复后，再尝试有明确范围的任务。例如，在测试目录中整理一份不含敏感信息的文本。首次验证时不要授权修改重要文件、批量删除数据或访问不需要的目录。

进入 TokenPlus 的调用日志，核对请求结果、实际模型及费用。能在日志中看到对应请求，有助于确认任务使用了 TokenPlus 自定义模型。

管理模型和密钥

WorkBuddy 支持在模型设置中添加、编辑和删除自定义模型。密钥轮换后，请更新对应配置并重新验证；不再使用时，可以删除客户端配置并在 TokenPlus 停用密钥。

按照 WorkBuddy 官方说明，自定义模型配置及 API Key 保存在本地。请妥善保护本机和配置文件，不要将包含密钥的文件、截图或备份上传到公开仓库。

接入 TokenPlus 不代表对话内容不离开设备。发送任务时，所选模型需要的输入会经 TokenPlus 接口处理；涉及文件或敏感内容时，请结合数据策略及项目要求决定是否发送。

常见问题

没有找到自定义模型入口

确认使用的是支持自定义模型配置的 WorkBuddy 桌面客户端，而不是移动端或小程序。入口以当前版本的官方文档和实际界面为准。

连接失败或返回 404

检查 URL 是否为 https://api.tokenplus.cn/v1/chat/completions，是否存在重复路径、缺少 /v1 或多余空格。确认没有将本教程配置为其他 API 协议。

提示密钥无效、模型不存在或额度不足

检查 TokenPlus 密钥是否完整、有效，模型 ID 是否与平台提供的调用标识一致，以及账户余额、项目预算和密钥消费限额。错误原因可结合 TokenPlus 调用日志排查。

普通问答成功，但任务执行失败

检查模型是否支持工具调用，以及 WorkBuddy 的任务权限和能力设置。图片、推理或上下文相关错误，应按模型详情调整，不要通过开启无关协议开关解决。

自定义模型如何计费？

WorkBuddy 官方说明，自定义模型产生的模型服务费用由用户向第三方支付。本教程接入的请求由 TokenPlus 结算，可在 TokenPlus 用量分析和账单中查看；WorkBuddy 内置模型的积分或套餐不能抵扣 TokenPlus 调用费用。

自动化和多步骤任务可能持续调用模型，建议为专用 API 密钥设置合理的消费限额，并关注用量。