HyperLyrics Enhanced

HyperLyrics Enhanced

面向 HyperOS 的 Apple Music 深度适配与系统级歌词展示增强工具

License GPL-3.0 Android Support Miuix UI libxposed


项目定位

HyperLyrics Enhanced 是一个为小米 HyperOS 设备打造的 Android 模块与独立应用,也为其他安卓品牌手机提供 Apple Music 体验优化。

  • 将 Apple Music 的逐字歌词、翻译、伴唱和歌曲信息更完整地带入小米 HyperOS 的超级岛、媒体卡片与 AOD。
  • 将 Apple Music 体验进一步优化,且面向所有安卓品牌手机。
  • 同时兼容原项目支持的其他音乐软件,如 QQ 音乐、网易云音乐等。

本项目基于 limczhh/HyperLyric 二次开发,现已形成独立的功能方向和维护边界。

Warning

HyperLyrics Enhanced 不是 HyperLyric 的官方后续版本。仅在本项目中出现的问题,请在本项目的 Issue 中反馈,不要打扰原项目维护者。

相较原项目的主要优化

1. Apple Music 从外部 Provider 变成内置能力

  • 内置 Apple Music 逐字歌词 Provider。Apple Music 用户不需要额外安装 Lyricon、Lyricon Central 或独立 LyricProvider,即可使用推荐作用域配置。
  • 直接传递歌词、播放状态和进度,并在 SystemUI 重连、切歌或数据延迟后重新同步当前歌曲。
  • 支持在 Apple Music App 内进行更细粒度的体验调整:内容 UI 地区语言、歌曲信息地区化、原地区名称恢复、元数据检索缓存、繁体歌词转简体、歌词模糊效果、跟随系统字体粗细等优化。
  • Apple Music 的原生歌词翻译和发音数据优先显示;缺失内容可按配置从在线歌词源补全。

2. 统一在线、离线与兜底歌词管线

  • 移除原有在线/离线构建分支,将在线歌词能力整合进统一版本。
  • Apple Music 原生歌词优先;确认没有可用原生歌词后,才从 QQ 音乐或网易云音乐获取逐行歌词兜底。
  • 根据标题、歌手、时长和版本特征进行匹配,尽量区分同名歌曲、Live、Remastered、翻唱和不同剪辑版本。
  • 处理 LRC/QRC、逐行歌词和逐字歌词之间的结构转换,并修复无效行、重复时间戳、缺失结束时间、相邻重复歌词不刷新等常见问题。
  • 在线歌词和译文按时间轴与结构进行匹配,支持一行对多行、多行对一行等差异,减少翻译错位。

3. 翻译优先级更明确,也更可控

  • Apple Music 原生译文优先。
  • 已匹配的 QQ 音乐/网易云音乐在线译文优先于 AI 补全;可以配置在线翻译的偏好来源,系统仍会根据覆盖率和匹配质量选择更合适的结果。
  • AI 翻译只补充缺失内容;需要时也可以开启强制 AI 翻译覆盖已有译文。

4. 米系 AOD 也纳入同一套歌词体验

  • 提供两套 AOD 歌词路径:锁屏 AOD 与经典 AOD。
  • AOD 支持主句、伴唱、翻译、下一句歌词、对唱居中、暂停行为、下首歌曲预览和显示位置配置。
  • 经典 AOD 还可以选择显示歌曲信息的样式:焦点通知样式或嵌入式文本样式。

运行模式

模式 适合人群 主要能力 依赖
Xposed / LSPosed 模式 已 Root、希望使用原生超级岛/系统界面注入 HyperOS 超级岛、SystemUI 媒体卡片、Apple Music 深度适配、AOD 与系统白名单增强 LSPosed v2.0+;HyperOS 3 相关功能需要对应 SystemUI
通知歌词模式 未 Root 或不使用 Xposed 的设备 实时通知/焦点通知歌词、通知型灵动岛、基础媒体信息展示 通知发送权限、通知使用权;部分功能可选 Shizuku

