听屿 1.5.24 · 洛雪音源管理完善

听屿 1.5.24 · 洛雪音源管理完善

这是洛雪自定义音源管理界面的预发布版本，应用版本 1.5.24 / versionCode 239。保留听屿现有 Media3 播放器、底部导航、极简歌词、歌词舞台与封面动画。

本次变化

• 洛雪音源弹窗改为“更新与来源、已安装音源、播放与换源设置、诊断日志”四段式布局；修复标题遮挡与内容裁切，移动端可独立滚动。
• 音质、自动降级、自动换源改用标准开关和下拉框，平台名称改为中文，不再用大块文字按钮表示开关。
• 本地导入的音源可绑定公网更新地址；支持检查更新、安装更新和回退到上一版。下载失败、服务器错误或脚本校验失败时保留当前版本。
• Android 原生洛雪管理页同步支持来源选择、更新地址、检查与安装更新、回退及播放策略，与网页管理入口保持一致。
• 继续保留已有的 URL/文件导入、启用/停用/删除、多音源选择、有限重试、音质降级、前台跨平台匹配、诊断日志与敏感信息脱敏。

登录与更新说明

平台账号继续使用听屿现有登录体系。官方洛雪 Android 自定义源协议没有通用的“音源登录”接口；需要独立登录或 Token 的音源，应依据该音源作者提供的真实认证协议单独适配。听屿不会自动把平台 Cookie 转发给自定义脚本。

更新检测目前是用户在音源详情中手动触发，不轮询主页猜测下载地址，也没有后台更新通知。

下载

• Tingyu-1.5.24-lx-layout.apk：同签名安装包，可覆盖 1.5.23；SHA-256 e06a84dac1f221481e86272ba032a972f1def22aee52db91259e2119db45a230。
• Tingyu-1.5.24-lx-layout-source.zip：提交 dc87cde6fee0c376b249c0d010e75a1c2ac98b2f 的完整应用源码；SHA-256 260b396b2428969abd87007b1c503ef23f4f5d36a035cd3098a5884f0743aba7。
• LX-MOBILE-COMPATIBILITY.md：官方协议矩阵、功能对照、缺陷位置和验证边界。
• verification.json / SHA256SUMS.txt：构建、测试、源码和安装包校验记录。

验证结果

• 类型检查与主题一致性检查通过。
• 前端/逻辑测试 154 项通过，覆盖 19 个测试文件。
• Android 原生单元测试 1315 项通过，0 失败、0 错误、0 跳过。
• Playwright 2 项通过：URL 导入、启用、策略修改、更新、回退与删除；无效地址和下载失败保留已安装音源。
• APK 版本、包名、v2/v3 签名和非调试属性通过检查；2034 个包内 Web 资源与 dist 逐文件哈希一致。
• 源码归档的 4359 个文件与提交逐项核对一致，未包含签名密钥。

未验证与已知边界

• 本次未连接 Android 真机或模拟器，未执行真实安装、实际播放、暂停/恢复、拖动、连续切歌和后台音频验证。
• 未使用用户复现音源与官方洛雪 Android App 做同脚本、同歌曲、同音质对照，因此不声明“完整兼容”。
• 原生同步 CPU 死循环的强制中断、完整异步回调时序、后台独立跨平台匹配、二进制文件 multipart、后台更新通知仍未完成。
• 音源声明和协商到的档位不等于已核实真实编码；界面不据此直接宣称无损或 Hi-Res。

本版本为预发布，不替换当前稳定版 v1.5.23。

听屿 1.5.29 音质切换修复（验收预览）

修复音质、音效及音源工具错误依赖极简页会话，导致从歌词舞台等页面打开后点击无响应的问题。工具页开关与操作复用宿主动作通道。移除音质面板中的洛雪自定义音源入口，保留设置页管理入口。补充未执行提示、切歌后旧结果保护及音质切换诊断事件。

验证：54 项前端定向测试、类型检查、2 项 Robolectric 测试通过（含各主题检查）；Release 构建、APK v2/v3 签名校验通过。未连接真机，真实账号及歌曲切换需安装验证。日志中的上游 403 属于独立访问失败，本次不声称已修复该资源问题。

