Open Voice Bridge 0.4.0

Open Voice Bridge 0.4.0

这是首个支持应用内更新的 macOS 正式版本。

• 新增菜单栏“检查更新…”以及设置页版本、自动检查开关和手动检查按钮；
• 默认每天最多检查一次，发现新版本后由用户确认安装，不静默安装；
• 更新 ZIP 使用 Sparkle EdDSA 签名，并继续要求同一 Developer ID 团队签名和 Apple 公证；
• 禁止系统画像与使用数据上报，更新失败不影响蓝牙、按键映射或音频桥接；
• 修复设置窗口打开时反复解码遥控器图片导致的高 CPU、发热和界面卡顿；
• 双击语音键同时使用独立的 HID 与 ATVV 手势判定，短按 HID 报告偶发丢失时仍可暂停或恢复桥接，且不会重复切换；
• 保持 Bundle ID、Developer ID、蓝牙、权限、设备适配、按键映射和音频默认行为不变。

从 0.3.9 或更早版本升级时，需要最后一次手动安装本版本。安装 0.4.0 后，后续版本即可在应用内完成更新。

Open Voice Bridge 0.3.9 · 正式签名权限修复

主要修复

• 补齐 Developer ID Hardened Runtime 的音频输入能力，修复正式签名包中麦克风开关已开启、应用仍显示拒绝的问题。
• 麦克风已授权时，“查看”按钮也会准确打开系统的麦克风隐私设置。
• 加强发行门：固定开发者 Team ID、精确校验 entitlement、校验 arm64/x86_64 的 macOS 11 最低版本，并验证 DMG 内层 App 的 Gatekeeper 状态。

从早期测试签名升级

如果系统权限开关看似开启但应用仍显示未授权，请完全退出应用，在终端仅重置本应用的旧签名授权记录：

tccutil reset ListenEvent com.kingwell.XiaomiRemoteBridgeMac
tccutil reset Accessibility com.kingwell.XiaomiRemoteBridgeMac
tccutil reset Microphone com.kingwell.XiaomiRemoteBridgeMac

重新打开应用后，按“权限”页面提示重新授权。麦克风重置后会暂时从系统列表消失，应用重新请求并允许后会再次出现。

验证

• Apple Developer ID 签名与公证：PASS
• Gatekeeper：Notarized Developer ID
• Universal：arm64 / x86_64
• 最低部署目标：macOS 11（构建校验；尚未做 macOS 11 真机运行）
• 自动测试：156 passed / 0 failed
• 本机空闲 CPU：约 0.3%

SHA-256：c3ac3d1d8dcc7dd4d1bfa59ec663f5e27c270379b187f32ee4f6c7f848e65623

Open Voice Bridge 0.3.8 · Mac Fn 权限与空闲稳定性修复

本次更新

• macOS 0.3.8（15）：修复正式签名版本中的权限状态显示与 Mac 物理 Fn 默认设置。
• 新安装默认开启“按住物理 Fn 时使用本机麦克风”；曾主动关闭的用户保持关闭。
• 功能关闭时显示“未启用（无需麦克风权限）”，不再把历史麦克风拒绝误报为当前故障。
• 从系统设置返回应用时自动刷新权限状态；不会自动请求麦克风权限。
• 移除默认开启后的空闲 1 Hz 轮询，只有实际按住 Fn 并成功采集期间才运行存活检测，停止后立即取消。
• 同值状态不重复刷新，降低空闲 UI 和 CPU 开销。

下载说明

• macOS：下载 OpenVoiceBridge-macOS-0.3.8-universal-notarized.dmg。
• 适用于 macOS 11+，同时支持 Apple Silicon 和 Intel。
• App 与 DMG 均使用 Developer ID Application 签名，Apple 公证状态为 Accepted，并已装订公证票据。
• SHA-256：be72d6a0c7e505424c0295f58d0c8c5405d97df9774b28d034c7fc9c18d9b6d5。

升级提示

如果旧版权限开关看似开启但应用仍显示未授权，请在“输入监控”和“辅助功能”中删除旧的“小米遥控器桥接”，再使用 + 重新添加 /Applications/小米遥控器桥接.app，然后完全退出并重开。本版本会在应用重新激活时刷新权限状态。

Mac Fn 默认勾选不会后台录音：只有系统已经授权并且你实际按住物理 Fn 时才采集，松手立即停止；RC003 遥控器语音始终优先。

验证

• 155 项自测、profile contract、静态 UI/模型门与 Swift 构建全部通过。
• 双架构、Developer ID、hardened runtime、安全时间戳、公证 ticket 与 Gatekeeper 验证通过。
• 独立对抗审查通过。

已知边界

• macOS 11 已通过双架构编译与打包校验，但尚未在真实 macOS 11 机器上运行验收。
• Windows RC003 客户端仍是未签名候选版，本次没有改动。

Open Voice Bridge 0.3.7 · macOS 正式签名与 Apple 公证

