HyperEars

源码仓库 · English · 兼容性 · 安装指南 · 问题排查

HyperEars 是面向 Xiaomi HyperOS 的 LSPosed 模块。它为受支持的第三方蓝牙耳机补充 MiLink 融合设备中心所需的设备身份、能力和运行状态,使这些设备能够复用系统原生的 耳机卡片、设备流转和音量控制流程。

模块不替换 Android 的 A2DP/HFP 音频链路,不接管配对、通话或音频路由。私有控制通道 仅由确实需要协议遥测的设备会话建立。

功能

  • 将受支持的第三方耳机发布为 MiLink 耳机设备,复用系统设备流转和音量控制。
  • 按实际适配能力提供整机、左右耳和充电盒电量;标准耳机回退到 Android 系统电量。
  • 将已确认的厂商私有协议映射为系统卡片支持的降噪、关闭、通透和型号专属模式。
  • 兼容旧版 HyperOS 与 HyperOS 4 的原生三态耳机卡片;已确认的抗风噪能力作为降噪 分支开关呈现,不替换系统原生模式按钮。
  • 按用户选择从耳机卡片打开真实蓝牙设备详情、对应厂商控制 App 或 HyperEars;厂商 App 不可用时回退到系统设备详情。
  • 在应用内展示蓝牙会话、协议确认和 MiLink 发布生命周期,便于定位兼容问题;兼容性页面可按 品牌、型号、电量与噪声能力搜索。
  • 应用提供 Miuix 与 Material 3 两套可切换界面;没有已保存界面偏好时默认使用 Miuix。 Miuix 可配置明暗模式、界面缩放、菜单栏模糊和悬浮菜单栏,Material 3 保持系统动态配色 与标准底栏。
  • FitClip Ultra 在协议确认后使用 MiLink 原生模式卡片提供“标准模式 / 游戏模式”, 不会因此声明耳机具有降噪能力。

兼容性概览

品牌或范围 当前适配范围
vivo / iQOO TWS Air3 Pro 实机验证;TWS 3e 公开实现;其他已登记型号使用家族协议确认
OPPO Enco Air2 Pro、Free4、X3、Air5 参考协议;其他 Enco 型号使用家族协议确认
Technics EAH-AZ AZ80 实机验证:组件电量、三态控制;其他 EAH-AZ TWS 公开协议探测
StarRing / 籁特易耳 Ultra 实机验证;其他型号使用标准耳机回退
Bose QuietComfort Headphones 实机验证;已登记 BMAP 产品按产品身份和控制方言细化
Edifier / 漫步者 W860NB PRO、花再 Evo Pro、FitClip Ultra 实机验证;其他已登记型号协议探测
ROSESELSA / 弱水时砂 琉璃 X / Ultra、Furina 实机验证;其他已登记产品公开实现或协议探测
NiceHCK / YuanDao OriG in 公开实现;其他型号使用标准耳机回退
MOONDROP / 水月雨 Robin 公开协议;Pudding 实机验证并提供左右耳、充电盒电量及降噪、关闭、通透;其他型号标准回退
荣耀 X5s Pro 实机验证;协议确认后提供组件电量和降噪、关闭、通透
华为 5i、Pro 3、FreeClip 2 实机验证;FreeClip 2 仅组件电量;其他型号公开实现或家族探测
QCY Crossky C50S 公开协议;同协议家族进行协议确认,其他型号使用标准耳机回退
Sony WF-1000XM6、WH-1000XM4 实机验证;其他已登记型号公开实现或家族探测
其他标准 A2DP/HFP 耳机 设备流转、系统音量和 Android 整机电量回退

“公开实现”“参考协议”和“家族确认”不等于 HyperEars 实机验证。家族适配器默认不 开放未经确认的私有写能力;只有收到合法协议响应后,才向 MiLink 发布对应电量或噪声 控制能力。具体型号、证据等级、判型条件和开放能力以 完整兼容性矩阵为准。

系统要求

  • Xiaomi HyperOS,Android 15 或更高版本;
  • root 与可正常工作的 LSPosed,API 101 或更高版本;
  • 目标耳机已通过系统蓝牙完成配对;
  • LSPosed 必选作用域为 com.android.bluetoothcom.milink.service;如需厂商 App 运行时退避,再按控制 App 目录 勾选实际使用的厂商应用。

公开测试范围包含 HyperOS 4 的 MiLink 原生三态卡片。AOSP、MIUI、非小米 ROM 和 Android 15 以下系统不在当前公开测试范围内。