附件含安装包、对应源码、修复记录和 SHA256。源码提交：35a36f965920d304766e36611c62c6dc8d46de43

听屿 1.5.28 歌词舞台显示范围修复（验收预览）

自动隐藏系统栏仅在歌词舞台生效，极简封面及歌词页保持显示。常亮分为歌词舞台屏幕常亮、极简歌词页常亮，并按实际页面分别释放。舞台横屏打开设置及其他页面后恢复竖屏，防止旧横屏请求回写。保留原设置值。

类型检查、28 项前端定向测试、18 项页面归属检查、11 项原生方向测试及 1 项 Robolectric 常亮测试通过。Release 构建和 APK 签名校验通过。当前未连接真机，厂商旋转和系统栏实际表现仍需安装验收。

源码与测试记录：tingyu-android/docs/STAGE-DISPLAY-1.5.28.md
SHA256: 2b0606eb1db0c92df822d4b424c4223b1dabba0002ce7b6f4750d82229dfc1b8

听屿 1.5.27 推荐卡浏览修复（验收预览）

推荐卡改为轻量的“查看歌曲 ›”，去掉胶囊边框与底色，和说明左对齐。修复猜你喜欢底层直接播放分支，先打开推荐歌曲列表，点击歌曲或播放全部后才播放，并保留私人电台续歌。

类型检查、71 项定向测试、原生 Compose 截图/对齐/点击测试通过；Release 构建与 APK 签名校验通过。未连接真机或访问真实用户 QQ 会话，真实推荐及续歌仍待验收。

记录：tingyu-android/docs/HOME-BROWSE-1.5.27.md
SHA256: 2a0b40791686d215eb576f50dc07eeeb501a07d8e88bdcd65b490d0211fa9021

听屿 1.5.26 恢复雾笺玻璃字迹（验收预览）

移除背屏字迹的固定灰白填色和不透明度增强，恢复擦开雾气后透出窗外的玻璃书写效果。保留缩小水滴、减弱折射和笔画附近减少透镜覆盖。

32 项定向单测、2 项 WebGL 浏览器测试通过；截图已检查；Android Release 构建及 APK 签名校验通过。真实背屏效果仍待复验。

源码记录：tingyu-android/docs/NEBBIA-GLASS-1.5.26.md
SHA256: 2541dfdd3ccb83979b991a1444b5cbc4fbe29ec089ce29f0f69d7ef2f7617c27

听屿 1.5.25 背屏与桌面歌词优化（验收预览）

背屏显示隔离、雾笺字迹保护、推荐卡先浏览、桌面长句滚动与左右分离、右上角横排图标。

Android 全量 1346 项、最终定向 37 项、前端单测 37 项、浏览器 WebGL 2 项通过；Release 构建和签名校验通过。无连接手机，真实 Shizuku 迁移与悬浮窗交互待验收。

报告：tingyu-android/docs/LYRICS-AND-HOME-1.5.25.md。SHA256: 5BD72F5EB0E98477DBBD4137EFF05D2E3151BB7AEB46CF684DC9C8FBDF7A0914

听屿 1.5.24 悬浮窗初始化修复

修复桌面歌词在播放 Service 中直接创建 WindowContext 导致 UnsupportedOperationException。改为先绑定主屏，再创建窗口。API 30/31/34 服务路径回归及歌词定向测试 27 项通过；Release 构建通过。用户 Android API 37 实际窗口显示仍待复验。覆盖安装后重新开启桌面歌词即可，无需清除数据。

听屿 1.5.24 桌面与车载歌词验收预览

新增原生桌面悬浮歌词、共享歌词投影、实验性 A2DP 歌词标题模式（默认关闭）。

Android 单元回归 1339 项通过，前端定向测试 101 项通过，类型检查和 Release 构建/签名校验通过。

没有连接真实 Android 设备或车机，悬浮权限、后台、蓝牙路由与车机显示尚待实测。兼容 WebView 事件停止后最多外推 4 秒。

