前言¶
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 用法的丢弃，同时保持了零原生依赖的特性。