安装

  1. 从本仓库的 Releases 下载 APK。
  2. 安装 APK,在 LSPosed 中启用 HyperEars。
  3. 确认作用域为 com.android.bluetoothcom.milink.service
  4. 重启设备,使蓝牙进程和 MiLink 进程同时加载模块。
  5. 连接耳机后打开 HyperEars,检查会话中的 Adapter、传输、协议和 MiLink 状态。

首次从早期开发测试包迁移时,如遇签名不一致,应先在 LSPosed 中禁用旧模块、重启、 卸载旧 APK,再安装正式版本并重新启用。完整步骤见 安装指南

架构与扩展

设备匹配按以下顺序回退:

具体型号 Adapter → 厂商品牌/协议家族 Adapter → Standard Bluetooth Adapter

每台已连接耳机拥有独立的有状态 Adapter 和 ProtocolSession。Adapter 负责设备身份、 能力、传输策略与运行状态;ProtocolSession 保存流式解码、握手、序列号和请求队列; WireCodec 只负责厂商帧的字节编解码。UI 和 MiLink 桥只消费统一状态快照,不识别具体 品牌实现。

新增型号通常只需扩展具体型号 Adapter 或家族协议配置。需要协议确认的候选设备先执行 只读探测,确认成功后再更新能力或替换为更具体的 Adapter。完整设计见 系统模块架构

仓库与反馈

本仓库由 Xposed Modules Repository 托管,用于 LSPosed 模块索引元数据和 APK Release。 HyperEars 的源码、开发历史、Issue、Pull Request、完整文档和原始 Release 均由 主仓库维护。

新增设备适配应提供可复现的协议证据,并通过主仓库提交 Pull Request。请勿在 Issue、 日志或抓包中公开完整设备地址、账号信息、密钥或其他个人数据。

许可与声明

HyperEars 以 GNU GPL-3.0-only 发布。本项目与 Xiaomi、vivo、iQOO、OPPO、Panasonic、Technics、Bose、Edifier、 ROSESELSA、NiceHCK、MOONDROP、荣耀、华为、QCY、Sony 及相关品牌无关;商标和产品名称 仅用于兼容性描述。

协议研究所参考项目及其许可证见主仓库的 第三方声明

Releases

2.6.0

Stable

8/31/2026, 5:39:58 PM

本版新增 Technics、ROSE、华为和 Sony 多款耳机适配,为 Edifier FitClip Ultra 增加
充电盒电量与游戏模式控制,并完成 Miuix / Material 3 的界面设置和导航体系。

新增与完善的设备适配

  • 新增 Technics EAH-AZ TWS 家族适配。EAH-AZ80 已完成实机验证:合法 Airoha RACE
    响应确认后提供左右耳与充电盒电量,以及降噪、关闭、通透三态控制;其他 EAH-AZ 型号
    依据公开实现进入协议探测,EAH-A800 头戴系列不参与该规则。
  • 新增 ROSE Ceramics X(琉璃 X)实机适配:关联独立的 CERAMICS X BLE 控制端点,
    合法状态响应确认后提供降噪、关闭、通透和抗风噪;协议未确认时保留系统整机电量,
    不推测抓包中尚未确认的私有电量字段。
  • 新增 HUAWEI FreeBuds 5i 实机适配:使用已验证的 RFCOMM Channel 16,分别以合法电量帧
    和模式帧确认组件电量与降噪、关闭、通透;未验证的型号专属档位不开放。
  • 新增 HUAWEI FreeClip 2 实机适配。该开放式夹耳型号只在合法电量帧后提供左右耳与
    充电盒电量,不查询、不展示也不接受降噪控制;原版 FreeClip 继续使用既有家族探测。
  • 新增 Sony WF-1000XM6 实机适配:使用 v2 服务和 0x19 环境声方言,提供双耳、
    充电盒电量及降噪、关闭、通透;模式写入和确认提示音标志均已通过实机与 Sound Connect
    流量验证。
  • 修复 Sony WH-1000XM4 的握手兼容。仅该精确型号在握手前收到设备命令时允许重发一次
    初始化请求,不延长其他 Sony 或全局设备会话的握手时间。

