首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >WorkBuddy内网DeepSeek模型配置实战教程

WorkBuddy内网DeepSeek模型配置实战教程

原创
作者头像
大圣喵
修改2026-06-18 14:30:59
修改2026-06-18 14:30:59
1741
举报

作者:大圣喵 适用版本:WorkBuddy 5.1.2(Windows) 场景:公司内网部署的 DeepSeek 模型接入 WorkBuddy

一、背景

我在钢铁企业负责能环管理与厂内物流工作,日常使用 WorkBuddy 处理文档、数据分析、合同审查等任务。公司 IT 在内网部署了一套 DeepSeek 模型服务(地址 http://10.193.200.210:1025),想在 WorkBuddy 中直接使用这个内网模型,减少网络延迟、保障数据不出企业内网。

本以为配置个 API 地址很简单,结果踩了一串坑——配置完模型不显示、显示了报 408 错误、能用了模型选单又只剩两个选项……花了近两个小时才彻底搞定。把这些坑整理出来,给同样在公司内网部署 AI 模型的兄弟们参考。

二、最终效果

配置完成后,WorkBuddy 模型选单中:

  • 所有内置模型正常显示(DeepSeek V4 Pro / Flash 等)
  • 多出一个"内网 DeepSeek"自定义选项
  • 切换即用,数据不出内网
内网专用模型
内网专用模型

三、完整配置步骤

第1步:找到模型配置文件

WorkBuddy 的自定义模型配置存储在:

代码语言:javascript
复制
C:\Users\<你的用户名>\.workbuddy\models.json

注意:旧版可能在 ~/.codebuddy/models.json,新版统一在 .workbuddy 目录下。如果文件不存在,直接新建一个即可。

发现配置的模型不能用
发现配置的模型不能用

第2步:写入正确格式的配置

错误示范(裸数组格式):

代码语言:javascript
复制
[
  {
    "id": "deepseek-v4-flash",
    "url": "http://10.193.200.210:1025/v1",
    "apiKey": "sk-local"
  }
]

正确格式(对象包装 + 完整字段):

代码语言:javascript
复制
{
  "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

不填

一旦填写这个字段,会限制模型选单只显示列出的模型

采用第一种模式修复
采用第一种模式修复

第3步:验证内网 API 是否可达

开 PowerShell,用一行命令测试内网服务:

代码语言:javascript
复制
@'
{"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 超时则检查下一节。

第4步:重启 WorkBuddy

重要:必须完全退出(系统托盘右键 -> 退出),只关窗口不算退出。重启后在模型选单中就能看到自定义模型了。

四、常见问题排障

问题1:代理拦截(最坑的坑)

症状:模型能选到,但发送消息后报错,错误信息中包含公司代理地址(如 proxy: http://10.2.190.41:8080)和 408 状态码。

原因:WorkBuddy 走系统代理访问内网 IP,公司代理无法转发到内网地址,导致超时。

解法:管理员 PowerShell 执行:

代码语言:javascript
复制
setx NO_PROXY "10.0.0.0/8,localhost,127.0.0.1"

然后完全退出 WorkBuddy 再重新打开。

修改以上内容
修改以上内容
但是依然不能用
但是依然不能用

问题2:配置后模型选单只剩很少模型

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

原来的模型丢失了
原来的模型丢失了

原因:models.json 中写了 availableModels 字段,限制了模型列表的展示范围。

解法:删除 availableModels 字段,WorkBuddy 会自动显示所有内置模型。

问题3:内网服务报 404 "model does not exist"

症状: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 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 一、背景
  • 二、最终效果
  • 三、完整配置步骤
    • 第1步:找到模型配置文件
    • 第2步:写入正确格式的配置
    • 第3步:验证内网 API 是否可达
    • 第4步:重启 WorkBuddy
  • 四、常见问题排障
    • 问题1:代理拦截(最坑的坑)
    • 问题2:配置后模型选单只剩很少模型
    • 问题3:内网服务报 404 "model does not exist"
  • 五、避坑总结
  • 六、总结
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档