v0.1.2

界面与播放

• 修复刷新登录页时的闪烁和顶栏短暂露出。
• 登录会话失效后立即停止播放，清理旧队列与私有页面状态。
• 收藏歌曲、歌单和听书后及时更新按钮与计数，后台刷新失败不再回退到旧状态。
• 清空播放历史后同步清除各分类记录与计数，避免刷新失败时旧记录重新出现。

下载与稳定性

• 下载入队采用最新设置，同时保留本次请求明确指定的音质和附加文件选项。
• 修复下载列表筛选无法识别“写入元数据”状态的问题。
• 完善音源脚本取消与超时处理，统一下载设置入口并保留旧任务恢复能力。
• 升级 Web、服务端及构建依赖，更新 Node.js、Go 与容器基础镜像。

安装与升级

• Docker 镜像：ghcr.io/raving4934/melora:0.1.2，支持 linux/amd64、linux/arm64。
• fnOS 安装包：melora-0.1.2-linux-amd64.fpk、melora-0.1.2-linux-arm64.fpk，附 SHA-256 校验文件。
• Docker Compose 默认镜像版本同步更新为 0.1.2。

Melora Android v0.2.1

【大屏适配】

• 优化超大屏车机和平板的界面比例，让文字、侧栏和播放控件大小更协调。
• 调整卡片网格、排行榜及设置页布局，改善窗口缩放时的内容对齐和浏览位置保持。
• 统一大屏弹窗与底部抽屉的尺寸和手势响应。

【播放与队列】

• “下一首播放”重复操作不再重复添加歌曲，队列中已有歌曲会移至下一首。
• 修复随机播放、播放服务重建及听书切换后指定下一首失效的问题，保留当前进度与播放状态。
• 隔离重建前后的媒体通知，避免旧通知延迟清理时中断新会话播放。

【在线内容】

• 修复排行榜切换音源时旧结果、加载状态或错误提示覆盖新页面的问题。
• 发现页推荐内容为空时提供提示和重试入口，关闭下拉刷新后仍可重试。

【兼容性改进】

• 升级客户端依赖与音源脚本运行环境，完善歌词解码兼容性。

Melora Android v0.2.0

【新增设置】

• 新增启动页恢复开关，关闭后默认进入本地歌曲。
• 音频缓存支持 1–10G 调节，每 0.5G 一档，滑动时提供振动反馈。

【播放与听书】

• 修复部分设备后台、熄屏播放卡顿，以及睡眠定时提前截断歌曲尾声的问题。
• 修复拖动进度时切歌造成错误跳转、取消迷你播放器滑动仍触发切歌的问题。
• 修复歌单翻页异常，以及听书新增章节无法继续加载的问题。

【稳定性改进】

• 扫描时保留临时离线存储的已有条目；标签补全保留原有封面和歌词。
• 完善备份恢复失败后的处理，避免旧恢复记录影响后续保存的数据。
• 修复音源更新不生效，以及在线歌单、歌词缓存异常。

Melora Android v0.1.10

Melora 0.1.10 release notes

Exported from CHANGELOG.md section ### 安卓客户端.

安卓客户端

本次仅更新 Android 客户端至 0.1.10（versionCode 19）；Web / NAS、FPK 与 Docker 维持 0.1.1。沿用正式签名，可保留数据覆盖升级。

【播放与歌词】

• 修复上下滑动歌词、停止惯性滚动及多指操作时误触跳转播放进度的问题；浏览歌词期间暂停自动跟随，保留正常点击定位与 mini 歌词交互。(ad867df)
• 修复关闭迷你歌词后方形封面偏下的问题，重新平衡封面上下留白；切换迷你歌词开关时保持播放控制区位置稳定。(e1db42d)
• 修复平板分屏时封面偏左，以及较宽分屏误用手机横屏布局导致封面下沉、歌词缩成一行的问题；调整窗口大小时保留歌词页面与播放状态。(e1db42d)
• 明确“保持屏幕唤醒”设置的作用范围：全屏播放页保持亮屏，不改变原有开关行为。(84205a2)

【界面与验证】

• 修正模糊标题栏渐变的覆盖范围，避免未滚动时遮盖首条歌曲，补充单行、双行标题栏及不同窗口尺寸的布局回归。(b2f49ba)
• 修复下载相关测试在记录尚未发布时就断言的时序问题，提高 Android CI 稳定性。(1acbea5)