Edifier FitClip Ultra

  • 补充充电盒电量,并将设备回报的游戏模式建模为 FitClip Ultra 专属状态与控制请求;只有
    合法 0x08 / 0x09 回包后才展示和控制,写入后以设备回读为准。
  • 游戏模式复用 MiLink 完整的原生模式卡片,将其显示为“标准模式 / 游戏模式”;卡片尺寸、
    间距、裁切和动画继续由 MiLink 管理,同时兼容旧版与 HyperOS 4 的原生布局。
  • 该呈现方式不声明 FitClip Ultra 具备降噪能力。退出卡片、协议重置或厂商 App 接管时恢复
    原生视图和保守能力,不保留高度修补、延时重绘或测试 Adapter。

应用界面

  • 将“界面风格”放在一级设置页;没有已保存偏好的安装默认使用 Miuix,已明确选择的风格
    继续保留。Miuix 与 Material 3 共用页面、设置和设备状态模型。
  • 新增完整“界面设置”:明暗模式、界面缩放,以及 Miuix 专属的菜单栏模糊、悬浮菜单栏和
    实时效果预览。Material 3 保持系统动态配色与标准底栏,不显示不适用的 Miuix 选项。
  • 每个主页、设置和关于页面维护独立标题与滚动状态;从二级页面返回时回到原入口,切换风格、
    点击底栏或横向滑动时保留当前页面,不再出现逐页跳转、标题错位或额外弹跳/缩放动画。
  • 移除未达到系统交互质量的“液态玻璃”选项及其状态,统一 Miuix 与 Material 3 的设置分组、
    操作行、兼容性入口和检查更新入口。

架构、文档与验证

  • 新增协议端点的写入方式、通知要求和配套设备选择均由具体 Adapter 声明;Technics、ROSE、
    华为和 Sony 的协议确认、能力解锁、控制回读与会话重置保持型号内有界处理。
  • 华为共享 ProtocolSession 现在可明确表示仅电量画像或附带型号扩展的噪声画像;FitClip
    游戏模式通过类型化状态和请求接入,不向全局三态控制增加型号字段。
  • 同步中英文 README、兼容性矩阵、协议记录、控制 App 目录与第三方许可证;增加新增型号的
    名称边界、流式解帧、协议门禁、电量、模式控制、卡片恢复和界面偏好回归测试。

Assets

2

2.5.0

Stable

8/25/2026, 6:47:35 PM

本版新增可切换的 Miuix 与 Material 3 应用界面、独立可搜索的兼容性页面,并加入
MOONDROP Pudding 实机适配;同时更新 Android、Kotlin 与 Gradle 构建工具链。

应用界面

  • 新增 Miuix 与 Material 3 两套渲染风格,可在设置页即时切换;没有已保存界面偏好的
    新安装或升级用户默认使用 Miuix,已经明确选择的风格继续保留。
  • 两套界面共用页面导航、设置状态、设备会话模型和控制请求。切换风格不会重建蓝牙或
    MiLink 会话,也不会把界面偏好写入注入进程配置。
  • 按 HyperOS 页面层级重新组织 Miuix 主页、设置和关于页;设置开关、二级页面、快捷控制、
    证据标签和设备会话卡片使用统一的信息层级。Material 3 同步相同的分组、操作和状态语义。
  • Root 快捷控制与日志导出改为整行点击,执行时不再重复弹出操作说明;主页模式值保留明确的
    下拉入口,并继续通过当前会话的标准控制请求切换。

兼容性页面

  • 将品牌与型号矩阵从关于页拆为独立二级页面,关于页只保留“兼容性”入口。
  • 支持按品牌、型号、验证级别、电量类型和噪声能力搜索;多个关键词组合筛选同一条适配记录。
  • Miuix 与 Material 3 使用同一份兼容性数据和筛选逻辑,只分别渲染对应主题组件。

MOONDROP Pudding

  • 新增 MOONDROP Pudding 实机适配。精确名称只用于选择候选,收到完整合法握手响应后才进入
    私有协议会话并分别开放组件电量与降噪、关闭、通透三态控制。
  • 解析左右耳与充电盒电量,合并连接初期的分侧回报,并使用有界单次查询补齐缺失组件;协议
    未确认或三个组件均不可读时继续保留 Android 系统整机电量回退。
  • 模式写入成功后先发布目标状态,再按设备实测时序执行有界只读回查;回包达到目标后立即停止,
    超过边界则接受最后真实状态,不重复发送设置命令,也不创建常驻轮询。
  • 水月雨控制 App 已接入“更多设置”和运行时退避;厂商 App 不可用或未进入作用域时不增加
    后台进程监控或控制通道开销。

