ColorOS Live Lyrics Bridge v4.3.2

简体中文

状态栏与控制中心媒体卡片排版彻底根治

• 永不改写 QS 规则表：Bridge 彻底移除对 OPlus QS 规则表（args[1]）的修改，100% 保留系统原生 RUS 策略。无论是 QQ 音乐、网易云、还是通用 Provider 接入的 SaltPlayer、LX 等任意播放器，状态栏下拉控制中心的播放器卡片完全按照播放器原生排版呈现，彻底解决按钮错位、关闭按钮丢失等排版崩溃问题。
• 两类播放器针对性处理：
  • 第一类（原生内置 Rule0，如 QQ 音乐、网易云）：原生主表本就是 Rule0，不碰任何规则表，仅在锁屏时原位把收藏槽替换为翻译按钮（跳过重排，保持列表长度与顺序）。
  • 第二类（无内置 Rule0，如通用 Provider 播放器）：仅在锁屏主表（args[0]）前置 0, 优先级，绝不污染 QS 状态栏。

翻译按钮锁屏态门禁与即时刷新

• 锁屏态门禁：翻译按钮仅在设备处于锁屏状态（Keyguard locked）时激活注入；解锁进入桌面（USER_PRESENT）时，自动平滑撤出注入并恢复原生卡片。真机实测人脸与指纹解锁过渡无任何视觉闪烁、跳变或抽搐。
• 即时刷新修复：修复了此前内部重绑机制将包名误传为 Key 导致 SystemUI 忽略刷新的问题。现在灭屏锁屏或解锁进入桌面瞬间，媒体卡片即时响应并刷新形态，完全无需手动切歌或暂停。
• 延时锁屏保护：在亮屏时核验真实锁屏状态，解决灭屏延时锁定窗口内未上锁直接回桌面导致的卡片残留。

收紧翻译按钮注入门禁与防污染

• 严格歌词门禁：仅在当前播放器确实由歌词 Provider 服务且当前曲目确实包含有效翻译歌词时，才允许展示翻译按钮；未适配播放器或无翻译歌曲严格保持 100% 原生。
• 对象状态恢复：在关闭或撤出按钮时，自动恢复 SystemUI 内存中 MediaAction 的原始图标与回调，彻底消除多卡片对象共享引起的污染。

兼容矩阵与升级

• Bridge 仍只作用于 system 与 com.android.systemui，不进入播放器进程，不恢复私有歌词传输。
• 14 个 Provider 仍为 libxposed API 102 矩阵；KuWo 保持 1.2.0 (3)，其余模块版本不变。
• 升级：从同一个 v4.3.2 Release 安装 Bridge 与所需 Provider APK；更新 Bridge 或变更 scope 后重启 SystemUI。

资产

正式 Release 包含 18 项已验证资产：1 个 Bridge APK、14 个 Provider APK、1 个 Provider ZIP、release-assets-v4.3.2.json 与 SHA256SUMS。

ColorOS 17 适配计划

ColorOS 17 的 nolog 版本封锁 bootloader，无法解锁并建立模块运行环境，因此本项目不会跟进 nolog 分支的更新与适配；同时主力机型一加 13 也尚未收到 ColorOS 17 nolog 版本，缺少可验证的设备条件。因此 ColorOS 17 适配将在 ColorOS 17 正式版发布之后再启动：届时先在正式版上核对 SystemUI 媒体/歌词实现与权限面差异，再给出 Bridge 与 Provider 的适配版本。在此之前，现有 ColorOS 16 版本继续接收 bug 修复。

致谢

感谢 Salt Player 提供字符上浮跃模态的视觉参考，也感谢 Lyrico 与 Lyrico-Plugins 在本地音乐元数据、歌词管理和插件化歌词源上的开源工作与启发。

English

Complete fix for status bar and Quick Settings media card action layout

• Never mutate the QS rule table: The Bridge completely ceases patching the OPlus Quick Settings action-rule table (args[1]), preserving 100% native RUS rules. Media cards in the notification shade and Quick Settings for QQ Music, NetEase, and universal provider players (SaltPlayer, LX Music, etc.) always adhere strictly to their native action order, eliminating misplaced controls and missing actions.
• Differentiated player classification:
  • Class 1 (Natively Rule0, e.g. QQ Music, NetEase): Left entirely untouched in rule tables; favorite slot replaced in-place without re-ordering the action list.
  • Class 2 (Non-Rule0, e.g. Universal Provider players): Prepends 0, strictly on the main lockscreen surface (args[0]), leaving the QS surface completely pure.

Lockscreen-only gate and instant state rebind

• Lockscreen-only gate: Translation toggle injection is only active while the device is locked (Keyguard locked); unlocking into the launcher (USER_PRESENT) smoothly withdraws the toggle and restores the native card. Verified on physical devices with zero flicker, layout jump, or white-screen artifacts during facial or fingerprint unlock.
• Instant rebind fix: Fixed a bug where the internal rebind passed a package name instead of the composite MediaEntry key, causing SystemUI to ignore state refreshes. Lockscreen and unlock transitions now refresh immediately without requiring a track switch or pause.
• Delay-lock protection: Re-checks actual keyguard lock state on screen-on to prevent stale toggle retention during smart-lock or delay-lock windows.

Tightened translation toggle gate and object contamination prevention

• Strict payload gate: Translation toggles are only permitted when the player is actively managed by a lyric provider and the current song contains verified translation lines. Unadapted players and non-translated tracks remain 100% native.
• Native action restoration: Automatically restores original icon drawables and callbacks on SystemUI MediaAction objects upon withdrawal, preventing cross-surface object sharing pollution.

ColorOS 17 adaptation plan

ColorOS 17 nolog builds lock the bootloader, preventing root and Xposed environments. Therefore, this project will not track or support nolog firmware. Furthermore, our primary test device (OnePlus 13) has not received any C17 nolog builds. Full ColorOS 17 adaptation will begin after the official ColorOS 17 release is publicly available. Until then, the ColorOS 16 codebase will continue to receive maintenance and bug fixes.

Donate

ColorOS Live Lyrics Bridge v4.3.1

简体中文

媒体卡控制按钮错位修复（QQ 音乐）

修复 QQ 音乐媒体卡控制按钮顺序错乱（现场表现为 下一首 / 翻译 / 上一首 / 暂停）。根因是
Bridge 为了让翻译按钮出现在收藏槽，把 QQ 的 OPlus action rule 强制到 Rule0 并重新下发规则表，
SystemUI 因此改用语义动作模板重拼整行；关闭播放器的翻译按钮设置也不能阻止该改写。

v4.3.1 对这类播放器保留系统原生 action row，不再改写规则表：QQ 的按钮顺序恢复，翻译按钮
仍通过收藏槽原地替换呈现（锁屏界面已真机确认）。其它播放器行为不变。

翻译按钮接入：合成动作兜底

对既不暴露 PlaybackState.CustomAction、也没有 OPlus heart 动作的播放器，Bridge 现在会合成
一个与 framework 同类型的 SystemUI MediaAction 注入 Rule0 自定义动作列表，并同步置位
hasCustomAction；按钮点击仍在 Bridge 内处理，不依赖播放器配合。

歌词时钟平滑

播放中媒体会话若重新发布一个略有差异的位置（部分播放器按 400 ms 粒度上报），Bridge 不再
把它当作跳变或回退：小于 600 ms 的正负偏差按本地时钟修正处理，状态切换与大幅跳变仍以宿主
发布值为准，避免歌词前沿被微小抖动带偏。

Provider：KuWo 1.2.0 (3) 只追加 lyricInfo

KuWo Provider 现在只往宿主自己的 MediaMetadata bundle 写入 lyricInfo 一个键：不再重建
metadata、不再改写任何封面通道，并删除了此前的联网补封面与 240px 重绘策略。ColorOS 的封面
取用顺序（loadBitmapFromUri → ART → ALBUM_ART）与 Bitmap 实例完全保持宿主原样。

真机验证（酷我 12.2.0.0）：metadata 由 9 键变为 10 键，ALBUM_ART 保持 360x360
ARGB_8888 varied，SystemUI 正常 NATIVE_LYRIC_RECEIVED，锁屏封面与歌词同时正确。
其余 13 个 Provider 在本版本中不改变行为。

兼容矩阵与升级

• Bridge 仍只作用于 system 与 com.android.systemui，不进入播放器进程，不恢复私有歌词传输。
• 14 个 Provider 仍为 libxposed API 102 矩阵；KuWo 模块版本 1.2.0（versionCode 3），其余模块版本不变。
• 升级：从同一 v4.3.1 Release 安装 Bridge 与所需 Provider APK；更新 Bridge 或变更 scope 后重启
  SystemUI，更新 Provider 后重启对应播放器。

验证与已知限制

• 本地门禁覆盖 Bridge 单测、debug/release lint、debug 构建、发布契约校验与 14-Provider Debug 矩阵。
• tag workflow 生成正式签名资产，校验包名/版本、证书、zipalign 与 DEX guards，将 Provider main
  冻结到完整 commit，并从同一验证批次发布 Bridge 与 LSP mirror。
• 兼容性仍取决于厂商 SystemUI 实现与播放器经 MediaSession 暴露的歌词时间信息。
• 微小时钟修正阈值（600 ms）为固定值；超出该范围的位置变化仍按宿主处理。

资产

正式 Release 包含 18 项已验证资产：1 个 Bridge APK、14 个 Provider APK、1 个 Provider ZIP、
release-assets-v4.3.1.json 与 SHA256SUMS。Provider ZIP 只包含 14 个顶层 Provider APK。

ColorOS 17 适配计划

ColorOS 17 的 nolog 版本封锁 bootloader，无法解锁并建立模块运行环境，因此本项目不会跟进
nolog 分支的更新与适配；同时主力机型一加 13 也尚未收到 ColorOS 17 nolog 版本，缺少可验证的
设备条件。因此 ColorOS 17 适配将在 ColorOS 17 正式版发布之后再启动：届时先在正式版上核对
SystemUI 媒体/歌词实现与权限面差异，再给出 Bridge 与 Provider 的适配版本。在此之前，现有
ColorOS 16 版本继续接收 bug 修复。

致谢

感谢 Salt Player 提供字符上浮阶跃模型的视觉参考，也感谢 Lyrico 与 Lyrico-Plugins 在本地音乐
元数据、歌词管理和插件化歌词源上的开源工作与启发。

English

Media card control row fix (QQ Music)

Fixes the mis-ordered QQ Music media-card control row (observed as next / translate / previous /
pause). The Bridge used to force the player's OPlus action rule to Rule0 and re-dispatch the rule
table so the translation toggle could occupy the favorite slot; SystemUI then recomposed the whole
row from the semantic-action template, and disabling the player's translation button did not stop
that rewrite.

v4.3.1 keeps the native action row for such players and no longer rewrites the rule table: QQ's
button order is restored while the translation toggle still replaces the favorite slot in place
(confirmed on device in the lockscreen card). Other players are unaffected.

Translation toggle: synthetic action fallback

For players that expose neither a PlaybackState.CustomAction nor an OPlus heart action, the Bridge
now synthesizes a SystemUI MediaAction of the same type the framework uses, injects it into the
Rule0 custom-action list and sets hasCustomAction. The click is handled entirely inside the
Bridge and needs no player cooperation.

Lyric clock smoothing

When a media session re-publishes a slightly different position while playing (some players report
in 400 ms steps), the Bridge no longer treats it as a jump or rewind: deviations below 600 ms are
handled as local clock corrections, while state changes and large jumps stay authoritative.

Provider: KuWo 1.2.0 (3) appends only lyricInfo

The KuWo Provider now writes exactly one key — lyricInfo — into the host's own
MediaMetadata bundle. It no longer rebuilds metadata and no longer touches any artwork lane;
the former network cover completion and 240 px redraw policy were removed. ColorOS's artwork order
(loadBitmapFromUri → ART → ALBUM_ART) and the Bitmap instances stay exactly as the host
published them.

Device validation (KuWo 12.2.0.0): metadata grew from 9 to 10 keys, ALBUM_ART stayed
360x360 ARGB_8888 varied, SystemUI reported NATIVE_LYRIC_RECEIVED and the lockscreen showed the
real cover together with the lyrics. The other 13 Providers are unchanged in this release.

Compatibility and upgrade

• The Bridge still scopes only system and com.android.systemui; it never enters player processes
  and does not restore any private lyric transport.
• All 14 Providers remain on the libxposed API 102 matrix; the KuWo module is 1.2.0 (versionCode 3),
  the other modules keep their versions.
• Upgrade: install the Bridge and the needed Provider APKs from the same v4.3.1 Release; restart
  SystemUI after a Bridge update or scope change, and restart the player after a Provider update.

Validation and known limitations

• Local gates cover Bridge unit tests, debug/release lint, debug build, release contract validation
  and the 14-Provider debug matrix.
• The tag workflow builds the signed assets, verifies package/version, certificate, zipalign and DEX
  guards, freezes the Provider main to a full commit, and publishes the Bridge and LSP mirror from
  the same verified batch.
• Compatibility still depends on the OEM SystemUI implementation and on the lyric timing a player
  exposes through its MediaSession.
• The small-correction threshold (600 ms) is a fixed constant; larger position changes stay
  authoritative.

Assets

The release contains 18 verified assets: one Bridge APK, 14 Provider APKs, one Provider ZIP,
release-assets-v4.3.1.json and SHA256SUMS. The Provider ZIP contains the 14 top-level Provider
APKs only.

ColorOS 17 adaptation plan

ColorOS 17 nolog builds lock the bootloader, so the module runtime environment cannot be unlocked or
set up; this project will therefore not follow the nolog branch. In addition, the primary test device
(OnePlus 13) has not received a ColorOS 17 nolog build, so there is no device to validate against.
ColorOS 17 support will start after the official ColorOS 17 release: we will first compare the
SystemUI media/lyric implementation and permission surface on the official build, then publish
Bridge and Provider updates. Until then the current ColorOS 16 line keeps receiving bug fixes.

Credits

Thanks to Salt Player for the visual reference of the character lift step model, and to Lyrico and
Lyrico-Plugins for their open-source work on local music metadata, lyric management and pluggable
lyric sources.

Donate

ColorOS Live Lyrics Bridge v4.3.0

简体中文

字符上浮动画

v4.3.0 为 ColorOS / OPlus 原生歌词界面新增可选的 Salt Player 式字符上浮动画。未唱
字素会停在正常基线下方，既有揭示前沿经过时沿升余弦阶跃回到基线，已唱文本则保持在
基线。它与当前的 clip-reveal、羽化和 glow 共用同一个时钟，不会引入第二条歌词进度线。

• 默认关闭；低帧率 AOD 路径会自动关闭该效果。
• “字符浮动幅度”可调 0–200%；100% 时下沉约为歌词字号的 10%，且只在动画开启时显示。
• 行激活时有 240 ms 下沉窗口；逐字行结束时有 240 ms 收尾窗口，使稳定状态回到同一基线。
• 开启“普通逐行歌词进度”后，普通 LRC 行时间戳歌词也会以整行线性前沿驱动上浮，无需
  新歌词 payload 或时间格式。

渲染可靠性

换行多段行现在通过累加每段已揭示 advance 计算整行上浮前沿，修复此前前沿钉在首段末端、
只在末段可见动画的问题。可选 lift 路径保持隔离：运行时绘制异常会回退到既有整段绘制并
记录 CHAR_LIFT_UNAVAILABLE，不会让 SystemUI coordinator 拉黑歌词绑定。

设备验收覆盖逐字歌词（包含换行多段行）和已开启进度的普通逐行歌词。普通逐行最后约
1.5 个字宽会在行切换前留在过渡窗口内，由既有行切换动画吸收；提前改写映射会让上浮与
羽化前沿失步，因此保留这一已接受的行为。

架构、兼容性与升级

Bridge 仍只作用于 system 和 com.android.systemui。Provider 继续从各自 scope 内发布
标准 MediaMetadata["lyricInfo"]；本版本不恢复播放器进程 Bridge Hook 或私有歌词传输。

Provider 源码仍为 14 模块的 libxposed API 102 矩阵：12 个专属 Provider、通用播放器
Provider 与 Readify TTS Provider。v4.3.0 不改变 Provider 的业务行为，但会同步推进
规范 Provider 资产文件名与发布契约。

1. 从同一 v4.3.0 Release 安装 Bridge 与所需 Provider APK。
2. Bridge scope 只保留 system 和 com.android.systemui。
3. 开启“字符上浮动画”；普通 LRC 歌词还需开启“普通逐行歌词进度”。
4. 升级或变更 scope 后重启播放器与 SystemUI。

验证与已知限制

• 本地发布门禁覆盖 Bridge 单测、debug/release lint、debug 构建、发布契约校验以及
  14-Provider Debug 矩阵。
• tag workflow 生成正式签名资产，校验包名/版本、证书、zipalign 与 DEX guards，将
  Provider main 冻结到完整 commit，并从同一验证批次发布 Bridge 与 LSP mirror。
• 低帧率 AOD 下动画有意关闭。拖长音缓慢推进时仍可能有极轻微的像素阶跃感，已在设备上
  验收并接受。
• 兼容性仍取决于厂商 SystemUI 实现，以及播放器经 MediaSession 暴露的歌词时间信息。

资产

正式 Release 包含 18 项已验证资产：1 个 Bridge APK、14 个 Provider APK、1 个 Provider
ZIP、release-assets-v4.3.0.json 和 SHA256SUMS。Provider ZIP 只包含 14 个顶层
Provider APK。

致谢

感谢 Salt Player 提供字符上浮阶跃模型的视觉参考，也感谢 Lyrico 与 Lyrico-Plugins 在
本地音乐元数据、歌词管理和插件化歌词源上的开源工作与启发。

English

Character float-up

v4.3.0 adds an optional Salt Player-style character float-up effect to the native
ColorOS / OPlus lyric surface. Unsung graphemes rest below the normal baseline and
rise back along a cosine step as the existing reveal front reaches them; sung text
then remains at the baseline. It follows the same clip-reveal, feather, and glow
timing already used by the renderer rather than introducing a second lyric clock.

• The effect is off by default and automatically disabled on the low-frame-rate
  always-on display path.
• Character float amount is available from 0–200%; 100% is a sink of about
  10% of the lyric text size, and the control appears only while the effect is on.
• It uses a 240 ms sink-in at line activation and a 240 ms finish window so a
  completed word-timed row returns to one stable baseline.
• With Line-timed lyric progress enabled, ordinary LRC-style line-timed lyrics
  use the same float-up front across the whole line. No new lyric payload or timing
  format is required.

Rendering reliability

Wrapped lines now resolve their float-up front by summing each segment's revealed
advance. This fixes the former first-segment pinning that could leave animation
visible only on a trailing wrapped segment. The optional lift path remains isolated:
if a runtime draw error occurs, it falls back to the existing whole-segment draw and
records a CHAR_LIFT_UNAVAILABLE warning instead of allowing SystemUI's coordinator
to blacklist the lyric binding.

Device validation covered word-timed lyrics, including wrapped multi-segment lines,
and line-timed lyrics with progress enabled. The accepted visual behavior keeps the
final roughly 1.5 glyph widths in their transition window until an ordinary
line-to-line handoff; changing that mapping would desynchronize lift from the
feathered reveal front.

Architecture, compatibility, and upgrade

Bridge remains scoped only to system and com.android.systemui. Providers continue
to publish standard MediaMetadata["lyricInfo"] from their own scoped processes; this
release does not restore a player-process Bridge hook or a private lyric transport.

The Provider source remains the 14-module libxposed API 102 matrix: 12 dedicated
providers, Universal Player Provider, and Readify TTS Provider. Provider business
behavior is unchanged in v4.3.0; the canonical Provider asset names and release
contract advance together with Bridge.

1. Install the Bridge and any required Provider APKs from the same v4.3.0 release.
2. Keep Bridge scope limited to system and com.android.systemui.
3. Enable Character lift animation to use the new effect. For ordinary LRC
   lyrics, also enable Line-timed lyric progress.
4. Restart the player and SystemUI after upgrading or changing scope.

Validation and known limits

• Local release gates cover Bridge unit tests, debug/release lint, debug assembly,
  release-contract validation, and the 14-Provider debug matrix.
• The tag workflow produces the formal signed assets, validates package/version,
  certificate, zipalign, and DEX guards, freezes Provider main to a full commit,
  and publishes the Bridge and LSP mirror from the same verified batch.
• The effect is intentionally disabled in low-frame-rate AOD mode. Slowly advancing
  sustained syllables can still have a very slight pixel-step character that is
  inherent to raster frames; it was evaluated on device and accepted.
• Compatibility still depends on the vendor SystemUI implementation and the lyric
  timing that the selected player exposes through its MediaSession.

Assets

The formal release contains 18 verified assets: one Bridge APK, 14 Provider APKs,
one Provider ZIP, release-assets-v4.3.0.json, and SHA256SUMS. The Provider ZIP
contains only the 14 top-level Provider APKs.

Acknowledgements

Thanks to Salt Player for the visual reference behind the float-up step model, and
to Lyrico and Lyrico-Plugins for their open-source work and inspiration around local
music metadata, lyric management, and plugin-based lyric sources.

Donate

ColorOS Live Lyrics Bridge v4.2.1

Readify TTS Provider / Readify TTS Provider

4.2.1 将 io.github.andrealtb.coloroslyrics.provider.readify 纳入正式 Provider
矩阵。它面向 Readify AI 3.1.0 的 com.readin.app，通过宿主已有 MediaSession
发布事件驱动的句子窗口；Bridge 保持只运行于 system 和
com.android.systemui。

All 14 Provider modules use libxposed API 102 with static scope and protective exception handling.

• sentence-window-v1 使用当前句索引保持高亮，避免 TTS 在未知时长时提前滚动。
• 最多五句的窗口可完整展示长文本，未伪造音频时间轴、播放状态或额外 MediaSession。
• Provider 仅读取宿主已预取的 Chunk AI/Readium 缓存，不推进朗读器或发起额外合成请求。
• Readify 继续严格锁定宿主 3.1.0；未知版本不发布歌词。正式 APK 的最终真机安装验证仍待补充。

发布与升级

1. 安装同一 v4.2.1 Release 中的 Bridge 与所需 Provider APK。
2. Readify Provider 仅在 LSPosed 中勾选 com.readin.app；Bridge scope 只保留 system
   与 com.android.systemui。
3. 不要同时启用历史测试包 de.sqlsec.readifylyrics 与正式 Readify Provider。
4. 更新后重启 Readify、SystemUI；首次安装或 scope 变更后按设备需要重启。

Release validation

• Provider matrix now contains 14 API 102 modules: 12 dedicated providers, Universal Player, and Readify.
• The tag workflow validates 14 Provider APKs, 15 APKs total, and 18 release assets, including
  package/version metadata, certificate, zipalign, DEX guards, Provider ZIP, manifest, and SHA256SUMS.
• The workflow resolves Providers main to a full commit SHA before build; the release manifest
  records that SHA and later stages use only the frozen commit.

Assets

The formal Release contains 18 assets: 1 Bridge APK, 14 Provider APKs, 1 Provider ZIP,
release-assets-v4.2.1.json, and SHA256SUMS. The Provider ZIP contains 14 top-level APKs only.

Donate

ColorOS Live Lyrics Bridge v4.2.0

通用播放器 Provider / Universal Player Provider

4.2.0 新增 Universal Player Provider 1.0.0 (1)。全部 Provider 继续使用 libxposed API 102。
它在 system_server 观察用户在设置
App 中明确选中的 MediaSession 播放器，并将已解析歌词安全附加到该播放器的原生 metadata；
Bridge 仍只运行于 system 和 com.android.systemui，不会进入任意播放器进程，也不会接收
旧版私有歌词 transport。

• Bridge 新增受限的通用 Provider 绑定同步：仅接受固定 action 与受控绑定集合，变更后重建
  SystemUI 侧兼容策略，不扩大 Bridge scope。
• 通用 Provider 仅处理用户选中的包；未选择的音乐、视频或其他 MediaSession 不会被注入。
• Provider 设置 App 支持播放器选择、来源优先级、缓存、手动匹配及诊断；正式版本为
  1.0.0 (1)。
• 12 个既有专属 Provider 保持其既有内部版本与实现；本次套件新增第 13 个 APK。

使用、升级与限制

1. 安装同一 4.2.0 Release 的 Bridge 和需要的 Provider。
2. 专属 Provider 继续只在 LSPosed 中勾选其对应播放器；通用 Provider 仅保留 system
   scope，并在它自己的设置 App 内选择目标播放器。