本次更新

• macOS 0.3.7（14）：首个 Developer ID 正式签名与 Apple 公证版本。
• App 本体和 DMG 容器均使用 Developer ID Application 签名，包含 hardened runtime 与安全时间戳。
• Apple 公证状态为 Accepted，公证 ticket 已装订进 DMG；Gatekeeper 验证结果为 Notarized Developer ID。
• 增加失败关闭的正式签名、公证、装订和验证脚本；本地开发构建流程保持不变。

下载说明

• macOS：下载 OpenVoiceBridge-macOS-0.3.7-universal-notarized.dmg。
• 适用于 macOS 11+，同时支持 Apple Silicon 和 Intel。
• 可用同名 .sha256 文件校验下载完整性。
• Windows RC003 候选客户端本次没有代码变更，继续从 v0.3.6 Release 下载。

升级提示

首次从 v0.3.6 或更早的 ad-hoc 测试包升级时，macOS 可能保留旧签名身份的“输入监控”和“辅助功能”权限记录。如升级后按键映射失效，请在这两项系统设置中删除旧条目，重新添加 /Applications/小米遥控器桥接.app，然后完全退出并重开应用。

已知边界

• 这仍是公开预发布版；macOS 11 已通过双架构编译与打包校验，但尚未在真实 macOS 11 机器上运行验收。
• Windows 包仍是未签名候选版。

Open Voice Bridge 0.3.6 · 全按键自定义

本次更新

• Mac 0.3.6（13）：所有真实实体键均可选择内置动作、禁用或录制单键/组合键；语音键支持按住型自定义快捷键。
• 语音自定义映射增加 F5→Fn 的保存、回读、恢复与异常后清理，遇到未知外部映射会拒绝接管，避免影响其他键盘设置。
• 更新 macOS 风格应用图标；RC003（2 Pro）与 ARN9（普通款）按蓝牙型号自动选择对应界面与实体按键集合。
• Windows RC003 候选客户端：更新快捷键库与录制入口；本次构建完成源码检查、测试、PyInstaller、安装程序与 SHA256 发布目录校验。

下载说明

• macOS：下载 小米遥控器桥接-0.3.6-测试版.dmg，适用于 macOS 11+、Apple Silicon 和 Intel。
• Windows：可选择安装程序 .exe 或便携版 .zip；两者均为未签名候选包。
• SHA256SUMS 和 macOS 的 .sha256 可用于验证下载文件。

已知边界

这是公开预发布版：macOS DMG 为 ad-hoc 测试签名，尚未公证；Windows 包未签名。Windows 构建已通过 CI，但本版本的完整实体设备回归仍建议由实际硬件用户反馈后持续维护。

Open Voice Bridge 0.3.4 · RC003 / ARN9 / Windows

Open Voice Bridge v0.3.4 是 RC003 2 Pro、ARN9 普通款与 Windows RC003 客户端的公开测试版本。

macOS

• 支持小米蓝牙语音遥控器 2 Pro / RC003。
• 新增小米普通款 ARN9 型号自动识别、专属实物映射页和语音键链路。
• 同名遥控器通过 BLE Model Number 区分；未知或缺失型号会失败关闭，不误显示为已连接设备。
• 支持方向、OK、返回、主页、菜单、音量、语音 Fn、BlackHole、本机 Fn 兼容和双击停用桥接。
• 修复无事件时可能持续高 CPU 的窗口布局/诊断刷新问题。

macOS 包为 Universal（Apple Silicon + Intel），最低部署目标 macOS 11。当前未使用 Apple Developer ID、未公证，首次启动可能需要 Control/右键点击应用后选择“打开”，并手动授予输入监控和辅助功能权限。

Windows

• 提供安装器和便携 ZIP。
• 包含 RC003 按键/语音设置、虚拟声卡环境诊断、日志入口、按键映射与语音快捷键配置。
• 构建包内含官方 VB-CABLE Basic 安装助手资源；驱动安装仍由 Windows UAC 明确确认，不会静默提升权限。

Windows EXE/ZIP 当前未进行商业代码签名，SmartScreen 可能显示未知发布者。GitHub Actions Windows Runner 已完成测试、PyInstaller、烟雾测试、Inno Setup 和哈希校验；ARN9 与 DJI Mic 2 的 Windows 真机适配仍属于未完成范围，请以应用内状态和 README 为准。

验证

• macOS 自测：145/145。
• Windows 契约测试：776/776。
• PR #8 与合并后 main 的 Windows CI 均通过。
• macOS DMG、内置 App、Universal 架构、源码包和 SHA-256 校验通过。
• ARN9 真机语音按下/启动/松开/停止完整闭合；空闲 CPU 0.0%。

下载

• macOS：OpenVoiceBridge-macOS-0.3.4-universal.dmg
• Windows 安装器：OpenVoiceBridgeRC003Setup-0.1.0-candidate-unsigned.exe
• Windows 便携包：OpenVoiceBridgeRC003-0.1.0-candidate-portable-unsigned.zip
• 两个平台均附带 SHA-256 校验文件。

