Release v0.5.1

更新日志

此次新增了AMLL风格的歌词弹簧滚动效果，同时重构了歌词模糊效果，欢迎反馈bug

Commits

• b3556b5 refactor(settings): 将歌词景深模糊从开关改为强度滑块
• 6804b93 refactor: 移除歌词弹簧动画开关功能
• 8a52c39 build: 应用版本更新至0.5.1+4003
• 2181225 chore(test): 为两个调试测试文件添加注释和忽略lint规则
• edadbf8 ci: 统一从pubspec获取版本号
• ef17f35 fix(player): 修复歌词页竖直滚动误触发页面切换的问题
• b2273e0 refactor(lyric): 调整歌词点击事件的封装逻辑
• fb7a466 feat(lyric): 优化多项歌词动画细节和景深模糊
• 7f4095d feat(lyric): 实现圆点动画锚定逻辑，对齐AMLL间奏圆点动画
• fb97654 refactor(lyric_view): 调整歌词行内圆点槽布局逻辑
• 5d784df refactor(lyric): 重构歌词行布局与呼吸圆点渲染
• 1850fa2 feat(lyric): 更新歌词景深淡出逻辑与测试用例
• 3a133fc style(lyric_line): 修复文件末尾缺少换行符的问题
• 7dc1b41 feat: 实现Apple Music风格歌词弹簧动画系统

Release v0.5.0

更新日志

新增

• 流体动态背景：播放页背景随封面主色实时流动渐变，切换歌曲时平滑过渡，不闪烁
• 封面强调色主题：播放按钮、进度条、歌词高亮等元素自动采用封面的可读强调色；浅色封面自动压暗，保证文字清晰
• 背景节奏律动：背景随音乐进度脉冲，可在设置中独立开关
• 背景帧率设置：三档可选——省电（30fps）/ 均衡（60fps）/ 流畅（跟随屏幕刷新率）
• 暗角效果：优化播放页背景观感，减弱画面边缘压暗强度

优化

• 播放页整体视觉重构，采用深色基调与封面强调色，提升沉浸感

其他

• 完善项目文档与说明（README、开发文档、用户指南）

Commits

• 100c526 ci(github workflows): 修复release.yml中的版本替换和编码问题
• 6c7c181 docs: 更新README文档，补充徽章、能力表格与合规说明
• 3ad8e7b chore: 发布v0.5.0正式版本，更新播放页体验与文档
• 298e797 refactor(fluid_background): 提取色板过渡逻辑为独立方法
• 0704e6b feat(settings, ui): 添加流体背景帧率控制
• 885f2a2 refactor(fluid): 调整律动滤波系数与视觉脉冲效果
• b8fb121 feat(color_readability): 新增过亮高饱和颜色压饱和逻辑，调整明暗阈值
• 8444251 refactor(fluid_background): 为浅色封面添加背景色板压暗逻辑
• c9ca517 feat(shaders): 调整暗角效果的压暗强度
• fd7e4d7 refactor: 移除对比投影功能，改用自适应强调色方案
• 70d1d57 feat(settings/player): 为播放页面元素添加阴影效果
• 64ae37d refactor(player page,shaders): 优化背景显示效果与主题适配
• 68d7dea fix(fluid_background): 修复动画重启首帧delta异常问题
• b4bf8a6 refactor(fluid_background): 实现色板平滑过渡动画，避免切换时闪烁
• 1c1b3ec refactor(fluid_background): 优化流体背景加载体验与性能
• 2e7fc90 feat(settings,shader): 添加流体背景节奏律动功能
• b9460bc refactor(fluid effect): 优化流体背景的着色器与状态管理
• 3b816fc feat: 新增播放页流体动态背景功能
• 33176f4 build: 调整pubspec版本号同步逻辑

Release v0.4.0

更新说明

✨ 新增功能

• 备份与恢复：支持导出和导入设置、播放队列、播放统计、收藏歌曲、最近播放记录。提供合并与覆盖两种恢复模式。
• 播放中断自动恢复：播放过程中遇到网络中断时自动重试，无需手动操作。
• 息屏网络保持：锁屏播放时维持网络连接，减少后台切歌失败。
• 通知栏封面缓存：封面图本地缓存，避免重复下载，加载失败时显示占位图。

🔧 问题修复

• 修复 release 包通知栏不显示播放控制的问题
• 修复通知栏收藏按钮状态偶尔不同步
• 修复全屏播放页封面被小图缓存污染导致模糊
• 修复歌词滚动时手指未松开却突然跳回的问题
• 修复 debug 包与 release 包在最近任务中无法区分的问题
• 修复部分设置项在非安卓平台误显示

⚠️ 备份功能说明

本版本首次支持备份功能。虽已通过自动化测试验证，但备份涉及用户数据安全，建议：

• 首次使用前先导出一份备份，确认文件可正常保存
• 恢复后检查播放队列、收藏、播放统计是否完整
• 如遇问题请及时反馈，以便后续版本改进，避免长期使用后才发现问题造成数据丢失

Commits

