dsh-dglab: Enabling AI in DSH to Control DG-LAB Devices via Tools

前言

在 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
羽毛球分组比赛记分
小程序二维码

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

Xiaoye