【构建与发布】

• 普通 CI 仅针对 Web 与共享构建输入触发，避免纯 Android 改动重复运行无关检查。(665390e)
• 完善 Android 发布中断后的草稿恢复与 API 错误诊断，支持继续完成未发布的版本。(376a582)

Melora Android v0.1.9

Melora 0.1.9 release notes

Exported from CHANGELOG.md section ### 安卓客户端.

安卓客户端

本次仅更新 Android 客户端至 0.1.9（versionCode 18）；Web / NAS、FPK 与 Docker 维持 0.1.1。沿用正式签名，可保留数据覆盖升级。

【听书与选集】

• 最近播放中的听书节目支持直接继续收听；完善每本书的章节、断点与完成状态记录，兼容缺少专辑 ID 的旧章节数据。
• 资料库与播放器共用听书目录，支持正序/倒序、分段选集、定位当前章节和连续加载；修正目录总数异常、章节编号与实际位置不一致时的定位偏差。
• 选集使用统一输入框，既可按集/章/回编号定位，也可按章节标题搜索完整目录；搜索结果点击后定位而不自动开播，切换查询时取消旧请求。
• 调整最近播放与收藏列表的信息层级、卡片和切栏体验；听书显示作者/主播及可用的整书收听进度，不同来源的同 ID 专辑不再串用最近记录与封面。

【搜索与界面】

• 多来源歌曲搜索渐进展示结果，并按分页信息继续加载；刷新时替换过期来源快照。
• 统一单行标题栏与次级操作栏的模糊覆盖，改善平板常驻侧栏和展开侧栏旁的边缘接缝，不改变前景控件布局。

【播放与歌词】

• 完善播放队列与位置检查点，恢复时保持曲目与断点对应；移除任务后清理不再继续播放的空闲会话。
• 恢复包含无效条目的历史队列时，按原位置保留当前曲目及断点，避免重复歌曲或条目过滤导致选中位置错乱。
• “其他应用发声时自动暂停”由播放服务持续监听设置，不再依赖界面控制器连接；覆盖设置修改、备份恢复及服务重建后的同步。
• 细化逐字歌词对轻微延迟位置校正的处理，避免可见回退，保留跳转、暂停、缓冲和切歌时的真实时间变化。
• 桌面歌词在词间隙暂停不必要的逐帧刷新，按下一词或歌词边界恢复；全屏与 mini 逐字歌词合并相邻已唱片段绘制，保留原有字形、羽化、换行及 RTL 呈现。

【交互与性能】

• 优化全屏播放器展开、收起时的圆角裁剪，保持原有轮廓与动效参数，降低转场绘制开销。
• 歌曲、节目及歌单操作抽屉直接展开到内容高度；新建、重命名歌单在抽屉入场稳定后再聚焦输入，减少键盘与入场动画互相干扰。
• 完善强制刷新、缓存失效及等待者取消时的请求生命周期，确保已被替换但仍在执行的请求也能正确取消。

【下载与本地文件】

• 删除旧下载记录关联资源时核对文件身份，避免误删同曲目后来下载的高音质版本。
• 下载完成、移除或清理记录，仅在状态持久化成功后报告成功；物理文件删除后若记录保存失败，如实提示并保留重试路径。
• 本地扫描与下载登记统一使用 URI 文件身份，降低同名文件碰撞；协调标签写入与删除，避免并发修改同一文件。

【质量验证】

• 完整 Android 设备回归改为双分片执行，保留全部测试和既有限时；修复动画、系统 Insets、输入法、平板几何断言及测试存储隔离问题。
• 补充无控制器连接时的音频焦点设置回归，以及逐字歌词在中英文、RTL、连字、透明度、换行、重叠时间轴和跳转下的像素等价验证。
• 统一 Android 检查与发布流程：质量检查、设备分片和正式构建并行，全部必需检查通过后才发布同一提交的已验证安装包；普通提交不发布。
• 修复歌单导入测试在输入法尚未稳定时点击操作导致的偶发超时，补充抽屉焦点及实际窗口尺寸回归验证。

Melora Android v0.1.8

Melora 0.1.8 release notes

Exported from CHANGELOG.md section ### 安卓客户端.

安卓客户端

