本版修复部分 HyperOS 3 设备的弹窗、超级岛兼容问题，以及电量更新时弹窗重复出现、通知
内容不更新或点击跳转错误的问题。更新范围为 v3.2.0 至本版。

HyperOS 3 兼容

• 兼容部分系统蓝牙扩展的入口变化，修复原生耳机检查、超级岛电量读取及连接提示条件检查
  失败，导致弹窗或超级岛无法显示的问题。
• 修复临时检查失败后，本次连接一直无法恢复展示的问题；系统正在连接或显示其他提示时
  继续避让。

电量弹窗

• 修复先显示整机电量、随后收到左右耳和充电盒电量时，弹窗关闭后再次弹出的问题。
  电量与适配图片现在更新到已有窗口，保留原生关闭、点击和动画状态。
• 修复弹窗启动期间电量已更新，首次显示仍使用旧单电量布局的问题。
• 保留系统整机电量回退；组件电量到达后直接补齐，未知充电盒电量保持隐藏。

电量通知

• 修复连接初期的通知可能停留在整机电量，后续左右耳、充电盒电量未能更新的问题。
• 修复点击通知误入小米专用耳机详情页的问题。首次通知和更新后的通知均按照当前
  “点击卡片‘更多设置’”选项，打开系统设备详情、厂商 App 或 HyperEars。
• 同次连接在同一条通知中更新电量，已有通知更新不重复提醒；保留原生删除及断开操作。

调试预览

• 手动预览可再次展示已结束的连接提示。
• 预览会反馈未连接、电量未就绪、系统占用或入口不可用等结果；未收到系统耳机服务响应时
  给出提示，便于判断需要重载作用域还是检查连接状态。

使用与说明

• 修复版已收到 vivo TWS 4 用户的实机正常反馈，同步更新原生展示、资源及排障文档。
• 覆盖安装后，请重启设备，或在 HyperEars 设置中分别执行“重启蓝牙”和“重启 MiLink”，
  让各作用域加载新模块；若旧版电量通知仍在，请先划掉，再重新连接耳机。

本版新增按设备选择适配器的调试功能和水月雨 ZZZ-ANGELS-OWS 支持，修复原生电量弹窗
可能丢失百分比的问题。更新范围为 v3.1.1 至本版。

原生电量弹窗

• 修复电量已回报、弹窗仍只显示耳机图片的问题：弹窗启动期间到达的电量会参与首次显示，
  后续回报继续更新已有窗口。
• 修正重连、断开与弹窗启动之间的状态同步，避免旧快照覆盖新状态；连接结束或系统接管后，
  旧弹窗请求及时失效。未知电量、真实 0% 和各组件充电状态保持独立显示。
• 感谢 kmou424 提供问题定位、修复思路和回归测试。

强制适配器

• 新增“设置 → 调试 → 强制适配器”，可为指定耳机选择协议探测入口，并按品牌、型号搜索，
  用于测试不同型号之间的协议兼容性。
• 选择后立即重新建立该耳机的模块会话；切回“自动识别”即可恢复正常匹配规则。
  只跳过型号匹配，私有电量和控制仍须有效协议响应确认，系统原生耳机保护保持生效。
• 修复修改适配器设置时，其他已完成型号确认的会话可能被无谓重建的问题。

MOONDROP ZZZ-ANGELS-OWS

• 新增水月雨 × 绝区零“妄想天使·闪亮登场”耳夹款的左右耳电量读取，保留系统流转和音量
  控制。当前实测协议提供左右耳电量，该型号无降噪功能。
• 连接初期自动补查尚未就绪的耳侧；设备明确回报电量未知时清除旧值，避免继续显示失效读数。
• 维护版已通过首次连接、电量更新、重连及厂商 App 退避恢复复核。固件 1.2.0 在单耳入盒时
  可能继续回报该耳上一次电量，模块按设备实际回报显示。
• 感谢 YifePlayte 提供协议资料、适配代码和实机复核。

使用与说明

• 更新兼容性表、控制 App 目录、协议来源及强制适配的排障说明。
• 覆盖安装后，请重启设备，或在 HyperEars 设置中分别执行“重启蓝牙”和“重启 MiLink”，
  让各作用域加载新模块；仅覆盖 APK 或重新打开 HyperEars 不会更新已运行的注入代码。

本版修复部分耳机已连接并读到电量，连接提示仍不出现的问题，同时补齐厂商控制 App 识别。
更新范围为 v3.1.0 至本版。

连接提示与电量通知

• 弹窗、超级岛和电量通知独立于 MiLink 的启动状态，由系统耳机服务所在进程直接完成
  原生接管检查，无需先打开融合设备中心。