• 33349ea build: 更新pubspec.yaml版本至0.4.0+3
• 1253b54 fix: 修复安卓应用最近任务栏显示名称不正确的问题
• 98ea7e3 fix(player_provider): 同步媒体通知栏收藏状态
• 81d8a30 build(android): 优化安卓混淆规则，允许R8优化依赖
• 13b280c chore(android): 移除过时的support包混淆配置
• b4e04f6 build(android): 显式启用代码混淆并添加proguard配置
• 721d0ad fix(backup test): 更新播放统计备份测试的断言匹配内容
• cf7e0ce feat(backup&player): 新增备份美化输出、修复队列恢复与播放统计导入
• db39610 feat(cover-cache): 实现按尺寸分档的封面磁盘缓存
• 3012da9 refactor(audio,settings): 优化封面缓存处理逻辑
• 5c8078b feat(storage,notification): 新增通知栏封面缓存自动清理与页面展示
• a8ffe49 fix: 修复封面加载异常未捕获和歌词缓存逻辑问题
• 566c009 feat(audio-service): 实现通知栏封面本地缓存与占位兜底逻辑
• 7dab082 refactor(player): 重构播放器provider，支持注入假播放器用于测试
• 64b16bf feat: 新增网络失败自愈重试机制，优化播放状态与缓存逻辑
• 87d28fb test: 修复数据库初始化异步调用遗漏的await关键字
• 29d2643 feat(player): 新增播放中断自动恢复逻辑，支持网络IO错误续播
• 59b0235 fix: 修复多个播放器逻辑与测试用例问题
• dfe4ed8 feat: 添加WiFi锁和网络重试自愈，优化弱网后台播放体验
• 931f7b3 feat(backup_page): 适配移动端备份导出逻辑
• dc77091 refactor(backup): 完善备份流程的错误处理
• 8528f4a feat(backup): 实现备份冲突解决弹窗与精细化冲突检测
• 6f3ea42 feat(backup): 新增播放队列备份恢复功能
• bf3b699 fix(backup_page): 修复异步中使用context.read的安全问题
• b5a0d4e ci(test): 优化测试配置与清理逻辑
• 15b7376 refactor(backup): 完善备份恢复后的重载逻辑
• fbdd179 feat: 添加备份与恢复功能
• 6049b64 fix(settings): 仅在安卓平台展示返回行为和触感反馈设置项
• 3932145 refactor(platform): 统一封装平台判断工具类，替换分散的平台检测代码

Release v0.3.0

⚠️ 升级须知

这是一个包含重大更新的版本，无法直接覆盖安装。
为确保最佳体验，请严格遵循以下步骤：

📲 安装指南

由于本版本启用了全新的正式签名机制，您需要先卸载设备上的旧版本应用，然后再安装此版本。

直接覆盖安装会导致安装失败，请不要尝试。

💾 数据迁移

此次版本对本地存储结构进行了重构。应用启动时会自动迁移旧数据，但为确保稳定：

如果您遇到歌单加载失败或封面不显示等问题，请在应用内 “设置 -> 清除缓存” 中手动清理一次，重启后即可恢复正常。

Commits

• 491e244 build: 更新应用版本到0.3.0+2
• b31a533 build: 更新pubspec.yaml版本到0.3.0+1
• b3a01c2 ci: 配置安卓构建签名自动化流程
• 4a9e677 fix(storage): 完善缓存清理逻辑，彻底清除存储文件
• 71f13e8 feat: 添加歌词和封面的磁盘缓存功能
• b9f8576 refactor: 重构缓存目录结构，新增歌词封面缓存与迁移工具
• 21b4f6b build: 更新pubspec.yaml版本号至0.2.0+1
• da46731 feat(player_page): 调整歌曲封面图的加载尺寸
• 57f3ffd fix(test: queue sheet scroll): 调整滚动位置断言的容错公差

Release v0.2.0

此次新增了更新检测功能，但下载需要跳转浏览器下载

Commits

• 025014b ci(github workflows): 修复release脚本中grep命令的错误退出问题
• 510b475 ci(github actions): 为Inno Setup 7添加缓存以加速构建
• 84dbdae ci: 更新github workflows依赖版本
• c87d7f4 ci(github workflows): 更新发布包的显示名称
• 2de63f2 ci(github actions): 过滤发布说明中的完整变更日志行
• 56d8d2a feat(settings): 新增更新渠道选择与 Beta 版更新支持
• f5dc458 refactor( update_dialog ): 重构更新弹窗UI与逻辑
• c396cbd refactor(settings): 替换原生SnackBar为AppToast组件
• 1367102 refactor(settings/about): 整合更新相关控件为统一栏目
• 3c8630b refactor(update_service): 提取版本前缀剥离逻辑为独立方法
• a200c5c feat(settings): 添加启动时检查更新功能
• eee1ef0 feat(settings): 添加更新检查功能

v0.1.0

Full Changelog: https://github.com/QiuQianZzz/FluxWave/commits/v0.1.0

这是FluxWave的第一个版本，已实现在线播放和离线缓存播放基础链路。
会在后续版本支持：

• 下载歌曲
• 本地歌曲播放
• 更新检测
• ……

Commits

• 0e9b690 ci(github workflows): 为gradle添加缓存配置
• bd89208 build(android): 更新gradle版本并注释代理配置
• 27b6cff build(android,ci): 调整Gradle版本和Windows构建流程
• 537e83d refactor(playlist_cache): 重构歌单详情缓存的LRU实现逻辑
• 2ab9ad6 ci(test): 调整测试相关配置优化执行
• c0c108a ci(github workflows): 为CI和release流程添加Java 17配置
• f97e20f build: 添加plugin_platform_interface作为直接开发依赖并配置分析器排除tool目录
• d7a4440 build(windows): 修复打包时的架构适配问题
• f4b85e7 build(ci/windows): 添加github actions工作流和windows安装包配置文件
• 7ab5faf feat: 完成项目基础搭建与核心功能开发
• 4fa26c5 feat: 初始化Flutter项目，添加Android和Windows平台配置文件及基础代码