准备配置信息
开始前，准备好下列参数和一个 AIGOKEY 实际支持的模型 ID。模型名称请以 AIGOKEY 控制台或模型列表为准。
AIGOKEY仅在当前 WorkBuddy 版本提供该字段时填写。https://llm.aigokey.cn/v1/chat/completions必须填写完整的 OpenAI 兼容接口地址。sk-你的API密钥粘贴完整密钥，不要加空格或引号。实际支持的模型 ID不要直接照抄教程截图中的示例。打开 WorkBuddy 设置
启动 WorkBuddy，点击左下角的头像或账户区域，然后在弹出菜单中选择“设置”。
进入模型管理
在设置窗口左侧找到并点击“模型”，进入自定义模型管理页面。
添加自定义模型
在“自定义模型”区域点击右上角的“添加模型”，再从提供商列表的“其他”分组选择“自定义 / Custom”。
填写 AIGOKEY 配置
在添加模型窗口中按下表填写。截图所示版本没有单独的显示名称字段，保持提供商为“自定义 / Custom”即可。
自定义 / Customhttps://llm.aigokey.cn/v1/chat/completionssk-你的API密钥AIGOKEY 实际支持的模型 ID高级配置怎么选
只勾选当前模型确实支持的能力。
工具调用模型支持 Function Calling 或 Tool Calling 时勾选。
图片输入模型支持视觉理解时勾选。
推理模式模型支持推理或思考模式时勾选。
思考选项“仅思考模式”、“允许关闭思考”和思考强度应按模型实际能力设置。
Token 数不确定时保留提供商默认值。
自定义协议使用标准 /v1/chat/completions 接口时保持关闭。
只有服务使用非标准路径，并且需要 WorkBuddy 完全按所填 URL 发起请求时，才开启该选项。
选择并测试模型
保存成功后，关闭设置窗口并回到新建任务页面。
- 点击输入框右下角当前显示的模型名称，例如 Auto。
- 在列表中找到刚刚添加的模型 ID。
- 选中该模型并新建一个任务。
- 输入“你好，请介绍一下你自己”，检查是否正常返回结果。
如需接入多个 AIGOKEY 模型，重复“添加模型”步骤，并为每个模型填写准确的模型 ID。
常见问题
根据错误提示先检查对应字段，再保存配置并重新测试。
保存时提示接口地址不正确
确认填写的是完整地址 https://llm.aigokey.cn/v1/chat/completions，而不是只有域名；同时保持“自定义协议”关闭。
请求返回 401 或鉴权失败
检查 API Key 是否完整、有效，粘贴时不要带空格或引号。如果密钥可能泄露，请立即在 AIGOKEY 后台作废并生成新密钥。
提示模型不存在
“模型名称”必须是接口能够识别的真实模型 ID。请回到 AIGOKEY 模型列表核对拼写。
对话正常，但图片或工具调用失败
高级能力选项可能与模型实际能力不一致。编辑该模型，关闭不支持的“图片输入”、“工具调用”或“推理模式”后重新测试。
安全与费用说明
根据 WorkBuddy 官方文档，自定义模型配置和 API Key 仅保存在本地，不会作为模型配置上传到 WorkBuddy 云端。
%USERPROFILE%\.workbuddy\models.json发起任务后，输入内容会由 WorkBuddy 转发到你配置的第三方模型服务，并按照第三方服务的规则处理。
使用 AIGOKEY 产生的 Token、订阅或其他费用由 AIGOKEY 侧结算。请勿在公开截图、聊天记录或共享文档中暴露真实密钥，并留意账户用量与费用变化。
- 接口地址包含 /v1/chat/completions
- API Key 完整且未泄露
- 模型 ID 与 AIGOKEY 列表一致
- 高级能力只勾选模型支持项
- “自定义协议”保持关闭
- 已新建任务并完成测试