参考与许可：GPL-3.0-only；Xiaomi ATVV/HID 行为参考项目及 revision 已在 THIRD_PARTY_NOTICES.md、COPYRIGHT 和 README 中声明。

Open Voice Bridge · RC003 Windows 候选版 0.1.0

下载

本次候选版提供两种等价使用方式，只需选择其中一种：

• OpenVoiceBridgeRC003Setup-0.1.0-candidate-unsigned.exe：当前用户安装器，提供开始菜单中的设置、启动、停止和卸载入口。
• OpenVoiceBridgeRC003-0.1.0-candidate-portable-unsigned.zip：便携版，解压即用；设置命令为 .\OpenVoiceBridgeRC003.exe --settings，无参数运行即启动。
• SHA256SUMS.txt：以上两个文件的 SHA-256 校验清单。

项目级标签是 v0.3.0-windows-rc003-candidate.1；资产内部版本仍为 0.1.0-candidate，两者用途不同。

已验证

• 基于 main 提交 8891d62 的 Windows Actions 运行 29647018274：469 项测试通过，3 项按平台条件跳过。
• 在真实 Windows 运行时验证了 WinRT 投影导入与已配对设备枚举、Raw Input 设备枚举及隐藏消息窗口启停/重启、SendInput 调用和 PortAudio 输出枚举；CI 没有连接 RC003 硬件。
• PyInstaller 构建、冻结程序 --dry-run、Inno Setup 编译、三文件预检和哈希校验全部通过。
• 便携 ZIP 只有一个版本化顶层目录，程序本体、README、LICENSE、COPYRIGHT、来源与第三方声明齐全。

首次使用

1. 支持 Windows 10 1809 或以上的 64 位系统。
2. 下载后先用 SHA256SUMS.txt 核对文件哈希。
3. 同时长按遥控器主页键 + 菜单键进入配对广播，在 Windows 蓝牙设置中完成配对。
4. 语音桥接可选安装官方 VB-CABLE：Open Voice Bridge 的语音输出选 CABLE Input，Windows/听写软件的麦克风选 CABLE Output。
5. 先在记事本中手动确认键盘 Win+H 能正常听写，再测试遥控器麦克风键。
6. 完整安装、便携版、停止、清理、默认映射与故障排查见仓库内 apps/windows/rc003/README.md。

重要限制

• 这是未签名候选版，SmartScreen 可能拦截；请只从本 Release 下载并先核对哈希。
• 尚未完成 Windows + 真实 RC003 的配对、逐键、ATVV 语音和断线重连验收；电源键/TV 键的真实 Raw Input 事件形态也待真机确认。
• 安装器已在 CI 编译，但本项目和 CI 尚未执行安装/卸载验收。
• 不捆绑、不安装任何音频驱动；VB-CABLE 需要用户自行从官方来源安装。
• RC003 共 13 个物理按键，没有独立静音键；Windows 候选版的返回键目前未映射。
• 设置和日志会保存在 %LOCALAPPDATA%\OpenVoiceBridge\RC003。卸载或删除便携目录后如需完全清理，可在确认没有其他 RC003 版本使用该共享目录后手动删除。

小米遥控器桥接 0.2.0 测试版

小米遥控器桥接 0.2.0 测试版

首个公开测试版本，面向小米蓝牙遥控器 2 Pro / RC003：

• 原生 macOS 菜单栏应用，支持 Apple Silicon 与 Intel，最低部署目标 macOS 11；
• RC003 按键图形化映射；
• ATVV 语音解码并输出到用户选择的 CoreAudio 回环设备；
• 仅对 RC003 把真实 F5 硬件按下/松开映射为 Mac Fn，用于长按语音输入；
• 应用退出时恢复进入前的 F5 映射，不修改其他键盘设备。

本版本通过 36/36 自动测试、Universal 应用/DMG 验证，以及 RC003 真机语音 5/5、松手 5/5 和普通按键回归。

上游来源与许可

ATVV UUID、握手、能力解析、IMA/DVI ADPCM 顺序及 RC003 HID usage 参考并改编自 GPL-3.0 项目 xxb26553663-star/remote-bridge-hub，参考 revision：8a93f321ac71a602300c6cd77f7256fa4b63068e。

本项目代码以 GPL-3.0-only 发布。详细修改说明与第三方权利边界见仓库 COPYRIGHT 和 THIRD_PARTY_NOTICES.md。

安装提醒

这是 ad-hoc、未经过 Apple 公证的测试版。首次打开可能需要在 Finder 中按住 Control 单击应用并选择“打开”。语音功能需要另行安装 BlackHole 2ch 或等价 CoreAudio 回环设备；不需要安装 Karabiner。

DMG SHA-256：e65f450033afff06ae2f262271eb23b759259bb903a10e1ed8e26602ba171e60