3. 使用通用 Provider 时，关闭播放器的蓝牙歌词、车载歌词或其他会用当前歌词覆写媒体标题的
   功能。两者同时启用时，首曲识别、缓存命中和切歌判定可能不可靠。
4. 更新模块、修改 scope 或绑定列表后，重启 SystemUI 与目标播放器。回滚请使用已发布的
   4.1.1 Bridge 与配套 Provider APK；Android 可能要求显式允许降级安装。

发布验证

• Provider 契约现在精确列出 13 个 API 102 模块，并把通用 Provider 的 system_server
  静态 scope、applicationId、入口、版本和正式资产名称纳入校验。
• CI、收集脚本、Bridge 跨仓库契约、签名/zipalign/包元数据校验及 Provider ZIP 均升级为
  13 个 Provider APK；最终 Release 为 14 个 APK、17 项资产。
• 最终 tag workflow 会重新执行 Bridge unit tests/lint、Provider matrix tests、正式签名
  release/R8 构建、DEX 禁用字符串检查、SHA-256 清单和 Bridge/LSP 双 Release 发布。
• 通用 Provider 的已知蓝牙/车载歌词边界及当前真机回归状态见 Provider 仓库的
  docs/4.1/UNIVERSAL-PROVIDER-*.zh-CN.md；未列为本次发布阻断项的场景不应表述为已完成
  真机验收。

资产

正式 Release 恰好包含 17 项：1 个 Bridge APK、13 个 Provider APK、1 个 Provider ZIP、
release-assets-v4.2.0.json 和 SHA256SUMS。Provider ZIP 只是顶层 APK 下载合集，不是
Recovery 刷机包。

---

Universal Player Provider

4.2.0 adds Universal Player Provider 1.0.0 (1). It observes only the MediaSession players that
the user selects in its settings app, enriches their native metadata from system_server, and
leaves Bridge scoped to system and com.android.systemui. No player-process Bridge hook or
legacy private lyric transport is restored.

• Binding updates are limited to the fixed Universal Provider action and a controlled package set.
• Unselected music, video, and other MediaSession apps are not injected.
• The existing 12 dedicated Providers retain their implementation and internal versions; this suite
  adds a thirteenth Provider APK.

Install matching 4.2.0 assets. Keep dedicated Providers scoped to their matching player; keep the
Universal Provider scoped only to system and select target players in its app. Disable Bluetooth,
car-lyrics, or similar features that overwrite media titles while using Universal Provider. Restart
SystemUI and the target player after an update, scope change, or binding change.

The signed workflow validates 13 Provider APKs, 14 APKs total, and 17 release assets, including
package/version metadata, certificate, zipalign, DEX guards, the Provider ZIP, and SHA-256 sums.
Device scenarios not marked complete in the Universal Provider regression matrix remain pending.

Donate

ColorOS Live Lyrics Bridge v4.1.1

中文

4.1.1 是 4.1 系列的 Bridge 修复版。Bridge 仍只运行在 system 和
com.android.systemui，播放器歌词仍由播放器自己的 MediaSession 及独立 Provider
发布；本版没有改变 Provider 版本或私有播放器 Hook。

翻译按钮与 OPlus 媒体卡片

• 修复翻译动作在同一个 OPlus 媒体模型重复重建时丢失原始动作身份的问题。
• 翻译按钮关闭、歌词明确没有翻译，或切歌处于暂态空窗时，分别执行安全撤销或保留未知状态，恢复播放器原生动作及顺序。
• 修复设置重应用路径遗漏“用户关闭翻译按钮”的门禁，并在设置或歌词模型变化后请求媒体动作重新绑定。
• 普通媒体卡片和下拉控制中心的 OPlus action-rule 表同时更新，避免两个界面命中不同规则。
• MD3Music 的 com.md3music.md3music 加入已验证的 OPlus media-history / translation 兼容名单；有翻译时接管桌面歌词动作，保留收藏动作，无翻译时恢复桌面歌词。
• 翻译动作的语义图标仍要求资源型 Icon，避免 SystemUI 对 bitmap、URI 或 data 图标调用不兼容接口。

架构与兼容范围

• Bridge 继续只消费播放器 MediaSession 的标准 lyricInfo，不进入播放器进程，也不恢复旧的私有歌词传输。
• 4.1.1 复用已验证的 12 个 Provider 源码并建立发布标签 providers-v1.1.1；Provider 包名、作用域和内部版本保持不变。
• Bridge APK 的作用域仍为 system、com.android.systemui；不需要为 MD3Music 增加 Bridge 的播放器进程作用域。
• ColorOS 锁屏歌词和 OPlus 媒体卡片属于厂商私有实现，系统或播放器升级后仍可能需要重新验证。

升级与回滚

1. 在支持 libxposed API 102 的 LSPosed 环境中安装 ColorOS-Live-Lyrics-Bridge-v4.1.1.apk。
2. 保持 Bridge 只勾选 system 与 com.android.systemui，并重启 SystemUI；翻译动作设置变化后重启对应播放器。
3. 使用 4.1.1 Release 中的 Provider APK；本版 Provider 源码只变更发布契约，标签为 providers-v1.1.1，内部版本沿用 1.1.0。
4. 如需回滚，使用已发布的 4.1.0 Bridge 与对应 Provider；Android 可能要求显式允许版本降级。

验证

• Bridge 本地 testDebugUnitTest：510 项通过，6 项明确跳过，0 failure/error。
• Debug APK 的 API 102 元数据、作用域、DEX 修复标记、v2 签名和 zipalign 已通过本地检查。
• 用户已完成本次翻译按钮回归：按钮接管、关闭/恢复和控制中心显示通过。
• 正式 tag workflow 重新执行 release lint、签名 release 构建、Provider 矩阵构建、13 APK 校验、16 项资产打包和 SHA-256 复核。

发布资产

正式 Release 恰好包含 16 项：1 个 Bridge APK、12 个 Provider APK、1 个 Provider ZIP、
release-assets-v4.1.1.json 和 SHA256SUMS。Provider ZIP 只是 APK 下载合集，不是 Recovery
刷机包。

感谢所有提供播放器样本、ColorOS SystemUI 证据、日志和实机回归结果的贡献者。

English

4.1.1 is a Bridge maintenance release for the 4.1 line. Bridge remains limited to system and
com.android.systemui; player lyrics still come from player-owned MediaSessions and independent
Providers. Provider versions and private player hooks are unchanged.

Translation actions and OPlus media cards

• Preserve the original action identity when an OPlus media model is rebound repeatedly.
• Safely undo a translation takeover when the button is disabled or a track is known to have no
  translation, while leaving a transient track-change gap unresolved until the next model arrives.
• Apply the user-disabled button gate during settings reapplication and request a media-action rebind
  after settings or lyric-model changes.
• Update both the regular media-card and Quick Settings OPlus action-rule tables so they select the
  same Rule0 policy.
• Add com.md3music.md3music to the device-validated OPlus media-history/translation compatibility
  policy. With translations, Bridge takes over the desktop-lyrics action and keeps favorite; without
  translations, it restores desktop lyrics.
• Keep resource-backed semantic icons as the only safe icon type for this SystemUI path.

Architecture and compatibility

• Bridge consumes standard lyricInfo from player MediaSessions and never enters player processes or
  restores the retired private lyric transport.
• The release uses the validated Provider source with the metadata-only tag providers-v1.1.1; Provider package IDs,
  scopes, and internal versions remain unchanged.
• Bridge scope remains exactly system and com.android.systemui.
• ColorOS lock-screen lyrics and OPlus media cards are private vendor surfaces and may require renewed
  validation after system or player updates.

Upgrade and rollback

1. Install ColorOS-Live-Lyrics-Bridge-v4.1.1.apk in an LSPosed environment supporting libxposed API 102.
2. Keep only system and com.android.systemui selected for Bridge and restart SystemUI; restart the affected player after translation-action setting changes.
3. Use the Provider APKs from the same 4.1.1 Release; their source tag is providers-v1.1.1 and internal versions remain 1.1.0.
4. Roll back with the published 4.1.0 Bridge and matching Providers if needed; Android may require an explicit downgrade install method.

Validation

• Local Bridge testDebugUnitTest: 510 passed, 6 explicitly skipped, 0 failures/errors.
• The debug APK passed local API 102 metadata, scope, DEX-marker, v2-signature, and zipalign checks.
• The user confirmed the translation-action takeover, disable/restore path, and Quick Settings display.
• The formal tag workflow reruns release lint, signed release builds, the Provider matrix, 13-APK checks, 16-asset packaging, and SHA-256 verification.

Release assets

The formal Release contains exactly 16 files: one Bridge APK, 12 Provider APKs, one Provider ZIP,
release-assets-v4.1.1.json, and SHA256SUMS. The Provider ZIP is an APK download bundle, not a
Recovery package.

Thanks to everyone who supplied player samples, ColorOS SystemUI evidence, logs, and device
regression results.

Donate

ColorOS Live Lyrics Bridge v4.1.0

中文

4.1 是一次稳定性与现代 LSPosed API 升级。Bridge 继续只运行于 system 和
com.android.systemui，播放器专属逻辑仍由 12 个独立 Provider 在播放器自己的
MediaSession 中发布标准 MediaMetadata["lyricInfo"]。本版把全部 Provider 统一迁移到
libxposed API 102，并集中修复 4.0 实机回归、完整代码审查以及歌词/封面边界问题。

12 Provider 全量 API 102 迁移

• Salt、Cone、酷我、LX、Poweramp、Metrolist、酷狗、QQ、网易云、Apple、Spotify 与汽水
  全部改用唯一的 XposedModule 入口和 META-INF/xposed 现代资源。
• 12 个 Provider 均声明 minApiVersion=102、targetApiVersion=102、静态作用域、
  exceptionMode=protective，并明确关闭 Hot Reload。
• 移除旧 Hook 入口、旧共享偏好和兼容层；Debug 配置切换到 libxposed Remote Preferences，
  默认仍关闭，开启或关闭后需要完全重启目标播放器进程。
• 每个 Provider 的 package/process/profile、歌词获取、曲目 generation、翻译 lane、封面、
  PlaybackState 与 action 所有权保持 4.0 已验证语义。
• 全部 Provider 内部版本统一提升到 1.1.0：Salt versionCode=6，其余 11 个
  versionCode=2，可覆盖安装正式 4.0 Provider。

Bridge 稳定性与歌词修复

• 收紧 SystemUI 主进程路由，修复 MediaController 回调在控制器切换后的注册/注销与事件代际，
  避免旧控制器或旧歌词结果污染当前曲目。
• 歌词发布新增本地 epoch 与曲目身份门禁；稳定 track key 优先，缺少身份的 payload 不再跨曲
  复用任意旧歌词。
• 修复酷狗冷启动首曲身份和时间轴事务：fallback key、mediaId、songId 的同曲补全不再制造
  新 generation；宿主官方 lyric 时间倒退时改用同批 KRC 生成的单调时间轴，完整保留制作
  人员 credit，避免《回家的路》第一句在冷启动时丢失。QQ 音乐正常首句行为保持不变。
• 统一识别普通空格、NBSP 与 Unicode 空白占位，防止空白行被误判为翻译。
• 官方歌词自绘失败时立即回退宿主绘制，并确保 Canvas 状态始终恢复，避免单帧空白或后续绘制
  污染。
• 修复 OPlus 媒体 action 图标在旧 Android API 上的类型读取风险；只有图标反射写入并回读成功
  时才替换/提升翻译 action。
• 完成反射/Class 缓存、插件 Hook 生命周期、负速率回绕以及设置颜色对话框键盘与无障碍行为的
  稳定性收口。
• 结构化日志不再记录完整歌词、稳定 media ID、URL query 或私人路径，诊断只保留计数、类型与
  脱敏 hash。

酷我首曲封面

• 酷我 Provider 在播放器首次歌词早于宿主 metadata 到达时保持当前 MediaSession，避免首曲错过
  立即发布窗口。
• 对酷我官方封面主机使用 HTTPS、无重定向、有限超时/大小/分辨率的封面补全；结果严格绑定
  track identity 与 generation，切歌后的旧结果会被丢弃。
• 修复首次打开酷我时首曲封面降级为纯色、后续切歌却正常的问题；后续宿主原生 bitmap 仍优先。

Provider 支持矩阵 / Provider matrix

播放器 / Player	资产 / Asset	Provider 内部版本 / Internal version	已验证宿主 / Validated host	歌词能力 / Lyrics
Salt Player	ColorOS-Live-Lyrics-Provider-Salt-v4.1.0.apk	1.1.0 (6)	12.3.0-alpha03	逐字、翻译 / Word timing, translations
Cone / GP	ColorOS-Live-Lyrics-Provider-Cone-v4.1.0.apk	1.1.0 (2)	1.2.0 profile / GP	完整时间轴、翻译 / Timeline, translations
酷我 / KuWo	ColorOS-Live-Lyrics-Provider-KuWo-v4.1.0.apk	1.1.0 (2)	12.2.0.0	官方追加、逐字、翻译 / Official append, word timing, translations
LX / Walnut	ColorOS-Live-Lyrics-Provider-LX-v4.1.0.apk	1.1.0 (2)	LX 1.8.4 / Walnut 26.07.16	逐字、翻译、蓝牙与封面兼容 / Word timing, translations, Bluetooth/artwork
Poweramp	ColorOS-Live-Lyrics-Provider-Poweramp-v4.1.0.apk	1.1.0 (2)	build 1025	同目录或内嵌歌词、翻译 / Sidecar or embedded lyrics, translations
Metrolist	ColorOS-Live-Lyrics-Provider-Metrolist-v4.1.0.apk	1.1.0 (2)	13.6.1	BetterLyrics/LrcLib/KuGou，不支持翻译 / No translations
酷狗 / KuGou Concept	ColorOS-Live-Lyrics-Provider-KuGou-v4.1.0.apk	1.1.0 (2)	20.8.0 / 5.2.61	官方追加、逐字、翻译 / Official append, word timing, translations
QQ 音乐 / QQ Music	ColorOS-Live-Lyrics-Provider-QQ-v4.1.0.apk	1.1.0 (2)	20.7.5.8	QRC 逐字、翻译 / QRC word timing, translations
网易云、荣耀、9.0.40 / NetEase, Honor, 9.0.40	ColorOS-Live-Lyrics-Provider-NetEase-v4.1.0.apk	1.1.0 (2)	9.5.70 / 3.5.20 / 9.0.40	官方追加或构造、翻译 / Official append or constructed, translations
Apple Music	ColorOS-Live-Lyrics-Provider-Apple-v4.1.0.apk	1.1.0 (2)	6.5.2	JNI TTML 逐字、翻译 / JNI TTML word timing, translations
Spotify	ColorOS-Live-Lyrics-Provider-Spotify-v4.1.0.apk	1.1.0 (2)	9.1.78.2208	Color Lyrics 逐行或逐字，不支持翻译 / Line or word timing, no translations
汽水音乐 / QiShui	ColorOS-Live-Lyrics-Provider-QiShui-v4.1.0.apk	1.1.0 (2)	20.7.0	TrackLyric/缓存、逐字、翻译 / TrackLyric/cache, word timing, translations

从 4.0 升级

1. 需要支持 libxposed API 102 的 LSPosed/LSP 环境；建议使用 LSPosed 2.2.0 或更新版本。
2. 使用正式 ColorOS-Live-Lyrics-Bridge-v4.1.0.apk 覆盖安装 4.0.0，Bridge 作用域仍只保留
   system 与 com.android.systemui。
3. 使用同一 4.1.0 Release 中自己需要的 Provider APK 覆盖 4.0 Provider，并保持每个 Provider
   只勾选对应播放器。
4. Provider Debug 已迁移到 Remote Preferences，升级后会按默认关闭处理；需要日志时重新打开
   Debug，并完全停止后重启播放器。
5. 本版不支持 Hot Reload。更新 Provider、修改作用域或切换 Debug 后必须重启目标进程；首次
   升级建议重启设备。
6. 不要让旧词幕 Provider 与当前 Provider 同时 Hook 同一播放器。

需要回滚时可重新安装 4.0.0 正式 Bridge 与对应 Provider。Provider applicationId 和正式签名
保持不变；若 Android 阻止降版本，需要使用允许版本降级的安装方式。Bridge 设置 schema 未
变更，但仍建议升级前导出完整配置备份。

验证

• 12/12 Provider 已完成 API 102 资源、入口、scope、依赖、Remote Preferences、legacy 字符串、
  单元测试和 Debug 全矩阵门禁；488 tests，0 failure/error/skip，生成恰好 12 个 Debug APK。
• Wave A–E 覆盖全部 12 个 Provider 及多宿主/profile 的用户真机回归；网易云 9.0.40 构造
  profile 按其特殊安装前提验收。
• 本次 Bridge 审查修复通过 503 tests（0 failure/error，6 项明确 skipped）、debug/release
  lint（0 error）与 Debug 构建门禁；酷狗首句、酷我首曲封面和 OPlus 媒体 action 崩溃路径
  均由用户实机确认。
• 正式签名 RC/GA 流水线会重新构建 13 个 APK，并校验 R8、包名、内部版本、API 102 资源、
  scope、证书、zipalign、DEX 禁用字符串、16 项资产与 SHA-256。

已知限制

• ColorOS 锁屏歌词属于私有 SystemUI 功能，系统更新后可能需要重新适配。
• 播放器私有歌词接口可能随播放器更新变化。
• Spotify 与 Metrolist 当前不提供翻译；QQ 音乐 HD 不在支持矩阵。
• 歌词源没有逐字或翻译 lane 时，Bridge 不会凭空生成。
• 4.1 Provider 要求 libxposed API 102；不提供旧 Hook API 回退或 Hot Reload。

本项目不分发词幕 Provider。需要词幕时请前往
LyricProvider 原项目，词幕显示或产品问题也请
向原项目反馈。

开发文档、致谢与支持

• 播放器主动发布 lyricInfo 协议
• Provider 适配技术指南

感谢 tomakino/LyricProvider 原项目及贡献者、Accompanist Lyrics Core，以及提供播放器样本、
SystemUI 证据、日志、录屏和实机验证的所有用户。第三方来源与许可证保留在 Bridge
LICENSE、Provider NOTICE、源码头和迁移报告中。

如果项目对你有帮助，可在
Bridge README 查看支持方式。
支持完全自愿，不影响 Issue 优先级或 Release 资产获取。

---

English

4.1 is a stability and modern LSPosed API release. Bridge remains limited to system and
com.android.systemui; player-specific code still lives in 12 independent Providers that publish
standard MediaMetadata["lyricInfo"] through player-owned MediaSessions. This release migrates the
entire Provider matrix to libxposed API 102 and closes the 4.0 device regressions, full code-review
findings, and lyric/artwork edge cases.

Complete 12-Provider API 102 migration

• Salt, Cone, KuWo, LX, Poweramp, Metrolist, KuGou, QQ, NetEase, Apple, Spotify, and QiShui now use
  a single XposedModule entry and modern META-INF/xposed resources.
• Every Provider declares API 102 as both minimum and target, static scope, protective exception
  mode, and explicitly disabled Hot Reload.
• Legacy hook entries, preferences, and compatibility layers were removed. Debug configuration now
  uses libxposed Remote Preferences, remains off by default, and takes effect after a full player
  process restart.
• Existing package/process profiles, lyric acquisition, track generation, translation lanes,
  artwork, PlaybackState, and action ownership preserve the device-validated 4.0 behavior.
• All Provider internal versions move to 1.1.0: Salt uses versionCode=6; the other 11 use
  versionCode=2, allowing in-place upgrades from the official 4.0 packages.

Bridge stability and lyric fixes

• Tightened the SystemUI main-process route and repaired MediaController callback registration,
  teardown, and event epochs across controller changes.
• Added local publication epochs and track-identity gates. Stable track keys are authoritative, and
  identity-free payloads can no longer retain arbitrary lyrics across tracks.
• Fixed KuGou cold-start identity and timeline transactions. Enriching the same track from a
  fallback key to mediaId/songId no longer advances generation; a non-monotonic official lyric
  is replaced by a monotonic timeline generated from the same KRC while retaining every production
  credit. This prevents the first real line from disappearing and preserves the correct QQ path.
• Unified normal spaces, NBSP, and Unicode whitespace placeholder handling.
• Renderer failures immediately fall back to host drawing and always restore Canvas state.
• Removed the old-API OPlus media-action icon type risk; translation action replacement/promotion
  now requires successful semantic icon writeback and readback.
• Closed reflection/cache, plugin-hook lifecycle, negative rewind, settings keyboard, and
  accessibility issues.
• Structured diagnostics no longer expose full lyrics, stable media IDs, URL queries, or private
  local paths.

First-track KuWo artwork

• KuWo keeps the current MediaSession when lyrics arrive before the first host metadata update, so
  the first-track publication window is not lost.
• Official KuWo artwork hosts are fetched over HTTPS with no redirects and bounded timeout, size,
  and dimensions. Completion is tied to track identity and generation; stale results are dropped.
• This fixes the first KuWo track degrading to a solid color while later track changes work. A
  later host-provided bitmap still has priority.

The single bilingual Provider matrix above is shared by both language sections.

Upgrade from 4.0

1. Use an LSPosed/LSP environment that supports libxposed API 102; LSPosed 2.2.0 or newer is
   recommended.
2. Install the official ColorOS-Live-Lyrics-Bridge-v4.1.0.apk over 4.0.0 and keep Bridge scope
   limited to system and com.android.systemui.
3. Install the matching Provider APKs from the same 4.1.0 Release over their 4.0 versions, keeping
   each Provider scoped only to its player.
4. Provider Debug moved to Remote Preferences and starts from the disabled default after upgrade.
   Re-enable it when logs are needed, then fully restart the player.
5. Hot Reload is not supported. Restart the target process after Provider, scope, or Debug changes;
   a device reboot is recommended for the first upgrade.
6. Never let an old Lyricon Provider and the current Provider hook the same player simultaneously.

Rollback uses the official 4.0.0 Bridge and Provider packages. Application IDs and release signing
remain unchanged; Android may require an install method that explicitly permits version downgrade.
The Bridge settings schema is unchanged, but exporting a complete backup before upgrade is still
recommended.

Validation

• All 12 Providers passed API 102 resource, entry, scope, dependency, Remote Preferences, legacy
  string, unit-test, and debug-matrix gates: 488 tests with no failures, errors, or skips, and exactly
  12 debug APKs.
• User-run Wave A–E device regression covered all Providers and multi-host/process profiles;
  NetEase 9.0.40 was accepted under its documented special installation prerequisite.
• The Bridge review fixes passed 503 tests (no failures/errors, six explicit skips), debug/release
  lint with no errors, and the debug build gate. The KuGou first line, first-track KuWo artwork, and
  OPlus media-action crash paths were confirmed on device by the user.
• The signed RC/GA workflow rebuilds all 13 APKs and verifies R8, package IDs, internal versions,
  API 102 resources, scopes, certificate, zipalign, forbidden DEX strings, 16 assets, and SHA-256.

Known limits

• ColorOS lock-screen lyrics are a private SystemUI feature and may require renewed compatibility
  work after system updates.
• Player-private lyric APIs can change after player updates.
• Spotify and Metrolist currently have no translations; QQ Music HD is outside the matrix.
• Bridge cannot invent word timing or translations absent from the source.
• 4.1 Providers require libxposed API 102; there is no legacy hook fallback or Hot Reload support.

This project does not distribute Lyricon Providers. Obtain them from the
original LyricProvider project, and report Lyricon
display/product issues there.

Developer documentation, acknowledgements, and support

• Player-owned lyricInfo protocol
• Provider adaptation guide

Thanks to the original tomakino/LyricProvider project and contributors, Accompanist Lyrics Core,
and everyone who supplied player samples, SystemUI evidence, logs, recordings, and device
validation. Third-party provenance and licenses remain in the Bridge LICENSE, Provider NOTICE,
source headers, and migration reports.

Support is optional and never changes issue priority or access to release assets. See the
Bridge README for
support options.

Assets / 发布资产

The Release contains exactly 16 files / Release 恰好包含 16 项文件：

• ColorOS-Live-Lyrics-Bridge-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-Salt-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-Cone-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-KuWo-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-LX-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-Poweramp-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-Metrolist-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-KuGou-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-QQ-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-NetEase-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-Apple-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-Spotify-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-QiShui-v4.1.0.apk
• ColorOS-Live-Lyrics-Providers-v4.1.0.zip
• release-assets-v4.1.0.json
• SHA256SUMS

The Provider ZIP is an APK download bundle, not a Recovery package. / Provider ZIP 只是 APK 下载
合集，不是 Recovery 刷机包。

Donate

ColorOS Live Lyrics Bridge v4.0.0

中文