构建与验证

  • 更新至 Gradle 9.5.0、Android Gradle Plugin 9.3.1、Kotlin 2.4.10、AndroidX Core 1.19.0
    与 Lifecycle 2.11.0,并保持 Android 15 最低版本和现有模块作用域不变。
  • 增加 Pudding 名称边界、流式解帧、握手、电量、三态控制、写后回查,以及界面风格恢复和
    兼容性多关键词搜索测试;Release 流程继续执行完整单元测试、Android Lint、R8、APK
    签名验证和 SHA-256 生成。

Assets

2

2.4.1

Stable

8/22/2026, 6:11:58 PM

本版新增 Edifier FitClip Ultra 与华为 FreeBuds 系列适配,并修复部分旧版 MiLink 耳机
卡片缺少标题区域时抗风噪开关无法正确集成的问题。

设备支持

  • 新增 Edifier FitClip Ultra 实机适配。精确识别该型号,并在收到合法 0xF2 响应后
    提供左右耳私有电量;该型号未验证降噪协议,因此不展示或发送私有模式控制,协议不可用时
    保留系统整机电量、音量与设备流转。
  • 新增 HUAWEI FreeBuds Pro 3 实机适配:支持组件电量、降噪、关闭、通透,以及已验证的
    降噪四档和透传两档;耳机侧状态变化能够通过协议通知同步至模块。
  • 新增 HUAWEI FreeBuds 4 公开协议适配,并为 FreeBuds、FreeClip、FreeLace 产品线提供
    家族协议探测。只有合法协议响应确认后才开放对应的私有电量与模式能力,其他华为音频设备
    不会被家族规则接管。
  • 华为家族候选在同一个会话中依次尝试已知 RFCOMM 端点;端点失败、协议未确认或厂商 App
    接管时均回退到标准耳机能力。华为智慧音频已接入现有“更多设置”与运行时退避机制。

MiLink 卡片兼容

  • 兼容没有独立标题区域的旧版 MiLink ANC 卡片:在原生三态控件内部增加紧凑的“抗风噪”
    开关行,保留系统原有降噪、关闭、通透按钮的完整宽度、层级与点击处理。
  • 有标题区域的旧版卡片与 HyperOS 4 新版卡片继续使用原来的稳定集成路径;布局选择只依据
    已确认的资源标识和原生 View 类型,不依赖系统版本号、混淆方法、布局扫描或延时重试。
  • 修正同时存在多个候选 ANC 容器时的宿主选择,仅绑定当前可见且属于目标卡片的原生控件,
    避免开关缺失或插入错误布局。

架构与验证

  • FitClip Ultra 与华为适配均遵循“身份选择候选、合法协议响应解锁能力”的统一门禁;私有
    电量与模式分别确认,不会因型号名称或端点可连接而提前开放未验证功能。
  • 华为 FreeBuds 使用配置化 ProtocolSession 复用协议对话,CRC16/XMODEM 校验通过后才
    接受握手、电量和模式状态;Pro 3 的型号专属档位通过类型化状态与控制扩展接入。
  • 增加型号边界、协议确认、组件电量、噪声状态、档位控制、端点回退和卡片布局测试;Release
    流程继续执行完整单元测试、Android Lint、R8、APK 签名验证和 SHA-256 生成。

Assets

2

2.4.0

Stable

8/21/2026, 2:21:56 AM

本版适配 HyperOS 4 的新版耳机详情卡片,并统一带抗风噪能力设备的系统卡片呈现;同时
收紧厂商控制 App 退避与私有协议重连期间的能力生命周期。

HyperOS 4 卡片兼容

  • 适配 HyperOS 4 新增的原生三态选择卡片,同时保留旧版 HyperOS 的原生 ANC 卡片路径。
    两种布局按稳定资源标识和原生 View 类型识别,不依赖系统版本号、混淆方法、布局遍历、
    轮询或延时重试。
  • Edifier、StarRing、ROSESELSA 和 NiceHCK 的已确认抗风噪能力统一使用“系统原生三态 +
    抗风噪开关”。降噪、关闭和通透继续由 MiLink 原生控件处理,抗风噪仅作为降噪分支的型号
    扩展,不再替换或复制原生模式按钮。
  • 卡片扩展仍只在卡片绑定时创建一次,只消费统一设备状态并发送标准模式请求,不参与蓝牙
    通信、状态轮询或协议解码。

会话与诊断

  • 私有通道断开、厂商控制 App 接管或连接重试时,撤销上一轮协议会话确认的私有电量、模式
    和专属卡片能力;Android 系统电量立即恢复为保守回退,重新握手成功后再开放真实能力,避免
    恢复窗口出现可见但不可操作的旧模式。
  • 详细日志开启时记录私有通道收到的原始字节,便于分析尚未映射的状态字段;关闭详细日志时
    不构造或输出这些记录。

