前言¶
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 或前端界面繞過軟限制、速率限制或會話冷卻等安全機制。建議在使用前檢查插件源碼與許可證。