4.0 是一次完整架构升级。
播放器专属 Hook 已迁移到 12 个独立 Provider，由 Provider 从
播放器自己的 MediaSession 发布原生 MediaMetadata["lyricInfo"]。
Bridge 现在只运行于system 和 com.android.systemui，
负责通用逐字渲染、AOD、外观、翻译按钮与 SystemUI兼容增强。
并移除对词幕lyricon的兼容支持。

这是从 3.8.x 升级时需要完整迁移的破坏性版本。
重要！！请从同一个 4.0.0 Release 安装 Bridge 与自己需要的 Provider，
并在启用新 Provider 前取消旧 Provider 对同一播放器的作用域。

Bridge 架构

• 删除 direct-v4 receiver、来源/发送者注册表、外部协议模块与播放器进程 Adapter。
• Bridge 不再识别 Provider applicationId，也不再请求或接收私有歌词 payload。
• Bridge 作用域缩减为 system 与 com.android.systemui。
• 每次原生 lyricInfo 发布只解析一次，身份、清理、翻译对齐、官方列表和 renderer 共用
  同一个快照。
• SystemUI 大型 Hook 已拆分为 bootstrap、diagnostics、media/lyrics policy、model
  assembly、frame resolve、draw coordinator 和具名兼容 owner。
• Debug 默认关闭，采用结构化 [CLL] 事件、节流、脱敏以及 logcat/Xposed 双写；开启
  Debug 不会改变歌词行为。

歌词外观与渲染

• 新增独立“歌词亮度与渐隐”页面。
• 可分别调整实时文字、实时未高亮部分、实时翻译、翻译进度、非实时文字和非实时翻译。
• 非实时翻译可跟随正文亮度，也可独立设置。
• RecyclerView 上下边缘渐隐支持开关和长度调节。
• 非活动行额外淡化与模糊、缩放互相独立。
• 默认、柔和、鲜明、极简四套预设覆盖新增参数；任意偏离预设的设置显示为“自定义”。
• 根据实机反馈调整了预览行距、垂直居中、整数 dp 渐隐步进、全宽底部 Dock 和滑动条长度。
• 修复居中、右对齐歌词仍从左侧 pivot 缩放的问题。

翻译、配置与清理

• 默认亮度层级调整为：实时正文最亮，实时翻译稍暗，非实时翻译与对应非实时正文一致。
• 翻译基础亮度与翻译逐字进度亮度分别控制。
• 媒体卡翻译按钮现在立即刷新，不再等待暂停/继续播放。
• 翻译图标统一使用白色基准 tint，并通过 alpha 表示开关状态，避免部分播放器显示成黑色。
• 新增 Bridge 全量配置备份与恢复，覆盖 UI/schema、全局及逐播放器翻译、开头清理规则、
  逐曲修正、Debug 与设置语言；恢复失败会回滚。
• 全量重置需要二次确认。
• 内置歌词开头清理规则继续保留，但默认关闭；Bridge 不再无条件修补所有原生 payload。

原生播放器主动接入

Halcyon、Flamingo、QZ Music 与 PrismMusic 已加入纯包名的 SystemUI 歌词入口、媒体历史和
AOD 兼容策略。这不是歌词来源白名单：播放器仍必须从自己的 MediaSession 发布标准
lyricInfo，旧广播不会被接收，也不需要额外 Provider APK。

Provider 支持矩阵 / Provider matrix

以下表格由中英文说明共用。Provider 可以独立安装；受支持的 ColorOS SystemUI 能直接
消费其原生 lyricInfo，Bridge 只增加可选的通用增强。

播放器 / Player	资产 / Asset	已验证宿主 / Validated host	歌词能力 / Lyrics
Salt Player	ColorOS-Live-Lyrics-Provider-Salt-v4.0.0.apk	12.3.0-alpha03	逐字、翻译 / Word timing, translations
Cone / GP	ColorOS-Live-Lyrics-Provider-Cone-v4.0.0.apk	1.2.0 profile / GP	完整时间轴、翻译 / Timeline, translations
酷我 / KuWo	ColorOS-Live-Lyrics-Provider-KuWo-v4.0.0.apk	12.2.0.0	官方 payload 追加逐字与翻译 / Official append, word timing, translations
LX / Walnut	ColorOS-Live-Lyrics-Provider-LX-v4.0.0.apk	LX 1.8.4 / Walnut 26.07.16	逐字、翻译、蓝牙与封面兼容 / Word timing, translations, Bluetooth/artwork fixes
Poweramp	ColorOS-Live-Lyrics-Provider-Poweramp-v4.0.0.apk	build 1025	同目录或内嵌歌词、翻译 / Sidecar or embedded lyrics, translations
Metrolist	ColorOS-Live-Lyrics-Provider-Metrolist-v4.0.0.apk	13.6.1	BetterLyrics/LrcLib/KuGou，不支持翻译 / No translations
酷狗 / KuGou Concept	ColorOS-Live-Lyrics-Provider-KuGou-v4.0.0.apk	20.8.0 / 5.2.61	官方追加逐字与翻译 / Official append, word timing, translations
QQ 音乐 / QQ Music	ColorOS-Live-Lyrics-Provider-QQ-v4.0.0.apk	20.7.5.8	QRC 逐字、翻译 / QRC word timing, translations
网易云、荣耀、9.0.40 / NetEase, Honor, 9.0.40	ColorOS-Live-Lyrics-Provider-NetEase-v4.0.0.apk	9.5.70 / 3.5.20 / 9.0.40	官方追加或构造、翻译 / Official append or constructed, translations
Apple Music	ColorOS-Live-Lyrics-Provider-Apple-v4.0.0.apk	6.5.2	JNI TTML 逐字、翻译 / JNI TTML word timing, translations
Spotify	ColorOS-Live-Lyrics-Provider-Spotify-v4.0.0.apk	9.1.78.2208	Color Lyrics 逐行或逐字，不支持翻译 / Line or word timing, no translations
汽水音乐 / QiShui	ColorOS-Live-Lyrics-Provider-QiShui-v4.0.0.apk	20.7.0	TrackLyric/缓存、逐字、翻译 / TrackLyric/cache, word timing, translations

从 3.8.x 升级

1. 在 Bridge 主设置页备份完整配置。
2. 使用正式 4.0.0 Bridge APK 覆盖安装官方 3.8.1。
3. Bridge 作用域只保留 system 和 com.android.systemui。
4. 卸载旧 Provider，或至少取消旧模块对同一播放器的全部作用域。
5. 安装对应的 ColorOS-Live-Lyrics-Provider-<Name>-v4.0.0.apk，只勾选表中宿主。
6. 重启播放器与 SystemUI；首次安装或作用域迁移后建议重启设备。
7. 不要让旧、新 Provider 同时 Hook 同一个播放器。

完整 applicationId、作用域和降级说明：

• 3.8.x → 4.0 迁移指南

降级到 3.8.x 不能保证配置无损，因为旧版本不认识全部 schema-v3 字段。请保留 4.0 完整
备份，并准备在旧版中重置设置。

验证与发布资产

• Bridge 标准 Gradle：481 tests，0 failure/error，6 项明确 skipped；debug/release lint、
  构建、包名、作用域、证书、zipalign、DEX 与 manifest 门禁通过。
• Provider testV5Matrix：462 tests，0 failure/error/skip；12 个 release/R8 构建通过。
• RC5 run 33301880289 的正式签名包已通过用户实机回归。
• 正式 run 33305725280
  完成不可变源码解析、Bridge/Provider 签名构建、16 资产打包以及 Bridge/LSP 双发布。
• 两个公开 Release 各 16 项资产，名称、字节数与 SHA-256 完全一致；13 个 APK 和
  12-APK Provider ZIP 已重新下载独立复核。
• Bridge commit：6ebced30a6af3fa5015af0c8ab212ea339fd9d91。
• Provider commit：950c3b170271e3a0f9bccdf3fa18735451740c80。
• Bridge APK SHA-256：3be16859c347740ca47c5bd99f0180d45fcb45615a2e90a5398417f2e98751f6。
• Provider ZIP SHA-256：3465696f5355a55379dad7ab70d637cd42659449f480f67d54ac697882b8e07d。

Release 恰好包含 16 项资产：1 个 Bridge APK、12 个 Provider APK、1 个 Provider ZIP、
release-assets-v4.0.0.json 和 SHA256SUMS。Provider ZIP 只是 APK 下载合集，不是
Recovery 刷机包。

已知限制

• ColorOS 锁屏歌词属于私有 SystemUI 功能，系统更新后可能需要重新适配。
• 播放器私有歌词接口可能随播放器更新变化。
• Spotify 与 Metrolist 当前不提供翻译。
• QQ 音乐 HD 不在 4.0 支持矩阵。
• 歌词源没有逐字或翻译 lane 时，Bridge 不会凭空生成。

本项目不再兼容适配词幕 Provider。
需要词幕时请前往LyricProvider 原项目下载对应 词幕 Provider。
词幕显示或相关问题也请向词幕原项目仓库反馈。

开发文档、致谢与支持

• 播放器主动发布 lyricInfo 协议
• Provider 适配技术指南

感谢 tomakino/LyricProvider 原项目及贡献者、Accompanist Lyrics Core，以及提供播放器
样本、SystemUI 证据、日志、录屏和实机验证的所有用户。第三方来源与许可证保留在
Bridge LICENSE、Provider NOTICE、源码头和迁移报告中。

如果项目对你有帮助，可在
Bridge README 查看支持方式。
支持完全自愿，不影响 Issue 优先级或 Release 资产获取。

---

English

4.0 is a full architecture release. Player-specific hooks now live in 12 independent Providers
that publish native MediaMetadata["lyricInfo"] from player-owned MediaSessions. Bridge runs only
in system and com.android.systemui and focuses on generic word rendering, AOD, appearance,
translation controls, and SystemUI compatibility.

This is a coordinated breaking upgrade from 3.8.x. Install Bridge and the Providers you use from
the same 4.0.0 Release, and remove the old Provider scope from a player before enabling its 4.0
replacement.

Bridge architecture

• Removed the direct-v4 receiver, source/sender registry, external protocol module, and
  player-process adapters.
• Bridge no longer knows Provider application IDs or accepts a private lyric payload.
• Scope is reduced to system and com.android.systemui.
• Native lyricInfo is parsed once per publication and shared by identity, cleanup, translation
  alignment, official-list handling, and renderer preparation.
• Large SystemUI responsibilities were split into bootstrap, diagnostics, media/lyrics policy,
  model assembly, frame resolution, draw coordination, and named compatibility owners.
• Debug remains off by default and uses structured [CLL] events, throttling, redaction, and
  logcat/Xposed sinks without changing lyric behavior.

Lyrics, appearance, translation, and configuration

• Added a dedicated Lyric brightness & fading page.
• Active text, unrevealed active text, active translation, translation progress, inactive text,
  and inactive translation have separate controls.
• Inactive translation can follow the main inactive opacity or keep its own value.
• Native RecyclerView top/bottom edge fading has configurable enable and length controls.
• Optional inactive-row fade is independent from blur and scale.
• Default, Soft, Vivid, and Minimal presets own the new fields; any deviation becomes Custom.
• Preview spacing, vertical centering, integer fade-length steps, the full-width bottom dock, and
  slider length were refined from device feedback.
• Center and right alignment now scale around the correct pivot.
• Media-card translation state updates immediately without waiting for pause/play.
• Translation icons use a canonical white tint and enabled/disabled alpha instead of inheriting a
  black host tint.
• Complete Bridge backup/restore covers UI/schema, global and per-player translation settings,
  opening-cleanup rules, per-track corrections, debug settings, and locale, with rollback on error.
• Built-in opening-cleanup rules remain available but default to disabled.

Native player integration

Halcyon, Flamingo, QZ Music, and PrismMusic have package-only SystemUI lyric-entrance,
media-history, and AOD compatibility. This is not source admission: each player must publish
standard lyricInfo from its own MediaSession. Old broadcasts are not accepted, and no additional
Provider APK is required.

The single bilingual Provider matrix above is shared by both language sections. Provider-only
installation can drive stock ColorOS lyrics on supported systems; Bridge adds optional generic
enhancements.

Upgrade from 3.8.x

1. Back up the complete Bridge configuration from the main settings page.
2. Install the official 4.0.0 Bridge APK over the official 3.8.1 build.
3. Keep only system and com.android.systemui in Bridge scope.
4. Uninstall/disable the old Provider or remove its player scope.
5. Install the matching ColorOS-Live-Lyrics-Provider-<Name>-v4.0.0.apk and select only its host.
6. Restart the player and SystemUI; reboot after the first installation or scope migration.
7. Never let old and new Providers hook the same player simultaneously.

See the complete 3.8.x → 4.0 migration guide
for application IDs, scopes, and downgrade details. Downgrading is not configuration-lossless
because 3.8.x does not understand every schema-v3 field.

Validation and release assets

• Bridge standard Gradle suite: 481 tests, 0 failures/errors, 6 explicit skips; debug/release lint,
  builds, package, scope, certificate, zipalign, DEX, and manifest gates passed.
• Provider testV5Matrix: 462 tests, 0 failures/errors/skips; all 12 release/R8 builds passed.
• The signed RC5 batch from run 33301880289 passed user device validation.
• Formal run 33305725280
  resolved immutable sources, built signed Bridge/Providers, packaged 16 assets, and published both
  Bridge and LSP Releases.
• Both public Releases contain the same 16 files with identical sizes and SHA-256 values; all 13
  APKs and the 12-APK Provider ZIP were downloaded and independently reverified.
• Bridge commit: 6ebced30a6af3fa5015af0c8ab212ea339fd9d91.
• Provider commit: 950c3b170271e3a0f9bccdf3fa18735451740c80.
• Bridge APK SHA-256: 3be16859c347740ca47c5bd99f0180d45fcb45615a2e90a5398417f2e98751f6.
• Provider ZIP SHA-256: 3465696f5355a55379dad7ab70d637cd42659449f480f67d54ac697882b8e07d.

The Release contains exactly 16 assets: one Bridge APK, 12 Provider APKs, one Provider ZIP,
release-assets-v4.0.0.json, and SHA256SUMS. The Provider ZIP is an APK download bundle, not a
Recovery-flashable package.

Known limits

• ColorOS lock-screen lyrics are a private SystemUI feature; system updates can require renewed
  compatibility work.
• Player-private lyric interfaces can change after player updates.
• Spotify and Metrolist do not provide translations in the current matrix.
• QQ Music HD is not supported.
• Bridge cannot invent word timing or translations that the lyric source does not provide.

