
作者:大圣喵 适用版本:WorkBuddy 5.1.2(Windows) 场景:公司内网部署的 DeepSeek 模型接入 WorkBuddy
我在钢铁企业负责能环管理与厂内物流工作,日常使用 WorkBuddy 处理文档、数据分析、合同审查等任务。公司 IT 在内网部署了一套 DeepSeek 模型服务(地址 http://10.193.200.210:1025),想在 WorkBuddy 中直接使用这个内网模型,减少网络延迟、保障数据不出企业内网。
本以为配置个 API 地址很简单,结果踩了一串坑——配置完模型不显示、显示了报 408 错误、能用了模型选单又只剩两个选项……花了近两个小时才彻底搞定。把这些坑整理出来,给同样在公司内网部署 AI 模型的兄弟们参考。
配置完成后,WorkBuddy 模型选单中:

WorkBuddy 的自定义模型配置存储在:
C:\Users\<你的用户名>\.workbuddy\models.json注意:旧版可能在 ~/.codebuddy/models.json,新版统一在 .workbuddy 目录下。如果文件不存在,直接新建一个即可。

错误示范(裸数组格式):
[
{
"id": "deepseek-v4-flash",
"url": "http://10.193.200.210:1025/v1",
"apiKey": "sk-local"
}
]正确格式(对象包装 + 完整字段):
{
"models": [
{
"id": "deepseek-v4-flash",
"name": "内网 DeepSeek",
"vendor": "Custom",
"url": "http://10.193.200.210:1025/v1/chat/completions",
"apiKey": "sk-local",
"maxInputTokens": 128000,
"maxOutputTokens": 8192,
"supportsToolCall": true,
"supportsImages": true,
"supportsReasoning": true,
"useCustomProtocol": true
}
]
}关键字段说明:
字段 | 填什么 | 为什么 |
|---|---|---|
id | 内网服务能识别的模型名 | API 请求中 "model" 字段发这个值。我这里是 deepseek-v4-flash |
name | 自定义显示名 | 用 "内网 DeepSeek" 方便和内置版区分 |
url | 完整路径 | 必须是 /v1/chat/completions 结尾,只写 /v1 会导致请求失败 |
apiKey | 内网服务的 API Key | 很多内网部署不校验,随便填一个也行 |
maxInputTokens / maxOutputTokens | 根据模型能力填 | 不填可能导致模型行为异常 |
supportsToolCall | true | 开启工具调用能力 |
availableModels | 不填 | 一旦填写这个字段,会限制模型选单只显示列出的模型 |

开 PowerShell,用一行命令测试内网服务:
@'
{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"hi"}],"stream":false}
'@ > $env:TEMP\test.json
curl.exe -X POST http://10.193.200.210:1025/v1/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer sk-local" -d "@$env:TEMP\test.json"返回正常 JSON 响应说明服务没问题。返回 408 超时则检查下一节。
重要:必须完全退出(系统托盘右键 -> 退出),只关窗口不算退出。重启后在模型选单中就能看到自定义模型了。
症状:模型能选到,但发送消息后报错,错误信息中包含公司代理地址(如 proxy: http://10.2.190.41:8080)和 408 状态码。
原因:WorkBuddy 走系统代理访问内网 IP,公司代理无法转发到内网地址,导致超时。
解法:管理员 PowerShell 执行:
setx NO_PROXY "10.0.0.0/8,localhost,127.0.0.1"然后完全退出 WorkBuddy 再重新打开。


症状: 原来有十几种内置模型,配置后只剩一两个。

原因:models.json 中写了 availableModels 字段,限制了模型列表的展示范围。
解法:删除 availableModels 字段,WorkBuddy 会自动显示所有内置模型。
症状:API 返回 The model 'xxx' does not exist
原因:id 字段改了名字,和内网服务期望的模型名不匹配。
解法:把 id 改回内网服务能识别的模型名(如 deepseek-v4-flash),name 字段单独设置显示名即可。

易错点 | 正确做法 | 错误后果 |
|---|---|---|
models.json 裸数组格式 | 用 {"models":[...]} 对象包装 | 模型不显示 |
URL 写到 /v1 就停 | 补全 /v1/chat/completions | API 请求路径不对 |
忘了 NO_PROXY | 内网 IP 加到环境变量绕过代理 | 408 超时 |
availableModels 限制了 | 删掉它 | 选单只剩一两个模型 |
只关窗口没完全退出 | 右键托盘退出 | 配置不生效 |
WorkBuddy 接入内网私有模型本身不复杂,关键就三点:配置文件格式对、URL 路径写全、代理要绕开。配置好之后,内网模型和云端模型可以自由切换,既享受云端模型的完整能力,又能在敏感数据场景走内网链路。
如果这篇文章对你有帮助,欢迎点赞收藏。有问题可以在评论区交流~
本文首发于腾讯云开发者社区,未经授权请勿转载。#WorkBuddy #AI部署 #自定义模型
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。