文档与验证

  • 更新 Edifier BES 协议说明、HyperOS 平台范围和卡片扩展边界,明确花再 Evo Pro 当前仅确认
    左右耳电量,充电盒字段仍保持未知。
  • 增加协议会话重置、系统电量回退、原生三态与抗风噪开关控制策略测试;Release 流程继续执行
    完整单元测试、Android Lint、R8、APK 签名验证和 SHA-256 生成。

Assets

2

2.3.2

Stable

8/13/2026, 4:50:43 PM

本版修复 ROSE Ceramics Ultra(琉璃 Ultra)的模式识别与组件电量,并为未知 MiLink
版本补充严格、低开销的“更多设置”入口兼容。

ROSE Ceramics Ultra

  • 根据实机完整状态帧补齐 BudsFeel 的自适应降噪 0x05 与极致降噪 0x06 状态解码;
    两者作为已确认的降噪状态接入现有标准四态卡片,不新增私有控件,卡片重新选择降噪时仍发送
    标准 0x01 命令。
  • 按 BudsFeel 组件电量格式从每个字节的低七位读取百分比。实测 E4 E4 5E 现在显示为
    左右耳 100%、充电盒 94%;尚未确认语义的高位不会被推测为充电状态。
  • 合法模式回报现在能够完成协议确认并开放降噪、关闭、通透和抗风噪;未知模式或无效电量仍不
    会提前开放私有能力。

MiLink 兼容

  • “更多设置”入口继续优先使用稳定公开类和已验证的 17.2.017.2.2 精确版本表;常规入口
    均不可用时,增加一次性的 DEX 语义指纹兜底。
  • 兜底同时校验 headset 包范围、单个 CirculateServiceInfo 参数、CompletableFuture 返回值、
    两个精确语义常量和 CompletableFuture.supplyAsync 调用。只有唯一结果才安装 Hook,零结果或
    多结果均保持系统原行为。
  • DEX 查询结果按当前 APK 路径缓存,每个 MiLink 进程最多解析一次;已支持版本不会加载解析器,
    卡片创建、点击和蓝牙协议会话均不参与扫描。

文档与验证

  • 补充 ROSE Ceramics Ultra 扩展模式、电量高位和 MiLink 语义入口的实现边界,并登记 DexKit
    许可证与实际使用范围。
  • 增加实机完整帧、扩展降噪值、组件电量和 Adapter 标准状态投影测试;Release 流程继续
    执行完整单元测试、Android Lint、R8、APK 签名验证和 SHA-256 生成。

Assets

2

2.3.1

Stable

8/13/2026, 12:50:44 AM

本版修正漫步者四态控制与花再 Evo Pro 电量解析,并整理主页模式切换和卡片“更多设置”
选择方式。

漫步者兼容

  • 漫步者协议确认后的四态卡片统一使用 MiLink 原生控件展示降噪、通透、关闭和抗风噪,
    四项保持互斥;选择抗风噪时不再同时点亮降噪。
  • 修正花再 Evo Pro 0xF2 复合状态帧解析:首字节是元数据,不再误报为 3%;按照实机回包
    分别显示左右耳电量,不再把未确认字段当作充电盒电量或充电状态。
  • 四态卡片只在漫步者协议确认并开放对应模式后启用;未确认私有协议时仍保留标准流转、
    音量和 Android 整机电量回退。

应用交互

  • 主页不再额外增加一组模式按钮;原有“模式”指标在设备开放多个模式后可以直接点击,
    通过下拉列表切换,当前模式由统一会话状态更新。
  • 设置页将卡片入口标为“点击卡片‘更多设置’”,当前动作显示在设置项右侧;点击后可直接
    选择“打开系统设置”“打开厂商 App”或“打开 HyperEars”。

构建、文档与验证

  • 新增维护者手动签名构建流程:使用正式发布证书完成测试、Lint、Release 构建、签名验证和
    SHA-256 生成,只上传短期 Actions Artifact,不创建版本标签或 GitHub Release。
  • 同步中英文 README、兼容性矩阵、漫步者协议说明和应用内兼容性信息;增加花再 Evo Pro
    复合电量帧、漫步者能力映射及四态卡片策略测试。

Assets

2

2.0.0

Stable

8/8/2026, 8:08:20 AM

