前言¶

在 DSH（DeepSeek Harness）裏接入外部硬件，通常要自己寫一層橋接：處理連接與配對、同步設備狀態，還要考慮 AI 下發指令時的安全確認。DG-LAB 這類設備尤其如此——手機 APP、本機控制方、設備三方要打通，AI 側還需要一組邊界清晰的工具。

lindog114514 寫的 dsh-dglab 把這一整套做成了 Web 平臺插件：AI 側拿到 dglab-kit 工具集，Web UI 裏提供掃碼配對面板。下面介紹它的功能、安裝步驟和典型用法。

這是什麼¶

一句話定位：DG-LAB 控制插件，爲 AI 提供 dglab-kit 工具集，外加一個掃碼配對手機 APP 的 Web UI。

• 倉庫：lindog114514/dsh-dglab，版本 1.0.0
• 許可證：MIT（依賴的 dglab-kit / qrcode-generator 均爲 MIT）
• 運行要求：engines 裏要求 dsh >=0.0.1、node >=22，platform 爲 web

它支持的設備是 DG-LAB 的郊狼 / 負鼠 / 靈貓系列。接入方式是手機上的 DG-LAB 4 APP 掃描面板二維碼，把手機接入插件的本機控制方，之後 AI 通過工具下發指令。

核心功能¶

10 個 AI 工具¶

插件註冊 10 個 dglab_* 工具，覆蓋：連接、狀態查詢、設備刷新、強度（絕對 / 相對 / 臨時）、波形、清理、斷開。強度步長等參數在工具內校驗，出錯時給出明確的錯誤信息，設備類型（負鼠 / 郊狼 / 靈貓）以中文名顯示。

掃碼配對面板¶

配對二維碼以 SVG 在本地生成。面板默認出現在 Web UI 左下角，可拖動，位置會被記憶。

電刺激指令確認¶

AI 下發電刺激指令時默認彈窗，三選一：執行一次 / 永久允許 / 拒絕。選擇偏好按會話記憶。

跨會話共享連接¶

任意會話共用一條 DG-LAB 連接，新開會話能直接看到已配對的設備。

狀態自動刷新¶

每次對話都會靜默刷新設備狀態緩存，不注入提示詞。AI 用工具查詢時，拿到的總是最新狀態。

安裝與啓用¶

這是一個 Web 平臺插件，package.json 中 client.platform 爲 web，注入 @deepseek-ai/dsh-client-runtime 與 @deepseek-ai/dsh-client-ui-conversation 兩個客戶端包，因此安裝後必須重啓 dsh web 才生效。經過下面三步即可啓用。

1、一鍵安裝：

dsh plugin --profile web add "github:lindog114514/dsh-dglab#main"

2、重啓 dsh web。先結束當前 dsh web 進程，再重新運行：

dsh web

3、驗證安裝：

dsh --profile web --dump-config | findstr dglab

輸出應包含 dglab 行。重啓完成後，聊天輸入框左側會出現二維碼按鈕。

典型使用流程¶

1、點輸入框左側的二維碼按鈕，打開面板，點「連接」。
2、手機打開 DG-LAB 4 APP 掃描面板二維碼（APP 需已登錄並支持 V4 掃碼）。
3、APP 接入後，面板和 dglab_status 會顯示設備信息：slotId、中文類型名、當前強度。
4、此時可以讓 AI 控制（會彈確認框），也可以在面板手動操作：±強度、播放波形、清除。

適用場景與注意事項¶

適合已經在用 dsh web、手上有 DG-LAB 設備（郊狼 / 負鼠 / 靈貓）、想讓 AI 通過工具安全操作硬件的人。

幾點注意：

• 插件以 Web 平臺運行（platform: web），安裝後需重啓 dsh web 生效。
• 電刺激指令默認需要彈窗確認，偏好按會話記憶；不希望 AI 頻繁彈窗時，可在確認時選擇「永久允許」。
• 插件以當前 dsh 進程的權限運行，安裝前建議先閱讀源碼並確認許可證。本項目及 dglab-kit / qrcode-generator 均爲 MIT。
• 使用問題可到作者的 QQ 羣反饋：870333220。

小結¶

dsh-dglab 把硬件橋接、配對面板、指令確認和跨會話狀態共享打包進一個插件，裝完重啓即可使用，符合 DSH「一切皆插件」的思路。

• 插件目錄頁（社區獨立維護的目錄站點，與 DeepSeek / 幻方無官方從屬關係）：https://www.skillhub.cn/plugins/lindog114514/dsh-dglab
• GitHub 倉庫：https://github.com/lindog114514/dsh-dglab