前言¶
DSH 的模型调用默认直连官方渠道,自己充 Key、填地址。实验室场景里这两件事都麻烦:组里共用一份额度,成员机器 IP 又经常变——DHCP 一换地址,之前配好的接口地址就废了。
deliver0/dsh-labai-gateway 就是为这个场景做的插件。它由 Deliver0 维护,在本地起一个反代,DSH 只需连 127.0.0.1:8801,剩下的找网关、带 Key 的事交给插件;网关换 IP 后插件自行重新发现地址,用户侧配置不用动。分类是 admin-security。
下面介绍它的工作原理、安装流程和验证方式。
定位¶
一句话:管理员用一个组账号连 DeepSeek 官网,你的 DSH 通过网关借用这个组账号发请求。额度从组账号扣,网关记录每次是谁用的。
架构上分两层:
- 用户侧的插件跑在本机
127.0.0.1:8801,负责把请求转发给真正的网关,并把sk-lab-开头的成员 Key 注入进去。 - 网关机核对 Key 对应的成员和来源 IP,通过后以组账号请求官网,返回结果原路回去。
配置里不需要手动填网关地址,这正是它相对「自己填 API base URL」的做法省掉的一步。
核心功能¶
- 本机反代:插件在
127.0.0.1:8801提供 OpenAI 风格的/v1接口,DSH 里填这个地址即可,Key 由插件注入,不用自己填。 - 网关自动发现:网关主机 IP 变化或重启后,插件重新发现网关地址并连上,用户不需改任何配置。
- 单成员 Key:
sk-lab-开头,由管理员按姓名、邮箱、IP 发放,可与 IP 绑定。 - 按成员记用量:网关侧有「用量监控」,管理员能看到具体成员的调用次数和 token 用量。
- 提供
DeepSeek Flash、DeepSeek V4 Pro两个模型分组Lab436。 - 提供状态与刷新接口,见后面的排障一节。
前置条件¶
来自插件 README 的要求:
- Windows,已安装 DSH 0.2.1 或更新版本。
- 处于校园网内,不是手机热点或家庭宽带。
- 已向管理员拿到一把
sk-lab-开头的 Key。
插件的 package.json 声明 "engines": { "node": ">=20" },许可证为 MIT,当前版本 1.0.2。
安装前建议自己读一遍仓库里的 lib/ 和 bin/ 脚本,确认没有超出预期的行为。
安装¶
官方安装走下载脚本,仓库里没有给出 dsh plugin add 形式的命令。
第 1 步:查出自己的校园网 IP。
ipconfig | findstr /i "IPv4"
取 10.16 开头的那个地址,例如 10.16.35.101。127.0.0.1、192.168.x.x、172.x.x.x 都不是校园网地址;有多行时选「以太网」或「WLAN / 无线局域网」那一行,避开 VMware、VirtualBox、WSL 虚拟网卡。
第 2 步:把姓名、邮箱、刚查到的 IP 发给管理员,拿到 sk-lab- 开头的 Key。管理员若答复不用绑 IP,则只发姓名和邮箱即可。
第 3 步:完全退出 DSH。托盘图标右键退出,任务管理器里不应再有 DeepSeek Harness 进程;只点窗口右上角 × 不算退出。
第 4 步:下载安装脚本,双击运行。
https://github.com/Deliver0/dsh-labai-gateway/releases/latest/download/LabAI-Setup.bat
运行时按提示粘贴第 2 步拿到的 Key 回车。脚本会下载插件,缺渠道插件时会顺带装一个;出现「此文件不安全 / 未知发布者」提示,点「保留」→「仍要运行」。链接打不开时,从仓库首页绿色 Code → Download ZIP 下载,解压后双击 install.bat。
第 5 步:脚本末尾会显示:
申请已提交,正在等审批
看到这行就告诉管理员「我装好了」,等管理员在网关侧点通过。通过后重新打开 DSH 即可使用。
启用与验证¶
重新打开 DSH,新建对话,在模型选择里找到 Lab436 分组,里面有两个模型:
| 模型 | 什么时候用 |
|---|---|
DeepSeek Flash |
日常对话、写代码、改文档,回答快,便宜 |
DeepSeek V4 Pro |
数学、逻辑、长链条推理,会先想一段再回答,慢一些,也贵一些 |
DeepSeek Flash 与日常用的 v4.1-flash 是同一个模型。地址和 Key 插件已经配好,不用自己填。想切回原来的模型分组,直接换回去即可,两套互不影响。
验证是否真走实验室额度:随便问一句,能正常回答就算通了;再让管理员在「用量监控」里确认出现你的名字和调用次数。
有些工具非让填接口地址时:
地址 http://127.0.0.1:8801/v1
Key 随便填一个,或留空
排障¶
先打开状态页:
http://127.0.0.1:8801/__labai/status
- 返回里有
"ip": "10.16.x.x",说明已连上网关;其中approval为pending表示还没审批,继续等;approval为active仍报错,多半是本机 IP 变了。 - 返回
"ip": null,多半是没连校园网、网关主机没开机,或网关换到了新网段。
提示「这个 Key 不允许从 x.x.x.x 使用」,说明本机 IP 变了。重新执行 ipconfig | findstr /i "IPv4" 查新 IP,发给管理员换绑或重新报备。
想强制重新找一次网关:
http://127.0.0.1:8801/__labai/refresh
仍未解决就把 status 页截图发给管理员。注意:别自己改 DSH 里的地址,也别把 Key 转给别人。Key 绑了 IP 换机器就用不了,不绑 IP 的谁拿到都能用,用量会算在账号上。
卸载¶
双击插件目录里的 uninstall.bat,再重启一次 DSH。
适用场景与注意¶
适合实验室、课题组这类想共享一份 DeepSeek 额度、且成员机器 IP 会变动的 Windows 用户。前提是人在校园网内,需要管理员先建好组账号和 Key,并走一遍审批。
几点要注意:
- 插件以当前 DSH 进程的权限运行,安装脚本与
bin/、lib/下的代码会在本机执行;动手装之前先读源码,并确认许可证(当前为 MIT)。 - 主要用于实验室网关(LabAI)配套,README 未给出在 non-校园网 环境下的使用说明。
- 作者侧只有管理员功能写在
ADMIN.md,普通用户不用看;本文只覆盖普通成员视角。
小结¶
插件的作用是填掉「自己配地址、自己充钱、IP 一变就重配」这三步手工活,DSH 只面对本机固定地址,额度管理交给网关侧。目录页在 https://www.skillhub.cn/plugins/Deliver0/dsh-labai-gateway ,仓库在 https://github.com/Deliver0/dsh-labai-gateway 。