Tencent WorkBuddy
Tencent WorkBuddy 支持通过“自定义 API”添加模型。接入 Geekit 时优先使用标准 OpenAI Chat Completions；只有当前客户端要求完整端点时，才启用自定义协议。
核验日期：2026-07-27
前置条件
- 已从 WorkBuddy 官方入口安装或更新支持自定义 API 的客户端并登录。
- 已取得 Geekit 根地址、用户令牌和模型 ID。
- 所选模型支持 Chat Completions 和任务需要的工具能力。
标准配置
在 WorkBuddy 的模型设置中添加“自定义 API”，保持“自定义协议”关闭，并填写：
标准模式会在基础地址后补全 Chat Completions 路径。保存前检查地址末尾只有一个 /v1。
使用完整端点
如果当前 WorkBuddy 版本明确要求完整请求地址，开启“自定义协议”，并填写：
自定义协议会直接请求所填 URL，不再自动补全路径。不要在标准模式中填写完整端点，否则可能出现重复的 /chat/completions。
验证连接
先使用 WorkBuddy 自带的连接检查，再新建会话执行一个只读最小任务。随后在 Geekit 调用日志中确认：
- 请求命中
/v1/chat/completions。 - 模型 ID 与 WorkBuddy 配置一致。
- 返回状态和 Token 统计正常。
- 流式输出、工具调用和文件任务符合模型实际能力。
WorkBuddy 官方页面没有给出所有模型的流式与工具调用兼容矩阵。连接成功只说明协议和凭证可用，不代表每个模型都能完成全部桌面任务。
常见问题
返回 404
检查“自定义协议”开关与 URL 是否匹配：关闭时填 /v1 基础地址，开启时填完整 /v1/chat/completions。
返回 401
重新粘贴 Geekit 用户令牌，确认没有前后空格。不要把令牌放进截图、项目文件或工单正文。
模型列表中找不到目标模型
WorkBuddy 可能不会自动同步 Geekit 模型列表。直接填写 /v1/models 返回的准确模型 ID。