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 。

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

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

小夜