Releases: Zeno-cc/OPPO-Earbuds-Mac-Controller
Releases · Zeno-cc/OPPO-Earbuds-Mac-Controller
Release list
OPPO Earbuds Mac Controller v1.5.1
OPPO Earbuds Mac Controller v1.5.1
这次更新
- 加入 OPPO Enco Free4 支持：已验证关闭、通透以及深度、中度、轻度、智能降噪状态；自适应模式可识别，但不提供主动切换。
- 加入基于 Sparkle 的应用内更新。更新入口收为“关于”里的小图标：点击检查，发现新版本后图标变蓝，再点击打开下载与安装窗口；稍后安装仍可重新打开。
- 更新包和更新源使用 Sparkle EdDSA 签名验证；自动检查更新不等于自动安装。
升级方式与限制
- v1.5.0 尚无更新器，因此首次升级到 v1.5.1 需要从 GitHub Release 下载 DMG，手动拖入“应用程序”。此后才能使用应用内更新。
- 最低系统仍为 macOS 26。分发包沿用 ad-hoc 签名；更新后 macOS 可能再次请求蓝牙权限，允许后控制功能才会恢复。
- 本版本不新增 Widget、Alive Audio、入耳检测或双设备手动切源控制。
OPPO Earbuds Mac Controller v1.5.0
OPPO Earbuds Mac Controller v1.5.0
这次更新
- 菜单栏电量改为左耳（L）和右耳（R）上下排列，减少菜单栏宽度占用。
- 充电盒（C）只有在读到自己的有效电量时才显示；没有数据时自动隐藏，不再显示无意义的占位内容。
- 菜单栏电量使用独立的两行原生绘制，解决多行标题被状态栏裁剪和垂直偏移的问题。
- 增加
Option + 点击在 ANC 与通透之间快速切换。 - 增加右键原生菜单，可直接选择降噪、关闭、通透和降噪强度。
- 增加可选全局快捷键，支持录入、清除、替换失败恢复和持久化，不需要辅助功能权限。
- 增加 Quick Action HUD，并与连接状态浮窗共享显示位置，避免浮窗重叠。
- 更新快速控制设置、v1.5 新功能说明和使用文档。
范围说明
- 最低系统要求保持为 macOS 26 或更高版本。
- 双设备自动连接仍由耳机和官方手机体验负责，Mac 不提供优先设备或手动切换音源控制。
- 不包含 Widget、Alive Audio、独立入耳检测、Head Tracking、BLE/OTA、自动音频接管或 macOS 26 以下兼容。
- 发布包继续使用项目现有的 ad-hoc 签名；首次打开若被 macOS 拦截，请按 README 中的
xattr命令处理。
验证
- Air5 Pro 已完成用户真机验收，覆盖菜单栏电量、快速控制入口、HUD 和连接状态场景。
swift test：160 个测试通过。swift test -c release：160 个测试通过。bash build.sh release与bash scripts/verify-app-bundle.sh：通过。- 最低系统、Bundle ID、蓝牙控制链路和签名模型保持不变。
证据边界
软件回归和 Air5 Pro 真机验收已完成。手机参与的跨端冲突/失败矩阵仍不在本版本中宣称为已覆盖能力。
OPPO Earbuds Mac Controller v1.4.0
OPPO Earbuds Mac Controller v1.4.0
这次更新
- 新增自定义 EQ 管理：创建、命名、编辑、启用和删除耳机端曲线。
- 新增完整曲线读回确认；草稿与耳机当前状态分离，外部变化不会静默覆盖编辑内容。
- 新增 Mac 本地 EQ 方案：可在本机保存、载入和删除曲线，断开耳机时也能离线编辑。
- 本地方案的保存、载入和删除不会发送蓝牙设置命令；只有“新增并启用”或“保存并启用”才会写入耳机。
- 显示已验证的盒内/盒外位置状态，不把盒外状态推断为已佩戴。
- 更新 v1.4 首次启动说明，保留原生、克制的连接反馈和 Liquid Glass 界面体验。
范围说明
- 最低系统要求保持为 macOS 26 或更高版本。
- 双设备自动连接仍由耳机和官方手机体验负责，Mac 不提供优先设备或手动切换音源控制。
- 不包含 Widget、Alive Audio、独立入耳检测、BLE/OTA 或付费签名能力。
- 继续保留 realme Buds T500 Pro 的既有兼容性测试；本版本没有新增 T500 功能承诺。
验证
swift test：141 个测试通过。swift test -c release：141 个测试通过。bash build.sh release与bash scripts/verify-app-bundle.sh：通过。- 发布包使用项目现有的 ad-hoc 签名；首次打开若被 macOS 拦截，请按 README 中的
xattr命令处理。
证据边界
软件回归和 Mac 本地方案 UI 已通过验证。手机参与的跨端冲突/失败矩阵需要 Android 端 HCI 日志与现场操作，本包不把这部分未取得的物理证据宣称为已完成能力。
OPPO Earbuds Mac Controller v1.3.0
OPPO Earbuds Mac Controller v1.3.0
本次更新重点升级连接反馈、macOS 26 外观和应用入口体验。
新增
- 新增连接、重新连接和意外断开 HUD，状态变化更直观。
- 菜单栏可选显示左右耳真实电量中的最低值。
- 应用默认显示 Dock 图标，可在“详情 → 偏好”中即时关闭；关闭后仍保留菜单栏入口。
- 新增 v1.3 功能介绍窗口和设备信息刷新反馈。
优化
- 主面板与设备信息/设置面板升级为更轻量的 macOS 26 Liquid Glass 风格。
- 调整 HUD 展开动画与停留时间，反馈更柔和、更易读。
- 使用新的 macOS 26 Icon Composer 应用图标，支持系统浅色、深色和着色外观。
- 面向用户的产品名称与说明统一为 OPPO。
修复
- 修复详情和更新浮窗打开后控件无法点击的问题。
- 修复新功能窗口默认位置不居中的问题。
- 修复刷新设备信息时缺少触发反馈的问题。
- 修复隐藏 Dock 图标后可能失去应用入口的问题。
安装
下载 OPPO-Earbuds-Mac-Controller-v1.3.0-macOS.dmg，打开后将应用拖入“应用程序”。
系统要求：macOS 26 或更高版本。
v1.2.1
本次更新完成菜单栏控制面板的整体重构：
- 面板改为内容自适应高度，最高 556pt，减少无效留白。
- 设备名称、连接状态、电量和错误提示固定显示，滚动内容不再遮挡顶部信息。
- 降噪、降噪强度和均衡器统一为紧凑分段控件。
- 电量、游戏模式、帮助与“更多”菜单重新布局。
- 连接和断开过程中显示明确的处理中状态。
- 使用系统强调色，并完善键盘焦点与无障碍语义。
- 蓝牙协议、轮询、重连和设备映射保持不变。
系统要求：macOS 26 或更高版本。
下载 DMG 后双击打开，将应用拖入“应用程序”即可安装。
v1.2.0
更新内容
- 新增“至臻原音、纯享人声、澎湃低音”三种均衡器预设。
- 新增游戏低延迟模式开关，并通过耳机查询回读确认真实状态。
- 新增 Air5 Pro 主动电量同步，可显示左右耳、充电盒电量及充电状态。
- 新增设备信息读取，可查看 Air5 Pro 固件版本。
- 新增可选低电量通知。
- 重新设计菜单栏面板：连接状态和电量固定显示，控制区独立滚动，不再遮挡标题。
- 改进连接后的自动同步、失败重试和状态刷新。
安装方法
下载下方 .dmg，双击打开后，将“OPPO Earbuds Mac Controller”拖入“应用程序”即可。
系统要求：macOS 26 或更高版本。
说明：游戏模式已完成 Mac 端开关与耳机状态回读；手机端的游戏模式入口尚未验证。