WorkBuddy 接入

适用于支持图形化自定义模型配置的 WorkBuddy 桌面版本。下面按官方模型配置文档中的入口说明，实际界面可能随版本变化。

1. 打开模型设置

进入 设置 > 模型，添加自定义模型。在提供商接入方式中选择 自定义 API，服务不在预设列表时选择 自定义 / Custom。

对话中的模型选择器也有自定义模型分组，可以从那里进入配置界面。

2. 填写连接信息

字段	填写内容
URL	https://api.keenkind.ai/v1
API Key	你的 KeenKind API 密钥
模型名 / 模型 ID	模型目录中的实际 id
显示名称（如有）	可填写 KeenKind 加上模型名称，方便辨认

选择已确认支持 Chat Completions 和工具调用的模型。如果界面要求设置工具调用、图片输入等能力标记，请按模型的实际能力填写。

3. 保持标准路径设置

自定义协议开关先保持关闭。按 WorkBuddy 官方说明，关闭时会校验并自动补全标准 /chat/completions 路径；上面的地址对应完整请求为：

https://api.keenkind.ai/v1/chat/completions

如果你确实需要开启自定义协议，则 URL 要填写上面的完整请求地址，因为开启后会跳过路径自动补全。两种方式选择一种，避免重复拼接路径。

4. 保存并验证

保存配置后，在对话模型选择器的自定义模型分组中选中新模型。打开一个小项目，让它读取 README 并说明启动方式，再到用量记录核对调用。

自定义模型的消耗由 KeenKind 账户结算，不应拿 WorkBuddy 内置模型的积分余额判断这条连接的可用量。

现象	先检查
找不到自定义模型入口	当前版本是否支持图形化配置；保存版本号后联系支持确认
404	自定义协议开关与 URL 是否匹配，实际路径是否重复拼接
能聊天但不能执行代码任务	模型是否支持工具调用，能力设置与本地项目权限是否正确
401 / 403 或额度错误	Key、账户权限与 Key 使用上限，参见 API 常见问题

配置方法依据 WorkBuddy 官方模型配置文档，资料核对日期：2026-10-18。