源码与验收记录：tingyu-android/docs/ANDROID-LYRICS-OUTPUT-VALIDATION.md。APK SHA256: D1953BF07B74AA9DC886FC8D4F8DBC2158CC797B82E9651F39089B7820C180AF

听屿 1.5.23 · 歌单返回位置、网易云试听误判、锁屏背屏与下拉框

听屿 1.5.23（versionCode 238）

• 修复歌单页从底部播放器进入歌词页再返回时会跳回顶部的问题：只有排序、筛选或歌单内搜索真正变化时才回到首行。
• 修复网易云部分歌曲被误判为「仅返回试听片段」：每档音质按自身格式请求，试听片段降为兜底。
• 修复 Shizuku 模式锁屏后背屏歌词被系统背屏桌面盖住、无法恢复的问题：窗口不可见时改走迁移路径。
• 修复经典深色模式下搜索音源、排序与筛选下拉框文字不可见：弹层统一使用弹层专用配色。

检查：类型/主题通过，前端单测 7586 项通过（2 项原有跳过），定向单测 16 项通过，相关浏览器回归 10 项通过，原生单测 1311 项通过；正式 Web 重建、资产同步、Android 签名构建与 2033 个包内 Web 资产逐个哈希核验通过。

未连接 Android 真机：实际安装、小米背屏摄像头边缘、LSP/Shizuku、冷启动、触摸、锁屏/后台、GPU 帧率/功耗及音频切歌延迟需安装后复测。

包名：�0io.github.huleixin.tingyu�0；versionCode：�0238�0。
Build ID：�01.5.23@7b99ecd�0；构建源码：�07b99ecd199efae46279135a798ba49948ba06e8b�0。
源码归档提交：�07b99ecd199efae46279135a798ba49948ba06e8b�0（构建后仅补录报告，代码与安装包一致）。
沿用此前正式签名，可覆盖安装同签名旧版。
APK SHA-256：�08cccf7704e8b06a7d3b714c1b39e083a3ca476e950d5d031251644a96c0137e7�0

详见随附 FOLIA_ANDROID_MERGE_REPORT.md 和 verification.json。P1 功能仍暂缓。

听屿 1.5.23 · 洛雪兼容性专项审阅版

本版本为洛雪 Android 自定义源兼容性专项的审阅预发布版本，并非“完整兼容”验收版。

包含移动版事件/Promise、RSA/AES 参数、HTTP 响应类型与真实取消、歌曲身份传递、源更新与缓存隔离等修复；增加 URL 导入、更新回退、音质降级、有限重试、来源策略和诊断入口。保留现有 Media3、原生播放器与歌词界面架构。

下载

• Tingyu-1.5.23-lx-review.apk：已验证的签名安装包，应用版本 1.5.23 / 238。
• Tingyu-1.5.23-lx-review-source.zip：提交 9cbad0b54a0378a1f7bb244a7975d0062c9b4801 的完整应用源码归档。
• Tingyu-lx-changes.zip：63 个改动文件及逐文件校验清单。
• LX-MOBILE-COMPATIBILITY.md：官方协议矩阵、功能对照、缺陷位置与剩余事项。
• verification.json / SHA256SUMS.txt：验证记录与文件校验值。

APK 保持上一轮测试过的文件，未重新构建；构建时基于 7b99ecd199efae46279135a798ba49948ba06e8b 的未提交工作区。已逐个确认发布提交中的 63 个改动文件与构建工作区相同，仅允许 Git 换行规范化差异。

已执行验证

• 类型检查通过；前端/逻辑测试 152 项。
• Android 原生单元测试 1315 项；QuickJS JVM 协议断言 13 项；HTTP 传输测试 13 项。
• Playwright 管理流程、更新回退与 WASM 死循环脚本隔离通过。
• APK 签名通过；2035 个 Web 文件与构建产物逐一核验一致。

尚未完成 / 未验证

尚未连接 Android 真机或模拟器，没有用户复现音源与授权歌曲的官方 App 对照，未验证实际播放。原生同步 CPU 死循环硬中断、完整异步回调时序、后台独立跨平台匹配、二进制文件 multipart 等仍有缺口，完整范围见审计报告。

本预发布版本保留这些验证边界，不替换当前稳定 Release。