两种模式可以分别配置。Apple Music 内置 Provider 与体验优化功能均属于 Xposed 侧能力;通知模式则依赖播放器提供媒体信息或歌词通知数据。

安装与配置

Xposed / LSPosed 模式

  1. 从本项目的 Releases 下载并安装 APK。
  2. 在 LSPosed 中启用 HyperLyrics Enhanced,并勾选推荐作用域:
    • com.android.systemui
    • miui.systemui.plugin
    • com.apple.android.music
  3. 打开应用主页的“超级岛歌词”,在“歌词设置”中选择歌词模式和歌词来源。
  4. Apple Music 用户可以直接使用内置 Provider;其他播放器可以在应用内 Provider 页面按需下载官方 Pack。Pack 通过 GitHub 目录签名、Pack 签名和内置目标包名校验后加载,不需要额外安装独立模块;已有独立 LyricProvider 模块仍保留兼容性。
  5. 根据提示重启 SystemUI 和音乐 App。

通知歌词模式

  1. 打开应用主页的“通知型灵动岛歌词”。
  2. 授予发送通知权限和通知使用权。
  3. 在歌词白名单中添加需要显示歌词的音乐 App。
  4. 选择实时通知或焦点通知,并按需配置图标、进度条、歌曲信息和点击行为。
  5. 如果设备后台限制较严格,可以在页面内配置自启动、电池优化;焦点通知限制绕过功能需要运行中的 Shizuku。

具体系统版本、权限入口和通知表现可能因 HyperOS/Android 版本而变化,请以应用内“使用帮助”和设备实际行为为准。

兼容性说明

项目最低支持 Android 13(API 33),但不同功能依赖不同的系统界面实现:

功能 当前目标环境 备注
HyperOS 超级岛歌词与 SystemUI 注入 Android 15+ / HyperOS 3 需要 LSPosed v2.0+ 以及 miui.systemui.plugin
Apple Music 内置 Provider Android 13+,配合 LSPosed 作用于 com.apple.android.music;Apple Music 版本变化可能影响兼容性
锁屏 AOD / 经典 AOD 米系 Android 13+ 取决于设备的 AOD 实现和对应作用域
通知型灵动岛歌词 Android 13+ 需要通知发送权限、通知使用权和播放器数据
小米焦点通知增强 HyperOS 2 / HyperOS 3 可能需要移除焦点通知白名单
下拉小窗白名单增强 Android 16 / HyperOS 3.0.300+ 依赖对应系统版本
Android 实时通知 Android 16;部分 HyperOS 3 / ColorOS 16 是否显示为系统级实时通知由系统决定

系统更新、SystemUI 插件更新和 Apple Music 更新都可能改变内部实现。遇到不适配时,建议先导出应用日志,并在 Issue 中附上设备型号、Android/HyperOS 版本、音乐 App 版本和复现步骤。

歌词来源与外部依赖

歌词源 说明 额外依赖
Lyricon Apple Music 内置 Provider 使用的统一歌词管线;其他播放器可以通过 Lyricon 接入 Apple Music 无需额外 Provider;其他播放器通常需要 Lyricon CentralLyricProvider
SuperLyric 获取逐行或逐字歌词以及更细粒度的时间轴 SuperLyric,并按其说明开启广播
LyricInfo 读取媒体会话中的 lyricinfo 数据 LyricInfo,可选
在线兜底 Apple Music 没有原生歌词时,从 QQ 音乐或网易云音乐匹配逐行歌词与译文 需要联网;可在歌词设置中关闭或调整优先来源
AI 翻译 对缺失译文进行补全,支持 OpenAI 兼容接口 需要用户自行提供 API Key、模型和接口地址

构建

本项目使用 Gradle 和 Kotlin/Compose。常用本地检查命令:

./gradlew :app:testDebugUnitTest
./gradlew :app:assembleDebug

Release 构建需要在项目根目录提供 keystore.properties,或设置构建脚本读取的 Release 签名环境变量。APK 输出名称会包含版本名和 versionCode。

