WorkBuddy 配置方法

WorkBuddy 是腾讯推出的本地 AI 工作台，支持通过自定义模型接入 OpenAI Chat Completions 兼容接口。完成配置后，可以在 WorkBuddy 的对话、任务与 Agent 工作流中使用 wylon 已上线的对话模型。

1. 添加模型

WorkBuddy 通过可视化界面管理自定义模型，无需手动编辑配置文件。

1. 安装并打开 WorkBuddy，登录后进入设置（Settings）。
2. 在 Features 分组中选择模型 / Models。
3. 点击右上角添加模型 / Add Model。
4. 按下表填写模型信息。
5. 点击测试连接 / Test connection。出现 Connection succeeded 表示地址、密钥与模型 ID 均有效。
6. 点击保存 / Save。模型将出现在 Custom Models 列表中，并标记为 Custom。

接口地址与自定义协议

WorkBuddy 默认使用标准 /chat/completions 路径，会在接口地址后自动校验和补全路径。推荐填写：

https://api.wylon.cn/v1

同时保持自定义协议 / Custom Protocol 关闭。

如果开启自定义协议，WorkBuddy 将不再自动补全路径。此时必须填写完整端点：

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

模型名字段

模型名会直接作为 wylon API 的 model 参数发送。请从 模型广场或 GET /v1/models 复制完整 ID，不要自行缩写。

2. 选择模型并验证

1. 返回 WorkBuddy 新建任务页面。
2. 打开页面底部的模型选择器。
3. 在 Custom models 分组中选择添加好的模型，例如 ZhipuAI/GLM-5.3。
4. 先发送一条简单消息确认链路。模型正常返回内容，且回复下方标注 ZhipuAI/GLM-5.3，即表示配置成功。

3. 配置文件位置

自定义模型保存后，配置会写入本地文件：

该路径也显示在「设置 → 模型」页面的说明文字中，请以当前客户端实际显示为准。文件由客户端自动生成和维护，日常配置优先使用可视化界面，仅在排查故障时检查文件内容。

4. 更换其他模型

1. 访问 模型广场，或请求 GET https://api.wylon.cn/v1/models。
2. 复制模型的完整 API ID。
3. 在 WorkBuddy 的「设置 → 模型」页面新增模型，或点击已有模型的编辑图标。
4. 保留相同接口地址和 API Key，只替换模型名。