前言¶
在 DeepSeek Harness (DSH) 的开发中，Agent 执行高危操作（如删除文件、系统关机、格式化磁盘）时需要一道安全防线。传统的软件层审批（弹窗、命令行输入）可能被键盘记录器窃取或被远程控制模拟。
dsh-gamepad-approval 插件引入了硬件层的确认机制。它利用 Xbox 手柄（XInput 协议）将 Agent 的工具调用请求转化为物理操作，确保只有持有手柄的人才能批准或驳回高危指令。
这是什么¶
这是 goldgish 维护的 DSH 插件，属于 admin-security 类别。它的核心作用是在 Agent 尝试执行高危操作时，强制要求物理按键确认（A 批准 / B 驳回），以此阻断自动化脚本或远程攻击的恶意执行。
功能特性¶
- 物理按键审批：Agent 触发高危操作时，手柄会震动，需按下 A 键批准或 B 键驳回。
- 硬件层交互：基于 XInput 协议，信号直接来自硬件层，不经过浏览器或键盘驱动，无法被软件模拟。
- 内置权限规则：内置 18 条权限规则覆盖常见高危操作，包括文件删除、系统关机、磁盘格式化、Git 破坏性操作、全局安装脚本等。
- Fail-closed 策略：若无手柄连接、操作超时或读取不到输入，系统将自动驳回操作，不执行任何风险动作。
- 可配置化：支持配置超时时间（
timeoutSeconds）和触发审批的最低风险等级（minRiskLevel）。
安装与启用¶
在 DSH 环境中执行以下命令安装插件：
dsh plugin --profile default add dsh-gamepad-approval
安装后无需额外配置即可生效。
使用说明¶
当 Agent 遇到命中权限规则的高危操作时，流程如下：
- 触发：Agent 发起工具调用。
- 确认：手柄震动两下。
- 决策：用户按下 A 键放行，或按下 B 键驳回。
若未连接手柄或超时，操作会被自动驳回。
注意事项¶
- 平台限制：仅支持 Windows 平台。
- 依赖项：依赖
@deepseek-ai/schemastery。 - 物理要求：该插件依赖物理按键输入，旨在防止键盘记录器或远程操控模拟。