数据、权限与使用边界

  • Xposed 模式需要 LSPosed 及相应作用域;通知模式不要求 Root。
  • 在线歌词、在线译文和 AI 翻译仅在对应功能开启时使用网络。
  • AI 翻译使用的 API Key、模型和服务地址由用户自行配置,第三方服务的隐私政策和费用由用户自行承担。
  • 焦点通知、实时通知、AOD 和 SystemUI 注入均受设备厂商实现、系统版本、电池策略和后台限制影响。

致谢与许可证

本项目采用 GNU General Public License v3.0 开源协议发布。

感谢以下项目和贡献者:

请在提交 Issue 或 Pull Request 时保留相关上游项目、第三方库和原作者的归属信息。

Releases

7.4.0

Stable

8/19/2026, 10:38:21 AM

feat: 内置 Lyricon Central、新增官方插件体系并进一步增强歌词与超级岛体验

新增功能:

  • 内置 Lyricon Central 核心调度服务,无需额外下载安装独立的词幕服务模块。
  • 新增官方 Provider 插件管理体系,支持在线下载添加、更新、启停、移除与文件损坏自修复。
  • 新增网易云音乐、QQ 音乐(含 QQ 音乐 HD)、Spotify、汽水音乐、酷狗(含概念版)以及酷我等官方 Provider 插件,无需为各个音乐 App 分别安装独立 Provider 模块。
  • 兼容已安装的独立 Provider 模块,并在共存时按官方插件优先原则自动进行来源仲裁。
  • 新增 Apple Music 为无歌词歌曲补充歌词功能,无原生歌词时自动从三方在线源检索并注入展示,支持切源后播放时间轴平滑映射与精准定位。
  • 新增 Apple Music 应用内歌词源、在线翻译与发音切换菜单。
  • 新增在线翻译与发音匹配度统计功能,并在源菜单弹窗及元数据中直观展示匹配行数与百分比。
  • 新增酷狗音乐、酷我音乐在线歌词与翻译源。
  • 新增在线翻译多源自定义排序与“自动选择最优来源”并发竞速机制。
  • 新增在线翻译/发音显示模式(原文、仅翻译、仅发音等)与缺失时自动显示另一项的智能回退策略。
  • 新增在线翻译按应用单独启用设置,并为椒盐音乐提供优先使用在线源选项。
  • 新增超级岛左侧与右侧内容独立位置显示(默认 / 居中 / 靠右)配置。
  • 新增超级岛内边距负值调节(-50 ~ 100)并将内容长度调节范围扩大至 0 ~ 500。
  • 新增主页“一键刷新”功能,支持选择快速重启系统界面、全部音乐 App 或指定音乐 App 进程(需 root 权限)。
  • 新增向导页快捷添加官方插件引导流程。
  • 新增 SystemUI 运行时配置广播同步机制,修改歌词模式、超级岛内容与对齐等设置时即时刷新,无需重启系统界面。

优化与修复:

  • 优化超级岛暂停与切歌过渡,增加暂停宽限保护,避免切歌或短暂暂停时闪回原生媒体岛。
  • 优化超级岛亮屏恢复逻辑,仅在布局结构发生实际变化时触发宿主重绘,减少重复刷新与系统开销。
  • 优化超级岛与 AOD 在音频缓冲或卡顿时的表现,缓冲期间冻结歌词推进并维持当前行,恢复播放后再继续推进,避免歌词自行空跑。
  • 优化封面取色与光晕效果,在调色板提取失败时引入封面像素采样兜底,避免边缘光晕和歌词取色异常丢失或变为默认灰色。
  • 优化跨播放器活跃仲裁,结合实际底层音频输出流状态抑制已暂停或后台残留播放器抢占歌词显示。
  • 增强 Apple Music Hook 的版本自适应与解析稳定性,引入 DexKit 慢路径解析与自修复机制,降低客户端更新导致的混淆失效风险。
  • 修复经典 AOD 10 秒唤醒窗口下的歌词维持显示,以及通知图标锚点失效时回退到根布局。
  • 规范屏幕状态监听与 AOD 驱动链路,避免屏幕亮灭状态变化引发异常刷新。
  • 限制重叠歌词时间轴合并逻辑仅对 Apple Music 生效,非 Apple Music 提供方保持单一活动歌词行,避免多行重叠混乱。
  • 修复歌词延迟设置界面中字体在特定模式下的反色和对比度异常问题。
  • 优化歌词延迟滑块与卡片数值的实时同步显示。