• 系统已登记的耳机继续使用原生展示；系统后续接管时，模块同步退出对应展示和设备会话。
• 只有整机电量的 TWS 可使用原生单电量提示，显示耳机图形和一个百分比；未知盒电量保持隐藏。
• 修复状态补发导致新连接漏提示的问题；已有连接恢复状态时仍不重复弹出。

厂商控制 App

• 修复 Bose 中国版已安装却显示未安装的问题。
• 补充 QCY 中国版、EDIFIER ConneX、华为智慧生活，支持设置跳转和已开启的运行时退避。
• 补齐 7 个三星控制插件的应用查询和旧版作用域声明，统一校验控制 App 名单与文档。

诊断与说明

• 详细日志增加原生接管判断、插件就绪和展示跳过原因，便于定位“有电量但没有提示”。
• 补充琉璃 X 的协议证据与电量范围说明；该型号继续显示系统整机电量，左右耳及盒电量
  待协议资料补齐。琉璃 Ultra 已有组件电量解析保持不变。
• 升级后重启设备，或分别执行“重启蓝牙”和“重启 MiLink”，让各注入进程加载新版模块。

本版让耳机电量通知和连接弹窗共用卡片的设置打开选项，并改善 ROSE Ceramics X 部分固件
与零售批次的连接兼容性。更新范围为 v3.0.1 至本版。

耳机设置入口

• 点击电量通知或连接弹窗的耳机／电量内容区，可直接打开系统设备详情、厂商 App 或
  HyperEars，沿用设置页已有的“点击卡片‘更多设置’”选项。
• 每次点击都使用当前耳机和最新设置；厂商 App 或 HyperEars 不可用时回退到系统蓝牙详情。
  成功打开目标后关闭对应弹窗。
• 保留原生通知的“断开”、清除操作，以及弹窗原有关闭方式；系统原生接管的耳机继续使用
  官方路径。

ROSE Ceramics X（琉璃 X）

• 修复部分固件和零售批次无法找到私有控制通道的问题，兼容控制通道与音频蓝牙使用同一
  地址的设备，同时保留独立控制端点的支持。
• 控制端点仍通过设备关联信息确认，协议响应成功后开放模式控制；未确认时保留标准集成。
• 作者已完成维护版连接、模式控制、重连和厂商 App 退避恢复复核。感谢
  mimai114514 提供修复与实机验证。

使用与维护

• 更新中英文介绍、安装、控制 App 和架构文档，说明三个设置入口的共用行为与回退规则。
• 升级后使用“重启蓝牙”重新加载原生耳机弹窗／通知，使用“重启 MiLink”重新加载融合设备
  中心；也可直接重启设备。

本版修复“重启蓝牙”未重载新增耳机展示宿主的问题，并补全 3.0.0 的超级岛电量检查。
更新范围为 v3.0.0 至本版。

修复

• “重启蓝牙”现在同时重新加载系统蓝牙和系统耳机服务，避免升级或调整作用域后仍保留
  旧进程，出现“仅弹窗”未按选择执行或新增提示没有反应的情况。
• 重启操作检查旧宿主进程是否退出；停止某个宿主失败时仍会请求恢复蓝牙，并报告操作失败。
  结果沿用详细日志记录，不常驻显示在设置页。
• 将已有的有效电量判断接回超级岛发送入口，修复连接初期电量尚未到达就提交无效显示参数
  的问题。电量到达后由正常状态事件触发，不增加固定延迟或轮询。

诊断与使用

• 详细日志补充连接展示选项、通知开关、宿主实际应用的配置，以及各作用域加载的模块版本，
  便于区分设置未保存、旧进程残留和原生显示条件限制。
• 更新快捷操作说明；首次配置作用域后仍建议重启设备。“重启 MiLink”继续只负责 MiLink，
  重新加载蓝牙及原生耳机提示时使用“重启蓝牙”。

本版新增耳机连接时的系统原生电量弹窗、超级岛提示和独立电量通知，并为弹窗提供通用
耳机与充电盒图片。更新范围为 v2.8.0 至本版。

连接提示与电量弹窗

• 新增“连接时显示”：智能、仅弹窗、仅超级岛、关闭。默认使用智能模式，按系统判断
  在桌面或外屏桌面显示电量弹窗，在其他应用内显示连接超级岛；已有测试版的明确选择会保留。
• 电量弹窗使用当前耳机的真实状态，分别显示左右耳、充电盒或头戴式整机电量，后续回报
  更新已有窗口；未知电量及时清除。已知盒电量可正常显示，无需耳机处于充电状态。
