Repository navigation
Releases
Releases · StillMisty/molia
Molia 0.3.0
Molia 0.3.0
0.2.0 之后的稳定版本,汇总 0.2.1-beta.1 ~ beta.4 的全部内容:分享海报重新排版、
设置页收敛,本地曲库接入 Android 系统文件选择器并由设备本地缓存索引驱动,
Linux 系统媒体会话统一。
改进
分享海报
- 年度报告:按实际可用宽度决定单列还是两栏,窄屏不再被挤成两列;月份柱状图
直接标出全年峰值;统计只覆盖部分时段或已关闭时,说明从脚注提到正文;「保存为
歌单」与分享按钮按宽度排布。 - 年度报告海报:年份主视觉、统计卡、月份柱状图与榜单统一到一版设计;榜单按
内容高度收拢,短内容不留空白、长歌名不压水印;海报只画歌名与歌手,不额外拉取
封面。 - 歌词海报:成品宽度与年度 / 听歌统计海报对齐;歌词过长时按比例缩小字号与
行距而不是裁切;换配色、换字体只重新排版绘制,封面复用已下载的字节,预览不再
反复编码 PNG;连续切主题时只跑一轮渲染。 - 歌词选择:底栏在窄屏或大字号下自动退化为两行,复制改成带图标的「复制」,
不再被挤成省略号。
设置
- 首屏精简:下载设置 / 下载管理 / 缓存管理合并为「下载与缓存」,通知栏·锁屏与
车机歌词并入「歌词与输出」。 - 新增「高级设置」:应用字体、默认封面、淡入淡出、智能随机、加入位置、震动反馈、
应用名称、窗口记忆、省流音质、下载模板 / 标签 / 通知、缓存保留策略与更新地址。 - 桌面歌词减少一屏:对齐、阴影、冻结、动画与暂停回退进「高级」。
- 文案收敛:只保留状态、后果、权限与不可逆提示。
本地曲库
- Android 音乐文件夹支持系统文件选择器(SAF):可添加 SD 卡 / 云盘等目录,
不需要广泛存储权限;支持树扫描、增量更新、播放与缓存 / 下载写入。原有绝对
路径目录继续可用,位置无效与暂时读不到会分开提示。 - 本地歌曲缓存行改由设备本地缓存索引驱动:只记录本机真正写完的音频缓存,
不再依赖播放历史;缓存完成事件独立记录,切歌后才完成的后台缓存也会计入。
收藏页「本地歌曲」合集 ⋮ 新增手动「核对本地缓存」:补齐完整缓存、清理已失效行。 - 数据库自动迁移到 v4(新增
local_cache_index表),已有资料保留。
播放与系统
- Linux 系统媒体会话统一到
flutter_media_session(MPRIS),行为与其它平台
一致;系统媒体控件的进度条与快进 / 快退可用(该问题在 3.2.1 修复)。 - 系统低内存时先提交播放会话与听歌统计,减少进程被回收时丢失进度;Android
lifecycle trim 与真实低内存分开处理,普通退后台不再误清浏览缓存。 - 收藏页长按底栏 / 导航轨的收藏图标,可切到收藏页并定位当前播放曲目。
- 顶栏换曲标题改为淡入淡出,消除新旧标题叠影。
修复
- 同一音频缓存文件只允许一个写入者:重复播放、自动连播或播放失败原地重取时
不再并行写同一份.part,不再出现「完整文件 + 半成品」并存,也不会在先后完成
时覆盖已经可用的缓存;完整缓存已在位时直接本地播放并清掉中断残留。 - 未设置同步口令时不再刷屏与无效重连。
- 本地封面文件缺失时跳过取色,不再报错。
- 封面缓存索引改为等索引仓库打开后再清理失效条目。
- 区分本地音乐文件夹「位置无效」与「暂时读不到」;预期取词失败不再按严重错误
记录堆栈。
内部
- 全仓架构重构:领域模型 / 服务目录归一,组合根拆分为
app/bootstrap/**,收藏页 /
封面堆叠 / 歌词页 / 设置 / 统计 / 年度报告 / 应用壳拆分为更小的模块,并清空
UI → data 的存量白名单。用户可见行为不变,测试与架构守卫保持全绿。
升级说明
- 正式版与 0.2.0 及各测试版(0.2.1-beta.N)使用同一签名,可直接覆盖安装;构建号单调递增,
应用内更新能正常识别。测试版用户升级到本版后走稳定渠道。 - 本项目仍处于快速迭代期,不承诺跨版本数据与协议兼容;需要保留的资料请先备份。
下载
| 平台 | 系统要求 | 产物 |
|---|---|---|
| Android | Android 15(API 35)及以上 | molia-0.3.0-android-arm64.apk(多数设备)、armv7、x86_64,或 .aab |
| Windows | Windows 10 / 11 x64 | molia-0.3.0-windows-x64-setup.exe(安装版)或 -windows-x64.zip(便携版) |
| Linux | x64,需系统安装 mpv / libmpv2 |
molia-0.3.0-linux-x64.tar.gz,解压后可运行 ./install.sh 安装桌面入口 |
| iOS | iOS 18 及以上,需自行签名 / 侧载 | molia-0.3.0-ios-unsigned.zip(无签名,仅供验证) |
| macOS | macOS 12 及以上 | molia-0.3.0-macos-arm64-unsigned.zip(ad-hoc 签名、未公证,仅供验证) |
产物完整性校验见发布页的 SHA256SUMS.txt。
Molia 0.2.1-beta.4
Molia 0.2.1-beta.4
0.2.1-beta.3 之后的第四个测试版,以修复为主:音频缓存写入与 Linux 系统媒体控制。
修复
音频缓存
- 同一缓存文件只允许一个写入者:重复播放、自动连播或播放失败原地重取时,边播
边缓存可能在同一个缓存文件上再起一份下载。两个下载各自写同一个.part、完成时
各自改名,结果目录里留下「完整文件 + 半成品」并存——既白占磁盘,也可能在先后
完成时覆盖已经可用的缓存。现在同一缓存文件在任一时刻只有一个写入者:撞上在途
写入时本次直接流播,不再并行写。 - 完整缓存已经落位时直接本地播放,不再创建缓存源,并清掉中断遗留的
.part
半成品(beta.3 及更早版本留下的残留会在该曲下次播放时清掉,其余在下次启动清扫)。 - 后台字节预取对同一路径不再重复启动;播放侧已经接手同一文件时,预取不再改名覆盖。
Linux
- 系统媒体控件的进度条与「快进 / 快退」操作不生效的问题已修复(
flutter_media_session
升到 3.2.1,上游修正了 MPRISSeek/SetPosition丢失目标位置)。
其它
- 依赖升级到最新:
flutter_media_session3.2.1、material_3_expressive1.2.3 等,
无界面改版。
升级说明
- 测试版与 0.2.1-beta.3 使用同一签名,可直接覆盖安装;构建号单调递增,
应用内更新能正常识别。 - 本项目仍处于快速迭代期,不承诺跨版本数据与协议兼容;需要保留的资料请先备份。
下载
| 平台 | 系统要求 | 产物 |
|---|---|---|
| Android | Android 15(API 35)及以上 | molia-0.2.1-beta.4-android-arm64.apk(多数设备)、armv7、x86_64,或 .aab |
| Windows | Windows 10 / 11 x64 | molia-0.2.1-beta.4-windows-x64-setup.exe(安装版)或 -windows-x64.zip(便携版) |
| Linux | x64,需系统安装 mpv / libmpv2 |
molia-0.2.1-beta.4-linux-x64.tar.gz,解压后可运行 ./install.sh 安装桌面入口 |
| iOS | iOS 18 及以上,需自行签名 / 侧载 | molia-0.2.1-beta.4-ios-unsigned.zip(无签名,仅供验证) |
| macOS | macOS 12 及以上 | molia-0.2.1-beta.4-macos-arm64-unsigned.zip(ad-hoc 签名、未公证,仅供验证) |
产物完整性校验见发布页的 SHA256SUMS.txt。
Molia 0.2.1-beta.3
Molia 0.2.1-beta.3
0.2.1-beta.2 之后的第三个测试版。这一轮包含本地曲库增强、Linux 媒体会话统一,
以及一次覆盖全仓的架构重构。
本地曲库
- Android 音乐文件夹支持 SAF:通过系统文件选择器添加目录(如 SD 卡 / 云盘
提供方),不需要广泛存储权限;支持树扫描、增量更新、播放与缓存 / 下载写入。
原有绝对路径目录继续可用;位置无效与暂时读不到会分开提示。 - 本地歌曲缓存状态改用设备本地缓存索引:只记录本机真正写完的音频缓存;
收藏页「本地歌曲」的缓存行不再依赖启动扫描,新增 ⋮「核对本地缓存」手动补齐。
缓存完成事件独立记录,切歌后完成的后台缓存也能计入。 - 数据库自动迁移到 v4(新增
local_cache_index表),已有资料保留。
播放与系统
- Linux 系统媒体会话统一到
flutter_media_session(MPRIS),行为与其它平台一致。 - 系统低内存时先提交播放会话与听歌统计,减少进程被回收时丢失进度。
- Android lifecycle trim 与真实低内存分开处理,普通退后台不再误清浏览缓存。
- 顶栏换曲标题改为淡入淡出,消除新旧标题叠影。
稳定性与内部
- 全仓架构重构:领域模型 / 服务目录归一,组合根拆分为
app/bootstrap/**,
收藏页 / 封面堆叠 / 歌词页 / 设置 / 统计 / 年度报告 / 应用壳拆分为更小的模块,
并清空 UI → data 的存量白名单。用户可见行为不变,测试与架构守卫保持全绿。 - 升级
file_picker/material_ui等顶层依赖。 - 修复同步未设置口令时的刷屏与无效重连、本地封面缺失时的取色报错、
缓存索引清理时序等问题。
升级说明
- 测试版与 0.2.1-beta.2 使用同一签名,可直接覆盖安装;构建号单调递增,
应用内更新能正常识别。 - 本项目仍处于快速迭代期,不承诺跨版本数据与协议兼容;需要保留的资料请先备份。
下载
| 平台 | 系统要求 | 产物 |
|---|---|---|
| Android | Android 15(API 35)及以上 | molia-0.2.1-beta.3-android-arm64.apk(多数设备)、armv7、x86_64,或 .aab |
| Windows | Windows 10 / 11 x64 | molia-0.2.1-beta.3-windows-x64-setup.exe(安装版)或 -windows-x64.zip(便携版) |
| Linux | x64,需系统安装 mpv / libmpv2 |
molia-0.2.1-beta.3-linux-x64.tar.gz,解压后可运行 ./install.sh 安装桌面入口 |
| iOS | iOS 18 及以上,需自行签名 / 侧载 | molia-0.2.1-beta.3-ios-unsigned.zip(无签名,仅供验证) |
| macOS | macOS 12 及以上 | molia-0.2.1-beta.3-macos-arm64-unsigned.zip(ad-hoc 签名、未公证,仅供验证) |
产物完整性校验见发布页的 SHA256SUMS.txt。
Molia 0.2.1-beta.2
Molia 0.2.1-beta.2
0.2.1-beta.1 之后的第二个测试版。这一轮主要是设置页收敛,另外带上收藏定位与
统计海报的排布修正。
设置
- 首屏精简:桌面端从约 39 行降到约 28 行,下载设置 / 下载管理 / 缓存管理
合并为「下载与缓存」,通知栏·锁屏与车机歌词并入「歌词与输出」。 - 新增「高级设置」:应用字体、默认封面、淡入淡出、智能随机、加入位置、
震动反馈、应用名称、窗口记忆、省流音质、下载模板 / 标签 / 通知、缓存保留
策略与更新地址收进这里。字体与震动的自定义能力保留,只是不再占首屏。 - 桌面歌词减少一屏:主页面只留开关、预览、字号、透明度、宽度、颜色与
隐藏暂停;对齐、阴影、冻结、动画、暂停回退与控制条按钮进「高级」。 - 文案收敛:删除重复标题与解释内部实现的副标题,只保留状态、后果、权限
与不可逆提示。
其它
- 收藏页长按底栏 / 导航轨的收藏图标,可切到收藏页并定位当前播放曲目;
找不到、未在播放或曲库浏览时给底栏提示,不退出搜索、多选与排序。 - 听歌统计分享海报重排,分享图的信息层级更清楚。
- 年度报告海报移除「截至今天」文案,年份入口更明确。
升级说明
- 测试版与 0.2.1-beta.1 使用同一签名,可直接覆盖安装;构建号单调递增,
应用内更新能正常识别。 - 本项目仍处于快速迭代期,不承诺跨版本数据与协议兼容;需要保留的资料请先备份。
下载
| 平台 | 系统要求 | 产物 |
|---|---|---|
| Android | Android 15(API 35)及以上 | molia-0.2.1-beta.2-android-arm64.apk(多数设备)、armv7、x86_64,或 .aab |
| Windows | Windows 10 / 11 x64 | molia-0.2.1-beta.2-windows-x64-setup.exe(安装版)或 -windows-x64.zip(便携版) |
| Linux | x64,需系统安装 mpv / libmpv2 |
molia-0.2.1-beta.2-linux-x64.tar.gz,解压后可运行 ./install.sh 安装桌面入口 |
| iOS | iOS 18 及以上,需自行签名 / 侧载 | molia-0.2.1-beta.2-ios-unsigned.zip(无签名,仅供验证) |
| macOS | macOS 12 及以上 | molia-0.2.1-beta.2-macos-arm64-unsigned.zip(ad-hoc 签名、未公证,仅供验证) |
产物完整性校验见发布页的 SHA256SUMS.txt。
Molia 0.2.1-beta.1
Molia 0.2.1-beta.1
0.2.0 之后的第一个测试版。这一轮集中在两处「分享」:年度报告和歌词海报。
改进
年度报告
- 布局按内容宽度分档:报告页挂在设置弹层里,内容区通常比窗口窄;现在按实际可用
宽度决定单列还是两栏,窄屏不再被挤成两列,宽屏的歌手 / 专辑榜单并排展示。 - 月份柱状图直接标出全年峰值;多个最高月份并列时不再强行挑一个。
- 统计只覆盖部分时段或已关闭时,这层说明从脚注提到正文,避免误读数字。
- 首次播放、最近播放和「保存为歌单」按宽度排布:窄屏整行按钮更好点,宽屏不压过顶栏
的分享主操作。
年度报告海报
- 重新排版:年份主视觉、三张统计卡、月份柱状图、常听曲目与歌手 / 专辑榜单统一到一版
设计稿;底部品牌水印在图标缺失时退回纯文字,不影响分享。 - 榜单按内容实际高度收拢到页脚上方,短内容不再留一大条空白,长歌名也不会压到水印。
- 海报只画歌名与歌手,不额外拉取封面:年度报告可能混合多个平台,分享图不应因此发起
一批网络请求。
歌词海报
- 成品宽度与年度 / 听歌统计海报对齐,方便分享平台统一裁切;歌词过长时按比例缩小字号与
行距,而不是裁掉内容,也不会触碰单张图片的高度上限。 - 换配色、换字体只重新排版绘制,封面直接复用已下载的字节;封面与水印并行准备,预览页
不再为显示而反复编码 PNG。 - 排版只做一次,量高与绘制共用同一份结果,临时文本对象及时释放。
- 预览页连续切主题、拖动画时做防抖,同一时间只跑一轮渲染,旧图保留到新图完成。
歌词选择
- 底栏在窄屏或大字号下自动退化为两行:复制、全选 / 取消全选和海报入口不再被挤成
省略号;复制按钮改成带图标的「复制」,不再把行数塞进按钮文字。
升级说明
- 测试版与 0.2.0 正式版使用同一签名,可直接覆盖安装;构建号单调递增,应用内更新能正常
识别。 - 本项目仍处于快速迭代期,不承诺跨版本数据与协议兼容;需要保留的资料请先备份。
下载
| 平台 | 系统要求 | 产物 |
|---|---|---|
| Android | Android 15(API 35)及以上 | molia-0.2.1-beta.1-android-arm64.apk(多数设备)、armv7、x86_64,或 .aab |
| Windows | Windows 10 / 11 x64 | molia-0.2.1-beta.1-windows-x64-setup.exe(安装版)或 -windows-x64.zip(便携版) |
| Linux | x64,需系统安装 mpv / libmpv2 |
molia-0.2.1-beta.1-linux-x64.tar.gz,解压后可运行 ./install.sh 安装桌面入口 |
| iOS | iOS 18 及以上,需自行签名 / 侧载 | molia-0.2.1-beta.1-ios-unsigned.zip(无签名,仅供验证) |
| macOS | macOS 12 及以上 | molia-0.2.1-beta.1-macos-arm64-unsigned.zip(ad-hoc 签名、未公证,仅供验证) |
产物完整性校验见发布页的 SHA256SUMS.txt。
Molia 0.2.0
Molia 0.2.0
0.1.0 之后的一个稳定版本。这一轮的力气主要花在「本地优先」:把本地曲库做成能扫、能整理、
能查的样子,补上歌单与统计的进出通道,同时让取链和播放失败恢复更可靠。
新增
音源与播放
- 汽水音乐成为第七个内置渠道:搜索、歌手页、专辑、评论、歌单与逐字歌词;取链由 LX
音源脚本提供(会员曲目的匿名接口只给 30 秒试听流)。 - 取链加固:内置传输统一重试预算与结果缓存;单次取链超时只失败该请求,不再拖垮整条
队列;脚本引擎连续超时熔断后自动冷却恢复,网络变化时重试。 - 播放失败自动恢复:失效缓存 → 原地重取链并保留播放进度 → 同一曲目整首重试一次 →
仍然失败才换源。 - 播放淡变、暂停淡出、睡眠淡出与智能随机(随机轮次可预期,切换模式或切歌重抽)。
- 手机横屏改为专门的紧凑布局,不再挤压播放控件。
资料库
- 本地音乐:音乐文件夹扫描、缺文件探测、专辑 / 歌手聚合、智能列表、重复版本展开,
以及「只改标题」的标签编辑器。 - 歌单:详情页、分享海报、M3U8 导入导出,当前队列可存为列表。
- 收藏 / 列表 / 本地曲目共用一套列表元数据与分组,宽屏恢复歌曲表格列;动图封面统一归一化
为 WebP 后随同步发送。 - 多选支持长按范围选择;歌词选择支持全选与范围选择,取消原来的 15 行上限。
统计与诊断
- 听歌统计与年度报告:曲目 / 歌手 / 平台榜单、日历与作息热力图,支持分享与保存图片。
- 诊断页:轮转日志、失败记录、渠道检查、取链会话指标与一键导出诊断文件。
可选在线服务
- 听歌同步:ListenBrainz / Last.fm,默认关闭;只在你开启后发送歌名、歌手、专辑、时长
与开始播放时间。 - AI 推歌:生成进度收敛为一条进度,生成期间可以继续播放旧列表;换一批 / 补一批 /
历史收进顶栏。 - 跨设备同步:新增海报样式与 AI 推荐历史两个类别,封面支持动图。
体验与桌面
- 首次启动四屏引导,随时可以跳过。
- 平板 / 折叠屏宽度档位:手机与桌面共用一套自适应布局,不再按设备类型分叉。
- 无障碍:主链路语义标签、键盘焦点顺序、200% 字号与跟随系统的减弱动效。
- 设置首屏按域重组成九张卡,目录子页合并,写入即时生效。
- 播放页与底栏收敛:进度排收进「更多」菜单,底栏不再堆叠重复入口。
- Windows:Win11 贴靠布局、虚拟桌面跟随、按虚拟桌面分组记忆窗口位置;系统退出请求先落盘
再退出;最小窗口 480×400。 - Material 3 Expressive 细节:圆角统一到形状令牌、波浪页脚、滚动边缘渐隐、内容交叉淡化、
歌单首屏骨架屏、下载任务行内进度。 - 托盘内存:暂停时释放播放器、切歌后补一次 trim。
修复
- 哔哩哔哩登录用户的字幕歌词在首帧后恢复,不再需要重开页面。
- 手机横屏、预测返回手势与页面横竖切换的布局回归。
- 封面回退到默认图、重复版本切换、本地标题刷新与缺文件入口的边界问题。
- 随机播放轮次证据、暂停淡出与睡眠淡出互相覆盖、取消后音量未复位。
升级说明
- 0.1.0 可以直接覆盖安装,曲库数据会自动迁移到新结构;迁移前会在数据目录留一份
.bak
备份(仅供人工排查,不自动回滚)。 - 凭据改为存本机凭据库(明文 SQLite),不再依赖系统钥匙串。 旧的系统钥匙串凭据不自动
迁移,升级后需要重新登录哔哩哔哩、重新填写 AI Key、听歌同步 Token 与跨设备同步口令。 - 本项目仍处于快速迭代期,不承诺跨版本数据与协议兼容;需要保留的资料请先备份。
- 0.2.0 与 0.2.0-beta.7 功能一致,测试版用户可以直接覆盖安装。
下载
| 平台 | 系统要求 | 产物 |
|---|---|---|
| Android | Android 15(API 35)及以上 | molia-0.2.0-android-arm64.apk(多数设备)、armv7、x86_64,或 .aab |
| Windows | Windows 10 / 11 x64 | molia-0.2.0-windows-x64-setup.exe(安装版)或 -windows-x64.zip(便携版) |
| Linux | x64,需系统安装 mpv / libmpv2 |
molia-0.2.0-linux-x64.tar.gz,解压后可运行 ./install.sh 安装桌面入口 |
| iOS | iOS 18 及以上,需自行签名 / 侧载 | molia-0.2.0-ios-unsigned.zip(无签名,仅供验证) |
| macOS | macOS 12 及以上 | molia-0.2.0-macos-arm64-unsigned.zip(ad-hoc 签名、未公证,仅供验证) |
安装与升级
- Android:覆盖安装需要与已装版本使用同一签名(测试版与正式版同一签名);优先选
arm64,较老的 32 位设备选armv7。应用内更新需要允许「安装未知应用」。 - Windows:安装器会创建开始菜单 / 桌面入口;便携版解压即用。
- Linux:托盘图标需要系统有 StatusNotifier 宿主(GNOME 需 AppIndicator 扩展),缺失时
自动降级为无托盘。 - iOS / macOS:产物未签名 / 未公证;iOS 需自行签名侧载,macOS 首次打开可能需要在
「系统设置 › 隐私与安全性」中放行。 - 更新渠道:Android / Windows / Linux 支持应用内检查更新与安装;macOS 请从发布页手动
下载覆盖。
校验
每个产物都附带 SHA256SUMS.txt,下载后可校验完整性:
sha256sum -c SHA256SUMS.txt数据与隐私
- 收藏、列表、历史、统计保存在本机 SQLite。
- 各类凭据(AI Key、听歌同步 Token、B 站登录、跨设备同步口令)保存在本机凭据库;它是
明文 SQLite,能读本机数据目录或备份文件的人也能读到,这是本版接受的本机取舍。 - AI 推歌与跨设备同步默认关闭,开启前会展示数据发送范围 / 信任说明。
- 跨设备同步的快照整体加密(AES-256-GCM),同步口令不会被明文上传。
- LX 音源脚本是第三方可执行代码:在隔离环境中运行,但脚本仍可发起网络请求,导入前请确认
来源可信。 - 完整备份默认包含全部凭证与用户数据;备份文件本身是明文 JSON,请妥善保管。