xref/MusicFree/changelog.md

`2025.4.4 v0.5.1`
1. 【修复】修复插件开关点击无效的问题
2. 【修复】修复开屏图片消失的问题
3. 【优化】增加新建歌单名称的长度限制
4. 【优化】优化插件安装失败的提示样式

`2025.2.9 v0.5.0`
1. 【升级】升级ReactNative到0.76.5（注意：升级后只支持安卓7.0及以上设备，低于此版本的设备请不要升级）
2. 【修复】修复了运行应用一段时间后容易闪退的问题
3. 【修复】修复了插件网络请求无法传递cookie的问题
4. 【修复】新增了设置本地歌单封面的功能（在0.4版本暂时下线了）
5. 【修复】修复了部分情况下，播放本地音乐提示 “当前非Wifi环境” 的问题
6. 【优化】优化了一些代码逻辑

`2024.11.10 v0.4.4`
【修复】修复了部分系统上弹窗、浮层等无法出现，或动画表现异常的问题

`2024.10.27 v0.4.3`
【修复】修复了部分系统上文字显示不全的问题

`2024.9.18 v0.4.2`
1. 【修复】修复本地音乐无法播放的问题

`2024.9.8 v0.4.1`
安装包上传到了飞书云文档，浏览器打开链接后有个下载说明，可以根据这个指引安装apk
1. 【修复】修复桌面歌词无法开启的问题
2. 【修复】修复了修改桌面歌词颜色会导致闪退的问题
3. 【修复】回滚了本地音乐部分读取文件的逻辑
4. 【修复】修复了点击【编辑歌单信息】按钮无效的问题

`2024.9.1 v0.4.0`
本次更新修改了歌单的存储机制，建议谨慎更新
安装包上传到了飞书云文档，浏览器打开链接后有个下载说明，可以根据这个指引安装apk
1. 【升级】ReactNative升级到0.74.4
2. 【功能】换了个logo和开屏页
3. 【功能】播放列表的歌曲限制从1500首调整到10000首
4. 【功能】重写了歌曲排序机制
5. 【功能】插件新增评论区功能（需要插件实现getMusicComments方法）
6. 【优化】调整部分样式，优化删除歌曲时的性能
7. 【修复】修复歌词翻译错位的问题
8. 【修复】修复部分情况下无法复制作者/专辑的问题
9. 【修复】修复在歌单详情页删除歌单会导致白屏的问题
10. 【修复】修复搜索框在部分情况下自动触发搜索的问题
11. 【修复】修复右上角菜单位置跳变的问题
12. 【修复】修复在预览专辑封面时触发返回不会关闭预览弹窗的问题
13. 【修复】下载文件时转移文件中的保留字符（感谢@GuGuMur）
14. 【其他】分架构打包，更新开源协议为 AGPL 3.0

`2024.3.31 v0.3.0`
本次更新优化了存储方式，更新到此版本后，歌单会自动转化为新的存储方式；安装新版本后再回退到老版本会导致歌单清空，虽然测试下来没啥问题，但是请谨慎升级Orz
备用链接：https://pan.baidu.com/s/1HmbHlh3vTcSyVXcOs-7kTA?pwd=saku 提取码: saku
1. 【功能】历史播放记录支持批量编辑
2. 【功能】歌单内支持按照加入时间排序
3. 【功能】新增设置“本地歌单添加歌曲顺序”，在歌单内添加歌曲时可以加到歌单开头
4. 【功能】首页新建歌单旁边新增“导入歌单”按钮，点击时会自动寻找具有导入歌单功能的插件，并拉起导入浮层
5. 【功能】设置项中新增“自动换源”功能，当插件失效/无法获取播放链接时，会自动尝试更换其他源的同名歌曲
6. 【优化】尝试优化了软件启动时间，应该有点作用
7. 【优化】更新了存储方式，现在单个歌单可以存储大于10000首歌曲；
8. 【优化】调整未开启“允许使用移动网络播放”开关时的样式表现
9. 【优化】优化了设置页的样式
10. 【优化】微调歌词详情页的布局
11. 【修复】修复打开弹窗时，点击返回按钮不关闭弹窗的问题
12. 【修复】修复启动软件时播放模式错误的问题
13. 【修复】修复搜索结果页特定情况下白屏的问题

