前言¶
在 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。 - 物理要求：該插件依賴物理按鍵輸入，旨在防止鍵盤記錄器或遠程操控模擬。