自上次 Release 以来的提交记录
  • chores: 多项改进
  • feat: 添加翻译和发音匹配度统计功能
  • 修复 Apple Music 补充歌词切源定位
  • feat(apple music): 新增为无歌词歌曲补充歌词的功能开关
  • 完善在线翻译竞速与系统歌词适配
  • 完善 Lyricon 插件体系并增强歌词链路稳定性
  • 完善官方 Provider 诊断与跨播放器仲裁
  • 补充歌词位置链诊断并移除汽水进程注入
  • 增加歌词链路诊断并完善 Provider 兼容
  • 回退 AOD 逻辑并优化超级岛恢复
  • 修复息屏歌词与超级岛亮屏恢复
  • 增加设置与 PrefsBridge 诊断日志
  • 优化媒体岛暂停切歌过渡
  • 完善官方 Provider 解析与 Apple 歌曲展示
  • 完善 Apple Music DexKit 兜底解析
  • 完善官方 Provider DexKit 缓存与刷新交互
  • 新增一键刷新并修复在线歌词重匹配
  • 整理 Apple Music 全局歌词设置
  • 预发布 7.4.0-beta.1
  • 限制重叠歌词合并范围
  • 更新 Canary 构建编号
  • 完善官方 Provider 来源仲裁与作用域管理
  • 完善官方提供方下首歌曲与延迟设置
  • 扩展官方 Provider Hook 能力
  • 修复 Gradle Wrapper 执行权限
  • 支持 QQ 音乐播放子进程加载官方提供方
  • 完善官方提供方与播放器订阅链路
  • 修复 Apple Music 进度同步与提供方校验
  • 接入可选官方音乐 Provider Pack
  • 收口 Apple Music Hook 运行时成员访问
  • 拆分 Apple Music Hook 与元数据处理模块
  • 重构 Apple Music Hook 运行时模块
  • chore: 内置Lyricon Central并更新依赖
  • 切换 7.3.1 Canary 候选版本
  • ci: 让 Canary 恢复仅修改本地 Beta 标记
  • ci: 区分 Beta 恢复提交与正常测试构建
  • ci: 为 Canary 构建创建可追溯标签
  • ci: 新增 Beta 与 Canary 自动构建流
  • docs: 重写并更新README文档内容

下载说明

日常使用请选择 Release 包;Debug 包仅用于调试和查找问题。

7.3.0

Stable

8/4/2026, 9:21:37 AM

feat: 新增 Apple Music 体验优化与歌词链路增强,修复超级岛/AOD显示问题

新增功能:

  • 新增 Apple Music 体验优化系列功能页面,具体如下
  • 新增支持按设定地区替换歌曲信息、修正中日韩原地区原名及本地检索缓存。
  • 扩展 Apple Music 歌词能力,支持繁体转简体、原生翻译与发音补全、三方在线源兜底及翻译/发音来源切换。
  • 新增歌词模糊效果及跟随系统字体粗细等设置。
  • 顺便重构了模块app内歌词设置入口,让调整设置更加符合逻辑。
  • 新增超级岛/AOD隐藏中日韩歌词空格的设置。
  • 完善 Apple Music 版本化 Hook、元数据缓存、可见页面解析和跨进程翻译回传链路,提升歌曲信息实时替换及新版本适配能力。
  • 新增应用与模块日志的全部日志导出功能。
  • 关于页视觉焕新。

修复与优化:

  • 修复上个版本 AOD 切歌后沿用旧 Central 播放进度,导致短歌曲歌词停留在末行;增加歌曲时长边界校验及同曲 MediaSession 进度纠偏。
  • 优化超级岛与息屏歌词的歌曲、歌手及封面识别,避免 MediaSession 临时标题或旧封面导致内容与取色结果串曲。
  • 优化超级岛歌词和歌曲信息刷新,减少无变化样式的重复绑定,并完善暂停、无歌词、屏幕状态及覆盖层清理逻辑。
  • 优化封面取色缓存,支持按封面内容签名复用结果,减少重复提取和错误回退。