架构

  • 将 MiLink 卡片、详情扩展和蓝牙设备会话的控制路径统一为强类型 ControlRequest。标准刷新和
    三态模式控制由 Adapter 的当前已确认能力统一校验,现有 vivo、OPPO、Bose、StarRing、
    Edifier、ROSESELSA、NiceHCK、Sony 及保留的 Apple 协议实现均已完成迁移。
  • 使用版本化、严格校验且有大小上限的自动序列化控制信封替代手写 Intent extra。后续型号可通过
    请求子类型和 Adapter 契约增加专属控制,不需要修改公共 IPC 分发或 MiLink 生命周期代码。
  • 将电量、噪声模式和后续型号专属状态统一为带类型的 DeviceFeatureState 快照。协议事件、
    Adapter 运行态、跨进程状态传输、运行看板和 MiLink 平台投影共用同一状态链路,不再维护固定
    电量/降噪字段或型号专属状态 extra。
  • 将命令确认、乐观状态发布和冷却统一收敛为 Adapter 声明的请求级 ControlExecutionPolicy
    W860NB PRO、Evo Pro 等型号只保留各自已验证的控制策略,MiLink UI 不再维护型号专属限流状态。

兼容性与可靠性

  • 私有控制仍以当前 Adapter 已确认的能力为准:未通过协议证据确认的请求会在 Bluetooth 会话中
    被拒绝,不会写入耳机;来自设备的状态报告才是最终状态来源。
  • 家族探测、具体型号升级和保守回退均保留同一设备会话中的有效状态,并过滤替换后 Adapter
    不理解的状态,避免旧协议或旧型号状态泄漏到新的卡片呈现。
  • 保持现有的 MiLink 原生电量和三态降噪投影,以及各型号已有的私有协议行为;本次不增加 UI
    轮询、常驻扫描或额外系统注入范围。

验证

  • 增加控制请求传输、状态快照传输、状态替换/过滤、请求能力校验、请求确认策略和各适配器
    迁移的单元测试。
  • 覆盖畸形、未知、版本不符或超出大小限制的跨进程请求与状态载荷拒绝路径,确保它们不会触发
    耳机写入或污染已发布的会话状态。

Assets

2

1.3.1

Stable

8/8/2026, 12:33:16 AM

新增

  • Furina Endless Solo of Solitude:新增已实机验证的具体型号适配。通过 BudsFeel
    RFCOMM 通道确认协议后,发布左右耳与充电盒私有电量,以及降噪、关闭、通透和抗风噪四种模式。
  • 系统原生耳机退避:MiLink 已经原生识别的耳机优先由系统接管。HyperEars 不再覆盖同一
    设备的身份、能力、卡片或控制请求;该规则也适用于系统原生支持的 Apple 等品牌耳机。
  • 旧版 MiLink 设置入口兼容:为已验证的 17.2.0.1.2601081906 增加严格版本限定的
    “更多设置”入口兼容。HyperEars 卡片可继续跳转至厂商控制 App 或真实蓝牙设备详情。

修复

  • BudsFeel 响应按实际帧长度、校验和和结束标记解析;支持设备独立上报的组件电量帧与聚合状态帧,
    不再把独立电量响应遗漏为未知数据。
  • 修复家族协议首次试探始终未确认后仍保留私有通道和控制项的问题。此时会降级为对应品牌的
    标准耳机能力,保留流转、音量和系统电量回退。
  • 修复卡片缓存仍保留旧型号呈现信息的问题;Adapter 降级后,MiLink 同步移除不再适用的
    私有卡片扩展。

调整

  • 移除 Furina 协议测试版的逐帧强制追踪。正式版仅在用户开启“详细日志”时产生常规模块诊断日志。
  • 私有传输候选的创建失败会继续尝试同一 Adapter 声明的后续候选,不会提前终止本次有界连接尝试。
  • 应用图标改为自适应设计:白色画布和图形安全留白由图标本身提供,桌面、Dock 及其他
    系统入口保持一致的视觉比例。
  • 调整主页、设置和关于页的底部安全区,移除页面内容与底部导航之间的空白;设置项标题和说明
    采用与关于页一致的 Material 文字层级。

验证

  • 基于实机导出的 BudsFeel RFCOMM 日志,覆盖协议握手、四种模式控制、状态回读、独立组件电量、
    分片、合帧和异常长度帧重同步。
  • 覆盖 MiLink 原生所有权仲裁、家族协议降级与卡片解绑回归场景;在 Xiaomi 设备上完成
    Release 构建、签名校验和安装验证。