本次仅更新 Android 客户端至 0.1.8（versionCode 17）；Web / NAS、FPK 与 Docker 维持 0.1.1。

【逐字歌词与阅读体验】

• 修复播放位置周期校正造成的逐字歌词抢跑、填充回退；保留拖动进度、暂停、缓冲、倍速及切歌时的真实时间跳转。
• 全屏与封面 mini 歌词在间奏、尾奏保留已唱句的阅读焦点，下一句到实际起唱时间才交接，不添加等待提示或伪造逐字时间。
• 全屏歌词文字跟随播放页封面取色；普通全屏的虚化开关启用实际分层模糊，焦点句保持清晰，邻句轻虚、远句更虚。
• 调整普通全屏焦点与非焦点歌词的视觉大小差异，通过图层缩放保持原有换行与行距；mini 字号和布局不变。

【播放器与歌单】

• 修复打开全屏播放页后，经过最近任务返回应用时，底层搜索输入框残留焦点导致输入法意外弹出的问题。
• 修复沉浸模式进入及中途反向切换时封面下沉的问题，保持封面内容与位置连续。
• 歌单更新仅面向已记录导入来源的歌单；手动创建及没有原歌单来源的歌单不再显示绑定来源、从原歌单更新入口。

【构建与验证】

• 修复 Android CI 设备路径初始化和 SDK 命令行工具包列表识别问题。
• 补充播放时钟、服务连续播放、输入焦点、间奏阅读焦点、浅深色歌词取色及模糊层次回归测试。

Melora Android v0.1.7

Melora 0.1.7 release notes

Exported from CHANGELOG.md section ### 安卓客户端.

安卓客户端

本次仅更新 Android 客户端至 0.1.7（versionCode 16）；Web / NAS、FPK 与 Docker 维持 0.1.1。

【应用内 APK 更新】

• 可在应用内检查并下载更新 APK，查看下载进度或取消；下载完成后校验包信息、版本与签名，再交由 Android 系统安装。权限恢复和重试可在更新面板中完成。

【下载、取消与本地写入】

• 修复下载任务等待容量变化时的响应问题；升级中断后若目标文件已发布，可恢复原完成记录，避免重复处理。
• 下载和预取取消时同步结束底层网络与音源脚本任务；迟到的脚本结果不会串入后续请求。
• 本地歌曲标签写入前核对文件快照，避免文件被替换或截断后仍写入旧元数据；保留手动重试及未知元数据处理。
• 歌单批量添加改为一次去重事务；无变化时跳过写入，失败时保留原有回滚行为。

【列表与播放界面】

• 统一歌曲列表选择状态的渐隐动效并稳定行内操作位置，修复选择按钮淡出时影响“更多”操作的问题。
• 底部弹窗关闭时完整播放退场动画，遮罩随拖动位置同步变化；歌单导入后转为更新可复用同一弹窗并保留预览确认流程。
• 统一播放面板与队列吸附动效，保持转场中的不透明背景；播放器移动时复用静态底层画面。
• 封面样式切换连续过渡，覆盖封面形状、唱片标签与沉浸式描边，并同步调整封面尺寸、位置和迷你歌词对齐。

【队列、返回与恢复】

• 播放队列页返回原入口；普通播放页按层级收起，沉浸播放继续保留原有返回行为。播放器转场中首次返回可打断进入动画，横向翻页、纵向手势与队列交接分开处理。
• 从通知栏退出播放时保留队列、当前歌曲和播放位置，不关闭应用 Activity；重新打开应用后恢复迷你播放器。
• 队列展示按播放器引擎的真实播放顺序定位当前歌曲，同时保留原队列数据、手动浏览及下拉交接行为。
• 启动恢复过程直接观察播放就绪状态，沿用既有超时与队列回退策略。

【质量验证】

• 补充下载恢复、取消、本地文件变更、弹窗拖动、播放器导航、队列顺序与通知栏退出播放等回归覆盖；隔离异步缓存测试生命周期，并将 API 35 全量仪器测试设为 CI 默认门禁。

Melora Android v0.1.6

Melora 0.1.6 release notes

Exported from CHANGELOG.md section ### 安卓客户端.

安卓客户端

2026-09-29 同版本重发：版本名仍为 0.1.6，内部版本号由 14 递增为 15。已安装旧 0.1.6 的用户请重新下载 APK 覆盖安装；同版本不会再次提示更新，无需清空数据。