下载说明

日常使用请选择 Release 包;Debug 包仅用于调试和查找问题。

Assets

1

7.2.0

Stable

7/26/2026, 4:27:10 AM

feat: 新增双 AOD 歌词与更新检测,修复超级岛重叠歌词bug和完善下首歌曲预览样式

新增功能:

  • 新增模块版本后台检测,每次进入 App 时从 GitHub Release 获取最新版本,静默提醒无打扰。
  • 新增“息屏歌词”,支持“锁屏 AOD”和“经典 AOD”。
  • 完善岛上下首歌曲信息预览样式,新增半岛显示。

修复与优化:

  • 将“显示下一句歌词”移动到超级岛设置,并补充翻译优先级说明。
  • 优化翻译设置逻辑,替换为明确的“翻译显示”总开关,移除重复的“禁用所有翻译”功能。
  • 重构时间戳重叠歌词的预处理和活跃歌词选择,支持两句歌词同步或部分重叠时同时逐字滚动。
  • 重叠歌词不再套用普通伴唱切换模型,避免第二行反复上浮、旧歌词重复出现和主句闪现。
  • 优化三句及以上连续重叠场景,播放进入后续歌词后丢弃仍在延续的早期歌词,避免结束后回跳。
  • 关闭“显示下一句歌词”时,重叠场景改为以当前播放进度对应的歌词为准。
  • 调整超级岛第二行内容优先级,使重叠歌词和下首歌曲预览优先于相邻伴唱翻译,避免互相抢占。
  • 无歌词歌曲在歌曲信息开启时不再显示歌曲名作为歌词占位。
自上次 Release 以来的提交记录
  • ci: 自动同步 LSPosed 发布
  • fix: 优化 Release 说明生成格式

下载说明

日常使用请选择 Release 包;Debug 包仅用于调试和查找问题。

7.1.0

Stable

7/24/2026, 2:43:50 AM

feat: 新增 Apple Music 地区切换与超级岛下首预览

新增功能:

  • 在主页“特殊功能”中新增 Apple Music 地区切换(注:账号地区不支持的歌曲和服务仅提供浏览)。
  • 在超级岛中新增切歌前的下首歌曲预览。

优化与修复:

  • 修复三方歌词翻译因歌曲名为英文的情况下无法正确搜索的问题。
  • 修复同文本内容歌词之间错误的切换动画。
  • 优化在线歌词匹配,增加原始元数据重试、多人歌手分隔、空白归一化和时长评分,并改进网易云与 QQ 音乐候选比较及诊断日志。
  • 修正 QQ 音乐搜索响应中的歌曲 ID、音轨序号和曲风字段类型,避免接口响应反序列化失败。
  • 完善 Apple Music 播放器生命周期和活动实例追踪,修复恢复播放、播放器切换及释放后的进度同步与歌曲元数据刷新异常。
  • 仅允许活动播放器的当前队列项目更新当前歌曲,避免后台播放器或非当前项目覆盖正在显示的元数据。
  • 保留同一歌曲已有的 Apple 原生歌词,忽略空歌词降级更新和 MediaSession 占位数据,避免有效歌词被清空。
  • 在 Apple 原始元数据异步返回后重新执行在线翻译匹配,同时保留当前歌词和播放位置。
  • 统一超级岛歌词、歌曲元数据及下首歌曲预览的内容更新和动画路径,使各类内容正确使用用户配置的进场与切换动画。
  • 根据完整渲染内容判断是否需要播放动画,消除强制刷新、配置失效及相同内容重复写入导致的闪烁。
  • 修正延迟歌词加载、下一行晋升、翻译与罗马音动态开关以及背景人声翻译的时间和显示状态。
  • 使用封面尺寸和采样像素生成内容签名,并复用相同封面的颜色提取结果,提高随机配色一致性并减少重复计算。