前言¶
在 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