【歌单手动更新】

• 自建歌单支持“从原歌单更新”：记录导入来源，先读取并预览新增、移除的歌曲，再由用户确认保存；仅手动更新，不定时自动同步。
• 更新保留本地歌单名称和额外添加的歌曲，按原歌单顺序整理；在本地删除但原歌单仍有的歌曲会恢复。旧歌单可绑定原链接，首次绑定保留全部现有歌曲并合并远端内容。
• 增强同一来源歌单的重复导入识别：可选择更新已有歌单，或明确另存为副本；存在多个本地副本时需选择更新目标。
• 歌单来源和同步基线随备份保存与恢复；读取不完整、跨页重叠、来源不符或本地歌单发生冲突时拒绝更新，避免误改已有数据。

【歌单弹窗】

• 整理导入与更新弹窗的信息层级，增加歌单封面摘要与清晰的读取、预览、异常状态；无变化时可直接“完成”，不执行多余写入。
• 导入链接支持折叠，编辑和重新读取集中在链接栏；重复导入时，“另存为副本”与“更新已有歌单”组成底部操作组，关闭入口置于右上角。
• 正文独立滚动、底部操作保持可达，改善长链接、多副本、大字号及键盘弹出时的布局；候选歌单不再展示内部 ID。

【返回与通知】

• 应用主界面增加连续两次返回退出确认；内部页面、侧栏和播放器仍按层级返回，并加强播放器转场期间的返回处理，避免穿透退出。
• 开启通知歌词后，媒体通知标题同时显示歌曲名与歌手，歌词独立显示；关闭后恢复常规媒体标题。

【本地歌曲切页】

• 修复从我的列表、发现、排行榜等页面切回本地歌曲时，数量已显示但列表短暂空白的问题；排序结果与字母索引跨主页面切换保留。
• 歌曲列表、数量、搜索与批量操作共用完整快照；首次整理完成前不再误报空库或无搜索结果，清空后重新入库不会闪回旧歌曲。

【数据保存与文件恢复】

• 统一收藏、历史记录和歌单修改的保存流程：写入成功后才更新界面状态，避免写盘失败后界面与重启结果不一致。
• 本地歌曲标签覆写前保存持久原件和恢复记录；进程中断后可在下次启动恢复，授权暂不可用时保留原件，等待重新授权重试。
• 本地歌曲索引改为原子写入成功后再更新内存，移除吞错和原位覆盖旧文件的备用路径；保留无变化时的快速返回与索引映射复用。
• 自定义目录未取得持久访问权限时，不保存目录、不切换扫描模式、不启动扫描，并给出明确提示。

【音源与播放稳定性】

• 为音源脚本的同步执行、Promise、HTTP、初始化、协议检查和状态读取统一执行时限，修复慢脚本不能及时取消的问题；超时或取消后运行时仍可继续使用。
• 修复 HTTP 请求的超时与取消上下文未正确传递到 QuickJS 执行线程的问题，并同步等待 Promise 任务退出，避免旧任务影响后续请求。
• 清空播放队列或移除最后一首歌曲时，统一取消旧歌词加载任务；播放服务断连后停止无效进度轮询，正常连接时保留暂停和后台刷新行为。

【质量验证】

• 补充写盘失败、进程中断恢复、目录授权、脚本超时取消及队列生命周期回归测试。
• 修正基准导航在侧栏动画期间点击旧坐标的问题，统一基准与性能配置采集的导航流程，并完成冷启动、主页面切换、详情往返三项实机基准验证。

Melora Android v0.1.5

Melora 0.1.5 release notes

Exported from CHANGELOG.md section ### 安卓客户端.

安卓客户端

【大屏导航】

• 平板及较宽窗口支持常驻侧栏，直接切换搜索、排行榜、发现、歌单、听书、本地歌曲、我的列表和设置；窄窗口继续使用抽屉导航。
• 侧栏入口支持滚动，大字体或较矮窗口中也能找到后面的页面；保留设置中的退出按钮开关。

【大屏播放器】