• 超级岛在可用耳机电量到达后提交，使用系统原生动画和显示时长。当前显示左右耳或
  整机电量，不包含充电盒；只有系统整机电量的 TWS 暂不使用头戴式超级岛模板。
• 同一次系统连接只提交一次连接展示；协议重连、型号细化或打开应用不重复弹出。
  锁屏、已有系统窗口及流转状态仍参与展示判断，受阻时不增加轮询或定时重试。
• 新增通用双耳、头戴耳机和充电盒图片。各型号共享默认资源，也可声明专用图片；
  继续使用系统布局、电量图标、充电标志和关闭方式。

耳机电量通知

• 新增独立的“耳机电量通知”开关，默认关闭；连接弹窗和超级岛不依赖此开关。
• 通知随已接受的电量状态更新，保留原生“断开”操作；点击详情打开对应耳机的系统蓝牙设置。
• 沿用原生清理行为：通知可以清除，后续状态回报可重新发布，不额外限制为本次连接不再显示。

兼容性与诊断

• 修正 MiLink 的设备归属判断，服务未绑定、蓝牙关闭等错误返回不再被当作系统已支持设备。
• 为展示状态增加来源、会话和连接校验，避免迟到状态、历史回放或旧窗口更新影响当前设备。
  系统已支持的耳机继续由原生路径处理。
• 调试页增加“预览超级岛”和“预览电量弹窗”；详细日志增加展示选择、提交、更新和关闭记录，
  沿用原有日志开关和导出功能。
• 更新中英文介绍、安装、作用域、展示资源与架构说明，明确新增功能的使用条件和验证范围。

使用说明

• 使用新增提示或电量通知时，需在 LSPosed 中勾选 com.xiaomi.bluetooth，并保留
  com.android.bluetooth、com.milink.service 两个核心作用域。升级及调整作用域后重启设备；
  仅重启 HyperEars 或切换蓝牙开关，不能保证系统蓝牙扩展重新加载模块。
• 新增提示的实机基线为 HyperOS 4，已验证 Bose QuietComfort Headphones 和 vivo TWS Air3 Pro
  的对应展示，其中包含关闭电量通知时的超级岛和非充电状态下的充电盒显示。
  其他系统版本按宿主入口兼容情况启用，不能将这次结果视为所有型号和 ROM 均已实测。
• 本版提供连接后的提示，首次配对、仅开盖但未产生新连接的发现弹窗仍由系统及设备原有支持决定。

本版新增 Samsung Galaxy Buds 与 MOONDROP MIRAGE 适配，修复新版 MiLink 的 Bose
抗风噪入口，补充水月雨设备名称识别，并更新构建依赖。更新范围为 v2.7.0 至本版。

Bose 卡片

• 修复新版 MiLink 卡片中 Bose 抗风噪按钮不显示的问题。QuietComfort Headphones 将
  “关闭”位置用于抗风噪；QC35 / QC35 II 将“通透”位置用于抗风噪，并保留旧版布局兼容。
• 修复两态 Bose 机型在新版卡片中“关闭”项的禁用处理。
• 修复原生按钮被替换后可能提前回收、导致解绑时无法恢复的问题，保留原有尺寸、边距和样式。
• **验证范围：**布局契约、模式映射、完整单元测试和 Release 构建通过；新版 Bose 卡片的
  实际显示与点击仍待设备复核。QuietComfort Headphones 的抗风噪继续切换耳机已保存的预设。

Samsung Galaxy Buds

• 加入 Buds2 Pro、Buds2、Buds FE、Buds Live、Buds Pro、Buds3、Buds3 Pro、Buds Core、
  Buds3 FE、Buds4、Buds4 Pro 共 11 个型号候选，并提供三星专属服务的家族回退。
• 收到有效设备响应后逐项开放组件电量和噪声控制；Live、Buds3、Buds4 提供降噪与关闭，
  其余已配置型号按有效回报提供降噪、关闭和环境声。
• 增加触控总开关、已确认的手势选项及左右耳长按动作；噪声切换组合、耳缘音量和语音检测
  按型号及合法字段开放。连续修改左右耳设置时保留另一耳当前目标，状态按设备回报校正。
• Galaxy Wearable 与型号插件接入厂商应用跳转、运行时退避和“停止厂商应用”；停止操作
  统一覆盖控制 App 目录中的全部包名。运行时退避需勾选对应 LSPosed 作用域。
• 型号识别使用官方名称、SM-R 编号或三星专属服务，避免普通 Buds 关键词误匹配其他品牌。
• **验证范围：**Buds2 Pro 原版 Fix25 已有实机反馈；本维护版及其他型号仍待分别复核。
  Buds Core、Buds3 FE 采用共同字段进行实验性家族外推。

MOONDROP MIRAGE

