NeriPlayer 更新日志
更新时间：2026-03-12
更新类型：本地媒体支持升级 + 同步一致性重构 + 播放恢复与 UI 稳定性优化
一、 本地媒体与歌单系统升级
- 全面接入本地媒体能力
- 新增共享音频导入能力，支持从外部分享或文件入口将音频直接导入播放器。
- 完善本地媒体扫描链路，增强本地歌曲、专辑与歌单的数据接入能力。
- 新增系统级本地歌单支持，包括「我喜欢的音乐」与「本地文件」等系统歌单的统一管理。
- 本地元数据提取增强
- 强化本地音频元数据解析能力，补齐标题、歌手、专辑、时长、封面等信息提取。
- 新增本地歌曲专辑展示兼容层，优化本地歌曲在歌单页、播放页和同步数据中的显示一致性。
- 修复部分“扫描成功但展示异常”或“本地歌曲可见但播放不稳定”的问题，提高本地媒体可用性。
- 歌单身份与模型一致性修复
- 引入更稳定的歌单身份识别逻辑，避免系统歌单因名称变化、语言切换或来源差异被错误识别为不同歌单。
- 修复歌单键、缓存键、播放列表 identity 与同步模型之间的不一致问题。
- 新增
SystemPlaylistIdentityTest与本地媒体 identity 相关测试，补强系统歌单和本地媒体身份判断的回归覆盖。
二、 同步与数据一致性重构
- GitHub 同步链路增强
- 重构同步数据模型与序列化逻辑，提升歌单、歌曲和元数据在本地与远端之间的同步稳定性。
- 优化同步 Worker、封面 URL 映射与安全存储逻辑，减少同步重复写入和字段丢失的概率。
- 改进备份/恢复与同步流程之间的协同，降低旧数据升级后的异常风险。
- 用户数据保护与元数据一致性提升
- 统一歌曲模型扩展与元数据更新路径，降低手动编辑歌曲信息、封面、歌词等内容被意外覆盖的风险。
- 安全集成 PR #45 的 QQ 音乐歌词翻译获取。
- 持续收敛缓存键、歌单键与同步模型实现，提升后续维护可读性与一致性。
三、 播放器核心与后台恢复增强
- 播放状态持久化与恢复能力提升
- 重构
PlayerManager与AudioPlayerService的部分状态管理逻辑，增强播放队列、当前位置、媒体 URL 与恢复意图的持久化能力。 - 优化进程重启后的播放恢复路径，在系统允许的前提下尽量恢复播放上下文。
- 修复本地播放、切歌、播放队列推进与 Now Playing 状态更新中的多处稳定性问题。
- 在线取流与来源适配优化
- 新增 Bilibili 音频解析能力，强化 B 站音频与分 P 内容的播放接入。
- 支持播放 Bilibili 音乐时自动更新封面与歌词，减少来源切换后的信息滞后。
- 优化网易云取流链路、条件数据源与代理选择逻辑，提高不同网络环境下的稳定性。
- 从 QQ 音乐获取的歌曲信息目前包含中文翻译。 (#45)
- 下载与后台行为协同改进
- 优化下载任务与播放器状态之间的协同，改进下载管理页、下载进度页与播放页之间的联动体验。
- 完善通知、前台服务、睡眠定时器和后台播放链路，减少后台场景下的状态错乱和恢复异常。
四、 正在播放页与全局 UI/UX 优化
- 歌词、封面与过渡体验优化
- 优化歌词页、封面页与来源信息之间的联动显示。
- 新增主题揭示层与背景图存储能力，改善主题切换与视觉过渡的一致性。
- 修复播放页、歌词页与调试布局中的多处显示异常与交互细节问题。
- 全局界面一致性提升
- 优化首页、探索页、设置页、最近播放、歌单详情页与媒体库页面的布局与状态联动。
- 改进语言设置、底栏、Mini Player、最近播放等组件的交互与视觉一致性。
- 增强错误处理与调试入口，提升异常场景下的可诊断性。
- 深浅色切换动画优化
- 目前的深浅色切换动画模仿了 Telegram 的深浅色切换动画
- 尽可能避免应用冷启动时因系统状态导致的闪烁
五、 工程维护与测试补强
- 测试与回归覆盖增强
- 补充
SystemPlaylistIdentityTest、本地元数据兼容测试等用例，提升系统歌单、本地媒体与同步身份判断的回归保障。 - 修复单元测试与调试布局中的问题，提高日常开发验证质量。
- 工程配置与代码清理
- 简化本地 Gradle 缓存相关
.gitignore配置。 - 调整构建与依赖配置，补齐本地媒体、同步与 UI 相关功能所需支持。
- 持续清理冗余代码与不一致实现，为后续维护保留更清晰的结构。
不稳定性警告
- 此版本的改动范围较大，未进行全面测试，需收集用户反馈后持续优化。
- 升级以后可能会导致同步失败，请先备份本地歌单，避免数据丢失。
New Contributors
- @JulyStar-Lv made their first contribution in #45
Full Changelog: NeriPlayer-e7409a0.01160356...NeriPlayer-dd5942c.03120751