• 较宽窗口采用封面与阅读区双栏布局，右侧可在歌词和歌曲信息之间滑动切换；窄窗口保留原有分页布局。
• 沉浸播放适配双栏布局；大屏歌词区域滚动不再带动整张播放器下拉，封面区域仍可下拉收起。
• 平板竖屏的迷你歌词字号与可视空间自适应，减少控制区上方的多余空白，并对齐歌词设置与播放操作栏。

【卡片与布局】

• 排行榜按实际内容区宽度调整卡片列数，骨架与真实卡片保持一致；限制大屏听书快捷卡片尺寸，避免过度拉伸。
• 统一歌单、听书、搜索和发现网格的宽度计算，扣除常驻侧栏、页面边距及卡片间距，修复大屏内容区变窄后仍排过多列的问题；常见手机竖屏继续保持双列。

Melora Android v0.1.4

Melora 0.1.4 release notes

Exported from CHANGELOG.md section ### 安卓客户端.

安卓客户端

【歌单与播放队列】

• 支持从网易云、QQ 音乐、酷我、酷狗、咪咕的公开歌单分享链接导入歌曲；完善移动端链接识别，入口放在“新建歌单”标题右侧。
• 自建歌单更多菜单新增“添加所有歌曲到播放队列”，无需替换当前队列或打断正在播放的歌曲。
• 列表循环、单曲循环和随机播放模式可在重启后恢复，并纳入备份；听书仍按章节顺序播放。
• 修复清空队列后界面残留、队列意外恢复，以及快速切歌时清除已播放条目可能错位的问题。

【歌词与播放器】

• 完善桌面歌词：与播放器共用逐词渲染，窗口随内容调整，拖动位置可记忆并随备份恢复；全屏歌词工具栏可直接开关桌面歌词。
• 统一歌词匹配、来源选择和本地文件写入，保留真实逐词时间信息，改善在线与本地歌曲的歌词一致性。
• 全屏歌词的字号、对齐、加粗和模糊设置支持持久化与备份；精简歌词来源抽屉，修复大字号摘要裁切。
• 长按封面可打开外观卡片，集中选择封面样式与播放主题，并保留明确的沉浸播放入口。

【缓存与音源】

• 自动换源优先保留当前启用音源的可用结果；主源按阶梯降级后能播放时，不再为追逐备用高档音质增加等待。主源迟迟无结果或不可用时，仍会尝试备用音源。
• 区分播放与下载的音源选优缓存，避免下载选中的备用结果影响后续播放；下载保留按音质逐档选优，修复已失败资源重试时不必要的主源降级。
• 同一录音、同档实测音质的完整音频缓存可跨来源复用，供播放、下载和后台补齐共用，不拼接不同来源的音频片段。
• 完整缓存命中时显示“播放源：缓存”；缓存失效后重新解析时显示解析状态，不再沿用上次的缓存标签。
• 统一共享解析请求和物理资源失败冷却，避免取消一个请求影响其他调用，以及重新解析再次选中同一个失败资源。
• 完善页面、封面与歌词缓存的容量控制、按需恢复和清理反馈，减少批量操作中的重复文件系统访问。
• 音源文件选择器限制为 JavaScript 文件，轻量校验拦截误导入；脚本执行延后，避免导入时执行整份脚本。修复检查更新与本地替换、备份恢复之间的覆盖冲突。

【下载与本地音乐】

• 本地歌曲下载更高音质前先检查实际规格；没有更优版本时不新增下载记录，升级失败保留原文件。
• 下载遇到音频传输失败时可在限定次数内自动换源重试，不把不同资源拼接到同一文件；完善暂停、取消、任务冲突和下载完成记录处理。
• 完善下载文件被外部删除后的本地标记、记录与播放回退，支持本地歌曲批量删除授权，避免继续将缺失文件当作可播放的本地歌曲。
• 本地歌曲排序及字母索引在后台生成，补全实际码率徽标，减少大列表占用主线程的工作。

【稳定性与交互】

• 修复备份恢复中断后的重试、启动恢复及前台服务处理，并调整原生恢复弹窗的配色和文字层级。
• 修复脚本引擎初始化失败时的异常传递和资源清理，避免相关崩溃或长时间无响应。
• 完善发现、听书等页面的导航与加载状态恢复，避免播放器详情页残余滑动速度误触收起。
• 优化歌单创建、导入和重试状态，减少短暂加载文字闪烁；修复新歌推荐已到末尾仍显示“加载更多”的问题。