• 新增 MIRAGE 左右耳与充电盒电量，以及降噪、关闭、通透控制，收到有效协议响应后逐项开放。
• 沿用 Pudding 的连接初期电量补齐与模式写后回读流程，各设备保持独立会话和状态。
• 名称同时包含品牌与 MIRAGE 时选择具体型号；仅有联名信息时使用水月雨家族回退。
• **验证范围：**原版握手、电量和三态读写已有实测，维护版仍待实机复核。自适应等额外
  降噪档位尚未接入，继续等待该型号的协议证据。

设备识别与维护

• 补充 Space Travel 2 Ultra 的精确名称，归入水月雨家族；保留系统整机电量、音量与流转，
  私有协议及降噪控制仍待独立确认。
• Bose、FitClip 和公共卡片扩展共用原生布局识别与选项创建，统一维护新旧 MiLink 的兼容路径。
• 更新中英文介绍、兼容性表、厂商控制 App 作用域目录及协议来源说明，保留原作者贡献与
  各版本实测记录，并完善维护版复核流程。

构建依赖

• 更新 Android Gradle Plugin 至 9.4.1、Kotlin 至 2.4.20、Navigation Compose 至 2.10.2。
• 更新 Miuix 至 0.9.4、DexKit 至 2.3.0，以及构建工作流的 setup-java 至 6.0.1。

本版新增 Edifier FitBuds Turbo 适配，修复漫步者 TWS 单耳和双耳不可用时的电量显示，
并更新构建及运行依赖。更新范围为 v2.6.0 至本版。

Edifier FitBuds Turbo

• 根据贡献者提供的明文协议和原版实测结果，加入左右耳电量、降噪、关闭、通透、抗风噪及
  游戏模式。电量与各项控制分别在收到有效协议响应后开放。
• 在原生三态卡片中提供抗风噪和游戏开关，两项独立显示；仅游戏模式已确认时使用
  “标准模式 / 游戏模式”卡片。抗风噪入口不再等待游戏状态回包。
• 断开后的协议重建会清除旧游戏状态，重新确认后恢复控制；降噪写入后查询一次真实模式，
  游戏切换通过设备回报更新。
• **验证范围：**贡献者已验证原版协议和控制；本版维护后的共享卡片布局尚待实机复核。
  充电盒电量尚无该型号的独立实测，按有效协议字段提供。

漫步者电量

• TWS 左右耳上报零值时显示为未知，避免单耳使用时把不可用的一侧显示为电量耗尽。
• 双耳均不可用的有效回包仍更新盒电量，并清除旧耳电量；盒离线时清除旧盒电量，耳机恢复后
  显示新读数。整机和在线充电盒的真实 0% 保持有效，越界耳电量仍作为非法数据拒绝。
• 协议测试工具补齐充电盒电量展示，未知读数统一显示为破折号。

卡片与适配维护

• 抗风噪和 Turbo 游戏开关共用原生卡片的布局与恢复逻辑，统一维护旧版、有无标题和
  HyperOS 4 的兼容路径；多开关占用原有标题行并保留标题测量空间。
• FitClip Ultra 与 Turbo 共用游戏状态的清理和控制校验，游戏回包严格校验单字节状态值。
• 补齐应用内及中英文兼容性说明、协议记录和贡献引用；记录维护版实机复核流程，明确
  复核通过后再合入维护 PR、关闭原 PR。

构建依赖

• 升级 Android Gradle Plugin 至 9.4.0，并同步 Gradle Wrapper 至所需的 9.6.0。
• 升级 Navigation Compose 至 2.10.0、kotlinx.serialization 至 1.11.0，以及 CI、签名构建和
  发布流程使用的 setup-java 至 6.0.0。
• 升级 libxposed API 与 service 依赖至 102.0.0；现有调用与模块最低 API 要求保持 101，
  本次不启用热重载。

本版新增 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 目录与第三方许可证；增加新增型号的
  名称边界、流式解帧、协议门禁、电量、模式控制、卡片恢复和界面偏好回归测试。

本版新增可切换的 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 生成。

本版新增 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 生成。

本版适配 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 生成。

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

ROSE Ceramics Ultra

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

MiLink 兼容

• “更多设置”入口继续优先使用稳定公开类和已验证的 17.2.0、17.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 生成。

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

漫步者兼容

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

应用交互

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

构建、文档与验证

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

架构

• 将 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
  轮询、常驻扫描或额外系统注入范围。

验证

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

新增

• 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 构建、签名校验和安装验证。

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

状态刷新

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

设置可靠性

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

验证

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

相较于 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 校验。

相较于 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 发布验证全部通过。

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 和判型证据与当前实现一致。