简体中文 | English
Remote Buddy（遥控搭子）把遥控器变成电脑上的语音输入按钮。拿起遥控器，按下说话、松开结束，就能在当前输入框中使用你喜欢的输入法或听写工具。
当前支持 macOS 14 及以上版本，包括 Apple Silicon 和 Intel Mac。Windows 支持正在规划中。
- 用遥控器麦克风进行语音输入，减少对电脑键盘和内置麦克风的依赖。
- 把小米遥控器的普通按键映射成快捷键、应用操作或常用语。支持分类筛选动作、单击/双击/长按独立配置与单项恢复默认。常用语内容不随界面语言切换，可自由混写中英文。
- 选择语音输入工具，配置按住说话或点按开始／结束的触发方式。
- 在一个向导中完成系统权限、麦克风驱动、遥控器连接和输入工具设置。
应用不采集使用统计，不保存录音或文本历史，不上传日志。语音识别和文本整理交给所选输入工具，其联网行为由该工具的设置决定。
遥控器麦克风 → 蓝牙音频 → Remote Buddy → 虚拟麦克风 → 输入法／听写工具
遥控器语音键 → Remote Buddy → 触发工具的语音快捷键 → 当前输入框
Remote Buddy 接收遥控器音频，解码后送入虚拟麦克风，同时将按键动作转换成目标工具需要的快捷键。它负责连接硬件与输入工具，本身不运行语音识别模型。实时文字、识别速度和自动修正效果取决于所选工具。
从 Releases 下载 Remote_Buddy_*.pkg。一个安装包包含 App 和虚拟麦克风驱动。
- 安装后打开
/Applications/Remote Buddy.app。 - 按设置向导授予蓝牙、输入监控和辅助功能权限。首次默认跟随系统语言，可在第一步选择中文或英文。
- 选择并连接遥控器、测试按键，等待驱动检查与固定输出准备就绪，再在输入工具中选择 Remote Buddy Mic 虚拟麦克风。App 自动使用该设备，不需要选择输出，也不回退到 BlackHole 或扬声器。
- 在“输入法集成”中配置语音快捷键，通过向导测试。
- 打开文本输入框，按住遥控器语音键说话、松开结束。使用 Typeless 等单击触发的工具，可在设置中调整开始／结束行为。
在“设备”页面可删除不再使用的遥控器及其应用内配置；macOS 蓝牙配对不会被删除。选择“添加设备”后，之前删除的设备可能被重新发现。
支持普通按键的设备可在“按键映射”中配置；需要重新检查环境时，在“设置”顶部重新运行向导。G9N9N 因按键报文不符合系统规范不支持普通单键映射（语音输入正常）；向导按键检测请使用双键（OK＋上，返回＋上），设置完成后短按 OK＋任意方向键可发送 Enter。详见 G9N9N 语音支持与按键映射限制。
安装需要管理员授权；首次安装或驱动变化、修复时会短暂中断音频，驱动未变化的升级会跳过音频服务重启。当前安装包未经过 Apple 公证，系统可能阻止安装。详见 安装与发布说明。
| 设备 | 当前支持情况 |
|---|---|
| 小米蓝牙遥控器 2／2 Pro | RC001 = 2，RC003 = 2 Pro，均包含 ATVV 协议与按键适配。2 Pro 按键已本地验证，音频由用户确认正常；2 的完整音频流程仍需单独验收 |
| Google Chromecast Voice Remote（G9N9N） | 部分支持：语音键与麦克风正常可用；普通单键映射不支持。 因按键报文不符合 macOS 规范，单键会被系统丢弃；支持短按 OK＋方向键发送 Enter。详见 独立测试报告 |
| Google TV Streamer Voice Remote（GY3LE） | 计划支持；尚未完成适配与真机验证 |
| Apple Siri Remote | 计划支持；尚未完成适配与真机验证 |
设备范围限定为以上四项。Google 硬件型号依据 Google 官方监管信息。第三方兼容款必须单独验证，商品标注“兼容 G9N9N”不代表已经支持。
遥控器需支持对应的蓝牙按键与音频协议，不能仅凭“可以蓝牙配对”判断兼容。
| 输入工具 | 集成方式 |
|---|---|
| 微信输入法 | 专用配置向导入口，配合虚拟麦克风与语音快捷键 |
| 豆包输入法 | 专用配置向导入口，支持按住与点按触发设置 |
| 网易叭哥说 | 专用配置向导入口，配置语音快捷键与麦克风 |
| Typeless | 配置其语音快捷键及开始／结束行为 |
| VoiceCursor | 独立入口，配置虚拟麦克风与自定义语音快捷键 |
| macOS 听写 | 系统自带，无需安装第三方工具；快捷键设为“按两下 🌐 键”，按住遥控器时连按两次 Fn 开始，松开后按一次 Fn 结束 |
| 其他语音输入工具 | 使用“其他工具”配置自定义快捷键 |
目标工具需要能够接收虚拟麦克风音频，并支持可以触发的语音快捷键。每个工具的版本和设置可能不同，请通过向导实际测试；配置入口不代表所有版本都已验证兼容。
Apple Silicon 选择 *_macOS_arm64.pkg，Intel 选择 *_macOS_intel.pkg。每份包含 App 和 Remote Buddy Mic 驱动。
卸载时下载通用的 Remote_Buddy_Uninstaller_*_macOS_universal.pkg（Apple Silicon / Intel 共用），通过 macOS Installer 打开。默认删除 App、驱动和当前用户设置、日志、缓存；取消勾选个人数据删除选项即可保留设置与日志。系统固定的“安装”按钮实际执行卸载，不安装程序。需要管理员认证，音频服务会短暂重启。详见卸载说明。
| 项目 / 模块 | 用途 |
|---|---|
| remote-mic-app | 遥控器连接、音频桥接、按键映射与界面的代码基础 |
| remote-bridge-hub | 小米 ATVV 协议、ADPCM 解码和 HID 映射参考 |
| vibe-mote | Google TV／Chromecast 遥控器 HID 按键、ATVV 语音协议与第三方兼容款差异的参考（Windows 实现） |
| ATVVoice | 已验证 G9N9N 的 Linux ATVV 实现；能力协商、音频同步与会话保活参考 |
| mi-remote-mapper | macOS CoreBluetooth、HID 和虚拟音频输出参考；未作为 G9N9N 真机验收依据 |
| mi-ao | macOS ATVV 协议、解码与能力验证参考；Google 遥控器仍需真机验证 |
| mi_remote_control | 按键动作、应用预设与故障排查的设计参考 |
| open-voice-bridge | 设备能力建模与语音链路诊断的设计参考 |
| BlackHole v0.7.1 | 虚拟麦克风驱动 |
| MiRemoteVoice | USB transport 回环音频设备的兼容设计参考 |
| Sparkle 2.9.4 | macOS 应用内更新，验证一体安装包的签名 |
| codex-siri-remote | Apple 遥控器 HID 与触摸行为的历史参考 |
| SiriRemoteForge | Apple 遥控器音频与 PacketLogger 格式的历史参考 |
| iRemote A2854 | Apple 遥控器诊断与授权流程的历史参考 |
| Opus | Apple 遥控器音频兼容代码涉及的编解码器；当前安装包不包含其动态库 |
历史兼容代码的引用不代表当前支持 Apple 遥控器。系统框架和内部模块详见 模块清单，各模块版本、版权及许可见 第三方声明。