Assets

2

2.2.1

Stable

8/9/2026, 4:53:54 PM

本版完善状态刷新时机,并修复详细日志和适配器开关在应用重启后可能恢复默认值的问题。

状态刷新

  • 打开 MiLink 耳机详情卡片或进入 HyperEars 主页时,现在会为每个活动设备执行一次完整状态
    刷新。卡片仍先使用现有快照完成首帧,模式和电量等真实协议回报随后通过统一状态链更新。
  • 同一设备会话在 1.5 秒内收到的重复刷新会合并为一次协议事务;关闭卡片不会触发查询,也不
    增加常驻轮询。刷新门禁与用户控制节流相互独立,不会阻止紧随其后的模式切换。

设置可靠性

  • 修复没有禁用任何适配器时,空的适配器集合无法由 LSPosed 守护进程反序列化,进而导致整次
    设置写入失败的问题。详细日志、模块暂停、厂商设置和运行时退避等设置现在能够在应用或作用域
    进程重启后保持。
  • 跨进程集合统一转换为 Java 平台集合,避免 LSPosed 守护进程依赖模块内的 Kotlin 集合实现。

验证

  • 增加刷新合并、系统时钟重置和 RemotePreferences 集合类型测试。
  • 已在 vivo TWS Air3 Pro 上验证主页打开、卡片打开、卡片关闭与重新打开的刷新时序;每次可见
    事件只建立一次刷新事务,模式控制仍只发送一次设置帧,并在耳机真实回报后更新卡片。

Assets

2

2.1.0

Stable

8/9/2026, 7:53:08 AM

相较于 2.0.0,本版新增荣耀、水月雨和 QCY 设备适配,并加入可按品牌与具体适配器管理
接管范围的调试功能;同时收紧私有能力确认与失败回退,避免未验证的控制项提前出现在卡片中。

新增功能

  • 适配器管理:在“调试 > 适配器”中按品牌查看具体型号、协议家族和标准回退。每个品牌
    提供总开关,也可以单独停用某个适配器;设置变化会重新评估当前已连接设备,无需重启模块。
  • 荣耀亲选耳机 X5s Pro(BTV-ME10):新增实机验证适配,协议确认后提供左右耳、充电盒
    电量以及降噪、关闭、通透三态控制。协议层同时记录智能、轻度、中度、深度四档降噪深度,
    供型号专属卡片扩展使用;当前 MiLink 原生卡片仍使用三态控制。
  • MOONDROP Robin / 水月雨知更鸟:根据公开协议实现左右耳电量和降噪、关闭、通透三态
    控制。已知完整名称或同时包含品牌与型号的名称才会进入协议确认。
  • QCY Crossky C50S / QYCC50S:根据公开协议实现左右耳、充电盒电量和原生三态降噪;
    名称符合 QCY / Crossky 规则的其他设备可以进行同协议家族探测,失败后保留标准能力。
  • QCY 控制 App 协同:卡片“更多设置”可以打开已安装的 QCY App;将该 App 加入 LSPosed
    可选作用域后,也可以参与现有的运行时退避和“停止厂商应用”快捷操作。

兼容性与修复

  • 家族和公开协议适配器默认只发布流转、音量和 Android 系统整机电量。左右耳/充电盒电量、
    降噪和通透等私有能力现在分别等待合法协议响应确认;某项未确认时不会显示对应控制。
  • 初始协议探测增加明确截止时间。候选端点不可用、握手超时或声明的回退适配器已被用户停用时,
    会按当前设置退回可用的保守适配,不会保留失效私有通道或不可点击按钮。
  • Robin 设置噪声模式后主动查询耳机状态,卡片只使用设备回读结果,修复控制生效但界面长期
    停留在旧模式的问题。
  • 标准 SPP UUID、通用 GATT 服务和单独的厂商广播数据不再作为品牌判定依据,降低无关耳机
    被错误接管的风险。

架构与性能

  • 适配器目录成为连接匹配和设置界面的统一数据源;界面只读取品牌、名称、层级和启用状态,
    不包含具体耳机的判型或协议逻辑。展开较长品牌列表时使用按需构建的惰性列表,减少首帧工作。
  • 为音频端点与控制端点分离的设备增加通用伴生 GATT 端点机制。QCY 会先检查当前设备和已配对
    端点,必要时执行一次带厂商过滤条件、最长 8 秒的定向扫描;不会持续扫描或影响无关设备。
  • QCY 协议仍通过系统原生电量与三态卡片呈现,不增加自定义卡片、布局扫描或混淆方法 Hook。

