Repository navigation
Releases: crazypig321/musicfreeOH
Releases · crazypig321/musicfreeOH
Release list
版本: 3.1.5
🚀 升级说明
📦 3.1.5（从 3.1.4 升级）
✨ 新增功能
✨ 半模态沉浸光感材质
- 全部半模态弹层（播放队列、歌曲操作、插件详情 / 导入 / 排序、订阅源详情 / 编辑 / 导入、歌单创建 / 编辑 / 排序 / 导入、下载管理、搜索、均衡器、音效、更新日志等）接入系统沉浸式光感材质，弹层背景更通透
- API 26 以下设备自动回退原有样式，不影响使用
🐛 问题修复
- 修复搜索页插件标签横向列表滚动位置偶发回顶的问题：标题栏配置缓存复用，避免搜索过程中标题栏插槽反复卸载重建；列表重挂后自动恢复之前的横向偏移；标签数据无变化时跳过刷新
⚡ 优化与调整
| 项 | 说明 |
|---|---|
| 🎨 弹层顶部样式统一（插件页 / 订阅源页） | 标题固定在弹层顶部不随内容滚动，内容区自动避让，PC 自由窗口模式下避让系统关闭按钮 |
| 📜 弹层内列表底部避让 | 列表底部预留滚动空间，最后一项可完整滚出；上拉先展开半模态再滚动列表，下滑先滚回列表顶部再收起（与播放队列一致） |
| 🌫️ 背景模糊调整 | 弹层弹出时页面背景模糊强度减弱，观感更通透 |
📥 升级方式：进入「设置 → 关于 → 检查更新」自动下载，或前往 Releases 手动下载安装包。
版本: 3.1.4
🚀 升级说明
📦 3.1.4（从 3.1.3 升级）
✨ 新增功能
👤 「我的」页面
新增「我的」主 tab（位于歌单与插件之间），个人听歌数据与乐库一览
| 模块 | 说明 |
|---|---|
| 📚 我的乐库卡片 | 收藏歌曲 / 我的歌单 / 订阅歌单 / 插件 / 订阅源数量一览，进入页面自动刷新 |
| 📊 听歌数据卡 | 累计收听时长 / 累计播放 / 听过 / 本周在听四项统计 + 「最近常听」TOP5 垂直柱状图（取最近 50 条播放记录，按播放次数排序） |
| 🕘 最近收听列表 | 支持按歌名 / 歌手 / 专辑搜索过滤、一键全部播放、左滑删除（弹窗确认）与清空播放记录 |
| ☑️ 批量操作 | 长按歌曲或头部图标进入批量模式，支持 全选 / 下一首播放 / 换源 / 添加到歌单 / 下载，返回键一键退出 |
| ⚡ 快捷入口 | 右上角菜单新增 本地音乐、下载管理 快捷入口；标题副文本显示累计收听时长 |
⏱️ 真实收听时长统计
- 收听时长按播放状态与倍速真实累计（暂停不计、倍速按倍率折算），每 10 秒或切歌时自动结算，为听歌数据卡提供依据
🐛 问题修复
- 修复缓存音频命中不对导致播放错误歌曲（串台）的问题：
- 缓存键补充音质维度，同一歌曲的不同音质不再共用同一缓存条目
- 空 ID / 异常条目不再参与缓存命中
- 上游地址或请求头变化时自动失效旧缓存
- 下载与播放缓存代数隔离，互不串扰
📥 升级方式：进入「设置 → 关于 → 检查更新」自动下载，或前往 Releases 手动下载安装包。
版本: 3.1.3 紧急修复
🚀 升级说明
📦 3.1.3（从 3.1.1 升级）紧急修复缓存音频问题，建议安装3.1.2的更新3.1.3
✨ 新增功能
🌐 音频缓存代理
播放流经本地 HTTP 代理边下边缓存到磁盘，再次播放同一 URL 直接命中本地缓存无需联网；缓存受「音乐缓存上限」限制，超限按最近访问时间 LRU 淘汰（正在播放的条目不淘汰）
| 特性 | 说明 |
|---|---|
| ⚡ 渐进回包 | 边下载边向播放器推送数据，首块 64KB 快速起播、后续 512KB 大粒度减少请求往返；seek 到未下载区时等待至多 2s 后回当前已有数据 |
| 🔑 请求头透传 | 插件要求的自定义请求头（Cookie / Referer / User-Agent 等）经 base64 编码进代理 URL 查询参数，代理解码后转发上游 |
| 🧹 自动清扫 | 启动时自动清扫上次中断的 .tmp 临时文件并修正索引与目录一致性；退出时关闭代理 server 释放端口 |
⚡ 优化与调整
- 缓存页「音乐缓存上限」从输入对话框改为菜单选择（256MB / 512MB / 1GB / 2GB / 4GB / 8GB），当前值带勾选标记，并适配智感握姿左手镜像
- 缓存代理性能优化：索引落盘 5s 防抖减少高频命中时的磁盘 IO，复用
TextEncoder实例减少对象创建与 GC，发送缓冲区增大至 256KB 减少系统调用次数 - 优化音频打断机制
- 优化播放加载显示
📥 升级方式：进入「设置 → 关于 → 检查更新」自动下载，或前往 Releases 手动下载安装包。
版本: 3.1.1
🚀 升级说明
📦 3.1.1（从 3.1.0 升级）
✨ 新增功能
| 功能 | 说明 |
|---|---|
| 💗 心动模式 | 首页右上角新增「心动模式」按钮，基于最近播放历史生成专属歌单——按「越近播放权重越高 × 播放次数」提取歌手 / 专辑 / 平台偏好，从收藏、用户歌单、本地音乐与已下载中匹配相似风格歌曲立即开播（单歌手限量保证多样性）；随后自动通过插件并发拉取常听歌手的线上作品补充进播放队列（优先使用你听该歌手时实际使用的插件，超时静默降级不打断播放） |
| 🎵 歌曲级心动入口 | 歌曲操作菜单新增「心动模式」（「加入播放队列」旁），以当前歌曲为种子、播放历史为偏好背景生成心动歌单 |
| 📳 网络歌曲跨设备直达播放 | 网络歌曲分享从纯文本升级为 .mfsong 专属类型文件，经华为分享发送到另一台鸿蒙设备后，装有本应用的接收端点开文件即可播放：装有相同插件时按歌曲 ID 一步直达播放；未安装插件时自动进入搜索页按「歌名 + 歌手」搜索匹配，结果点击即播 |
⚡ 优化与调整
- 播放历史新增播放次数与最近播放时间统计（旧数据完全兼容），为心动模式提供偏好依据
📥 升级方式：进入「设置 → 关于 → 检查更新」自动下载，或前往 Releases 手动下载安装包。
版本: 3.1.0
🚀 升级说明
📦 3.1.0（从 3.0.3 升级）
✨ 新增功能
| 功能 | 说明 |
|---|---|
| 🔄 原版 MusicFree 备份恢复 | 备份与恢复页本地「恢复」与 WebDAV「从 WebDAV 恢复」自动识别原版 MusicFree 备份并转换后合并恢复，无需手动转换；歌单按标题合并、原版默认歌单自动映射到「我的收藏」，插件、订阅源、设置一键迁移 |
| 📦 本地插件源码内嵌备份 | 无 srcUrl 的本地导入插件源码随备份内嵌导出（pluginFiles 字段），换设备恢复时自动重新安装并按哈希去重；禁用插件一并备份；单个插件安装失败仅记录日志，不中断其余数据恢复 |
| 🗂️ WebDAV 多文件备份 | 每次备份生成独立文件 musicfree-backup_yyyyMMdd_HHmmss_设备名.json（时间戳 + 鸿蒙设备名），不再覆盖旧备份；旧版固定文件名 musicfree-backup.json 仍可识别与恢复 |
| 📋 WebDAV 恢复选择备份文件 | 恢复时拉取远端备份列表弹窗展示，每条显示备份时间、设备名、文件名与大小，单选后点「确认」恢复，不再恢复未知内容 |
| 🧹 WebDAV 备份保留数量 | WebDAV 页新增「备份保留数量」设置（1-50，默认 10），每次备份完成后自动删除超出数量的最老备份；退出时自动备份同样生效；旧版固定文件名不参与清理 |
| 🗑️ 清空所有数据 | 缓存页新增「应用数据 → 清空所有数据」入口，弹窗确认后清空全部 KV 存储、插件脚本、订阅源文件、本地歌词缓存与沙箱缓存，并自动重启应用；公共下载目录中已下载的音乐文件属用户文件，不删除 |
🐛 问题修复
- 修复恢复备份（含订阅源数据）后订阅源列表不显示、需重启应用才能看到的问题：订阅源页为底部常驻 Tab，生命周期仅执行一次，现切回该 Tab 时自动重新读取列表
📥 升级方式：进入「设置 → 关于 → 检查更新」自动下载，或前往 Releases 手动下载安装包。
版本: 3.0.3
🚀 升级说明
📦 3.0.3（从 3.0.2 升级）
✨ 新增功能
🎚️ 均衡器保存自定义预设
- 均衡器面板「恢复默认」旁新增「保存」按钮，可将当前调节好的 10 段增益保存为命名预设
- 已保存预设以列表形式展示（懒加载），点击列表项应用该预设，右侧「编辑」可改名、「删除」可移除
- 当前增益与某预设完全一致时该条目主题色高亮
🐛 问题修复
- 修复下载高品质格式音频时文件扩展名被误判为 mp3 的问题：部分音源返回的音频 URL 带 query string，ArkTS 正则引擎对无锚点分支匹配失败导致扩展名提取回退为 mp3（实际下载的音频流正确，仅文件名后缀错误）；改用纯字符串解析提取扩展名，与原版行为一致
📥 升级方式：进入「设置 → 关于 → 检查更新」自动下载，或前往 Releases 手动下载安装包。
版本: 3.0.2
版本: 3.0.0
🚀 升级说明
📦 3.0.1（从 2.9.0 升级）
✨ 新增功能
🌟 歌词逐字扫光动画
- 播放页歌词按词级时间轴逐字点亮，长句自动按显示行切分、多行依次点亮
- 逐帧渲染跟随屏幕刷新率，播放进度平滑外推，切行滚动带弹簧动画
- 翻译显示、上下渐隐、滑动 seek 与字号调节均保留
🐛 问题修复
- 修复未下载（未保存
.lrc文件）的歌词每次播放都要重新联网匹配的问题：自动匹配成功后即缓存歌词与翻译，再次播放直接命中，不再重复请求音源 - 修复部分插件订阅歌单后，重启歌单内部变空问题
⚡ 优化与调整
- PC / 平板自由窗口模式 UI 优化：隐藏系统标题栏，应用标题栏与窗口合一，空白区域可直接拖拽移动窗口；右上角系统最小化 / 最大化 / 关闭按钮下沉到页面内并自动避让；侧边栏搜索入口统一移至顶部标题栏
- 所有弹层（菜单、面板、选项等）在 PC 模式下居中显示
- 完善播放页面底部功能按钮的转场动画，使其更符合视觉逻辑
📥 升级方式：进入「设置 → 关于 → 检查更新」自动下载，或前往 Releases 手动下载安装包。
版本: 2.9.0
🚀 升级说明
📦 2.9.0（从 2.8.1 升级，接下来更新节奏会放缓）
✨ 新增功能
| 功能 | 说明 |
|---|---|
| 📝 下载歌词保存翻译 | 播放页「下载歌词」时，歌词翻译一并保存为音频同目录同名 .tran.lrc 文件并立即生效；本地音乐重新扫描导入时自动恢复翻译显示；当前歌词无翻译时自动清除旧的翻译文件，避免残留误显示 |
| 🖼️ 下载歌曲写入内嵌封面 | 设置 → 缓存管理「匹配封面后写入音频文件」开关开启时，下载歌曲完成后自动把插件提供的封面静默写入音频文件内嵌标签（后台异步执行，不拖慢下载管线）；封面缺失 / 解码失败 / 正在播放 / 文件不可写等情况自动跳过 |
| 下载页与本地音乐的「移出列表」操作（单曲与批量）增加确认弹窗，明确提示「仅移除记录、文件保留」（本地音乐同时提示不再被自动导入），避免误触 | |
| ✨ 沉浸光感材质 | 各页面右上角菜单、排序菜单等弹出菜单以及部分滑杆、搜索框控件接入系统沉浸式材质，观感更通透；API 26 以下设备自动降级为原有样式，不影响使用 |
🐛 问题修复
- 修复各页面双击标题栏滚回顶部时滚动停位顶头的问题，现按各页标题栏高度准确停位
⚡ 优化与调整
- 关于页「检查更新」发现新版本时，条目右侧显示新版本红点与「新版本 x.x.x」文案，提示更直观
- 标题栏滚动渐变模糊参数调整，过渡更自然
- 精简多个页面的 UI 代码，结构更清晰
📥 升级方式：进入「设置 → 关于 → 检查更新」自动下载，或前往 Releases 手动下载安装包。
版本: 2.8.1
🚀 升级说明
📦 2.8.1（从 2.7.0 升级）
✨ 新增功能
✏️ 编辑音频文件元数据
- 本地音乐的歌曲详情面板新增「编辑信息」入口，支持修改标题 / 歌手 / 专辑
- 保存后自动写回音频文件内嵌标签（基于三方库
@dabing/taglib_harmony），并同步更新本地记录与列表显示 - 正在播放的歌曲不可编辑（自动拦截，避免播放中文件被写入）
🖼️ 匹配封面后写入音频文件
- 设置 → 缓存管理新增「匹配封面后写入音频文件」开关（默认关闭），统一控制三个封面入口：
| 入口 | 说明 |
|---|---|
| 📚 批量搜索封面 | 下载页 / 本地音乐页 |
| 🔍 单曲「搜索封面」 | 自动匹配 |
| 🎯 单曲「选择封面」 | 手动指定 |
- 开启后命中的封面写入音频文件内嵌标签，自动压缩（最长边不超过 800px）控制体积
- 批量搜索封面完成后提示写入成功 / 失败 / 跳过数量；正在播放的歌曲自动跳过写入
- 关闭时保持原行为：封面仅更新应用内记录与缓存，不改动音频文件
🐛 问题修复
- 修复保存歌曲信息、更新封面后列表与面板信息不即时刷新的问题：列表行复用不重渲染、面板会话内使用旧数据两处根因均已修复
⚡ 优化与调整
- 关于页「三方库」列表补充
@dabing/taglib_harmony
📥 升级方式：进入「设置 → 关于 → 检查更新」自动下载，或前往 Releases 手动下载安装包。