Deliver0/dsh-labai-gateway:让 DSH 走实验室网关额度的本地代理插件

前言

DSH 的模型调用默认直连官方渠道,自己充 Key、填地址。实验室场景里这两件事都麻烦:组里共用一份额度,成员机器 IP 又经常变——DHCP 一换地址,之前配好的接口地址就废了。

deliver0/dsh-labai-gateway 就是为这个场景做的插件。它由 Deliver0 维护,在本地起一个反代,DSH 只需连 127.0.0.1:8801,剩下的找网关、带 Key 的事交给插件;网关换 IP 后插件自行重新发现地址,用户侧配置不用动。分类是 admin-security。

下面介绍它的工作原理、安装流程和验证方式。

定位

一句话:管理员用一个组账号连 DeepSeek 官网,你的 DSH 通过网关借用这个组账号发请求。额度从组账号扣,网关记录每次是谁用的。

架构上分两层:

  1. 用户侧的插件跑在本机 127.0.0.1:8801,负责把请求转发给真正的网关,并把 sk-lab- 开头的成员 Key 注入进去。
  2. 网关机核对 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 。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