dsh-xiaomi-remote-2-pro

LIMITATIONS

Known limitations

这一节请务必读完，它决定了这个插件**不适合**什么场景。 1. **必须让 DSH 窗口保持前台**。按键接管依赖页面的键盘事件；DSH 在后台时遥控器只是普通键盘，按键会打到当前活动窗口。对"对着输入框说话"这个主场景这是正确的，但**不能**用来在后台全局操控 DSH。 2. **无法区分"这个键来自遥控器"还是"来自你的物理键盘"**。浏览器不提供设备身份信息。因此：语音键绑定在 `F5` 之后，**你物理键盘上的 F5 也会触发录音**。我们用两个办法缓解——`skipWhileTyping`，以及把默认动作设计成幂等（比如发送、滚动）；但这是真实存在的取舍。如果你常用 F5，建议把 `voice` 的映射改到别的键，或用面板按钮 / 快捷键触发录音。 3. **返回键、音量键、静音键在 Windows 上收不到**，原因见上文。面板会标注它们，不会给假映射。 4. **语音用的是电脑麦克风，不是遥控器的麦克风**（v0.1）。 5. **向输入框插入文字依赖 DOM**。DSH 目前没有公开"写入草稿"的客户端服务，所以插入是"找可见输入框 → 用原生 setter / `execCommand` 写入 → 派发 input 事件"。React 受控组件走这条路是可行的，但它依赖界面结构：**DSH 前端改版可能让它失效**。失效时的表现是明确的——文字会被复制到剪贴板并提示你手动粘贴，而不是静默失败。找不到输入框时也可以把 `voice.insertMode` 改成 `clipboard`。 6. **日志环形缓冲的容量在插件加载时固定**。改 `logLimit` 需要重载插件（重启）后才生效。 7. **手势有固有延迟**：单击在配了双击的按键上会晚一个 `doubleTapMs`（默认 280ms）兑现。只配单击则无延迟。 8. **`exec` 不支持 shell 语法**（管道、重定向、`&&`），这是刻意的。 9. **仅 Windows**。设备探测走 PowerShell；按键与语音链路本身是跨平台的，但没在别的系统上验证过，所以不声明支持。 10. **首次使用语音会下载本地模型**（几百 MB，取决于识别器）。设置页里有预热按钮，建议先点一下。 ---