发布日期2026-08-10 | 适用版本WorkBuddy 最新版 | 话题WorkBuddy 自定义模型 · API 配置 · 模型自由WorkBuddy 的自定义模型功能允许用户将任意兼容 OpenAI 协议的第三方 API 接入到 WorkBuddy 的对话和 Agent 工作流中跳过内置积分消耗、直接调用自己的模型额度配置信息仅存储在本地~/.workbuddy/models.json文件中不上传云端。无论是 DeepSeek 官方 API、Kimi、GLM还是本地跑的 Ollama只要提供商支持 OpenAI 兼容格式就可以接进来。为什么要接自定义模型WorkBuddy 内置了 Hy3、GLM-5.2、Kimi-K3 等模型使用时按积分计费。当你在以下情况时接自定义模型更合适已有 DeepSeek、Kimi 或其他平台的 API 额度不想重复付费需要调用 WorkBuddy 内置列表里没有的模型比如某个微调版本使用 Ollama 在本地跑开源模型完全不走外网希望接入一个能统一管理多款模型的 API 中间层一个 Key 切换多模型自定义模型接入后费用由你直接向对应提供商支付与 WorkBuddy 积分完全独立。方式一图形界面操作推荐新手整个流程只需 3 步不用碰任何配置文件。第一步打开配置入口在 WorkBuddy 主界面点击底部的模型选择器默认显示当前使用的模型名在弹出的模型列表最底部找到**「配置自定义模型」**点击进入。第二步添加模型选择提供商进入「模型」设置页后点击右上角**「 添加模型」**。弹出「添加模型」对话框顶部标注「仅支持 OpenAI 兼容协议 API」。点击「提供商」下拉看到已预设的选项分类可选提供商Coding PlanKimi Coding Plan自定义 API智谱开放平台 / GLM API、Kimi 中国版、MiniMax 中国版、深度求索 / DeepSeek、Ollama 本地其他自定义 / Custom接入任意兼容接口选择预设提供商时接口地址会自动填入只需补上 API Key 即可保存。选择**「自定义 / Custom」**时需要手动填写所有字段见第三步。第三步填写接口信息并保存选择「自定义 / Custom」后表单展开四个字段接口地址填写提供商的 chat completions 端点格式为https://api.example.com/v1/chat/completionsAPI Key填入你在对应平台申请的密钥以sk-开头。模型名称填写模型的参数名即调用时传给 API 的model字段值。例如DeepSeek 官方deepseek-chat或deepseek-reasonerKimimoonshot-v1-8k或kimi-k2Ollama 本地llama3.2或qwen2.5:7b与ollama list输出一致填写完成后点**「保存」**模型会出现在 WorkBuddy 的模型选择器列表中可直接使用。方式二直接编辑 models.json适合批量配置如果需要一次添加多个模型或者通过脚本管理配置可以直接编辑本地文件macOS / Linux~/.workbuddy/models.jsonWindowsC:\Users\用户名\.workbuddy\models.json文件格式示例{models:[{id:deepseek-chat,name:DeepSeek Chat,vendor:DeepSeek,apiKey:sk-你的密钥,url:https://api.deepseek.com/v1/chat/completions,supportsToolCall:true,supportsImages:false},{id:qwen2.5:7b,name:Qwen 2.5 7B本地,vendor:Ollama,apiKey:ollama,url:http://localhost:11434/v1/chat/completions,supportsToolCall:false,supportsImages:false}]}字段说明字段必填说明id是传给 API 的 model 参数值name是下拉列表显示名称自行定义vendor是厂商标识自行填写apiKey是API 密钥Ollama 本地填ollamaurl是完整的 chat completions 地址supportsToolCall否是否支持工具调用默认 falsesupportsImages否是否支持图片输入默认 false文件保存后 WorkBuddy 会自动热重载约 1 秒延迟无需重启。高级配置选项解读图形界面的「高级配置」区域有四个选项影响模型在 WorkBuddy 内的调用行为工具调用勾选后WorkBuddy 的 Agent 和技能Skills可以让该模型调用外部工具搜索、代码执行等。模型本身需支持 Function Calling否则勾了也没效果。图片输入勾选后在对话中可以上传图片让该模型分析。需要模型为多模态视觉模型纯文本模型开了会报错。思考模式勾选后触发模型的推理链路类似 DeepSeek-R1 的think过程。仅对支持此特性的模型有意义如 DeepSeek Reasoner、某些 Kimi 版本。自定义协议勾选后WorkBuddy 直接使用你填写的接口地址原样发请求跳过自动路径补全。适用于通过 API 网关封装的非标准端点或接口地址末尾不是/chat/completions的情况。上下文窗口手动指定该模型的输入/输出 token 上限供 WorkBuddy 内部管理对话截断逻辑。不清楚可留空使用提供商默认值。各常用平台接口地址速查提供商接口地址模型名称示例DeepSeek 官方https://api.deepseek.com/v1/chat/completionsdeepseek-chat智谱 GLMhttps://open.bigmodel.cn/api/paas/v4/chat/completionsglm-5-plusKimi 中国版https://api.moonshot.cn/v1/chat/completionsmoonshot-v1-8kMiniMaxhttps://api.minimax.chat/v1/text/chatcompletion_v2MiniMax-Text-01Ollama 本地http://localhost:11434/v1/chat/completions与ollama list一致七牛云多模型 APIhttps://api.qnaigc.com/v1/chat/completions参考平台模型列表使用统一多模型 API 中间层的好处是一个 Key、一个地址WorkBuddy 里只需配置一次就能切换不同模型无需为每家提供商单独管理密钥。常见问题Q接入后显示「模型调用失败」怎么排查按顺序检查① 接口地址末尾是否有多余斜杠或路径错误② API Key 是否复制完整常见问题末尾空格③ 模型名称是否与提供商文档一致大小写敏感④ 如果接口地址不是标准/chat/completions结尾需要勾选「自定义协议」。QOllama 本地模型怎么接先确保 Ollama 已在本地运行ollama serve然后在 WorkBuddy 中选预设的「Ollama 本地 / Ollama」提供商接口地址自动填为http://localhost:11434/v1/chat/completionsAPI Key 填ollama模型名称填ollama list列出的模型名如llama3.2:latest。Q接自定义模型会消耗 WorkBuddy 积分吗不会。自定义模型的请求直接发往你填写的第三方接口费用由你向该提供商支付与 WorkBuddy 积分完全独立。Qmodels.json 里的 API Key 安全吗配置仅存在本地WorkBuddy 不会上传任何自定义模型信息到云端。但 models.json 是明文 JSON建议不要将该文件同步到公共 Git 仓库也不要分享给他人。小结WorkBuddy 的自定义模型功能本质上是一个兼容 OpenAI 协议的 API 转接层只要提供商给出标准的chat/completions端点和 API Key三步就能完成接入。图形界面适合快速配置单个模型models.json 适合批量管理或脚本化部署。核心注意点模型名称必须与提供商文档一致高级配置里的工具调用和图片输入要与模型实际能力对齐否则勾了反而会导致调用出错。WorkBuddy 文档持续更新本文配置方式基于 2026 年 8 月版本如遇界面差异以官方文档codebuddy.cn/docs/workbuddy为准。延伸阅读WorkBuddy 官方模型配置文档https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model七牛云多模型 API 接入可直接用于 WorkBuddy 自定义模型https://www.qiniu.com/ai/models