前言¶
DeepSeek Harness (DSH) 采用插件化架构，通过扩展组件丰富工作流能力。dsh-coyote 是一个连接 DG-LAB Coyote 电刺激设备的工作流插件。它为模型端工具调用和网页端 GUI 控制提供了统一的安全边界，确保所有操作（包括 Agent 和用户）都受到软限制、速率限制和会话冷却的约束。
功能概览¶
该插件主要包含以下能力：
- 八种模型端工具：为 Agent 提供控制设备的能力，包括状态查询、配对、断开连接、设置强度、播放/停止波形、紧急停止以及波形库管理。
- DSH 对齐的网页控制面板：提供可视化的操作界面，与 DSH 的整体 UI 风格保持一致。
- 自动刺激功能：支持将 DSH 的事件流（如工具调用、错误、回合结束等）映射为受限的脉冲刺激。
- 严格的安全限制：
- 软限制：由 Agent 和 GUI 共同维护的强度上限（0-200）。
- 硬限制：设备端或 App 端的物理上限。
- 速率限制：防止强度无序或过快增加的机制。
- 会话冷却：防止频繁重新配对或滥用。
- 波形库：内置 12 种波形预设（如呼吸、心跳等），并支持从社区导入
.pulsesJSON 文件。 - 协议支持：基于 WebSocket 实现 DG-LAB V3 协议服务器，通过二维码与官方 App 配对。
安装与配置¶
安装插件需要使用 DeepSeek Harness 的插件管理命令。
dsh plugin --profile web add dsh-coyote
安装后，插件会自动插入配置行，默认配置通常满足基本需求。如需调整，可在 DSH 的配置覆盖文件中修改 dsh-coyote 的配置项：
- id: coyote
config:
port: 9999 # WebSocket 通信端口，需确保手机在同一网络可达
softLimitA: 60 # Agent 端通道 A 的软限制，范围 0-200
softLimitB: 60 # Agent 端通道 B 的软限制，范围 0-200
使用流程¶
在启用插件并配置完成后，通过 DSH 网页 GUI 进行设备配对和操作：
- 在 DSH 网页界面的侧边栏底部点击 Coyote 按钮，打开控制面板。
- 点击面板上的 开始配对 按钮，生成二维码。
- 使用手机上的 DG-LAB App 扫描二维码，完成设备连接。
- 配对成功后，网页面板和 Agent 工具均可对设备进行控制，所有操作均在同一安全限制范围内生效。
注意事项¶
- 成人内容（18+）：该插件控制真实的电刺激功率箱，存在物理风险。使用前必须仔细阅读并理解安全说明。
- 环境依赖：插件依赖 Node.js 版本 >= 22。
- 权限与安全：所有操作（包括 GUI 操作）均受安全限制约束，无法通过 Agent 或前端界面绕过软限制、速率限制或会话冷却等安全机制。建议在使用前检查插件源码与许可证。