`2024.1.21 v0.2.0`
1. 【功能】支持 Webdav 备份 & 播放
2. 【功能】插件支持显示作者
3. 【功能】插件榜单详情支持分页
4. 【功能】首页&歌词页样式改版：新增歌词进度调整、歌词大小调整、歌词翻译、自动搜索歌词
5. 【功能】新增收藏歌单功能
6. 【功能】侧边栏新增“权限管理”设置
7. 【功能】音乐播放栏支持左右滑动切歌（可能会闪一下，后续修掉）
8. 【功能】新增 “通知栏显示关闭按钮” 设置
9. 【优化】重构播放、数据存储逻辑
10. 【优化】统一浮层、toast样式
11. 【优化】去除插件URL必须以.js结尾的限制
12. 【修复】修改无限列表到底不触发onEndReached的问题 (感谢 @282931)
13. 【修复】修复标题栏背景色透明度不生效的问题
14. 【修复】修复播放记录退出后被清空的问题
15. 【修复】修复部分情况下深色模式异常的问题
16. 【其他】这次安装包备用链接发到百度网盘了：https://pan.baidu.com/s/1H360C0MqejKXS67XwMqgPw?pwd=6666 提取码6666


`2023.11.24 v0.1.2-alpha.0`
1. 【功能】新增桌面歌词功能，可在设置页开启（开启之前需要去手机设置授予悬浮窗权限）
2. 【功能】可以使用 MusicFree 打开本地 .js 或 .mp3 文件；其中 .js 文件会被当作插件安装； .mp3 文件会直接播放
3. 【功能】新增插件设置：打开软件时自动更新插件、安装插件时不校验版本
4. 【功能】新增播放设置：打开软件时自动播放歌曲
5. 【功能】插件页新增开关，可以控制是否在榜单、热门歌单、搜索结果中展示对应插件的结果
6. 【功能】插件协议新增 “用户变量” ，可以在插件中获取 APP 输入的配置（可以由此实现自建音乐源的插件/webdav源插件，但是还没写）
7. 【优化】下载单曲支持选择音质
8. 【优化】新增“关联歌词方式”设置，如果设置为“输入歌曲ID”，则会恢复老版本关联歌词，即输入ID关联歌词
9. 【优化】侧边栏新增“返回桌面”按钮
10. 【修复】修复榜单、推荐歌单、搜索歌词页白屏闪退的问题 (感谢 @282931)
11. 【修复】修复自定义背景模糊度和透明度无法设置为 0 的问题 (感谢 @282931)
12. 【修复】修复浅色主题状态栏表现错误的问题
13. 【修复】修复歌单批量编辑无法删除的问题
14. 【修复】修复无法恢复桌面版导出的歌单的问题

`2023.10.15 v0.1.1-alpha.0`
1. 【功能】音源支持m3u8 (桌面版下个版本支持m3u8)
2. 【功能】增加歌曲详情页屏幕常亮的设置
3. 【功能】重构主题相关功能，增加「跟随系统深色设置」选项；调整大部分样式，移除第三方UI库
4. 【功能】插件页增加「插件批量更新」的功能
5. 【功能】取消原「歌词关联」的逻辑，修改为拉起「歌词搜索」浮层
6. 【优化】增加了一些无障碍属性
7. 【修复】修复部分场景下无法保存歌单的问题
8. 【修复】修复部分场景下重启之后无法播放歌曲的问题
9. 【插件】部分插件更新，侧边栏更新插件即可

`2023.8.13 v0.1.0-alpha.10`
1. 【功能】当前音乐无歌词时可以在歌词页搜索歌词
2. 【优化】调整右上角弹出气泡的位置
3. 【优化】增加打开歌曲详情页时的默认表现设置
4. 【优化】修复进入歌词页时候显示跳变的问题
5. 【插件】插件协议更新，更新后可以配置某插件不出现在特定的搜索结果页下
6. 【插件】部分插件更新，侧边栏更新插件即可

`2023.6.26 v0.1.0-alpha.9`
1. 【功能】新增搜索歌单功能
2. 【功能】新增播放记录功能
3. 【优化】加了一些无障碍适配
4. 【插件】部分插件更新，侧边栏更新插件即可

`2023.6.4 v0.1.0-alpha.8`
1. 【功能】新增“推荐歌单”功能，需要配合支持该功能的插件使用
2. 【功能】导入本地文件时增加“全选”按钮
3. 【优化】修改“保存专辑封面”时的提示文案
4. 【修复】修复当目标歌曲在播放列表内时，添加到下一首播放无效的问题
5. 【插件】部分插件更新，侧边栏更新插件即可

`2023.5.21 v0.1.0-alpha.7`
1. 【功能】歌单页新增“播放全部”按钮
2. 【功能】歌曲播放页中，长按专辑封面可保存到本地
3. 【功能】歌单页新增“歌单排序”功能
4. 【插件】b站插件作者页API变动，侧边栏更新插件即可