This project is no longer compatible with the lyricon.
For LyricProvider support, please download the corresponding provider from the original lyricon Provider project: [https://github.com/tomakino/LyricProvider].
For any issues related to LyricProvider display, please report them to the original LyricProvider project repository.

Developer documentation, acknowledgements, and support

• Player-owned lyricInfo protocol
• Provider adaptation guide

Thanks to the original tomakino/LyricProvider project and contributors, Accompanist Lyrics Core,
and everyone who supplied player samples, SystemUI evidence, logs, recordings, and device
validation. Third-party provenance and licenses remain in the Bridge LICENSE, Provider NOTICE,
source headers, and migration reports.

Support is optional and never changes issue priority or access to release assets. See the
Bridge README for
support options.

Donate

ColorOS Live Lyrics Bridge v3.8.1

v3.8.1 修复酷我通知栏媒体卡片在播放数秒后封面被降级为纯色的问题，并为酷我 Provider 的歌词拉取增加有界重试。锁屏歌词链路无功能性变更。

Bridge

• Bridge 版本更新为 versionCode=135 / 3.8.1。

• 酷我开启或未开启"蓝牙车载歌词"时，酷我都会周期性重发当前曲目的 metadata，其 ART / ALBUM_ART bitmap lane 只有 1x1 占位图。SystemUI 的通知栏卡片消费点会把该占位图直接写入 MediaData.artwork 并放大为纯色，而锁屏 Seedling 路径已有独立修复，因此表现为锁屏封面正常、状态栏媒体卡片纯色。

• 现在在 SystemUI 媒体 metadata 封面查找的同一身份归一化分支内，当原生查找结果为空或小于 96px 时，按严格同曲身份（mediaId 与稳定 title/artist 双键）从最近有效快照恢复；快照缺失时回退酷我 https 封面端点；两者都不可用时才保留原生结果。

• 合理尺寸的原生封面仍直接走系统路径，不额外发送或覆盖 metadata，不干涉酷我到 SystemUI 的原生封面传递。

• 新增限流日志 Restored KuWo album artwork for same-identity metadata from the same-track snapshot，便于真机确认修复命中。

LyricProvider（KuWo 2.1.0）

• 酷我自身歌词拉取 e0.f 因网络波动等返回空或抛异常时，Provider 过去没有补偿，切歌后有小概率卡在大封面状态，必须手动暂停触发重拉。现在按 2s/5s/10s 退避在后台线程以原调用参数重试，最多 3 次。
• 切歌事件、歌词到达或拉取成功都会自动取消重试；网络失败先于曲目身份到达的竞态也会被切歌事件接管重试。
• 新增日志 KuWo lyric fetch retry scheduled / KuWo lyric fetch retry succeeded，便于真机确认重试命中。

Provider 版本

• kuwo-music 提升到 versionCode=12 / versionName=2.1.0；其余 Provider 无功能性变更。

验证

• Bridge testDebugUnitTest、assembleDebug 通过。
• KuWo Provider testDebugUnitTest（含 KuWoLyricFetchRetryPolicyTest）、assembleDebug 通过。
• 酷我真机完成回归：首播、切歌、暂停、seek、车载歌词开关均正常，锁屏与通知栏媒体卡片封面不再出现播放数秒后降级纯色的问题。

升级说明

• 更新 Bridge APK；酷我用户同时更新 LyricProvider-KuWo-v3.8.1.apk（Provider 2.1.0），其余 Provider 无功能性变更。
• 更新后重启 SystemUI 进程使 Hook 生效。
• 酷我 Provider 更新后需重启酷我进程使注入生效。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.8.1.apk
• LyricProvider-QQMusic-v3.8.1.apk
• LyricProvider-163Music-v3.8.1.apk
• LyricProvider-AppleMusic-v3.8.1.apk
• LyricProvider-Poweramp-v3.8.1.apk
• LyricProvider-Spotify-v3.8.1.apk
• LyricProvider-QiShui-v3.8.1.apk
• LyricProvider-KuGou-v3.8.1.apk
• LyricProvider-KuWo-v3.8.1.apk
• LyricProvider-LXMusic-v3.8.1.apk
• LyricProvider-Metrolist-v3.8.1.apk
• LyricProvider-All-v3.8.1.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.8.0

v3.8.0 聚焦播放器兼容性、酷我完整歌词接入和酷狗歌词稳定性。

Bridge

• 酷我锁屏歌词按钮完成稳定适配：保持歌词入口、翻译按钮和媒体卡片行为，覆盖首播、切歌、暂停、seek 与车载歌词元数据变化。
• 酷我封面链路保持原生传递；歌词触发的 MediaData 重建遇到无效 bitmap 时，仅按严格同曲身份恢复封面。
• Bridge 与 SystemUIPlugin 增加结构化 DexKit 发现，降低 ColorOS/SystemUIPlugin 混淆类名或方法名变化造成的失配；旧版本名称仍保留回退。
• 注册 Halcyon（com.ella.music）与 Flamingo（yos.music.player）的原生 v4 Provider source-to-player 绑定。
• Bridge 版本更新为 versionCode=134 / 3.8.0。

LyricProvider

• 酷我 Provider 升级为 versionCode=11 / 2.0.0：直接把完整逐行、逐字和翻译歌词送入 Lyricon 词幕，不再依赖车载歌词模式。
• 酷我 Provider 增加酷我歌词获取方法、官方 LRCX 解析器和字段结构的 DexKit 兼容；官方 LRCX 行时间异常时只在词幕副本中修正，不改变锁屏 lyricInfo 数据。
• 酷狗 Provider 修复预取歌词串曲、车载歌词元数据身份变化和原生封面恢复问题，避免异步歌词绑定到上一首歌曲。
• 其他 Provider 没有功能性变更，仍随统一 Release 构建并按需安装。

验证

• Bridge testDebugUnitTest、assembleDebug 通过。
• 酷我 Provider testDebugUnitTest、assembleDebug 通过。
• 酷我真机完成首播、切歌、暂停、seek、翻译按钮、封面和词幕回归；DexKit 日志确认酷我歌词入口与 SystemUIPlugin 模型均命中结构发现。

升级说明

• 从同一 3.8.0 Release 更新 Bridge 和正在使用的 Provider，避免新旧协议或版本配合异常。
• 酷我用户需要更新 2.0.0 Provider；更新后重启 SystemUI、酷我及其他正在使用的 Provider 进程。
• 未使用酷我或酷狗的用户无需因本版本功能变化额外安装对应 Provider。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.8.0.apk
• LyricProvider-QQMusic-v3.8.0.apk
• LyricProvider-163Music-v3.8.0.apk
• LyricProvider-AppleMusic-v3.8.0.apk
• LyricProvider-Poweramp-v3.8.0.apk
• LyricProvider-Spotify-v3.8.0.apk
• LyricProvider-QiShui-v3.8.0.apk
• LyricProvider-KuGou-v3.8.0.apk
• LyricProvider-KuWo-v3.8.0.apk
• LyricProvider-LXMusic-v3.8.0.apk
• LyricProvider-Metrolist-v3.8.0.apk
• LyricProvider-All-v3.8.0.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.7.3

适配 Salt Player 12.2.1：官方在该版本把歌词发布协程方法名混淆（invokeSuspend 被重命名），
模块改为按结构签名回退解析，歌词获取恢复正常；旧版本 Salt Player 不受影响。

兼容与验证

• 旧版本 Salt Player（12.0.x / 12.2.0-alpha02 / 12.2.0）仍走原解析路径，行为不变。
• scripts\dev.cmd bridge testDebugUnitTest assembleDebug 通过（含新增 4 项方法解析单测）。
• 真机验证（Salt 12.2.1，debug 构建）：Hook 安装成功，SALT_FINAL_EMBEDDED 歌词正常接收并注入。

升级说明

• 更新 Bridge 为 ColorOS-Live-Lyrics-Bridge-v3.7.3.apk；本次无 Provider 变更，无需更新 Provider。
• 更新后重启 Salt Player 进程；如 LSPosed 仍加载旧模块，请重启设备。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.7.3.apk
• LyricProvider-QQMusic-v3.7.3.apk / LyricProvider-163Music-v3.7.3.apk /
  LyricProvider-AppleMusic-v3.7.3.apk / LyricProvider-Poweramp-v3.7.3.apk /
  LyricProvider-Spotify-v3.7.3.apk / LyricProvider-QiShui-v3.7.3.apk /
  LyricProvider-KuGou-v3.7.3.apk / LyricProvider-LXMusic-v3.7.3.apk /
  LyricProvider-Metrolist-v3.7.3.apk
• LyricProvider-v3.7.3.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.7.2

v3.7.2 重构“播放器翻译设置”：翻译开关按钮统一占用锁屏媒体卡收藏槽位（媒体卡固定 5 个按钮，
只能替换、不能新增），并为 QQ 音乐、原版酷狗修复此前失效的翻译按钮；新增分播放器
“锁屏媒体卡翻译按钮”开关；设置页建立播放器卡片接入约定（按是否有翻译源显示开关），
Spotify/Metrolist 明确显示“不支持翻译”。外部歌词 v4 协议、Provider 准入规则与既有
AOD/渲染行为保持兼容，本次无 Provider 变更。

播放器翻译设置重构

• 代码分层：新增 PlayerTranslationTogglePolicy（纯决策）与
  TranslationToggleMediaActionBinder（媒体卡模型操作：定位收藏、原地替换、提升、呈现、
  点击绑定），LockscreenLyricsModule 不再承载媒体动作操作，只保留 Hook 入口与运行时状态。
• 收藏定位三级兜底：PlaybackState.CustomAction 映射 → OPlus heart 标记
  （getHeartAction / hasHeartFromRating）→ Rule0 列表唯一动作。QQ 音乐、原版酷狗的收藏
  不携带 CustomAction（设备日志确认），此前翻译按钮完全失效，现经兜底恢复可用。
• 分播放器“锁屏媒体卡翻译按钮”开关（默认开）：开 = 收藏槽位换成翻译开关；关 = 恢复播放器
  自带收藏。开关覆盖三条按钮路径：替换收藏（QQ/酷狗/网易云/Apple/汽水/酷狗 Lite）、公开注入
  按钮（LX/Poweramp/Cone 等，关闭时从媒体卡移除）、Salt 自带桌面歌词按钮（关闭时恢复播放器
  自身行为）。
• 图标加载修复：模块 ic_translation 改为从资源所属包 Context 直接加载；此前
  Icon.loadDrawable 在 SystemUI 侧对跨包资源静默返回 null，导致按钮图标未被替换。
• 无翻译歌曲恢复播放器自带收藏：修复媒体卡按钮视图回收复用导致“只剩 4 个按钮”的问题，
  媒体卡始终 5 个按钮。

设置页卡片接入约定

• 播放器卡片新增 supportsTranslation 声明：有翻译源的播放器显示“默认显示翻译 / 锁屏媒体卡
  翻译按钮 / 清除记忆”；无翻译源的播放器（Spotify、Metrolist）保留卡片用于检测
  LyricProvider 安装状态，显示“不支持翻译”且不显示任何开关。
• 新增 Metrolist 卡片，并修复其 Provider 检测（manifest <queries> 补充
  io.github.proify.lyricon.metrolistprovider，此前 Android 11+ 包可见性导致卡片误灰置）。
• 新播放器接入约定见 docs/TRANSLATION_TOGGLE_INTEGRATION.md。

OPlus 媒体黑名单放行

• 新增 OplusMediaControlService.isInMediaBlackList(String) 拦截：模块管理播放器（内置
  适配器与 Provider 桥接播放器）在黑名单查询命中时放行（返回未命中），避免被 OPlus 媒体控制
  过滤；其他包需在清单中显式声明接入（opt-in），并经 LockscreenIntegrationPolicy 策略
  门控后放行。未命中黑名单或未声明接入的包保持系统原判定，不影响既有白名单/历史逻辑。

已知特殊案例

• Apple Music：收藏采用评分式槽位，其渲染图标来自媒体卡模型之外的来源，静态替换不可达；
  翻译按钮图标保留播放器自带（与翻译功能匹配），按钮功能与其余行为正常。

LyricProvider

• 本次无 Provider 功能变更；全部 Provider APK 仍随 Release 附带，供按需更新。

兼容与验证

• 外部歌词协议仍为 v4；现有 Provider 的 source / playerPackage / senderPackage /
  senderKind 静态白名单校验不变。
• 未修改官方 Renderer 的 AOD 切换时序、LyricsRecyclerView prime 或普通 TextView
  Hook 范围。
• scripts\dev.cmd bridge testDebugUnitTest assembleDebug 通过（423 项测试 0 失败）。
• 真机验证（OPPO 设备，debug 构建）：
  • QQ 音乐、原版酷狗：收藏槽位变为翻译按钮、点击切换翻译行、开关关恢复收藏 —— 通过；
  • Salt/Cone/LX/Poweramp/汽水：媒体卡翻译按钮开关开/关全部生效，Salt 图标修复为模块
    翻译图标 —— 通过；
  • 无翻译歌曲恢复播放器自带收藏、媒体卡保持 5 个按钮 —— 通过；
  • Metrolist 卡片亮起并显示“不支持翻译”、无开关 —— 通过；
  • Apple Music 图标为播放器自带（特殊案例，见上）。

升级说明

• 更新 Bridge 为 ColorOS-Live-Lyrics-Bridge-v3.7.2.apk；本次无 Provider 变更，无需更新
  Provider。
• 更新后重启对应播放器进程；如 LSPosed 仍加载旧模块，请重启设备。
• “播放器翻译设置”新增的“锁屏媒体卡翻译按钮”默认开启；不希望收藏槽位被替换的用户可
  逐播放器关闭。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.7.2.apk
• LyricProvider-QQMusic-v3.7.2.apk
• LyricProvider-163Music-v3.7.2.apk
• LyricProvider-AppleMusic-v3.7.2.apk
• LyricProvider-Poweramp-v3.7.2.apk
• LyricProvider-Spotify-v3.7.2.apk
• LyricProvider-QiShui-v3.7.2.apk
• LyricProvider-KuGou-v3.7.2.apk
• LyricProvider-LXMusic-v3.7.2.apk
• LyricProvider-Metrolist-v3.7.2.apk
• LyricProvider-v3.7.2.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

ColorOS Live Lyrics Bridge v3.7.1

v3.7.1 修复两项关键问题：ColorOS 16.0.10.x（OPPO X9s Pro 等新版本系统）的 SystemUI
private-hook 解析失效，以及 v3.7.0 引入的普通逐行歌词"实时行高亮消失"。Bridge 的外部歌词
v4 协议、Provider 准入规则与既有 AOD/渲染行为保持兼容。

SystemUI 兼容修复（ColorOS 16.0.10.x）

• 新版本系统界面（版本号仍为 16.99.12/169912，但媒体 RUS 管理器已重构）中，
  OplusMediaRusUpdateManager.getRusWhiteList() 被删除、saveListToSP 变为静态 10 参数、
  updatePkgActionsRule 由 5 个 Map 增至 6 个 Map，白名单改经 Kotlin data class
  MediaRusConfig.getWhiteList() 暴露，并新增与 getLyricEntrance 同形的
  getLyricEnable(String)。
• Bridge 的 DexKit 目标解析升级为"双锚点集 + 新旧形态兼容"：
  • RUS 管理器类使用 anyOf 双锚点集，16.0.9.x 与 16.0.10.x 各自唯一命中；
  • saveListToSp / updatePkgActionsRule 谓词同时接受新旧两种签名；
  • 白名单 getter 按构建变体选择（getRusWhiteList 或 MediaRusConfig.getWhiteList），
    后者按精确方法名解析以避免 Kotlin data class 的 componentN 歧义；
  • getLyricEntrance 按方法名排除同形的新增 getLyricEnable；
  • legacy 反射回退路径同步容错，解析日志新增 rusVariant（OLD/NEW）便于排查。
• 16.0.9.x 及更早构建的目标解析行为保持字节级一致，无回归。

实时行高亮修复

• 修复 v3.7.0 回归：普通逐行歌词（无逐字时间戳）的实时行不再以 100% 不透明度高亮，
  与相邻行不透明度一致。根因是 v3.7.0 将激活行绘制改为仅在 AOD 低帧率填充时使用
  activePaint，而无词行无法进入逐字 reveal 路径。
• 恢复激活行整行高亮：drawCompactLine 与 drawSegment 在无逐字进度时以 activePaint
  绘制实时行；lineTimedProgressEnabled（普通逐行歌词进度）开启时无词行同样回退整行
  高亮，不再出现"开关开着反而没有高亮"。
• 带逐字时间戳的歌词仍走逐字 reveal，主色仅用于逐字覆盖与扫光；AOD 低帧率整行填充
  行为不变。

LyricProvider

• 本次无 Provider 功能变更；全部 Provider APK 仍随 Release 附带，供按需更新。

兼容与验证

• 外部歌词协议仍为 v4；现有 Provider 的 source / playerPackage / senderPackage /
  senderKind 静态白名单校验不变。
• 未修改官方 Renderer 的 AOD 切换时序、LyricsRecyclerView prime 或普通 TextView
  Hook 范围。
• scripts\dev.cmd bridge testDebugUnitTest assembleDebug 通过（42 套件 / 412 项测试
  0 失败）。
• SystemUI 兼容修复：16.0.9.x（PJZ110）真机验证 rusVariant=OLD 全链路正常；16.0.10.500
  （OPPO X9s Pro）真机验证歌词接收、词幕模型缓存、官方渲染与 AOD 正常，并完成
  MediaRusConfig 新白名单 getter 与六 Map 规则更新路径验证。
• 实时行高亮修复：开发者设备与反馈用户真机实测通过（普通逐行歌词实时行恢复 100%
  不透明度；带逐字歌词与 AOD 无回归）。

升级说明

• 更新 Bridge 为 ColorOS-Live-Lyrics-Bridge-v3.7.1.apk；如使用对应播放器 Provider，
  建议从同一 Release 同步更新 Provider APK（本次无功能变更，可按需）。
• 更新后重启对应播放器进程；如 LSPosed 仍加载旧模块，请重启设备。
• ColorOS 16.0.10.x 用户本次为必须升级：旧版本在该系统上 SystemUI hook 无法安装，
  锁屏歌词整体失效。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.7.1.apk
• LyricProvider-QQMusic-v3.7.1.apk
• LyricProvider-163Music-v3.7.1.apk
• LyricProvider-AppleMusic-v3.7.1.apk
• LyricProvider-Poweramp-v3.7.1.apk
• LyricProvider-Spotify-v3.7.1.apk
• LyricProvider-QiShui-v3.7.1.apk
• LyricProvider-KuGou-v3.7.1.apk
• LyricProvider-LXMusic-v3.7.1.apk
• LyricProvider-Metrolist-v3.7.1.apk
• LyricProvider-v3.7.1.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.7.0

v3.7.0 完成设置页面的整体 UI 重构，并修复 LX Music 与汽水音乐 Provider 的歌词覆盖层稳定性问题。Bridge 的外部歌词 v4 协议、Provider 准入规则与既有 AOD/渲染行为保持兼容。

设置 UI 重构

• 主设置页按「状态 → 预览 → 风格预设 → 颜色与光晕 → 排版 → 动效与刷新 → 兼容与屏幕」重新组织，并加入分区头、图标与分组卡片；所有控件改为 Material 风格实现，不再使用原生 Spinner / 原生弹出菜单。
• 新增静态迷你锁屏预览：预览使用真实配置的字号、颜色、光晕、模糊、缩放与对齐效果，在页面滚动时吸顶浮动；预览卡可通过底部手势条上滑收纳为标题栏「预览」按钮，点击后原路展开，滚回原位自动恢复。
• 新增激活状态实时查询：标题下方显示模块是否运行，并提供「重启系统界面」按钮与统一的「应用并保存」底部操作栏；未保存修改时显示 UNSAVED 徽标，返回前弹出居中确认面板。
• 颜色与光晕设置改为 mockup 风格：主色/光晕色板、滑块与开关保持即时联动，自定义颜色使用锚定色块的圆角面板（HEX 输入、颜色预览、取消/应用），点击预览色块可展开 HSV 取色，并针对输入法避让做了键盘上方定位。
• 二级页面（播放器翻译设置、歌词开头信息清理）同步完成新版式改造，包含与主页一致的操作栏、分区结构与沉浸式手势导航栏。
• 修正主歌词颜色的语义：普通行与非实时行歌词始终为低透明度白色，主歌词颜色只作用于实时行的逐字覆盖与扫光过渡，避免整行染色与过渡区白色断层。
• 纯白主色选项增加常驻深色细描边，未选中时不再与卡片背景融为一体。
• UI国际化语言支持：中文、English。

LyricProvider

• LX Music：移除 MediaSession 播放状态/元数据回调中对 Lyricon 的重复 setPlaybackState 与 setSong 调用，歌词覆盖层由 LyricModule 锚点同步循环独占驱动，修复歌词闪烁与进度错位。
• 汽水音乐：Lyricon 歌曲去重改为按 id + lyrics 比较，仅元数据变化（歌名、歌手、时长）不再重置覆盖层，修复同曲元数据更新时的闪烁与过渡动画丢失。
• LX Music 内部版本提升到 1.0.3（versionCode 5），汽水音乐提升到 1.2.7（versionCode 10）；其余 Provider 本次没有内部版本变更。

兼容与验证

• 外部歌词协议仍为 v4；现有 Provider 的 source、playerPackage、senderPackage 与 senderKind 白名单校验不变。
• 本次不修改 SystemUI Renderer、AOD 切换时序、LyricsRecyclerView prime 或普通 TextView Hook 范围。
• 设置 UI 重构以真机手动验证为准，scripts\dev.cmd bridge testDebugUnitTest assembleDebug 通过；LX Music / 汽水音乐修复已通过 Provider 侧源码验证，正式实机验证随 Release 进行。

升级说明

• 更新 Bridge 与需要修复的 Provider APK；LX Music 用户更新 LX Music Provider，汽水音乐用户更新 QiShui Provider。
• 更新后重启对应播放器进程；如 LSPosed 仍加载旧模块，请重启设备。
• 其他播放器用户无需因功能变化单独更新 Provider，完整 Release 仍附带全部 Provider APK 与 LyricProvider-v3.7.0.zip。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.7.0.apk
• LyricProvider-QQMusic-v3.7.0.apk
• LyricProvider-163Music-v3.7.0.apk
• LyricProvider-AppleMusic-v3.7.0.apk
• LyricProvider-Poweramp-v3.7.0.apk
• LyricProvider-Spotify-v3.7.0.apk
• LyricProvider-QiShui-v3.7.0.apk
• LyricProvider-KuGou-v3.7.0.apk
• LyricProvider-LXMusic-v3.7.0.apk
• LyricProvider-v3.7.0.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.6.0

v3.6.0 新增 Metrolist 的完整 LyricProvider 适配，并修复外部歌词已经成功送达、锁屏原生歌词列表却要等到暂停或继续播放才刷新的问题。本次继续使用 v4 直达协议，不改变既有 Provider 的准入和兼容方式。

Bridge

• 在静态外部歌词注册表中加入 lyricprovider/metrolist-music 与宿主包名 com.metrolist.music 的固定绑定，支持 Provider 上报播放状态、曲目 generation 和当前曲目权威信息。
• Metrolist Provider 的 v4 广播仍按完整 source、playerPackage、senderPackage 与 senderKind 规则校验；未知来源、宿主不匹配和旧协议不会被动态放行。
• 修复部分首次播放或切歌场景：Bridge 已经接收并提升有效歌词模型，但 ColorOS SystemUI 的官方 LyricsRecyclerView 仍为空，只有暂停或继续播放触发元数据重载后才出现歌词。
• 外部歌词提升成功后，Bridge 现在会在验证播放器包名、当前曲目和上下文时效后，有限次重放最近一次 SystemUI 原生歌词加载事务，让官方列表及时填充。
• 重放逻辑是通用外部歌词恢复流程，不依赖 Metrolist 包名分支，也不会强制 setAodModeStyle、延迟首次 RecyclerView prime，或扩大普通 TextView Hook 范围。
• 新增 Metrolist v4 fixture、source/host 准入测试和 canonical enhanced-LRC 逐字解析测试。

Metrolist LyricProvider

• 新增独立的 LyricProvider-Metrolist，作用域为 com.metrolist.music。Provider 从 Metrolist 当前媒体模型取得歌曲 ID、标题、歌手、专辑和秒级时长，并转换成 Bridge 所需的毫秒级媒体身份。
• Metrolist是适用于安卓系统的第三方 YouTube Music 客户端，它将作为替代适用于对 YouTube Music 的适配而发布。
• Provider 读取 Metrolist 的 files/datastore/settings.preferences_pb，解析 LyricsProviderOrderKey 与供应商启用状态，保持用户配置的相对顺序，不再使用猜测路径或扫描 protobuf 可打印字符串。
• 当前实现依次支持 BetterLyrics、LrcLib 与 KuGou。BetterLyrics 使用标题、歌手、时长和专辑参数；LrcLib 接收 album_name；KuGou 搜索词也包含专辑信息，减少错误候选。
• BetterLyrics TTML 会保留毫秒级行时间、逐字 span、结尾时间、audio lyricOffset 和真实单词边界。无空白的相邻拉丁 span 会先合并为同一单词，修复 call ing、a lone、mega phone 等错误空格；CJK span 仍保持独立逐字时间。
• KuGou 优先下载并解析 KRC 逐字歌词，生成标准 [行时间]<词时间>文本...<结束时间> enhanced LRC；仅在 KRC 不可用时回退逐行 LRC。
• 首次播放和切歌搜索绑定当前 track generation。切歌会取消旧任务及正在进行的 OkHttp 请求，每个供应商具有独立 8 秒超时，过期结果不会覆盖新曲。
• 修复 Hooker 在 zygote 初始化阶段提前创建主线程 Handler 导致的初始化失败，以及发送前歌词清洗正则异常。主线程对象现在延迟到真实应用回调中创建。
• Provider 继续保留 Lyricon 的正常 player.setSong / playback state 路径，并在同一当前曲目校验后发送 Bridge v4 payload。

诊断与文档

• 新增统一的 Bridge / Provider 日志抓取说明与脚本，明确 adb logcat -s 只过滤输出，不能开启 Log.isLoggable 控制的调试日志。
• Provider 日志现在区分曲目识别、供应商顺序、命中来源、timing=word|line、行内时间标签数量、v4 发送和 Bridge 接收阶段，便于定位“搜索成功但未发送”或“已接收但未填充官方列表”。
• Provider 适配文档补充 DataStore、异步 generation、逐字格式、TTML 单词边界、KRC 回退和可取消网络请求等门禁。

兼容与验证

• Bridge 全量 testDebugUnitTest 与 assembleDebug 通过。
• Metrolist Provider testDebugUnitTest 与 assembleDebug 通过；测试覆盖 DataStore protobuf、供应商顺序与超时、BetterLyrics TTML、KuGou KRC、enhanced-LRC 清洗和 v4 payload。
• Android 16 实机验证通过首次播放、连续切歌、暂停恢复、供应商优先级、BetterLyrics 专辑匹配、KuGou KRC 逐字时间和拉丁音节合并。
• 实机日志确认 Bridge 能接收并提升 Metrolist 文档、重放 SystemUI 元数据歌词加载、生成非零 RecyclerView itemCount 并完成首次 prime，无需再手动暂停或继续播放。
• Salt Player、ConePlayer 和已有 8 个 LyricProvider 的适配方式保持不变；外部歌词协议版本仍为 v4。本次不调整已知良好的 AOD 切换时序和官方歌词几何策略。

升级说明

• Metrolist 用户需要同时安装同一 Release 中的 ColorOS-Live-Lyrics-Bridge-v3.6.0.apk 与 LyricProvider-Metrolist-v3.6.0.apk。
• 在 LSPosed 中启用 Metrolist Provider，并只勾选 Metrolist 作为作用域；随后强行停止并重新打开 Metrolist。首次安装或作用域变化后建议重启设备。
• 已使用其他播放器的用户可以直接更新 Bridge；原有 Provider 的作用域和使用方式无需改变。Bridge 与 Provider 应来自同一 Release。
• Metrolist Provider 当前发送原文逐字或逐行歌词，不生成歌词源未提供的翻译。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.6.0.apk
• LyricProvider-Metrolist-v3.6.0.apk
• LyricProvider-QQMusic-v3.6.0.apk
• LyricProvider-163Music-v3.6.0.apk
• LyricProvider-AppleMusic-v3.6.0.apk
• LyricProvider-Poweramp-v3.6.0.apk
• LyricProvider-Spotify-v3.6.0.apk
• LyricProvider-QiShui-v3.6.0.apk
• LyricProvider-KuGou-v3.6.0.apk
• LyricProvider-LXMusic-v3.6.0.apk
• LyricProvider-v3.6.0.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.5.2

v3.5.2 是一次 Salt Player 内置适配更新，适配最新的 12.2.0-alpha02 版本，并继续兼容原先已支持的旧版本。

Bridge

• Salt Player 12.2.0-alpha02 将混淆后的歌词来源枚举、滚动枚举、歌词结果和最终发布协程从 androidx.obf 整体迁移到了 androidx.media3，导致旧版 Bridge 的 DexKit 查询无法发现歌词发布链路。
• Bridge 现在通过独立的 SaltPlayerDexKitSearchPolicy 同时搜索 androidx.obf 与 androidx.media3，恢复 12.2.0-alpha02 的歌词捕获，同时保留旧版本兼容。
• Salt Player 的 Song#getId/getTitle/getArtist、MusicService 和媒体按键接收器路径保持不变；最终歌词仍在播放器完成当前歌曲 ID 校验后提交，避免把异步返回的旧歌词绑定到新歌曲。
• versionCode 从 127 提升到 128，默认 versionName 从 3.5.1 提升到 3.5.2。
• 本次不修改外部歌词 v4 协议、Provider 准入、SystemUI Renderer、AOD、LyricsRecyclerView prime 或普通 TextView Hook 范围。

LyricProvider

• 8 个 LyricProvider 本次没有功能源码或内部版本变更。
• 统一 Release 工作流仍构建并附带全部 Provider APK 与合集 ZIP，方便新安装或按需更新。

验证

• Salt Player 12.2.0-alpha02 适配测试通过。
• Bridge 全量 testDebugUnitTest 与 assembleDebug 通过，新增测试覆盖新旧 DexKit 包根及防御性副本行为。
• GitHub Actions 正式发布构建通过：Bridge、QQ 音乐、网易云音乐、Apple Music、Poweramp、Spotify、汽水音乐、酷狗音乐、LX Music 和双仓库 publish job 全部成功。

升级说明

• Salt Player 用户更新 Bridge 后重启 Salt Player 进程；如 LSPosed 仍加载旧模块，请重启设备。
• 本次 Salt Player 修复不需要安装额外 Provider。其他播放器用户无需因功能变化单独更新 Provider。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.5.2.apk
• LyricProvider-QQMusic-v3.5.2.apk
• LyricProvider-163Music-v3.5.2.apk
• LyricProvider-AppleMusic-v3.5.2.apk
• LyricProvider-Poweramp-v3.5.2.apk
• LyricProvider-Spotify-v3.5.2.apk
• LyricProvider-QiShui-v3.5.2.apk
• LyricProvider-KuGou-v3.5.2.apk
• LyricProvider-LXMusic-v3.5.2.apk
• LyricProvider-v3.5.2.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.5.1

v3.5.1 是一次网易云音乐 LyricProvider 定向修复。Bridge 本体没有业务逻辑变更；本次提升 Bridge 版本并触发统一 Release 工作流，用于发布修复后的 163 Music Provider。

Bridge

• Bridge 本体保持 v3.5.0 的协议、渲染、AOD 与 Provider 准入行为不变。
• versionCode 从 126 提升到 127，默认 versionName 从 3.5.0 提升到 3.5.1。

LyricProvider

• 网易云音乐 Provider 内部版本提升到 1.1.7。
• 修复网易云音乐 9.0.40 LSPatch 包中词幕无法显示双排翻译的问题：LSPatch 外层 wrapper ClassLoader 在 Hook 初始化阶段看不到原包的 com.netease.cloudmusic.utils.o2.a() 偏好访问器，导致 showLyricSetting 读取为 -1，词幕同时关闭翻译与罗马音。
• Provider 现在会在 Application.onCreate 后使用原包 application.classLoader 重新解析偏好访问器，再读取 showLyricSetting 并注册词幕 Provider。宿主自带冲突 libdexkit.so 时仍不会加载 Provider 自带 DexKit，保留对 LSPatch 包的进程安全保护。
• Bridge 侧歌词数据链路原本已正确携带翻译；本次不修改 Bridge、SystemUI Renderer、AOD 或 LyricsRecyclerView 行为。
• QQ 音乐、Apple Music、Poweramp、Spotify、汽水音乐、酷狗音乐与 LX Music Provider 本次没有源码或内部版本变更；统一 Release 工作流仍会构建这些 APK，以保持 Provider ZIP 合集完整。

验证

• CloudMusicPlaybackPolicyTest 通过。
• :163-music:assembleDebug --offline 与 :163-music:assembleRelease --offline 通过。
• 网易云音乐 9.0.40 LSPatch 真机日志确认偏好访问器由 unavailable 恢复为 com.netease.cloudmusic.utils.o2.a，Provider 以 translationType=0 注册。
• 真机确认词幕恢复双排翻译显示；Bridge 原有歌词检测与锁屏显示保持正常。

升级说明

• 本次实际功能修复只在 LyricProvider-163Music-v3.5.1.apk。网易云音乐用户更新该 Provider 后，重启网易云音乐进程；如仍加载旧 Hook，重启设备。
• 其他播放器用户无需因功能变化单独升级 Provider；完整 Release 仍会附带全部 Provider APK 与 LyricProvider-v3.5.1.zip。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.5.1.apk
• LyricProvider-QQMusic-v3.5.1.apk
• LyricProvider-163Music-v3.5.1.apk
• LyricProvider-AppleMusic-v3.5.1.apk
• LyricProvider-Poweramp-v3.5.1.apk
• LyricProvider-Spotify-v3.5.1.apk
• LyricProvider-QiShui-v3.5.1.apk
• LyricProvider-KuGou-v3.5.1.apk
• LyricProvider-LXMusic-v3.5.1.apk
• LyricProvider-v3.5.1.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.5.0

v3.5.0 把 v4 外部歌词协议补到可在长歌词场景稳定运行的形态：Bridge 与 Provider 各自新增并对齐了大小限制常量，Provider 侧加入逐行截短重试，LyricInfoContract 支持纯逐字歌词走完整流水线；这一版本同时收紧 BridgePayloadGate 的去重窗口并把 LockscreenLyricsModule 的渲染/时序逻辑拆到独立类，便于后续按层迭代。

Bridge

• LyricInfoContract.parse 现在接受 lyric 字段为空、rawLyric 含时间戳的 payload：纯逐字歌词会被视为合法 lyric 进入流水线，原始 rawLyric 仍按字渲染路径使用，避免 Provider 主动把逐字降级成逐行后丢字。
• external-lyric-protocol 新增大小限制常量 MAX_LYRIC_FIELD_CHARS = 1_500_000、MAX_TOTAL_LYRIC_CHARS = 3_000_000、MAX_METADATA_FIELD_CHARS = 16_384、MAX_PARCEL_BYTES = 512 KiB，与 Provider 端 ExternalLyricV4Protocol 同名常量镜像；Bridge 端按字符、Provider 端按 Parcel 字节校验，数字差异由两端的度量单位差异解释，并显式写在常量注释中。
• 新增独立的 LyricTimingTuningConstants 与 render/ 子包，把渲染与时序调整从 LockscreenLyricsModule 拆出；模块类体不再直接承载逐字进度、扫光、首句清理与时序微调逻辑，便于单独 review 与单元测试。
• 文本匹配、清理与核心 adapter 配合协议层变更同步更新：LyricTextMatchPolicy、LyricTextSanitizer、LyricsCoreAdapter 与 ExternalLyricIngress 调整接收侧数据形态与默认值。
• app/build.gradle.kts 开启 testOptions.unitTests.isReturnDefaultValues = true，方便本地单元测试在不依赖 Android 桩时通过运行。
• Bridge 端 README 中英文版同步更新 Provider 安装与常见问题说明。

LyricProvider

• share/extensions-android 中 SystemUiBroadcastSender 新增 submitWithLyricLineFallback：当标准 submit 流程因 payload 超大被 SystemUI 拒收（且行级降级后仍超限），会调用 LyricLineTruncator 对三个 lyric extras 做一次有界、按字节预算的中间行截短并重试；retry 时会以调用方传入的原始 lyric/rwLyric/translationLyric 为输入，避免在已降级字符串上重复裁剪。MAX_PARCEL_BYTES 改为引用 ExternalLyricV4Protocol.MAX_PARCEL_BYTES，统一阈值来源。
• share/extensions-kt 新增 LrcTimeFormatter、TrackKeyBuilder、LyricLineTruncator、WordTimeNormalizer、ProviderDiagnostics 等桥接辅助类，分别承担时间格式化、track key 计算、行截短预算、逐字时间归一化与 Provider 端诊断输出；现有 BridgeEventGates.BridgePayloadGate 由单 key 改为 ArrayDeque<Entry> 的多键 LRU，默认保留最近 8 条 30 秒窗口内的 key，支持按 key 主动 forget，避免跨曲目共用同一去重 slot。
• QQ 音乐、网易云音乐、Apple Music、Spotify、汽水音乐与酷狗音乐 Provider 的 SaltLyricBridge 同步切换到 submitWithLyricLineFallback：当 lyric 为空但 rawLyric 含时间标签时仍把 rawLyric 作为 lyric 兜底，并把 TrackKeyBuilder / WordTimeNormalizer / LrcTimeFormatter 等辅助接入主流程；QQ 音乐与 Spotify 同时把增强 LRC 与纯 LRC 分别装入 rawLyric / lyric，避免时间信息丢失。
• 酷狗音乐 Provider 移除 KuGouOriginalMediaMetadataPolicy，原职责并入 KuGouOriginalLyricCandidatePolicy：取消"临时车机歌词元数据"覆盖专辑封面路径，恢复真实专辑封面，并修复同曲不同标题版本互相切换时偶发的"暂无歌词"或歌曲信息串用。
• share/krckit、share/qrckit、share/yrckit 中的 KRC/QRC/YRC parser 与语言识别器微调：保持现有 API，仅修正对部分边界（极短行、空逐字、单次消费）解析的稳定性；QQ QRC 翻译对齐仍使用共享扩展层的有界一对一匹配，不退回逐行 findClosest。
• 新增与本次改动配套的单测：ProviderDiagnosticsTest、ExternalLyricV4ProtocolSizeLimitsTest、LrcTimeFormatterTest、LyricLineTruncatorTest、TrackKeyBuilderTest、WordTimeNormalizerTest、YrcParserTest 及更新后的 BridgeEventGatesTest。

本次有内部版本更新的 Provider：网易云音乐 1.1.6、QQ 音乐 1.1.6、Apple Music 1.1.4、Spotify 1.1.6、汽水音乐 1.2.6、酷狗音乐 1.1.9。Poweramp 与 LX Music 本次没有 Provider 侧改动，但 Release 工作流仍会构建它们的 APK 以保持 ZIP bundle 完整。

升级说明

• 请将 Bridge 与正在使用的 Provider 从本次 Release 一起更新；升级后重启设备，或至少重启 SystemUI 与对应播放器进程。
• 如果你使用的 Provider 在 v3.5.0 之前曾因歌词过大被 SystemUI 拒绝，现在会自动通过逐行截短重试一次；如仍失败，请导出 LSPosed 日志并按 [BRIDGE_GATE]、[SystemUiBroadcastSender]、[LyricLineTruncator]、[ProviderDiagnostics] 关键字定位日志。
• AOD 首次 attach、prime、槽高、官方行缩放与低刷新切换路径继续沿用 v3.3.0 起的已验证基线，本次未引入新的 AOD 可见性、透明度、尺寸或 readiness 门控。

验证

• Bridge：testDebugUnitTest、assembleDebug、lintDebug、LSPosed metadata 校验与 git diff --check 通过。
• LyricProvider：根项目 testDebugUnitTest 通过；新增的协议大小限制、桥接工具类与 Parser 单测全部覆盖；BridgePayloadGate LRU 行为已通过更新后的 BridgeEventGatesTest 覆盖。
• Provider 发布包通过 Bridge workflow 同一 tag（v3.5.0）一次性构建：Bridge 主 APK + 8 个 Provider APK + LyricProvider-v3.5.0.zip 一起上传到 GitHub Release 与 LSPosed 仓库。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.5.0.apk
• LyricProvider-QQMusic-v3.5.0.apk
• LyricProvider-163Music-v3.5.0.apk
• LyricProvider-AppleMusic-v3.5.0.apk
• LyricProvider-Poweramp-v3.5.0.apk
• LyricProvider-Spotify-v3.5.0.apk
• LyricProvider-QiShui-v3.5.0.apk
• LyricProvider-KuGou-v3.5.0.apk
• LyricProvider-LXMusic-v3.5.0.apk
• LyricProvider-v3.5.0.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。汽水音乐用户仍需在 LSP 管理器中为汽水音乐启用"还原内联钩子"，并按管理器提示处理 libart.so。

Donate

ColorOS Live Lyrics Bridge v3.4.1

v3.4.1 是一次兼容性与稳定性小修复，重点处理 Provider 安装检测、歌词开头清理、酷狗切歌，以及 LX Music 的切歌诊断。

Bridge

• 修复 Android 11 及以上版本中，播放器翻译设置把已安装的 LyricProvider 误判为“未安装”的问题；现在会正确识别 QQ 音乐、网易云音乐、Apple Music、LX Music、Poweramp、Spotify、汽水音乐与酷狗音乐 Provider。
• 补全英文制作人员信息的开头清理识别，并在清理后收紧歌词行，避免这些信息留下大段空白。
• 修正官方歌词列表含有插入行时的行位映射，避免后续歌词被错位匹配、抑制或显示为空白。

LyricProvider

• 修复网易云音乐、QQ 音乐、Spotify 与汽水音乐在 Bridge 的切歌门控下影响词幕原有歌曲提交的问题，恢复与词幕并用时的正常歌词检测与显示。
• 修复酷狗同曲不同标题版本互相切换时串用歌曲信息或显示“暂无歌词”的问题；同时保留真实专辑封面，不再被临时车机歌词元数据覆盖为纯色封面。
• LX Music 改进播放器进程重启后的轨道代次，避免 SystemUI 因旧代次拒收新歌词；新增低频、脱敏的 LSPosed 探针日志，便于排查极少数切歌后歌词入口消失的问题。

本次有内部版本更新的 Provider：网易云音乐 1.1.5、QQ 音乐 1.1.5、Spotify 1.1.5、汽水音乐 1.2.5、酷狗音乐 1.1.8、LX Music 1.0.2。Apple Music 与 Poweramp 本次无需单独升级。

升级说明

• 请将 Bridge 与正在使用的 Provider 从本次 Release 一起更新；升级后重启设备，或至少重启 SystemUI 与对应播放器进程。
• 如 LX Music 仍复现“切歌后歌词入口消失”，请导出 LSPosed 日志并筛选 [LX_PROBE]、LXMusicProbe 与 LockscreenLyrics，不要附带完整歌词正文。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.4.1.apk
• LyricProvider-QQMusic-v3.4.1.apk
• LyricProvider-163Music-v3.4.1.apk
• LyricProvider-AppleMusic-v3.4.1.apk
• LyricProvider-Poweramp-v3.4.1.apk
• LyricProvider-Spotify-v3.4.1.apk
• LyricProvider-QiShui-v3.4.1.apk
• LyricProvider-KuGou-v3.4.1.apk
• LyricProvider-LXMusic-v3.4.1.apk
• LyricProvider-v3.4.1.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。汽水音乐用户仍需在 LSP 管理器中为汽水音乐启用“还原内联钩子”，并按管理器提示处理 libart.so。

Donate

ColorOS Live Lyrics Bridge v3.4.0

v3.4.0 将 Bridge 与配套 LyricProvider 统一到新的歌词传递链路，重点是让完整歌词、逐字进度、翻译与切歌状态在 ColorOS 锁屏上更稳定地协同工作。

Bridge

• Bridge 主模块新增专属应用图标，替换此前的系统默认图标。
• 统一外部歌词 v4 传递协议，并按已登记的播放器与来源接收数据，减少切歌、后台恢复和播放器进程重载后的歌词丢失。
• 优化外部歌词的轨道切换、播放进度与翻译状态衔接；锁屏翻译按钮在播放器提供翻译时保持可用。
• 修复酷狗 Lite / 酷狗概念版部分逐字歌词行的渲染错位与空白问题。
• 优化逐字进度扫光和已播放文字的过渡，使高亮变化更连贯自然。
• 改进歌词开头清理：规则与逐曲“第一句正式歌词”不再被旧容量限制截断，跨歌词轨道时能更可靠地保留用户选择的首句。

LyricProvider

• 网易云音乐 Provider 兼容历史 9.0.40 的 :play 播放进程及荣耀版包名；对内置 LSPatch / DexKit 的特殊 APK 使用兼容初始化，避免冲突。
• 修复 QQ 音乐 QRC 原文与翻译时间戳存在偏差时的翻译行遗漏，改为按时序一对一对齐，并保留“无翻译”行的语义。
• 新增 LX Music Provider，支持 ToSide 与 Walnut 两个 LX Music 变体；可传递完整时间轴和可用的翻译歌词。
• QQ 音乐、网易云音乐、Apple Music、Poweramp、Spotify、汽水音乐、酷狗音乐/概念版与 LX Music 共 8 个 Provider 已统一适配 v4 链路。
• 保留 LyricProvider / 词幕原有功能；本次只调整面向 Bridge 的传递与诊断路径。

升级说明

• 请将 Bridge 与已安装的 Provider 一起更新，避免混用旧版 Provider。
• 首次安装或升级后请重启设备，使 SystemUI 与播放器进程重新加载模块。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.4.0.apk
• LyricProvider-QQMusic-v3.4.0.apk
• LyricProvider-163Music-v3.4.0.apk
• LyricProvider-AppleMusic-v3.4.0.apk
• LyricProvider-Poweramp-v3.4.0.apk
• LyricProvider-Spotify-v3.4.0.apk
• LyricProvider-QiShui-v3.4.0.apk
• LyricProvider-KuGou-v3.4.0.apk
• LyricProvider-LXMusic-v3.4.0.apk
• LyricProvider-v3.4.0.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。汽水音乐用户仍需在 LSP 管理器中为汽水音乐启用“还原内联钩子”，并按管理器提示处理 libart.so。

Donate

ColorOS Live Lyrics Bridge v3.3.1

v3.3.1 主要完善歌词排版和设置页操作，并修复一类短英文逐字歌词识别问题。AOD 首次挂载、prime、槽高和低刷新时序继续沿用 v3.3.0 的已验证基线。

Bridge

• 新增独立的“歌词内换行额外间距”，范围为 -1–8dp、步进 0.5dp。它只调整同一条歌词内部的换行，不影响歌词条目之间的间距；锁屏槽高、两行浏览窗口和设置预览共用同一套计算，总内部行距不会小于 0dp。
• 主歌词可调字号上限从 26sp 提高到 28sp；没有翻译的布局继续自动增加 2sp，实际最高 30sp。翻译和无翻译布局现在使用统一的字体度量换行策略，改善较大字号下的中文、日文等长句排版。
• 设置页新增“重启系统界面”按钮。请求通过模块已有的 signature 权限广播交给 SystemUI，并返回接收确认；如果模块尚未加载到 SystemUI，会提示用户先重启设备。
• 修复类似 “You move on” 的短英文逐字歌词在同时间戳双语组中被误判成翻译的问题，并补充解析回归测试。
• 重新编写原仓库及 LSPosed 仓库的中英文 README，以更清晰的方式说明模块功能、设备要求、播放器适配、Provider 安装和常见问题。
• 保持已验证的 AOD 首次 attach、prime、槽高、官方行缩放与低刷新切换路径不变。

LyricProvider

本次没有修改 Provider 侧适配逻辑。Release 工作流仍会从当前 Andrea-lyz/LyricProvider 的 master 构建并发布 7 个独立 Provider APK；建议 Bridge 与已安装的 Provider 一并更新，避免 Release 版本混用。

验证

• Bridge：testDebugUnitTest、assembleDebug、lintDebug、LSPosed metadata 校验和 git diff --check 通过。
• 新增并更新了短英文主歌词选择、配置序列化、字号上限、换行间距边界、预设识别和槽高计算单元测试。
• AOD 相关实现未改变；本版本不引入新的 AOD 可见性、透明度、尺寸或 readiness 门控。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.3.1.apk
• LyricProvider-QQMusic-v3.3.1.apk
• LyricProvider-163Music-v3.3.1.apk
• LyricProvider-AppleMusic-v3.3.1.apk
• LyricProvider-Poweramp-v3.3.1.apk
• LyricProvider-Spotify-v3.3.1.apk
• LyricProvider-QiShui-v3.3.1.apk
• LyricProvider-KuGou-v3.3.1.apk
• LyricProvider-v3.3.1.zip

Provider 为独立的 LSPosed 模块，不会打包进 Bridge APK。汽水音乐用户仍需在 LSP 管理器中为汽水音乐开启“还原内联钩子”，并按管理器提示处理 libart.so。

Donate

ColorOS Live Lyrics Bridge v3.3.0 - 强烈建议更新！

v3.3.0 重点改善 ColorOS/SystemUI 版本兼容性，并对全部 LyricProvider 的播放状态、曲目切换和歌词提交链路进行统一收束。
建议 Bridge 与已安装的 Provider 一并更新。

Bridge

• 不再依赖固定混淆字段名控制官方歌词行距和非活动行缩放；新增经指纹验证的兼容布局，并在未知 SystemUI 版本上使用 DexKit 语义解析。无法唯一确认字段时安全保留官方默认值，避免错误写入私有字段。
• 外部歌词在后台预处理阶段即应用当前“歌词开头信息清理”配置，并缓存清理后的逐字模型和提交载荷，避免 SystemUI 接收前后行数变化造成切歌时部分歌词延迟出现。
• 收紧 RecyclerView 所有权、绑定重试、官方绘制抑制和解析 trace 日志。常规运行保持静默；逐帧诊断使用主 Tag VERBOSE，完整解析日志使用 LockscreenLyricsParse=VERBOSE。
• 保持已验证的 AOD 首次 attach、prime、槽高与低刷新时序不变。

LyricProvider

• 为网易云、QQ 音乐、Spotify 和汽水音乐统一播放状态提交策略，降低启动首曲、切歌、暂停恢复以及元数据/歌词异步到达时的旧数据回写与闪烁风险。
• 抽取统一的 Bridge 广播发送、播放状态提交、载荷大小控制和逐字片段兼容策略，并补充单元测试。
• 修复 QQ 音乐部分逐字歌词中的短重复片段无法显示，以及切歌时歌词分批出现的问题；空歌词占位等待窗口调整为 1200ms，明确下载失败时仍立即回退。
• 改进汽水音乐官方歌词获取、数据库缓存、KTV 逐字解析和曲目身份判断，兼容更多实际播放时序。
• 将相同的提交与身份保护推广到网易云、Apple Music、酷狗、Poweramp 和 Spotify；降低常规成功、缓存命中和提交日志噪声，WARN/ERROR 继续保留。

Provider 内部版本：

• QQ Music：1.1.3 / versionCode 8
• NetEase Cloud Music：1.1.3 / versionCode 13
• Apple Music：1.1.2 / versionCode 10
• Spotify：1.1.3 / versionCode 9
• QiShui Music：1.2.3 / versionCode 6
• KuGou Music：1.1.6 / versionCode 11
• Poweramp：1.0.13 / versionCode 10

验证

• Bridge：testDebugUnitTest、assembleDebug、lintDebug、LSPosed metadata 校验和 git diff --check 通过。
• 7 个随附 Provider：单元测试、assembleDebug 与 lintDebug 通过。
• 已实机验证网易云、QQ 音乐、Spotify、汽水音乐、Apple Music、酷狗和 Poweramp 的播放、切歌与锁屏歌词链路。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.3.0.apk
• LyricProvider-QQMusic-v3.3.0.apk
• LyricProvider-163Music-v3.3.0.apk
• LyricProvider-AppleMusic-v3.3.0.apk
• LyricProvider-Poweramp-v3.3.0.apk
• LyricProvider-Spotify-v3.3.0.apk
• LyricProvider-QiShui-v3.3.0.apk
• LyricProvider-KuGou-v3.3.0.apk
• LyricProvider-v3.3.0.zip

Provider 为独立的 LSPosed 模块，不会打包进 Bridge APK。汽水音乐用户仍需在 LSP 管理器中为汽水音乐开启“还原内联钩子”，并按管理器提示处理 libart.so。

Donate

ColorOS Live Lyrics Bridge v3.2.1

v3.2.1 收束锁屏歌词的渲染职责与界面切换时序。亮屏阶段由 ColorOS SystemUI 独占当前行索引、seek 定位、平滑滚动、页面过渡和行缩放；模块只负责逐字、颜色、光晕、模糊、排版与受限槽位几何。该调整修复拖动进度后概率回落官方渲染、从解锁/指纹界面返回歌词页时非实时行延迟出现、居中或右对齐缩放错位，以及切歌模型替换时的歌词位移和生硬跳变，同时保持已验证的 AOD 首次 attach、prime 与低刷新路径不变。

亮屏渲染职责

• 亮屏时完整放行官方 LyricsRecyclerView.setCurrentLyric 链路，不再由模块主动 prime、强制定位、停止滚动或修正 seek；官方当前索引 n 优先作为活动行依据。
• AOD 或非交互屏幕继续保留既有一次性 prime 与定位兜底，不把亮屏改造扩展到已验证的 AOD 时序。
• 非活动行缩放只写入官方缩放参数，由 SystemUI 状态机执行实际缩放与动画；移除 Canvas 第二次缩放，避免活动态、逐字态和页面交叉淡入不同步。
• RecyclerView、页面 alpha、visibility、translation 和 ViewPropertyAnimator 始终归 SystemUI 所有，模块不再通过整体 View alpha 实现切歌过渡。

Seek 与界面切换

• 同一曲目回拉或跳转进度时保留已经就绪的外部逐字模型，不再把播放位置跳变误当成需要清空自绘渲染器的曲目重启。
• 瞬时找不到可见 RecyclerView 时增加受限过渡宽限；已存在歌词模型和界面切换信号时不会立即退出歌词模式。
• 每个 RecyclerView 独立维护活动目标、绑定 epoch 和自定义帧状态；重复歌词使用 adapter position 消歧，唯一歌词不会因 RecyclerView pre-layout 的瞬时位置错位被拒绝。
• RecyclerView attach、重新可见和模型提交会执行最多 6 帧/120ms 的纯像素 render pass。只有当前表面的可映射绑定行都已生成同一模型的自定义帧后才提前结束 handoff，避免某一帧回落官方字体或只显示实时行。
• 当缓存行都属于已隐藏表面时，会从当前已附着 RecyclerView 重新发现候选 TextView；恢复过程只更新绘制引用和 invalidate，不触碰索引、滚动或槽位坐标。

对齐、缩放与切歌过渡

• 左对齐、居中和右对齐均按实际内容区域计算官方缩放 pivot；首次布局前使用 measured size，尺寸变化后重新校正，修复居中视觉漂移和右对齐放大方向错误。
• 新歌词模型发布后，亮屏绘制会等待内容决定的槽位高度完成一次几何提交，避免先用上一首歌的行高绘制新歌词后再次位移。
• 几何提交完成后仅对模块自绘歌词像素执行一次轻量淡入，不修改 RecyclerView alpha；“关闭动效”和 AOD 路径不执行该淡入。
• 字号、字重、对齐和模型替换只清理必要的绘制、换行、光晕与绑定缓存，不接管官方滚动事务。

诊断与测试

• 增加亮屏/AOD 渲染所有权快照，可核对 owner、官方索引、可见范围、子项数量和目标中心；亮屏应显示 owner=systemui。
• 新增同曲 seek 保留、瞬时 surface miss、官方索引优先、亮屏/AOD 定位职责、缩放钳制、几何提交屏障、动效关闭和首次布局 pivot 回归测试。
• 实机已覆盖进度拖动、解锁/指纹界面往返、居中/右对齐、75%/90% 非活动缩放、连续切歌和 AOD 往返；未再观察到官方渲染回落、非实时行延迟、视觉对齐错乱或歌词行抖动。
• testDebugUnitTest、assembleDebug、lintDebug、LSPosed metadata 校验和 git diff --check 均通过；Lint 无错误，仅保留既有的版本兼容、依赖、资源反射和一次性 DexKitBridge 提示。

LyricProvider

• LyricProvider 协议和代码保持不变，已安装 v3.1.0/v3.2.0 Provider 的用户无需更新；Release 继续附带全部 Provider APK 与合集，便于首次安装或补装。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.2.1.apk
• LyricProvider-QQMusic-v3.2.1.apk
• LyricProvider-163Music-v3.2.1.apk
• LyricProvider-AppleMusic-v3.2.1.apk
• LyricProvider-Poweramp-v3.2.1.apk
• LyricProvider-Spotify-v3.2.1.apk
• LyricProvider-QiShui-v3.2.1.apk
• LyricProvider-KuGou-v3.2.1.apk
• LyricProvider-v3.2.1.zip

Donate

ColorOS Live Lyrics Bridge v3.2.0

v3.2.0 在 v3.1.0 自定义能力的基础上完成设置链路、解析稳定性与渲染性能收束。本版本修复设置链路可能覆盖外观配置、极近时间戳的歌词开头信息可能干扰逐字行匹配，以及自绘歌词每帧触发 SystemUI 全量测量与布局的问题；不改变既有 RecyclerView prime、滚动、槽位动画或 AOD 低刷新时序。

设置链路热修

• 播放器翻译设置只更新全局翻译默认值、播放器默认值和清除记忆请求，不再携带并回写可能过期的完整外观快照，避免居中、字号、行距、透明度和光晕等设置被意外恢复。
• 修复设置页 Spinner 初始化回调可能被误判为用户操作的问题，避免进入页面或重新绑定预设时意外应用“默认”预设。
• 修复设置页首次绑定发生在滑块监听器安装之前时，数值文字仍停留在控件下限的问题；保存后重新进入页面，透明度、模糊、缩放、光晕、字号、翻译比例和行距的文字会与滑块及实际配置一致。
• 页面因系统重建时会保存并恢复尚未提交的配置草稿，减少旋转、窗口重建等场景下的编辑内容丢失。
• 设置广播增加单调递增 revision、来源标识和受保护的 ResultReceiver 回执；设置页会区分“已保存”“SystemUI 已应用”“SystemUI 拒绝”和“未收到确认”。
• Logcat 增加 settings-send、settings-receive、settings-applied、settings-ack 和 settings-rejected 事件，并记录 revision、来源和最终对齐值，便于诊断偶发的设置未生效或对齐回退。
• 修正悬浮预览相对标题栏边界的坐标换算，优先使用实际 ActionBar 容器底边，避免预览框贴到屏幕顶端或遮挡标题栏。
• 设置页滑块改用不注册系统手势排除区的轻量控件，避免长页面滚动时每帧为多个原生滑块反复计算手势排除区与避让区。
• 设置页窗口稳定请求最高 120 Hz，并关闭独立的触摸升频投票；Android 15 及以上启用帧率省电平衡提示，使 LTPO 面板仍可在内容静止时向下自适应，避免滚动期间在 60/120 Hz 间反复切换造成 Buffer Stuffing。
• 合并悬浮预览的位置更新到下一帧执行，复用坐标缓存，并跳过没有变化的位移和阴影高度写入；滚动期间将整块预览临时缓存为硬件层，停止 160ms 后释放，降低主线程与 RenderThread 的重复绘制，同时不长期占用额外显存。

歌词解析与显示修复

• 修复极近时间戳的开头信息被 Accompanist 误合并为双语歌词的问题。例如相邻的“作词”“作曲”和第一句双语歌词会重新保持各自时间轴行，避免后续 RecyclerView 索引整体错位。
• 解决关闭所有可选歌词开头清理规则后，部分歌词可能出现逐字进度中途消失、相邻同文歌词同时高亮，以及制作信息异常放大的问题。
• 修复仅拆分能够确认吸收了非歌词信息的解析行；其余歌词继续保留上游逐字区间和翻译匹配结果，避免对正常的轻微错位双语歌词造成影响。
• 增加受频率限制的官方绘制回退诊断，记录模型缺失、行匹配失败和绘制异常，同时继续将 Hook 范围限制在 LyricsRecyclerView 内。

SystemUI 渲染性能热修

• 将官方歌词 TextView 的字体内边距和最小高度准备改为幂等操作：属性已经满足要求时不再重复调用 setter。
• 修复自绘路径每帧调用 TextView.setMinHeight(0) 并触发 requestLayout()，导致整个锁屏通知面板几乎每帧重新 measure/layout 的问题。
• 保留逐字进度、光晕、模糊和滚动的原有刷新节奏；不通过降帧隐藏 CPU 开销，也不修改翻译展开/收起的真实槽位动画。
• 不移动或延迟 LyricsRecyclerView 首次 attach、prime、setCurrentLyric、可见行高度同步及 AOD 低刷新路径。

刷新率与媒体封面

• 将“最大动态刷新率”更名为“歌词刷新上限”，并明确该设置只限制歌词内容重绘，不会强制 ColorOS 将锁屏物理刷新率升至 90/120 Hz；系统降至 60 Hz 时歌词也会随之降至 60 帧。
• 固定 60/90/120 Hz 改为按显示帧时间做截止时间节拍。修复 90 Hz 在 120 Hz 屏幕上因毫秒取整而实际退化为逐 VSync 刷新的问题，同时不会在物理屏幕已经降频时虚构额外帧。
• 修复 Salt Player 冷启动首曲歌词结果回写与异步封面加载竞争的问题：歌词元数据只进行一次延迟发布，并在发布前重新读取当前 MediaSession 元数据和核对曲目身份，不再用较早保存的元数据快照覆盖刚更新的封面。
• 歌词元数据发布日志增加位图尺寸、generation、对象标识和 URI 摘要，后续若仍出现播放器自身上报旧封面的情况，可以区分播放器源数据与 SystemUI 缓存问题；不会复制、清空或修改封面像素。

修复测试结果

同一设备、模块开启并使用 Salt Player 锁屏歌词的 60 秒 Perfetto 前后对比结果如下：

指标	v3.1.0	v3.2.0 构建	变化
SystemUI 总 CPU	57.63%	45.33%	下降约 21%
SystemUI 主线程 CPU	26.48%	14.83%	下降约 44%
RenderThread CPU	24.89%	24.12%	基本不变
measure	3616 次/分钟	36 次/分钟	减少约 99%
layout	3616 次/分钟	36 次/分钟	减少约 99%

• 官方锁屏歌词参考样本的 SystemUI 主线程为 14.56%、RenderThread 为 24.45%、measure/layout 各 99 次/分钟；优化后主线程开销已接近官方参考路径。官方样本为维持亮屏包含周期唤醒命令，因此只作为参考，不作为严格的整机耗电等价对照。
• 修复前后均保持约 60 帧/秒的歌词绘制采样，性能下降并非通过关闭逐字刷新或降低亮屏歌词帧率取得。
• 修复后 Perfetto 有效时长为 59.991 秒，未发现跟踪数据丢失或非信息级 trace stats 错误。
• testDebugUnitTest、assembleDebug、lintDebug 和 git diff --check 均通过；Lint 无错误，仅保留既有的兼容性、依赖版本、资源反射和一次性 DexKitBridge 解析提示。
• 新增配置 round-trip、播放器翻译不得覆盖外观、设置 revision 单调性、悬浮预览坐标和极近时间戳开头信息解析回归测试。
• 新增 60/90/120 Hz 截止时间节拍单测；设置页 120 Hz 连续滚动 CPU 通常约 30%、峰值约 40%，与系统设置页同类滚动负载接近，停止滚动后正确回落到接近 0%，未发现持续后台占用。
• 冷启动首曲封面发布增加当前曲目身份复核与诊断信息；播放器强制停止后的首曲概率场景仍建议后续持续观察。

LyricProvider

• LyricProvider 协议和代码保持不变，已安装 v3.1.0 Provider 的用户无需更新；本次问题均在 Bridge 设置、解析和 SystemUI 绘制侧修复。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.2.0.apk
• LyricProvider-QQMusic-v3.2.0.apk
• LyricProvider-163Music-v3.2.0.apk
• LyricProvider-AppleMusic-v3.2.0.apk
• LyricProvider-Poweramp-v3.2.0.apk
• LyricProvider-Spotify-v3.2.0.apk
• LyricProvider-QiShui-v3.2.0.apk
• LyricProvider-KuGou-v3.2.0.apk
• LyricProvider-v3.2.0.zip

Donate

ColorOS Live Lyrics Bridge v3.1.0

v3.1.0 完成歌词设置、渲染和内容清理的系统化升级。本版本开放安全的外观与排版自定义，同时把配置、预览、广播、缓存和 SystemUI 绘制收束到同一套版本化模型，并保持已验证的 AOD 首次挂载与低刷新路径。

歌词外观与预览

• 新增“默认、柔和、醒目、极简”四种外观预设；手动修改预设所管理的字段后自动显示为“自定义”。
• 开放非活动歌词透明度、模糊、非活动缩放、光晕强度与半径、主色/光晕色、动效等级、长歌词纵向浏览和长翻译横向滚动。
• 开放主歌词字号、翻译字号比例、字重、左对齐/居中/右对齐和 -5–20dp 歌词行间距；所有预设的默认行距为 0dp。
• 最大动态刷新率可跟随屏幕或限制为设备支持的 60/90/120 Hz，仅限制歌词内容重绘，不强制改变屏幕刷新率；AOD 继续使用低刷新路径。
• 设置页预览显示当前行及后续两行的主歌词与翻译，复用锁屏槽高、排版、行距、缩放和对齐策略；滚动后会平滑吸附在标题栏下方，便于边调边看。
• “恢复默认外观”只重置外观字段，不修改屏幕保活、刷新率、播放器翻译默认值或歌词内容清理策略。

稳定自适应布局

• 歌词物理槽位按换行、翻译和排版配置稳定计算，保留最小高度、字体上下边界与底部安全空间，修复 g 等下伸字符的轻微裁剪。
• 主歌词仍最多同时显示两行；超过两行时保留完整换行结果，并在固定两行视窗内按歌词进度平滑展示后续内容，避免复杂歌词忽大忽小。
• 翻译展开/收起重新压缩 RecyclerView 行高，并以统一动画进度同步所有可见行和当前行锚点，减少突跳和掉帧；AOD 只应用一次终态高度。
• 修正居中与右对齐时的缩放原点、视觉中心和长文本浏览方向；设置项使用“左对齐/居中/右对齐”可读名称。
• 同步 AOD/亮屏切换时的光晕与逐字效果，并统一 AOD 当前主歌词和翻译行亮度。

播放器翻译与歌词开头清理

• “播放器翻译设置”迁移到“兼容与屏幕”中的独立页面，可按播放器设置默认翻译并单独清除记忆；Salt Player 与 ConePlayer 始终显示，Provider 播放器会根据对应 APK 是否安装自动灰置。
• 新增“歌词开头信息清理”二级页面，以开关提供常见版权声明、制作/乐器信息和“歌名 - 歌手”开头规则；影响解析正确性的保护规则固定保留。
• 可一次性读取当前歌曲前 80 个时间轴行，直接选择第一句正式歌词；逐曲修正绑定原始 trackKey 与行指纹，不依赖易变化的行号。
• 可从未识别行中选择安全的前缀或整行格式供其他歌曲复用，无需编写正则或 DSL；规则受开头 30 秒、32 个候选、32 条规则和 4 KiB 快照等边界限制。
• 移除原计划中的展示元数据 DSL；清理只影响模块生成的歌词显示，不修改 MediaSession、Provider 原始数据、曲目身份或歌词时间轴。

配置、日志与解析

• 引入不可变、版本化歌词 UI 配置及统一校验、迁移和 SharedPreferences 仓库；设置采用“保存并应用”，保存前只更新预览。
• 设置广播从外部歌词 Receiver 中拆分，并使用 signature 权限保护；未知未来 schema 会被拒绝，缺失字段保持当前配置。
• Accompanist Lyrics Core 从 0.4.5 升级至 0.4.7，补充 YRC 逐字、LRC、TTML、翻译和逐字区间回归覆盖。
• Logcat 统一为 [进程][模块][事件] message | key=value，保留独立解析 Tag、长消息分块、控制字符转义和 LSPosed 必要错误镜像。
• Java 源码和构建显式使用 UTF-8；可见 Unicode 转义改为可读文字，不可见字符使用具名 code-point 常量。

设置与稳定性修复

• 修复设置二级页顶部被系统栏遮挡、输入框被输入法遮挡、自动填充干扰、选项文字未对齐和滚动预览闪退。
• “歌词显示时保持屏幕”更名为“歌词显示时保持屏幕点亮”，留空的自定义秒数继续表示默认常亮行为。
• 恢复 LSPosed 管理器中的模块图标占位，并保持应用图标、备份规则和 WindowInsets 配置完整。
• 保持 compileSdk/targetSdk 35；Android 36 版本提示作为独立兼容性工作，不使用全局 Lint 基线隐藏。

LyricProvider

• QQ 音乐、网易云音乐、Spotify、汽水音乐和 Poweramp Provider 不再提前删除开头制作信息，只过滤空行并排序，将显示级清理统一交给 Bridge/SystemUI。
• Poweramp 的普通歌词与行内括号歌词路径均保留带时间轴的开头信息。
• 酷狗 Provider 加强车载歌词展示元数据与乱码制作信息识别，避免展示文本被误当成稳定曲目身份。
• 更新受影响 Provider 内部版本，旧版仍可提供歌词，但需要更新后才能完整使用可配置的开头信息清理。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.1.0.apk
• LyricProvider-QQMusic-v3.1.0.apk
• LyricProvider-163Music-v3.1.0.apk
• LyricProvider-AppleMusic-v3.1.0.apk
• LyricProvider-Poweramp-v3.1.0.apk
• LyricProvider-Spotify-v3.1.0.apk
• LyricProvider-QiShui-v3.1.0.apk
• LyricProvider-KuGou-v3.1.0.apk
• LyricProvider-v3.1.0.zip

Donate

ColorOS Live Lyrics Bridge v3.0.4

v3.0.4 完善了关闭“普通逐行伪逐字”后的长歌词显示：普通逐行歌词换行超过两行时，不再固定截断在前两行，而是在保持两行视窗和既有 RecyclerView 几何不变的前提下，随整句播放进度平滑展示后续内容。

Bridge 改进

• 普通逐行歌词关闭伪逐字后，三行正文使用固定两行裁剪视窗，从第 1、2 行平滑移动至第 2、3 行。
• 被动滚动完全由当前歌词的行时间轴驱动，不额外模拟字级时间，也不绘制伪逐字高亮。
• 滚动采用 21.5%～78.5% 的有效进度区间和五次平滑插值，起步、停止更柔和，中段移动更自然。
• 暂停时滚动位置冻结，恢复后继续；拖动播放进度时直接落到对应位置，避免独立动画时钟造成漂移。
• 仅在符合条件的当前长歌词需要移动时保持显示帧率刷新；普通短句和静止状态继续走较低刷新频率。
• 重复或回收中的非当前歌词 holder 不会覆盖当前行的刷新判断。

稳定性边界

• 不改变 LyricsRecyclerView 的滚动位置、item 定位、prime 或 setCurrentLyric 时机。
• 不修改普通 SystemUI TextView；裁剪和自绘仍只作用于歌词 RecyclerView 内部。
• AOD 继续沿用已验证的低帧率与首次 attach 时序，不启用本次连续被动滚动。

LyricProvider

• LyricProvider 代码与内部版本保持不变，已安装的 Provider 无需更新；Release 仍附带各播放器 Provider APK 和合集，便于首次安装或补装。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.0.4.apk
• LyricProvider-QQMusic-v3.0.4.apk
• LyricProvider-163Music-v3.0.4.apk
• LyricProvider-AppleMusic-v3.0.4.apk
• LyricProvider-Poweramp-v3.0.4.apk
• LyricProvider-Spotify-v3.0.4.apk
• LyricProvider-QiShui-v3.0.4.apk
• LyricProvider-KuGou-v3.0.4.apk
• LyricProvider-v3.0.4.zip

Donate

ColorOS Live Lyrics Bridge v3.0.3

v3.0.3 是针对部分 ColorOS 16 / SystemUI 版本启动崩溃的兼容性修复版本，重点解决启用模块后冷启动卡在锁屏界面、SystemUI 主线程 ANR 并进入 LSPosed 安全模式的问题。

Bridge 修复

• 移除全局 ClassLoader.loadClass(String, boolean) Hook，避免在 SystemUI 主线程拦截所有类加载并引发高负载或 ANR。
• 改为仅 Hook OPlus OPlusPluginClassLoader 构造过程，在实际歌词插件 ClassLoader 上安装 LyricsRecyclerView 相关 Hook，并保留首次 View attach 的兜底路径。
• 防止可选的 RecyclerView 通知保护方法缺失时重复安装 setCurrentLyric Hook，降低不同 SystemUI 变体上的重复拦截风险。
• 将歌词 RecyclerView 匹配缓存中的 View 引用改为弱引用，避免静态缓存意外持有 SystemUI View 层级。
• 收紧 LyricsRecyclerView 类型判断，避免误匹配普通 SystemUI View；AOD 首次 attach、透明、位移或 0x0 状态的既有时序保持不变。

兼容性验证

• 在 OnePlus PJZ110、Android 16、SystemUI 16.0.9.401 测试机上完成冷启动与多轮 AOD/亮屏切换测试。
• 测试日志中未出现 SystemUI ANR、崩溃或 LSPosed 安全模式回退；歌词索引和 AOD 切换保持正常。

LyricProvider

• LyricProvider 代码与内部版本保持不变，已安装的 Provider 无需更新；Release 仍附带各播放器 Provider APK 和合集，便于首次安装或补装。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.0.3.apk
• LyricProvider-QQMusic-v3.0.3.apk
• LyricProvider-163Music-v3.0.3.apk
• LyricProvider-AppleMusic-v3.0.3.apk
• LyricProvider-Poweramp-v3.0.3.apk
• LyricProvider-Spotify-v3.0.3.apk
• LyricProvider-QiShui-v3.0.3.apk
• LyricProvider-KuGou-v3.0.3.apk
• LyricProvider-v3.0.3.zip

Donate

ColorOS Live Lyrics Bridge v3.0.2

v3.0.2 是 v3.0.1 的歌词交接与渲染细节修复版本，重点处理 Apple Music 自动切歌偶发“暂无歌词”，以及普通逐行歌词启用伪逐字时末句进度过快完成的问题。

Bridge 修复

• Apple Music 外部歌词交接改为优先跟随 Bridge MediaSession 的最新曲目元数据，避免队列预加载或旧的播放器回调把 Bridge 重新指向上一首/下一首歌曲。
• Apple Music 歌词到达后增加受限的 SystemUI 元数据刷新重试，并过滤同一交接窗口内会把旧歌词重新推进来的陈旧播放状态，降低自动切歌后短暂显示“暂无歌词”的概率。
• 普通逐行歌词的伪逐字模式不再给最后一句使用固定的 600ms 结束时间；会根据前面歌词节奏和末句文本长度估算显示时长，并限制在合理范围内。真实逐字时间轴和显式结束时间不受影响。
• 保持 v3.0.1 已验证的 AOD、锁屏岛切换、RecyclerView 通知保护和 SystemUI 性能优化行为不变。

LyricProvider 修复

• Apple Music Provider：MediaSession 元数据作为 Bridge 曲目身份的权威来源，避免 PlaybackItem 队列预加载覆盖当前曲目，并确保已构建的歌词发送到正确的 Bridge generation。
• Poweramp Provider：兼容不同 Poweramp 版本中以 Int 或 Long 提供的歌词时长字段。
• 本次随发布的 7 个 Bridge Provider 均递增内部 versionCode 与 versionName，安装过旧 Provider 的用户需要更新对应 APK。

Provider 版本

• QQ Music Provider：1.1.1 / versionCode 6
• NetEase Cloud Music Provider：1.1.1 / versionCode 11
• Apple Music Provider：1.1.1 / versionCode 9
• Spotify Provider：1.1.1 / versionCode 7，当前仍仅支持原文歌词，不支持翻译
• QiShui Music Provider：1.2.1 / versionCode 4
• KuGou Music Provider：1.1.4 / versionCode 9
• Poweramp Provider：1.0.11 / versionCode 8

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.0.2.apk
• LyricProvider-QQMusic-v3.0.2.apk
• LyricProvider-163Music-v3.0.2.apk
• LyricProvider-AppleMusic-v3.0.2.apk
• LyricProvider-Poweramp-v3.0.2.apk
• LyricProvider-Spotify-v3.0.2.apk
• LyricProvider-QiShui-v3.0.2.apk
• LyricProvider-KuGou-v3.0.2.apk
• LyricProvider-v3.0.2.zip

Donate

ColorOS Live Lyrics Bridge v3.0.1

v3.0.1 是基于 v3.0.0 的性能与渲染稳定性维护版本，重点降低未使用锁屏歌词时对 SystemUI 的后台开销，并继续收紧只应作用于歌词界面的保护逻辑。

SystemUI 性能优化

• 歌词区域隐藏后立即停止逐帧刷新、可见性恢复与延迟回调；不会因已隐藏的歌词界面继续保留刷新循环。
• Provider 广播在主线程只做轻量校验和快照，歌词解析转入有界后台执行器，降低切歌和媒体状态变化时的主线程压力。
• 歌词局部 View Hook 在无歌词模型、非歌词视图或无活动歌词界面时更早返回，并避免普通路径的临时对象分配与重复祖先查找。
• 移除全局日志 Hook，收紧 OPlus 白名单绕过范围；RecyclerView 通知保护仅作用于官方歌词 Adapter，不再触及普通 SystemUI 列表。

渲染与稳定性

• 修复锁屏岛界面切换时偶发回落到官方大字歌词、短暂闪烁后才恢复模块渲染的问题；过渡期间使用有时限的歌词局部恢复机制，不保留后台刷新。
• Apple Music 在同一播放会话切歌时，允许已确认的最新 generation 歌词绕过陈旧的 SystemUI 曲目标题完成晋升，减少歌词已到达但仍显示“暂无歌词”的情况。
• 保持 v3.0.0 已验证的亮屏到 AOD 歌词首帧与布局时序，不引入新的 AOD 可见性、透明度或尺寸门控。

日志与安装

• 发布版默认只保留必要警告和错误；详细歌词诊断仍需显式开启对应 debug tag。
• Bridge 内部版本更新为 3.0.1 / versionCode 115。LyricProvider 内部版本未变化，已安装的 Provider 无需重装；Release 仍附带全部 Provider APK 与合集，便于首次安装或补装。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.0.1.apk
• LyricProvider-QQMusic-v3.0.1.apk
• LyricProvider-163Music-v3.0.1.apk
• LyricProvider-AppleMusic-v3.0.1.apk
• LyricProvider-Poweramp-v3.0.1.apk
• LyricProvider-Spotify-v3.0.1.apk
• LyricProvider-QiShui-v3.0.1.apk
• LyricProvider-KuGou-v3.0.1.apk
• LyricProvider-v3.0.1.zip

Donate

ColorOS Live Lyrics Bridge v3.0.0

这是一次面向锁屏歌词完整链路的大版本更新。相较 v2.7.2，本版重构了 Bridge 与各 LyricProvider 的切歌、歌词到达和播放状态交接，修复多类“暂无歌词”、旧歌词残留、逐字进度错位和 AOD 切换抖动问题，为偶发 SystemUI 崩溃增加定向保护，并进一步降低 SystemUI 绘制热路径与调试日志的开销。

重大更新

• 统一 QQ 音乐、网易云音乐、Apple Music、Poweramp、Spotify、汽水音乐和酷狗音乐 Provider 的 Bridge 事件模型：使用曲目 generation 区分 trackChanged 与 lyricReady，对需要外部状态的 Provider 继续区分 playbackState，丢弃异步返回的旧曲歌词，并对重复 payload 和高频播放状态广播去重。
• 重做外部歌词切歌交接：在新曲歌词尚未到达、播放器 metadata 短暂抖动或 SystemUI RecyclerView 正在换行绑定时，保持曲目身份和渲染状态一致，减少“暂无歌词”、上一首歌词闪回、边界外首句和淡化未完成等问题。
• 稳定亮屏到 AOD 的歌词绘制：沿用 SystemUI 官方首帧 prime 和布局时序，降低 AOD 低帧率模式下的连续刷新与复杂进度效果，修复靠近绘制区域下边界的歌词异常抖动。
• 新增严格限定在 LyricsRecyclerView 的 RecyclerView Adapter 通知保护，仅拦截布局计算期间的对应 IllegalStateException，降低切歌和状态变化时 SystemUI 偶发崩溃风险。

播放器修复

• ConePlayer：兼容“媒体通知（车载蓝牙）歌词”复用媒体元数据的情况，避免临时歌词行被误判为切歌后令锁屏显示“暂无歌词”，同时保留原有车载歌词功能。
• Spotify：改善首次歌词到达等待、快速切歌、播放进度接续和无歌词曲目处理；当前仍仅支持原文歌词，暂不支持翻译。
• QQ 音乐：修复切歌后旧歌词偶发重复、首句越界，以及快速切歌后歌词淡化或渲染状态未完整恢复的问题。
• 网易云音乐：补齐曲目 generation、播放状态和旧异步结果过滤，降低快速切歌时的错绑风险。
• Apple Music：修复暂停时歌词区域闪现、部分歌曲长时间“暂无歌词”、显示文本与逐字数据不一致及逐字进度错位；增加匹配 PlaybackItem 的请求重试，并兼容交叉渐入渐出期间的曲目交接。
• Poweramp：补齐显式 trackChanged、lyricReady 事件并复用一次生成的歌词 payload；播放状态保持由原生 MediaSession 单路提供；规范化方括号行内逐字时间戳，兼容 durMs 以 Int 或 Long 提供的不同 Poweramp 版本，并在官方索引短暂落后时让放大行回跟实际进度，避免拖动或恢复播放后歌词越界、滚动行与高亮行错位。
• 汽水音乐：优化歌词对象、缓存和播放状态的接管顺序，修复部分有歌词歌曲仍显示“暂无歌词”，并让切歌交接更自然。
• 酷狗音乐/概念版：过滤缺少有效曲目身份的早期播放状态，保留稳定 generation 与歌词 payload，降低启动和切歌竞态。

歌词解析

• 修复部分增强 LRC 的非递增逐字时间戳被降级后误挂到上一句翻译的问题，避免主歌词重复显示或翻译错位。
• 修复英文短句 You you 与中文翻译 你 你 同时间戳时被误判为拼音、使翻译行成为主歌词的问题。

性能与日志

• 减少 SystemUI TextView.onDraw 热路径中的重复父级查找、可见区域计算、时间读取和临时对象分配；相同歌词行的最近绘制缓存改为原位刷新。
• 普通逐行歌词在不需要逐帧进度效果时自动降低刷新频率；AOD 模式继续使用更保守的刷新节奏。
• Official lyric row scale 仅记录目标状态变化，不再在动画的每一帧重复输出；详细诊断仍可通过对应 debug tag 显式开启。
• QQ、网易云、Apple Music、Poweramp、Spotify、汽水和酷狗 Provider 的 Bridge 成功/跳过日志统一受 debug tag 控制，发布版默认只保留必要警告和错误；Poweramp 的内部反射探针仅在显式开启 debug tag 后安装。

Provider 版本

• QQ Music Provider：1.1.0 / versionCode 5
• NetEase Cloud Music Provider：1.1.0 / versionCode 10
• Apple Music Provider：1.1.0 / versionCode 8
• Spotify Provider：1.1.0 / versionCode 6
• QiShui Music Provider：1.2.0 / versionCode 3
• KuGou Music Provider：1.1.3 / versionCode 8
• Poweramp Provider：1.0.10 / versionCode 7

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.0.0.apk
• LyricProvider-QQMusic-v3.0.0.apk
• LyricProvider-163Music-v3.0.0.apk
• LyricProvider-AppleMusic-v3.0.0.apk
• LyricProvider-Poweramp-v3.0.0.apk
• LyricProvider-Spotify-v3.0.0.apk
• LyricProvider-QiShui-v3.0.0.apk
• LyricProvider-KuGou-v3.0.0.apk
• LyricProvider-v3.0.0.zip

Donate

ColorOS Live Lyrics Bridge v2.7.2

这一版继续收紧外部 Provider 的切歌接管和歌词来源兜底，重点改善汽水音乐、酷狗音乐/概念版在实际锁屏场景里的稳定性，同时保持 Bridge 渲染链路的发布版日志更安静。

新增

• 新增汽水音乐官方运行时歌词对象兜底：本地网络缓存和数据库还没命中时，可直接接管播放器当前歌词对象，降低第二次打开后一直“暂无歌词”的概率。
• 新增汽水音乐数据库表发现和 NetCacheLoader 递归查找能力，兼容不同安装来源或缓存目录结构差异。
• 新增汽水音乐中文翻译语言键兜底，优先识别 ZH-HANS、ZH-CN 等翻译字段。

优化

• 优化汽水 Provider 切歌重试、缺失缓存和 Bridge 发送链路，减少歌词 pending 后长期不落地的情况。
• 优化酷狗 Provider：原版酷狗与概念版酷狗分离处理歌词和封面，概念版不再覆盖系统封面；歌词发送增加同曲目去重和稳定元数据保留。
• 优化 Bridge 对汽水音乐和酷狗概念版的外部歌词接管：短暂 metadata/lyricInfo 抖动时保留稳定歌词表面，降低切换时闪回官方渲染或非歌词区域残留。
• 优化翻译按钮识别和可见性跟随，避免歌词出现后按钮视图被回收或隐藏后不恢复。
• 降低 Bridge、汽水 Provider、酷狗 Provider 的发布版日志噪声，高频诊断默认关闭，仅保留必要异常与显式 debug tag 输出。
• 酷狗 Provider 更新到 1.1.2 / versionCode 7。
• 汽水 Provider 保持 1.1.0 / versionCode 2，安装说明提示在 LSP 管理器中为汽水音乐开启“还原内联钩子”。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v2.7.2.apk
• LyricProvider-QQMusic-v2.7.2.apk
• LyricProvider-163Music-v2.7.2.apk
• LyricProvider-AppleMusic-v2.7.2.apk
• LyricProvider-Poweramp-v2.7.2.apk
• LyricProvider-Spotify-v2.7.2.apk
• LyricProvider-QiShui-v2.7.2.apk
• LyricProvider-KuGou-v2.7.2.apk
• LyricProvider-v2.7.2.zip

Donate

ColorOS Live Lyrics Bridge v2.7.1

这一版基于 v2.7.0 继续收紧外部 Provider 接管链路，重点解决酷狗切歌歌词稳定性、锁屏歌词区域残留、网易云逐字格式兼容，以及发布版日志噪声。

新增

• 新增对网易云括号式逐字时间轴的兼容，[00:46.230]Girl [00:46.470]tell ... 这类歌词会转换为可渲染的真逐字时间轴。
• 新增网易云增强逐字/普通逐字格式的回归覆盖，翻译行和主歌词逐字时间可同时保留。
• 新增酷狗原版 Provider 的本地完整歌词缓存优先链路，原版酷狗与概念版酷狗继续分别走各自稳定策略。

优化

• 优化 Bridge 与官方 SystemUI 歌词区域切换逻辑，降低封面/歌词切换期间非歌词区域残留、重叠和错位闪现。
• 优化外部 Provider 切歌接管，减少酷狗原版切歌后“暂无歌词”、歌词闪回官方渲染或上一首歌词残留的概率。
• 优化酷狗 Provider：原版酷狗避免车载歌词兜底污染封面和歌词身份，概念版保持既有稳定行为；缓存命中、候选绑定和 lyricInfo 发布更保守。
• 优化网易云 Provider：普通模式不再发送合成逐字，开启逐字相关模式时才输出增强 rawLyric；同时改善真逐字行中个别时间戳格式被误降级的问题。
• 优化歌词解析：标点与下一词共用时间戳时不再把整行误判为异常逐字，减少真逐字歌词回落为逐行歌词。
• 降低日志噪声：Bridge 高频布局/逐帧诊断收敛到 verbose 级别，酷狗和网易云 Provider 的桥接调试日志仅在显式 tag 下输出。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v2.7.1.apk
• LyricProvider-QQMusic-v2.7.1.apk
• LyricProvider-163Music-v2.7.1.apk
• LyricProvider-AppleMusic-v2.7.1.apk
• LyricProvider-Poweramp-v2.7.1.apk
• LyricProvider-Spotify-v2.7.1.apk
• LyricProvider-QiShui-v2.7.1.apk
• LyricProvider-KuGou-v2.7.1.apk
• LyricProvider-v2.7.1.zip

Donate

ColorOS Live Lyrics Bridge v2.7.0

这一版在 v2.6.0 的外部 Provider 接入基础上，继续收紧锁屏歌词渲染、屏幕超时保活和酷狗/网易云 Provider 的切歌链路，重点是更稳、更安静、更可控。

新增

• 新增歌词界面设置页，可单独控制普通逐行歌词的伪逐字高亮、翻译行逐字高亮、滚动放大、非实时行模糊。
• 新增锁屏屏幕保活设置，可关闭智能保活，也可设置亮屏保持秒数；留空或 0 表示歌词界面显示期间不额外限制保活时长。
• LyricProvider 外部协议新增 Provider 声明字段，Provider 可以主动声明播放器包名、播放状态、曲目 generation、当前曲目可信度和翻译按钮能力。
• 酷狗 Provider 新增 MediaSession lyricInfo 主动发布链路，Bridge 可在 SystemUI 尚未收到外部广播时直接从当前媒体会话读取完整歌词。

优化

• 优化屏幕超时保活语义：保活重新支持从可见官方歌词行兜底识别锁屏歌词界面，减少 SystemUI 日志格式变化或日志延迟导致的保活失效；自定义超时只控制保活窗口，wake lock 仍保持短租约续租，降低异常长持有风险。
• 降低默认运行日志噪声：普通信息日志默认静默，酷狗 Provider 诊断日志仅在显式 debug tag 下输出。
• 优化 SystemUI 性能开销：缓存歌词 RecyclerView 类型判断与 TextView 所属 RecyclerView 关系，减少高频绘制与布局路径上的父节点遍历和字符串匹配。
• 优化官方歌词行缩放与模糊过渡，降低 AOD/亮屏切换、外部 Provider 接管和播放跳转时的旧行闪现与缩放抖动。
• 优化外部 Provider 切歌逻辑，使用声明式播放器身份、generation、trackKey 和当前曲目可信度过滤迟到歌词，减少跨曲目串词。
• 优化酷狗 Provider：歌词文件读取增加写入完成等待、本地歌词文件兜底探测、候选歌词延迟绑定和缓存命中校验，切歌时更少出现“暂无歌词”或上一首歌词残留。
• 优化网易云 Provider：根据用户当前歌词模式决定是否发送逐字 rawLyric，避免普通歌词模式下合成逐字时间轴带来的显示节奏偏差。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v2.7.0.apk
• LyricProvider-QQMusic-v2.7.0.apk
• LyricProvider-163Music-v2.7.0.apk
• LyricProvider-AppleMusic-v2.7.0.apk
• LyricProvider-Poweramp-v2.7.0.apk
• LyricProvider-Spotify-v2.7.0.apk
• LyricProvider-QiShui-v2.7.0.apk
• LyricProvider-KuGou-v2.7.0.apk
• LyricProvider-v2.7.0.zip

Donate

ColorOS Live Lyrics Bridge v2.6.0

这一版在 v2.5.0 的歌词解析与锁屏渲染稳定性基础上，新增酷狗音乐/概念版 LyricProvider 接入，并继续收紧外部 Provider 切歌时的异步歌词绑定、AOD 恢复和 RecyclerView 过渡显示。

核心更新

• 新增酷狗音乐与酷狗概念版 Provider 支持，Release 附带 LyricProvider-KuGou-v2.6.0.apk。
• 酷狗 Provider 支持 KRC、LYC、LRC、TXT 歌词文件解析，输出逐字歌词和翻译歌词，并通过 Bridge 外部歌词协议转发到 ColorOS 锁屏歌词。
• Bridge 为酷狗/概念版登记播放器包名、source、播放状态、翻译开关和 AOD/历史播放器放行能力。
• 酷狗/概念版在 SystemUI 标题短暂为空时，可以凭 Provider 的 trackGeneration 与曲目 key 提升为当前歌词，减少切歌时“暂无歌词”。

切歌与显示稳定性

• 外部 Provider 切歌时增加 generation/key 校验，丢弃迟到歌词，避免上一首歌词串到当前曲目。
• 外部歌词切歌软遮罩会等待当前歌词 model 准备完成后再恢复 RecyclerView，减少切歌瞬间的缩放抖动和旧行闪现。
• 合并频繁的外部 playback reset 过渡，避免流媒体切歌时反复重启 handoff。
• 优化官方歌词行的缩放、淡入和模糊过渡，保留滚动放大效果，同时降低 AOD/锁屏切换后的恢复抖动。

Provider 更新

• KuGou Provider 更新到 1.1.0 / versionCode 5，新增 Bridge 转发、播放状态广播、曲目 generation 和歌词缓存校验。
• Poweramp Provider 更新到 1.0.9 / versionCode 6，改进本地内嵌歌词与网络匹配歌词的 Bridge 发布链路。
• Poweramp Provider 新增安全日志封装，避免 YukiHookAPI 日志不可用时影响播放器进程。

日志与源码

• 默认降低切歌、RecyclerView 过渡、酷狗缓存命中和 Poweramp probe 明细日志噪声；需要排查时仍可通过对应 tag 的 DEBUG 日志打开。
• 清理 LyricProvider 顶层构建脚本中的重复注释和未使用变量。
• 更新 LyricProvider Bridge 接入文档、播放器 hook 路线、README 和 LSPosed 展示元数据。

打包流程

• Release 继续提供各播放器单独的 LyricProvider APK。
• 新增 LyricProvider-v2.6.0.zip，内含全部 LyricProvider APK，方便需要一次安装所有 Provider 的用户下载。
• 主仓库 Release 与 LSPosed mirror Release 都会上传单独 APK 和整合 zip。

测试

• 已执行 :app:testDebugUnitTest。
• 已执行主模块 release 构建。
• 已执行 :kugou-music:assembleRelease。
• 已对本地打包的主模块与 KuGou Provider APK 执行 apksigner verify。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v2.6.0.apk
• LyricProvider-QQMusic-v2.6.0.apk
• LyricProvider-163Music-v2.6.0.apk
• LyricProvider-AppleMusic-v2.6.0.apk
• LyricProvider-Poweramp-v2.6.0.apk
• LyricProvider-Spotify-v2.6.0.apk
• LyricProvider-QiShui-v2.6.0.apk
• LyricProvider-KuGou-v2.6.0.apk
• LyricProvider-v2.6.0.zip

Donate

ColorOS Live Lyrics Bridge v2.5.0

这一版重点修复复杂歌词解析和官方锁屏渲染稳定性，尤其是逐字歌词、翻译、罗马音、重复歌词和格式异常混在一起时的错位问题。
同时新增可自定义选项：默认样式、滚动放大和非实时行模糊。

核心更新

• 新增歌词 lane 分类器，同时间多行会稳定区分主歌词、翻译、罗马音、原文变体和 credit 行。
• 修复 He did it / 他背叛了我 这类异常逐字时间导致的夹心显示问题，避免渲染成 He did / 他背叛了我 / it。
• 修复 Bejeweled、coney island 等增强 LRC 中主歌词被翻译行覆盖，只显示翻译的问题。
• 修复部分歌词缺失翻译、重复短句、多句同时间戳时的 lane 错位和漏解析。
• 清理“以下歌词翻译由 xxx 提供”等翻译提供方说明，避免被当作歌词内容。
• 对异常大间隔或非递增的逐字时间做整行降级，减少坏格式歌词触发的渲染异常。
• 修复 All Too Well 后段重复歌词和翻译近邻导致的锁屏歌词抖动。
• 修复 closure、willow、'tis the damn season 等开头 title/credit 行抢占首句焦点的问题，第一句歌词在正式开始前保持清晰。

锁屏显示与设置

• 新增歌词界面设置页，可切换默认样式、滚动放大和非实时行模糊。
• 优化官方歌词列表 alias 复用和首句 display anchor，降低官方列表缺 title/credit 或行号偏移时的错位风险。
• 优化行高、缩放、模糊和 AOD/锁屏切换时的刷新稳定性。

Provider 更新

• Poweramp Provider 更新到 1.0.8 / versionCode 5，修复部分 API 102 兼容框架中因包可见性或多余 scope 导致 Poweramp 启动崩溃的问题。
• Poweramp Provider 现在只注入 com.maxmpz.audioplayer 主包，移除未使用的 com.maxmpz.audioplayer.unlock scope，并声明对 Poweramp 主包的 <queries> 可见性。

性能与日志

• 默认关闭逐帧布局诊断和解析 trace，减少常规使用时的 logcat 噪声。
• 保留 LockscreenLyrics 和 LockscreenLyricsParse DEBUG log tag，用于后续精准排查。
• 优化长歌词热路径查询，减少每帧重复扫描歌词行。

测试

• 新增歌词解析回归矩阵，覆盖 no body, no crime、Bejeweled、coney island、provider credit 清理、异常逐字时间降级等场景。
• 发布前执行 :app:testDebugUnitTest 和 :app:assembleDebug。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v2.5.0.apk
• LyricProvider-QQMusic-v2.5.0.apk
• LyricProvider-163Music-v2.5.0.apk
• LyricProvider-AppleMusic-v2.5.0.apk
• LyricProvider-Poweramp-v2.5.0.apk
• LyricProvider-Spotify-v2.5.0.apk
• LyricProvider-QiShui-v2.5.0.apk

Donate

ColorOS Live Lyrics Bridge v2.4.0

这一版重点优化锁屏歌词布局、亮屏/AOD 切换稳定性，并新增汽水音乐 Provider 适配。

核心更新

• 优化英文歌词换行：短句能一行显示就不再强行拆行，例如 Forgive me, Peter。
• 长英文歌词仍会在实际溢出时做均衡换行，避免过长行挤出屏幕。
• 修复亮屏切 AOD 时歌词/翻译行闪烁抖动：在 TextView.setText 和 attach 阶段提前固定歌词高度，避免 AOD 模板重绑时先按单行布局。
• 增强 AOD/锁屏切换稳定性：增加最近绘制帧 fallback、翻译短缓存，减少系统重排或短暂数据空窗造成的视觉跳动。
• 优化歌词面板淡入逻辑，避免已经可见时重复隐藏再淡入。
• 改善歌曲开头首句还没到时间轴时的显示稳定性。

播放器与 AOD 适配

• 新增汽水音乐 Provider 适配，Release 附带 LyricProvider-QiShui-v2.4.0.apk。

汽水音乐使用提醒

汽水音乐需要额外安装 LyricProvider-QiShui-v2.4.0.apk，并在 LSPosed 中为 com.luna.music 启用该 Provider。

同时，请在 LSP 管理器中为汽水音乐开启“还原内联钩子”：对列表中的应用清理 libart.so。否则汽水音乐可能弹出“当前版本不安全”，Provider 也可能无法稳定获取歌词。

另外，感谢来自酷安用户@sylajiao的捐赠。

文档与发布

• 更新演示 GIF，体积从约 43.6 MB 降到约 17.2 MB。
• 新增捐赠二维码 PY_QR.png。
• README / 中文 README / LSPosed README 增加支持项目说明。
• Release workflow 增加自动附加 Donate 区块的逻辑。
• Release workflow 新增汽水音乐 Provider 构建与发布资产。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v2.4.0.apk
• LyricProvider-QQMusic-v2.4.0.apk
• LyricProvider-163Music-v2.4.0.apk
• LyricProvider-AppleMusic-v2.4.0.apk
• LyricProvider-Poweramp-v2.4.0.apk
• LyricProvider-Spotify-v2.4.0.apk
• LyricProvider-QiShui-v2.4.0.apk

测试

• 新增 LyricLineBreakPolicy 换行策略测试，覆盖“短英文不拆行”和“长英文可均衡拆行”。
• 发布前执行 :app:assembleDebug、:qishui-music:assembleDebug 与 git diff --check。

捐赠

ColorOS Live Lyrics Bridge v2.3.3

这一版继续修复 v2.3.x 的锁屏歌词渲染稳定性，重点处理拖动播放进度后的实时行恢复、歌词列表定位，以及 LyricProvider 接入播放器切歌时偶发露出官方渲染的问题。

当前支持的播放器

Bridge 内置适配：

• Salt Player
• ConePlayer 正式版与 Google Play 版
• 主动发布完整 MediaMetadata["lyricInfo"] 的播放器，例如 Halcyon
• Poweramp 内部适配

Provider 适配，需要额外安装 Release 附带的独立 LyricProvider APK，并在 LSPosed 中为目标播放器启用：

• LyricProvider-QQMusic：QQ 音乐
• LyricProvider-163Music：网易云音乐、网易云音乐荣耀版
• LyricProvider-AppleMusic：Apple Music
• LyricProvider-Poweramp：Poweramp 外部 Provider 兼容包
• LyricProvider-Spotify：Spotify

修复与改进

• 修复拖动播放进度后，目标位置落在间奏或两句歌词中间时，锁屏歌词可能停留在旧行，直到下一句歌词开始才滚动的问题。
• 修复将播放进度拉到开头时，第一句歌词小概率落在渲染区域外，需要唱到第二句才恢复的问题。
• 统一 seek 后强制定位和实时播放时的活动行锚点，减少目标行落在绘制区域偏下、随后又被实时歌词拉回的问题。
• 优化 seek 后歌词跳转过程中的滚动保护和精确落点校准，减少定位过头、回弹和上下抖动。
• 修复 Apple Music、QQ 音乐、网易云音乐等 LyricProvider 接入播放器切歌时，外部歌词 handoff 期间可能提前淡入，导致官方渲染闪一下或整体绘制闪烁的问题。
• 收敛 seek、handoff 和布局定位诊断日志，正式使用时减少 LockscreenLyrics logcat 噪声；需要排查时仍可通过 DEBUG 日志级别打开细节输出。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v2.3.3.apk
• LyricProvider-QQMusic-v2.3.3.apk
• LyricProvider-163Music-v2.3.3.apk
• LyricProvider-AppleMusic-v2.3.3.apk
• LyricProvider-Poweramp-v2.3.3.apk
• LyricProvider-Spotify-v2.3.3.apk

验证

• .\scripts\gradle-local.cmd :app:testDebugUnitTest :app:assembleDebug
• .\scripts\gradle-local.cmd :app:assembleRelease
• powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\validate-lsposed-metadata.ps1
• git diff --check

ColorOS Live Lyrics Bridge v2.3.2

这一版继续收敛 v2.3.x 的歌词解析兼容性，重点修复 LyricProvider 外部歌词在部分混合逐字歌词格式下出现的主行、翻译行和官方列表项错位问题。

当前支持的播放器

Bridge 内置适配（只安装 ColorOS-Live-Lyrics-Bridge 即可）：

• Salt Player
• ConePlayer 正式版与 Google Play 版
• 主动发布完整 MediaMetadata["lyricInfo"] 的播放器，例如 Halcyon
• Poweramp 内部适配

Provider 适配（需要额外安装 Release 附带的独立 LyricProvider APK，并在 LSPosed 中为目标播放器启用）：

• LyricProvider-QQMusic：QQ 音乐
• LyricProvider-163Music：网易云音乐、网易云音乐荣耀版
• LyricProvider-AppleMusic：Apple Music
• LyricProvider-Poweramp：Poweramp 外部 Provider 兼容包
• LyricProvider-Spotify：Spotify

修复与改进

• 修复网易云音乐等 Provider 外部歌词中，“逐字主行后紧跟无逐字主行”被误判为翻译行，导致锁屏歌词顺序错乱、重复行、翻译位显示主歌词的问题。
• 修复外部歌词模型和 ColorOS 官方歌词列表项数量不一致时，adapter index 回退到错误主行导致的首屏/切歌渲染错位。
• 改进官方歌词显示文本别名映射，只在文本确实匹配主行时覆盖显示文本，避免把元信息或下一句歌词挂到逐字行上。
• 修复 We are, we are, we are、Is it? Is it? 这类重复英文短句被误识别成罗马音，进而只显示翻译行的问题。
• 为 LyricProvider 外部歌词增加 UTF-8 被 GB18030 误解码时的 Bridge 侧兜底修复；Provider 模块本身不引入本次调试期的 163 Music 编码补丁。
• 关闭正式包中的歌词解析 trace 日志，减少正常使用时的 logcat 噪声。
• 改进本地 Gradle 构建脚本在中文路径、Gradle 锁文件、项目目录 ACL 异常场景下的 fallback 能力。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v2.3.2.apk
• LyricProvider-QQMusic-v2.3.2.apk
• LyricProvider-163Music-v2.3.2.apk
• LyricProvider-AppleMusic-v2.3.2.apk
• LyricProvider-Poweramp-v2.3.2.apk
• LyricProvider-Spotify-v2.3.2.apk

验证

• .\scripts\gradle-local.cmd :app:testDebugUnitTest :app:assembleDebug
• .\scripts\gradle-local.cmd :app:assembleRelease
• powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\validate-lsposed-metadata.ps1
• git diff --check

ColorOS Live Lyrics Bridge v2.3.1

这一版是 v2.3.0 后的小修版本，重点修复歌词解析兼容性、连续快进后的逐字渲染恢复，以及 Apple Music Provider 的小版本兼容问题。

当前支持的播放器

Bridge 内置适配（只安装 ColorOS-Live-Lyrics-Bridge 即可）：

• Salt Player
• ConePlayer 正式版与 Google Play 版
• 主动发布完整 MediaMetadata["lyricInfo"] 的播放器，例如 Halcyon

Provider 适配（需要额外安装 Release 附带的独立 LyricProvider APK，并在 LSPosed 中为目标播放器启用）：

• LyricProvider-QQMusic：QQ 音乐
• LyricProvider-163Music：网易云音乐、网易云音乐荣耀版
• LyricProvider-AppleMusic：Apple Music
• LyricProvider-Poweramp：Poweramp
• LyricProvider-Spotify：Spotify

修复与改进

• 修复部分歌词格式下主歌词、翻译、标音行识别错误导致的渲染混乱。
• 修复锁屏界面连续快进后，逐字歌词概率不再渲染的问题。
• 加强 Apple Music Provider 的版本兼容性：使用 DexKit 查找 Apple Music 内部 PlaybackItem 转换 hook 点，避免小版本混淆类名变化后失效。
• Apple Music Provider 版本更新至 1.0.22。
• 收敛 Bridge 与 Apple Music Provider 的正式版调试日志，减少正常播放时的 logcat 噪声。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v2.3.1.apk
• LyricProvider-QQMusic-v2.3.1.apk
• LyricProvider-163Music-v2.3.1.apk
• LyricProvider-AppleMusic-v2.3.1.apk
• LyricProvider-Poweramp-v2.3.1.apk
• LyricProvider-Spotify-v2.3.1.apk

验证

• .\scripts\gradle-local.cmd testDebugUnitTest assembleDebug
• powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\validate-lsposed-metadata.ps1
• git diff --check

ColorOS Live Lyrics Bridge v2.3.0

这一版正式加入 Apple Music Provider，并修复外部 Provider 歌词在锁屏渲染中的若干边界问题。

当前支持的播放器

Bridge 内置适配（只安装 ColorOS-Live-Lyrics-Bridge 即可）：

• Salt Player
• ConePlayer 正式版与 Google Play 版
• 主动发布完整 MediaMetadata["lyricInfo"] 的播放器，例如 Halcyon

Provider 适配（需要额外安装 Release 附带的独立 LyricProvider APK，并在 LSPosed 中为目标播放器启用）：

• LyricProvider-QQMusic：QQ 音乐
• LyricProvider-163Music：网易云音乐、网易云音乐荣耀版
• LyricProvider-AppleMusic：Apple Music
• LyricProvider-Poweramp：Poweramp
• LyricProvider-Spotify：Spotify（不支持翻译）

改进

• 新增 Apple Music Provider：支持逐字歌词与翻译歌词，不输出背景人声或对唱格式歌词。
• Apple Music Provider 通过播放器内部歌词对象取词，并向 Bridge 转发完整 lyricInfo。
• Bridge 侧翻译开关改为按播放器独立保存，避免 Salt 等播放器关闭翻译后影响 QQ 音乐、网易云音乐、Apple Music 等 Provider。
• Bridge 可在 QQ 音乐、网易云音乐、Apple Music 等官方占用翻译按钮位置的播放器中覆盖可用媒体 action，补回翻译开关。
• 修复 Apple Music 中文主行带 Oh、Hoh、ICBM 等短英文尾词时被误拆成翻译/主行错位的问题。
• 保持 Provider APK 的独立模块形态：Bridge APK 不内置大厂播放器 Hook，用户按目标播放器选择安装对应 Provider。
• 补充外部歌词源和短英文尾词解析单测，锁定 Apple Music、Poweramp、Spotify 的差异化策略。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v2.3.0.apk
• LyricProvider-QQMusic-v2.3.0.apk
• LyricProvider-163Music-v2.3.0.apk
• LyricProvider-AppleMusic-v2.3.0.apk
• LyricProvider-Poweramp-v2.3.0.apk
• LyricProvider-Spotify-v2.3.0.apk

验证

• .\scripts\gradle-local.cmd testDebugUnitTest assembleDebug
• powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\validate-lsposed-metadata.ps1
• git diff --check

ColorOS Live Lyrics Bridge v2.2.0

这一版把 QQ 音乐、网易云音乐、Poweramp、Spotify 的 LyricProvider 辅助模块纳入正式发布包，并整理 Bridge 侧对外部歌词源的接入逻辑。

当前支持的播放器

Bridge 内置适配（只安装 ColorOS-Live-Lyrics-Bridge 即可）：

• Salt Player
• ConePlayer 正式版与 Google Play 版
• 主动发布完整 MediaMetadata["lyricInfo"] 的播放器，例如 Halcyon

Provider 适配（需要额外安装 Release 附带的独立 LyricProvider APK，并在 LSPosed 中为目标播放器启用）：

• LyricProvider-QQMusic：QQ 音乐
• LyricProvider-163Music：网易云音乐、网易云音乐荣耀版
• LyricProvider-Poweramp：Poweramp
• LyricProvider-Spotify：Spotify（不支持翻译）

改进

• 新增 Bridge 侧外部歌词源注册表，统一管理 Provider source、播放器包名、播放状态能力和 Poweramp 特殊匹配策略。
• 扩展外部 lyricInfo 广播契约，支持 trackChanged、lyricReady、播放状态、播放进度和 track generation，降低切歌后旧歌词回绑概率。
• 支持 Spotify Provider 发送播放状态，修复广告、暂停和切歌场景下歌词抢跑或停不住的问题。
• 支持 Poweramp Provider 在播放器内部补写 lyricInfo，优先使用 Poweramp 当前媒体会话和内部歌词结果，避免外部广播路线切歌后长时间无歌词。
• 保留 Provider APK 的独立模块形态：Bridge APK 不内置大厂播放器 Hook，用户按目标播放器选择安装对应 Provider。
• 补充外部歌词源能力单测，锁定 Spotify 与 Poweramp 的 source 映射和差异化策略。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v2.2.0.apk
• LyricProvider-QQMusic-v2.2.0.apk
• LyricProvider-163Music-v2.2.0.apk
• LyricProvider-Poweramp-v2.2.0.apk
• LyricProvider-Spotify-v2.2.0.apk

验证

• .\scripts\gradle-local.cmd testDebugUnitTest assembleDebug
• powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\validate-lsposed-metadata.ps1
• git diff --check

ColorOS Live Lyrics Bridge v2.1.0

这次主要优化锁屏歌词渲染密度、翻译切换动画和增强 LRC 双语解析稳定性。

改进

• 将官方歌词 item 从单纯固定高度改为动态槽位高度，保留 56dp 最小高度和约 12dp 垂直留白，缓解短句间距过大和长句布局不均匀的问题。
• 翻译开关继续保持“最多两行主歌词 + 一行翻译”的显示规则，并优化展开/收起过渡，减少歌词绘制抖动和展开末尾轻微回弹。
• 在锁屏高亮状态与 AOD 暗屏切换期间增加官方 LyricsRecyclerView settle 窗口，降低 active line 瞬时跳动概率。
• 优化同时间戳增强 LRC 解析，避免英文逐字主歌词被误判为日文罗马音而与中文翻译互换。
• 补充 Taylor Swift 与 Beauty And A Beat 等用户反馈样例的解析回归测试，覆盖 <00:00.000> 与 [00:00.000] 两种逐字时间标签形式。

清理

• 收拢翻译切换后的 RecyclerView、TextView 与根视图刷新逻辑。
• 移除重复的官方歌词 settle 触发，并整理歌词槽位高度计算接口。

验证

• .\scripts\gradle-local.cmd testDebugUnitTest assembleDebug
• powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\validate-lsposed-metadata.ps1
• git diff --check

ColorOS Live Lyrics Bridge v2.0.1

这是一次兼容性和锁屏渲染稳定性修复版本。

修复

• 修复日文歌词中包含“鼓”等制作信息关键词时，可能被误判为参与者/制作信息，导致主歌词丢失或和翻译错位的问题。
• 兼容同一时间戳缺少罗马音行的日文逐字歌词，优先保留日文主歌词并继续匹配中文翻译。
• 修复锁屏界面连续快进或连续切换播放位置后，逐字歌词 RecyclerView 可能停留在隐藏 alpha，导致逐字歌词不显示的问题。
• 增加更长尾的歌词可见性恢复检查，覆盖 SystemUI RecyclerView 晚布局或动画被打断后的隐藏态。

说明

• Release 继续附带 LyricProvider-QQMusic APK，作为 QQ 音乐歌词提供模块。
• ColorOS-Live-Lyrics-Bridge 与 LyricProvider-QQMusic 使用同一套 release 签名。

验证

• 已执行 testDebugUnitTest。
• 已执行 assembleDebug。

ColorOS Live Lyrics Bridge v2.0.0

这是一次面向外部歌词提供模块的主要更新：

• 适配QQ音乐
• 歌词解析优化

新增

• 接入 LyricProvider 外部歌词桥接协议，支持由歌词提供模块向 ColorOS Live Lyrics Bridge 投递完整歌词数据。
• Release 附带 LyricProvider-QQMusic APK，可为词幕和 ColorOS Live Lyrics Bridge 提供 QQ 音乐歌词。
• SystemUI 侧支持外部歌词覆盖官方 lyricInfo，在 QQ 音乐场景下优先使用逐字歌词渲染。
• 支持外部歌词翻译数据进入锁屏歌词渲染链路。

改进

• 优化 QQ 音乐切歌稳定性，减少首句错位、官方歌词闪现、歌词区域跳动等问题。
• 优化外部歌词模型切换时的软遮罩和淡入，降低切歌时官方渲染短暂露出的概率。
• 改进歌词解析中的日语罗马音、翻译行和共享英文尾词识别，减少把罗马音误判为翻译的问题。
• 改进本地歌词解析对逐字 LRC、翻译行、长句和重复行的处理。
• 增强 SystemUI 歌词 RecyclerView 定位和首句对齐逻辑。

说明

• ColorOS-Live-Lyrics-Bridge 仍是 LSPosed 主模块。
• LyricProvider-QQMusic 是本次 Release 的附加 APK，需要单独安装并在 LSPosed 中为 QQ 音乐启用。
• 两个 APK 使用同一套 release 签名。

更新内容

• 重构 Salt Player 歌词接入链路，改为在 Salt 最终发布歌词结果后读取歌曲与歌词结果，减少异步回调串歌、旧结果覆盖新歌、同一首歌偶发提示无歌词的问题。
• 优化歌词会话匹配与回调稳定性，改善开启状态栏歌词后部分歌曲更容易出现“暂无歌词”的情况。
• 优化普通逐字歌词、增强逐字歌词的主歌词/翻译选择逻辑，日文歌曲会自动剔除罗马音，只保留主歌词和翻译。
• 增强对歌名、词曲、编曲、制作人等参与者信息逐字行的兼容，避免这类元信息导致歌词解析中断或混乱。
• 撤回按 Live 岛、锁屏小控件、大封面、QS Media 等不同位置强制隐藏翻译按钮的实验性处理，避免影响 Salt 桌面歌词按钮和系统媒体控制卡稳定性。

温馨提示

温馨提示：如遇到歌词无法解析，锁屏提示歌曲暂无歌词，或者解析混乱/错位，请优先尝试使用 Lyrico 歌曲元数据编辑器匹配 QQ 音乐逐字歌词或增强逐字歌词。
如果问题依旧，请提供歌曲、歌词源文件以及触发 bug 后的 LSP 日志文件。

验证

• 已执行 testDebugUnitTest。
• 已执行 assembleDebug。

更新内容

• 修复了普通逐字歌词格式的解析混乱

温馨提示

温馨提示：如遇到歌词无法解析，锁屏提示歌曲暂无歌词，或者解析混乱/错位，请优先尝试使用 Lyrico 歌曲元数据编辑器匹配QQ音乐逐字歌词或增强逐字歌词。
如果问题依旧，请提供歌曲、歌词源文件以及触发bug后的LSP日志文件

验证

• 已执行 testDebugUnitTest。

更新内容

• 修复剩余文本已能整行放下时，逻辑仍强制在最后一个空格断开，导致 mouth、do 这类末词单独成行。现在会完整保留：
  She says, "That ain't my
  merlot on his mouth"

温馨提示

温馨提示：如遇到歌词无法解析，锁屏提示歌曲暂无歌词，或者解析混乱/错位，请优先尝试使用 Lyrico 歌曲元数据编辑器匹配QQ音乐逐字歌词。
如果问题依旧，请提供歌曲、歌词源文件以及触发bug后的LSP日志文件

验证

• 已执行 testDebugUnitTest。

更新内容

• 修正 v1.9.1 的长歌词布局：主歌词维持统一字号，不再为了压入两行而自动缩小。
• 长句会依据可用宽度自然换行；带翻译歌词仍保留固定槽位与逐字高亮、翻译显示逻辑。

验证

• 已执行 testDebugUnitTest。

更新内容

• 修复带翻译歌词的长英文句：主歌词会优先适配为两行，避免末尾单词被挤到第三行。
• 修复普通逐行 LRC 的伪逐字显示：长句换行窗口会依据实际渲染宽度和高亮位置切换，不会在进度中段提前跳到下一行。
• 修复短歌词被误匹配为同前缀长歌词的问题；例如 No, no 不会再显示为 No, no body, no crime 及其翻译。

验证

• 已执行 testDebugUnitTest。

更新内容

• 重构为播放器无关的歌词事务层：歌词来源现在显式区分“已解析歌词”“确认无歌词”“解析失败”和“来源未命中”，并按来源能力声明关联到当前曲目、下一次稳定元数据或明确曲目标识，不再依赖 Salt Player 专用时序补丁。
• 修复含纯音乐时的连锁歌词错位：无身份的被动回调不再抢绑当前曲目；完整标题/歌手、媒体 ID、媒体 URI 与请求上下文会优先精确匹配；强身份命中会清理此前遗留的弱事件，阻断“前后歌词互换”及后续持续显示无歌词的扩散。
• 改进曲目身份识别：兼容 LRC 的 [ti]/[ar]、首行“标题 - 歌手”、合作歌手与 feat. 写法，并识别“英文标题（中文译名）”这类文件名/元数据差异，例如 Boulevard of Broken Dreams（碎梦大道）。
• 修复异常 LRC 行：一行内粘连的多个方括号时间标签会拆成正确的独立时间点，避免后续歌词文本和时间轴被合并。
• 修复无空格日语、中文长句的锁屏显示：主歌词现在按 Unicode 字符边界换行，英文仍优先按词换行，并遵守常见 CJK 标点禁则，避免整句被压缩成过小字号。
• ConePlayer 的已选音轨元数据来源明确标记为当前曲目来源；Salt Player 保持“下一次稳定元数据”关联语义，两个适配器共享同一套事务保护。

兼容性与升级

• 适用于 Salt Player、ConePlayer 和通过公开 lyricInfo 协议接入的播放器；事务关联规则由来源能力决定，不再以播放器包名分叉。
• 安装升级后通常无需重启手机：请重启目标播放器进程和系统界面，使播放器与 SystemUI 中的 Hook 重新加载。若同时修改了 LSPosed 作用域，或需要验证 system 中的 OPlus 历史播放器能力，请重启设备。

验证

• 单元测试覆盖无歌词夹在有歌词曲目之间、重复回调、延迟回调、强身份同步屏障、译名标题匹配、粘连时间标签，以及日语/CJK 自动换行与标点边界。
• 发布前执行 testDebugUnitTest、lintDebug、assembleDebug 和 assembleRelease。

更新内容

• 修复极端快速切歌时歌词跨曲错绑：当播放顺序为“有歌词 A -> 无歌词 B -> 有歌词 C”且切换很快时，不再把 C 的歌词错误绑定到 B，也不会让 C 继续沿用空歌词状态。
• 重构 ColorOS 媒体 action 接入：保留播放器原始 PlaybackState action 顺序，仅在 OPlus Rule0 展示列表中提升翻译按钮，修复翻译按钮重复、上一首/下一首错位及媒体卡片控制按钮被带乱的问题。
• 翻译按钮扩展到所有内置适配器及公开 lyricInfo 协议播放器；外部播放器被动态识别后会刷新 OPlus Rule0，不再因 SystemUI 初始化时序较早而永久错过按钮。
• 修复 Salt Player 完全停止后无法从 ColorOS 控制中心恢复播放的问题：模块会处理播放媒体按键、启动 MusicService、延迟发送 com.salt.music.play_or_pause，并通过防抖避免重复广播造成二次触发。
• 增加 OPlus 历史播放器接入：所有内置 PlayerAdapter 自动放行；外部播放器可在 Manifest 声明 io.github.andrealtb.lockscreenlyrics.OPLUS_MEDIA_HISTORY=true。不再要求手工修改 Multimedia_Daemon_List.xml。
• 修复 ConePlayer 冷启动恢复播放后没有歌词的问题：从 Media3 已选中音轨的 Format.metadata 提取 LYRICS、USLT 等时间轴歌词，并过滤“暂无歌词”“No lyrics”“纯音乐”等占位内容。
• 补充播放器接入文档、后台恢复注意事项及 ConePlayer 服务级歌词来源说明。

兼容性说明

• OPlus 历史播放器能力需要模块作用于系统框架（system）；升级后请确认 LSPosed 作用域包含系统框架、系统界面和需要进程内适配的播放器。
• 外部播放器的历史卡片声明只负责通过 OPlus 历史播放器判断。播放器仍需自行实现有效的 MediaSession、媒体按键接收、后台服务启动及播放队列恢复。
• 翻译按钮不会改变播放器原始媒体 action 的语义顺序；快速切歌时即使翻译按钮暂时等待刷新，也不会占用上一首、播放/暂停或下一首槽位。

验证

• 单元测试覆盖歌词跨曲重放保护、完整曲目标识绑定、OPlus 历史播放器策略、防抖逻辑和 ConePlayer 音轨元数据提取。
• 发布前执行 testDebugUnitTest、assembleDebug、lintDebug 和 assembleRelease。

升级提示

安装 v1.8.0 后请在 LSPosed 中确认模块已勾选目标播放器、系统界面与系统框架（system），随后重启设备，确保 SystemUI 与 system_server Hook 完整加载。

更新内容

• 修复部分 Salt Player 构建未发布旧桌面歌词 action 时，ColorOS 锁屏歌词翻译按钮始终不出现的问题；模块现在会向媒体会话播放状态注入公开翻译开关 action。
• 屏幕超时保活改为 15 秒 SCREEN_BRIGHT_WAKE_LOCK 租约，并在保活期间按 8 秒节奏续租与发送 userActivity，避免自然超时后进入降亮/AOD。
• 保活证据改为以最近可见的官方锁屏歌词 TextView 为主，刚收到的歌词模型或官方歌词元数据只保留 3 秒过渡窗口，避免播放器异常退出或 OPlus Adapter 未清理时旧模型继续保活。
• ACTION_USER_PRESENT 后增加 Keyguard 延迟复核：人脸识别成功但仍停留在锁屏歌词页时会恢复保活，真正离开锁屏后立即释放。
• Release workflow 新增 LSPosed/Xposed 模块仓库同步步骤，发版 APK 会同步发布到 Xposed-Modules-Repo/io.github.andrealtb.lockscreenlyrics。

验证

• 本地已验证 testDebugUnitTest、assembleDebug、lintDebug。
• 继续保留既有歌词布局、逐字绘制、切歌淡入、翻译识别与翻译按钮恢复逻辑。

升级提示

安装后请在 LSPosed 中确认模块已勾选目标播放器与系统界面，然后重启播放器进程和系统界面；如果刚从旧版升级，建议直接重启设备以确保新版 SystemUI Hook 与屏幕超时策略完整生效。

更新内容

• 新增播放器无关的歌词会话规约器，将异步歌词回调与稳定曲目信息绑定，避免切歌期间把新歌词写入上一首歌曲；同时兼容 Salt Player 的状态栏/车载歌词转发元数据。
• SystemUI 私有媒体与歌词入口改用 DexKit 动态识别，并保留旧类名回退路径，降低 ColorOS/OPlus 更新或代码混淆带来的失效风险。
• 在歌词进入 OPlus 官方列表前统一规范化：同一时间戳只保留主歌词 item，翻译与逐字信息继续保留在完整模型中；过滤制作信息、标题歌手行和零宽占位行。
• 修复部分双语 LRC 被解析为“中文主句、英文翻译”的问题，并增加 Opalite 零宽占位行回归测试。
• 改进重复歌词、首行预滚动和官方列表位置映射，使用时间戳、规范化文本与出现顺序共同定位当前句。
• 锁屏歌词采用稳定的 80dp 物理槽位和 6dp 间距；短句视觉密度收紧，长句继续使用两行滑动窗口，当前进度行下移约 48dp。
• 移除按内容动态改变 item 几何的方案，避免每句播放完成时出现挤压、下跳或 RecyclerView 重新测量。
• 改进 Seedling 播放位置同步、歌词界面可见性恢复、切歌淡入恢复和屏幕超时保活状态更新。
• 新增适用于中文路径的本地 Gradle 构建脚本，并补充歌词会话、布局策略、LRC 规范化、曲目身份与双语解析测试。

已验证场景

• Salt Player 不同歌曲连续切换、暂停恢复与进度跳转。
• 连续短句、长句、翻译行、重复副歌和双语同时间戳歌词。
• Opalite 中零宽占位行紧邻同时间戳中英歌词的解析场景。
• 翻译按钮、锁屏超时保活与切歌歌词渐变在播放器重启后的正常恢复。

升级提示

安装后请在 LSPosed 中确认模块已勾选目标播放器与系统界面，然后重启播放器进程和系统界面；建议直接重启设备以确保新版 SystemUI Hook 与 DexKit 缓存完整生效。

更新内容

• 新增 ConePlayer 适配，支持正式版与 Google Play 版，并已跨版本验证 1.1.3、1.1.4 和 1.1.5。
• ConePlayer 歌词解析入口改由 DexKit 动态识别，不依赖混淆类名；兼容单参数与双参数解析方法。
• 为未主动提供翻译动作的播放器补充翻译开关，同时保留收藏等已有自定义动作。
• Salt Player 适配器迁移到 DexKit，通过歌词来源枚举、滚动状态枚举和结果类结构动态定位，已验证 12.0.0 正式版与 alpha07。
• 调整 lyricInfo 数据优先级：播放器主动增强接入优先，其次使用模块捕获的完整歌词，播放器官方简单 lyricInfo 仅作为兜底。

作用域变化

• 新增 ink.trantor.coneplayer。
• 新增 ink.trantor.coneplayer.gp。
• 保持 com.salt.music 与 com.android.systemui 支持。

升级提示

安装后请在 LSPosed 中确认模块已勾选对应播放器与系统界面，然后重启相关播放器进程和系统界面；若首次安装，建议直接重启设备。

更新内容

• 修复歌词正文存在重复句时，当前句可能无法进入逐字渲染的问题；现在会优先匹配实际播放位置对应的重复句。
• 修复接入公开翻译开关协议的播放器中，ColorOS Rule0 误把“上一首”显示为翻译按钮的问题。
• 将翻译动作提升到 Rule0 自定义动作首位，同时保留上一首、播放/暂停和下一首的原有位置与行为。
• 增加重复歌词匹配和翻译动作排序的回归测试。

播放器接入

• 继续使用公开动作 io.github.andrealtb.lockscreenlyrics.action.TOGGLE_TRANSLATION，协议本身没有变化。
• 已接入该动作的播放器无需修改即可获得本次按钮排序修复。

升级提示

安装后请在 LSPosed 中确认模块作用域，并重启系统界面或设备，使新版 SystemUI Hook 生效。

更新内容

• 在保持歌词槽高固定的前提下，将官方歌词行间距收紧至 6dp，避免动态高度引起滚动抖动。
• 无翻译歌词使用更大的 24sp 字号和均衡换行，按内容显示 2–3 行并保持垂直居中。
• 过长翻译会随当前歌词进度横向滚动，减少文字超出屏幕边界的问题。
• 翻译按钮仅在当前歌曲含可用翻译时显示。
• 优化关闭翻译时从“2 行歌词 + 1 行翻译”过渡到“3 行歌词”的补行动画。

播放器接入

• 新增公开动作 io.github.andrealtb.lockscreenlyrics.action.TOGGLE_TRANSLATION，主动接入 lyricInfo 的播放器可提供锁屏翻译开关。
• 自动为外部歌词提供方配置 OPlus Rule0 自定义动作槽位。
• 播放器包内存在 ic_translation 时优先使用；否则自动采用模块内置的透明背景、单色 Salt 风格翻译图标。
• 中英文播放器接入文档已补充动作顺序、图标及生命周期要求。

升级提示

安装后请在 LSPosed 中确认模块作用域，并重启系统界面或设备。

更新内容

• 引入 Lyrics Core 解析适配层，增强多种时间轴歌词、逐字时序和同时间戳双语歌词兼容性。
• 新增按曲目缓存与标准化身份匹配，兼容 [Explicit] / [Clean] 后缀及歌词早于媒体元数据到达的情况。
• 完善锁屏逐字渲染：当前词辉光、焦点过渡、双语排版、长句窗口和可持久保存的翻译开关。
• 优化切歌衔接，避免闪回官方歌词，并修复行重绑与淡入重复触发造成的 RenderNode 录制异常。
• 加强首次沉浸界面进入、延迟歌词行绑定、屏幕保活和 OPlus 媒体策略兼容性。
• 清理未启用的实验钩子与 fallback，减少 SystemUI 全局热路径开销。
• 更新播放器接入文档：首次元数据应原子携带完整 lyricInfo，避免紧邻 extras 补丁被 OPlus 防抖丢弃。

验证

• 真机回归测试通过
• JUnit：7/7
• Android Lint：通过
• GitHub Debug 与签名 Release 构建：通过

构建版本：versionName 1.5.0 / versionCode 57

更新内容

• 提高逐字歌词对比度

更新内容

• 优化逐字歌词表现

更新内容

• 新增播放器主动接入协议：播放器可直接通过 MediaSession lyricInfo 发布歌词，模块会在 SystemUI 侧动态识别，无需加入包名适配器或 LSPosed 播放器作用域。
• 支持 lyric 基础逐行歌词接入；可选 rawLyric 用于启用模块的逐字高亮渲染。
• 保留 Salt Player 兼容适配器，其他新播放器推荐优先走 lyricInfo 接入协议。
• 修复 Salt Player 12.0.0 新版本 hook 失效问题，兼容新版混淆类变化。
• 优化 Salt 歌词抓取逻辑，自动识别构造器参数中的时间轴歌词，降低版本变动导致失效的概率。
• 更新中英文接入文档，补充播放器接入方式和推荐发布时机。
• 去除SystemUI侧包名白名单。[测试]