前言¶
DeepSeek Harness (DSH) 的插件化架構允許用戶擴展功能。對於需要長時間使用智能體的開發者來說，頻繁切換窗口使用鍵盤輸入容易打斷思路。這款插件通過將小米藍牙遙控器 2 Pro（型號 RC003）接入 DSH，提供了一個非侵入式的語音輸入與快捷控制方案。
下面介紹 zmyisme/dsh-xiaomi-remote-2-pro 的安裝與使用方法。
插件定位¶
這是一個 DSH 插件，不是獨立程序。它主要解決兩個問題：
1. 語音輸入：利用遙控器的語音鍵實現“按住說話”，複用 DSH 內置的語音識別能力（如本地 SenseVoice），無需額外配置或 API Key。
2. 快捷控制：將遙控器按鍵映射爲各種可執行動作，支持單擊、雙擊、長按等多種手勢。
核心功能¶
插件具備以下核心能力：
* 按住說話：按住語音鍵錄音，鬆開後自動識別並插入光標處，再按 OK 發送。
* 手勢識別：支持單擊、雙擊、長按、按住鬆開四種手勢。
* 動作映射：支持十三種可執行動作，包括插入文本、發送消息、滾動會話、模擬快捷鍵等。
* 預設方案：提供三套預設配置，適配不同使用場景。
* 學習模式：對於未預設的按鍵，可通過學習模式快速綁定。
* 面板顯示：提供懸浮快捷面板，顯示實時鍵碼、設備狀態與最近按鍵。
* Agent 接口：支持通過 remote_2_pro 工具和 /remote2pro 命令讓模型讀寫配置。
* 技術特性：純 JavaScript 實現，零原生依賴，無需編譯，無需管理員權限。
安裝與啓用¶
前置條件¶
- 系統：Windows 10/11 x64
- DSH：桌面版或
dsh web - 遙控器：小米藍牙遙控器 2 Pro（型號 RC003）
- 語音識別：需先在 DSH 裏啓用實驗性語音輸入（本地 SenseVoice）
第一步：配對遙控器¶
- 打開 Windows 設置 → 藍牙和其他設備 → 添加設備。
- 按住遙控器的 主頁 + 菜單 鍵約 3 秒進入配對模式（不同批次略有差異，燈閃即進入）。
- 選擇設備名稱
MI RC或Xiaomi Bluetooth Remote 2 Pro。
第二步：啓用 DSH 語音輸入¶
在 DSH 的設置頁面中，找到並啓用實驗性語音輸入（@deepseek-ai/dsh-experimental-voice-input-bundle）。
第三步：安裝插件¶
使用以下命令安裝插件（以桌面版爲例）：
dsh plugin --profile desktop add github:zmyisme/dsh-xiaomi-remote-2-pro
第四步：重啓進程¶
必須完整重啓 DSH 進程，刷新頁面或熱更新無法加載新插件。
重啓後，進入 DSH 的設置頁面，在“小米遙控器 2 Pro”卡片中確認設備狀態爲活躍。
典型用法與配置¶
快速上手¶
- 打開一個會話，將光標點進輸入框。
- 按住遙控器上的語音鍵（麥克風圖標鍵）說話。
- 鬆開，識別後的文字會出現在輸入框中。
- 按 OK 鍵發送。
手勢與動作配置¶
插件支持四種手勢綁定動作。默認預設爲 vibe-coding，包括：
* 語音鍵：按住說話 / 單擊開關面板。
* OK 鍵：發送當前輸入。
* 方向鍵：滾動會話或跳轉頂部/底部。
你可以通過 DSH 界面的設置頁修改映射。如果遇到未預設的按鍵（如信號源鍵），點擊“學習”按鈕後按下該鍵即可綁定。
注意事項¶
- 按鍵接管限制：按鍵接管功能要求 DSH 窗口必須處於前臺。
- 系統限制：在 Windows 上，遙控器的“返回”、“音量 +”、“音量 -”鍵無法接收，因爲這些 HID 用法被系統丟棄。面板會顯示這些按鍵爲“系統丟鍵”。
- 權限要求：插件以當前 DSH 進程權限運行，無需管理員權限。
技術依據¶
該插件利用瀏覽器捕獲 HID 鍵盤事件的能力，在客戶端完成手勢識別與動作分發，將語音識別完全交給 DSH 自有的語音輸入棧。這種方式完全繞開了 Windows 對特定 HID 用法的丟棄，同時保持了零原生依賴的特性。