`2023.5.3 v0.1.0-alpha.6`
小小拖更一下~
1. 【功能】歌单内搜索时支持英文大小写模糊搜索
2. 【修复】修复首次进入时歌曲可能无法正常播放的问题

`2023.3.26 v0.1.0-alpha.5`
1. 【功能】更新弹窗新增“跳过此版本”的复选框
2. 【功能】侧边栏-基本设置-开发选项中新增“查看错误日志”的选项，点击会弹出错误日志的弹窗
3. 【修复】修复输入框被软键盘遮挡的问题
4. 【优化】优化了定时关闭的样式
5. 【文档】文档中更新了插件的制作教程。文档地址：http://musicfree.upup.fun

`2023.3.19 v0.1.0-alpha.4`
1. 【功能】适配横屏设备
2. 【功能】新建歌单时添加默认歌单名；从专辑/榜单批量添加到新歌单时，默认以专辑名/榜单名为新歌单名
3. 【修复】修复设备有虚拟按键时，浮层会被遮挡的问题
4. 【修复】修复拖拽歌词时部分情况下时间异常的问题
5. 【修复】调整下载失败时的提示文案
6. 【插件】部分插件有更新，可以从侧边栏更新

`2023.2.26 v0.1.0-alpha.3`
1. 【功能】专辑列表支持分页，需要配合插件更新；
2. 【优化】去掉了全面屏手机界面下方的小白条；
3. 【优化】调整拖拽歌词时标识线的对齐范围；调整歌词拖到最底端时的逻辑；
4. 【优化】调整下载歌曲时的文件名；
5. 【优化】导入歌曲时的提示文案增加滚动；
6. 【修复】修复特殊情况下歌曲中断后可能恢复到错误状态的问题（未验证）；
7. 【插件】个别插件有更新，可以去侧边栏更新订阅。

`2023.2.13 v0.1.0-alpha.2`
1. 【功能】备份&恢复：可以把本地的歌单和插件备份到一个json文件中，也可以从本地文件或网络上恢复插件和歌单。
2. 【修复】修复部分情况下后台播放切换歌曲时暂停的问题
3. 【修复】修复部分场景无法下载的问题
4. 【修复】修复部分场景无法删除本地文件的问题
5. 【优化】简单优化了下歌单列表
6. 【调试】调试面板现在可以打印出插件中的console语句

`2023.1.27 v0.1.0-alpha.1`
1. !!!【功能】插件更新，升级到新版本之后原有插件完全不兼容；更新后卸载原有插件，然后更新订阅即可（具体看公众号示例）
2. 【功能】新增功能“倍速播放”
3. 【功能】重写了插件订阅的逻辑，现在应该会更合理一点点
4. 【功能】删除本地文件之前增加二次确认提醒
5. 【功能】增加了一些无关紧要的分享
6. 【样式】换了个logo，丑的更直白一些
7. 【样式】调整了一些样式（如播放页的模糊和透明度、歌词样式等）
8. 【样式】专辑描述文字默认6行，点击可以展开或折叠
9. 【修复】修复部分情况下无法下载的问题
10. 【插件】大量插件有更新，更新到此版本后更新订阅即可

`2023.1.8 v0.0.1-alpha.13`
1. 【功能】主页入口增加“榜单”
2. 【功能】歌单页新增“编辑歌单信息”，可以修改歌单名称和歌单封面
3. 【修复】修复了一个会导致播放音乐时拖拽排序卡顿的问题，做了一些其他优化
4. 【插件】部分插件有更新，可以在侧边栏更新

`2022.12.25 v0.0.1-alpha.12`
1. 【功能】增加“单击搜索结果中单曲tab”时的行为配置
2. 【功能】增加调试配置及调试面板，可用于查看插件的错误信息
3. 【修复】修复部分情况下本地音乐中断时无法继续播放的问题
4. 【修复】尝试修复扫描本地音乐，音乐文件太多时可能卡死的问题

`2022.12.11 v0.0.1-alpha.11`
1. 【功能】完善音质功能
2. 【功能】更新下载功能，支持根据音质下载文件；修复一些小问题
3. 【功能】新增播放时被打断的设置，可设置为暂停或者暂时降低音量
4. 【优化】调整侧边栏样式，侧边栏新增“定时关闭”功能
5. 【优化】本地音乐读取歌词时，会自动读取同目录下的同名lrc文件作为歌词
6. 【修复】修复安装插件时误弹安装失败提示的问题
7. 【修复】修复部分情况下本地文件删除失败的问题
8. 【修复】修复本地音乐在通知栏不显示音乐标题的问题
9. 【插件】示例插件仓库中migu有更新（支持音质），需要可自行更新

