dsh-gamepad-approval

Xbox 手柄硬件审批插件 for DeepSeek Harness (dsh)

Agent 执行高危工具调用时必须通过物理按键确认：手柄震动两下提醒，A 键批准 / B 键驳回。审批决策物理隔离，远程攻击无法模拟。

与 trea-gamepad (MCP 版) 功能相同，本插件运行在 dsh 的 tools/pre-execute 管道内。

特性

• 物理隔离 — 审批决策必须通过 Xbox 手柄按键（XInput 直连，不经过浏览器）
• fail-closed — 无手柄 / 超时 / 断连 / 读不到输入时一律驳回
• 只加门不拆门 — 硬件批准后仍委托 dsh 后续安全门（next()），不会绕过其他策略
• 18 条权限规则 — 覆盖文件删除、系统命令、防火墙、磁盘、git 破坏性操作、密钥访问等
• 可配置风险阈值 — minRiskLevel 控制触发审批的最低风险等级
• 取消感知 — 工具调用被中止时立即终止等待，不挂起

前提条件

• Windows 系统
• dsh ≥ 0.1.0-rc.8
• Xbox 兼容手柄（XInput 协议，大多数 PC 手柄都支持）

安装

dsh plugin --profile default add dsh-gamepad-approval

或从本地目录安装（开发模式）：

dsh plugin --profile default add ./dsh-plugin

使用流程

1. 插件加载时自动探测手柄（日志中会显示连接状态）
2. Agent 发起高危工具调用（如 rm -rf、git push --force）时：
   • 手柄震动两下提醒
   • 按 A 键批准（升调"叮-叮↑"）/ 按 B 键驳回（降调"咚-咚↓"）
3. 超时（默认 120 秒）自动驳回

配置

在 dsh 的 cordis.yml 或 patch 中：

- insert:
  - id: gamepad-approval
    name: dsh-gamepad-approval
    config:
      timeoutSeconds: 120   # 等待手柄按键的超时秒数
      minRiskLevel: medium  # 触发审批的最低风险等级: low | medium | high | critical

权限规则覆盖

类别	示例	风险
文件删除	rm -rf, Remove-Item, del /f	critical
系统关机	shutdown, Stop-Computer	critical
磁盘操作	format, diskpart, dd if=	critical
系统配置	reg add, schtasks, systemctl	critical
数据库破坏	DROP TABLE, TRUNCATE	critical
远程脚本执行	`curl ...	sh`
Git 破坏性	push --force, reset --hard	high
密钥访问	cat *.pem, echo $*_KEY	high
防火墙	iptables, netsh firewall	high
进程终止	taskkill /f, kill -9	high
全局安装	npm i -g, choco install	medium
脚本执行	npx, npm run, bash -c	medium

技术实现

插件监听 dsh 工具管道的 tools/pre-execute waterfall 事件：

模型发起 tool-call
  → tools/pre-execute（本插件）
      命中规则 → PowerShell XInput 直连手柄：震动 + 等待 A/B
        A 键  → next()（委托后续安全门后放行）
        其他  → deny（fail-closed）
  → dsh 原有 guard / execute / post-execute 管道

License

MIT