文档与质量

  • 新增荣耀 X5s Pro、MOONDROP Robin 和 QCY 标准 GATT 协议文档,更新中英文 README、兼容性
    矩阵、控制 App 目录、架构说明、第三方来源与许可证记录。
  • 增加能力确认、失败回退、适配器开关、协议流式解码、设备状态回读和伴生端点关联测试。
  • Markdown、站内链接、控制 App 目录、单元测试、Android Lint、R8 Release 构建和签名发布
    均由 CI 校验。

Assets

2

1.3.0

Stable

8/7/2026, 10:22:55 AM

相较于 1.2.0,本版重点完善厂商控制 App 协同、模块设置、诊断和应用界面;不新增具体耳机协议型号。

新增功能

  • 厂商 App 运行时退避:开启设置并完成对应 LSPosed 作用域后,支持的厂商控制 App 运行期间,
    HyperEars 暂停自己的私有耳机控制,把控制权交给厂商 App;厂商 App 退出后自动恢复。MiLink
    流转、系统音量和 Android 音频路由不受影响。
  • 厂商设置入口:从融合设备中心卡片的“更多设置”打开对应厂商控制 App。功能关闭、App 未安装
    或无法启动时,自动打开真实蓝牙设备详情。
  • 模块暂停:可在设置页暂时停用 HyperEars 集成;不会关闭 Android 蓝牙或音频,恢复后重新连接
    耳机即可建立新的模块会话。
  • 诊断日志导出:通过系统文件选择器导出模块进程日志和 HyperEars 应用操作日志,合并为一个文本文件。
  • Root 快捷操作:设置页增加重启 MiLink、重启蓝牙和停止支持的厂商控制 App。

使用体验

  • 应用界面重构:主页、设置和关于页改为独立的 Material 3 页面;主页按设备分别展示识别、
    连接通道、协议、能力和 MiLink 发布状态。
  • 日志行为调整:详细日志关闭时不产生模块诊断记录;开启后,注入进程日志写入 LSPosed 守护进程,
    应用内设置变更和快捷操作结果写入本地滚动日志。
  • 控制权恢复更稳定:厂商 App 退出、崩溃或被强停后,模块自动恢复自己的私有控制;该判断不依赖
    厂商 App 是否建立了蓝牙连接。
  • 正式包精简:移除未使用的构建工具和调试资源,并加入启动优化配置。

文档与质量

  • 新增厂商控制 App 使用与 LSPosed 作用域目录,说明哪些 App 支持“更多设置”和运行时退避。
  • 统一中英文 README、兼容性、安装、排障、架构、隐私、贡献和第三方声明的术语与结构。
  • 增加文档格式、链接、YAML、控制 App 目录和 scope.list 的自动校验,并补充设置同步、退避和日志导出测试。
  • 本地测试、Release lint、正式构建、签名校验和 SHA-256 发布验证全部通过。

Assets

2

1.2.0

Stable

8/6/2026, 11:17:42 AM

Added

  • 根据社区贡献者的实机抓包,为 Edifier 花再 Evo Pro 增加具体型号适配:使用 0x1B
    ANC 槽位、0xF2 聚合电量响应及六值噪声模式方言,提供左右同值电量和四态控制。

Architecture

  • 将 Edifier ANC 槽位、模式编解码、电量查询来源和电量投影建模为协议方言配置;W860NB
    PRO、Evo Pro 与家族只读探测复用同一 ProtocolSession,四态 MiLink 展示不再绑定单一型号。

Fixed

  • Bose 家族判型不再把公共 accessory-side UUID 当作品牌身份;改用 Bose 专属服务证据,
    并保留该 UUID 仅作为传输候选。
  • Sony 家族仅使用 Sony 私有控制服务 UUID 参与服务判型,避免公共 UUID 将其他设备误判为
    Sony 或 Bose。
  • 增加共享 UUID、Bose 专属服务和标准耳机回退的注册表回归测试。

Changed

  • 默认适配注册表不再注册系统已有原生支持的设备适配;相关协议实现仍保留在源码中供
    显式测试使用。
  • 协议测试工具的 Bose 传输候选名称与说明改为反映实际端点用途。

Documentation

  • 同步中英文 README、兼容性矩阵、架构说明、贡献规范和应用关于页,使支持范围、单一
    有状态 Adapter、ProtocolSession 和判型证据与当前实现一致。

Assets

2