`2022.12.4 v0.0.1-alpha.10`
1. 【功能】支持自定义下载路径
2. 【功能】支持插件排序（也就是搜索结果的排序）
3. 【功能】增加音质相关的配置
4. 【优化】弹窗、浮层的性能优化，页面嵌套较深时卡顿的情况应该会好一点
5. 【优化】拖拽排序，比上个版本手感应该会好一点
6. 【修复】修复在歌词页清空播放列表时白屏的问题

`2022.11.20  v0.0.1-alpha.9`
1. 【功能】本地音乐读取内嵌歌词
2. 【功能】批量编辑页新增了凑合能用的拖拽排序
3. 【功能】歌曲详情浮层新增凑合能用的定时关闭
4. 【功能】添加到歌单时可以新建歌单
5. 【功能】本地音乐扫描支持外置sd卡；支持导入aac格式
6. 【优化】优化播放列表浮层拉起时的锚定
7. 【修复】修复更新弹窗无法滚动的问题
8. 【修复】修复安卓12状态栏概率不沉浸的问题
9. 【修复】修复安卓12、13播一首就停的问题
10. 【插件】示例插件有更新，可以删掉原有插件重新导入

`2022.11.13  v0.0.1-alpha.8`
1. 【功能】侧边栏插件设置新增“订阅插件”功能，订阅之后直接点击“更新插件”即可更新，不需要清空重装了
2. 【功能】本地音乐读取内置封面
3. 【功能】本地音乐歌单支持批量删除（不删除源文件）
4. 【优化】重写导入本地音乐的逻辑，支持多选文件夹；修复部分机型重启应用时本地音乐消失的问题（可能需要删除后重新导入）；支持导入flac,wav,wav,m4a,ogg等格式
5. 【优化】重写播放列表浮层，拉起时会锚定到当前正在播放的歌曲
6. 【优化】调整部分逻辑，可能会减少音频卡顿时卡死的情况
7. 【修复】修复歌曲详情页进度条不连续的问题
8. 【修复】修复某些情况下无法关联歌词的问题
9. 【修复】修复正在播放的歌曲无歌词时，进入歌词页白屏的问题
10. 【插件】示例插件有更新，可以删掉原有插件重新导入

`2022.10.30  v0.0.1-alpha.7`
1. 新增功能：历史记录一键清空
2. 新增功能：歌手页、本地歌单页支持批量编辑
3. 修复移动网络下无法播放本地音乐的问题
4. 样式优化&修复：toast提示显示异常、侧边栏样式优化、歌单内序号显示不全、【关于】页无法滑动
5. 之前使用的拖拽排序组件在列表较大时有很严重的性能问题，会导致卡顿甚至白屏，因此批量编辑页暂时去掉了拖拽排序，后续会重新加上

`2022.10.22  v0.0.1-alpha.6`
1. 重要!! v0.0.1-alpha.5以前的版本无法通过app正常更新，请在gitee/github发布页下载最新版本(v0.0.1-alpha.6)，或QQ群自取；
2. 导入本地音乐时，如果未识别本地音乐文件，则会使用文件名作为音乐名；
3. 自建歌单、专辑详情页增加批量选择功能，可点击右上角查看(歌曲较多时可能有点卡，后续优化)；使用方式：选中歌曲可进行下一首播放/加入歌单/下载/删除，长按拖动进行排序；删除/排序后点击保存按钮方可生效
4. 调整歌单内歌曲编号字体大小；

`2022.10.16  v0.0.1-alpha.5`
1. 新增功能：导入本地音乐文件
2. 从网络源安装的插件可在插件页直接更新
3. 调整下载逻辑

`2022.10.06  v0.0.1-alpha.4`
1. 修复专辑详情页没有loading的问题
2. 为插件新增Cookie管理器
3. 优化播放页的显示
4. 新增一键卸载全部插件的功能

`2022.10.04  v0.0.1-alpha.3`
1. 修复设置页无法滚动的问题
2. 修复播放结束时可能暂停的问题

`2022.10.03  v0.0.1-alpha.2`
1. 插件协议更新，需要重新安装插件
2. 支持批量导入插件
3. 新增清空播放列表功能
4. 优化搜索结果面板和播放专辑逻辑

`2022.10.02`
测试版本出现啦！撒花