AnhePlayer v2.0.3

AnhePlayer v2.0.3

音效

• 修复音效页点击右上角总开关导致应用闪退的问题：均衡器控制器不再在后台线程读取播放器音频会话 ID，避免触发 ExoPlayer 的跨线程访问校验异常。
• 均衡器设置应用过程增加异常兜底，出现异常时仅记录日志，不再导致进程崩溃。

AnhePlayer v2.0.2

AnhePlayer v2.0.2

品牌与图标

• 启动器背景恢复原版图标风格：青绿渐变上叠加左上浅色圆与右下深色圆，不再是一块纯色。
• 音符保持中心安全区比例，并补上偏右下的软投影。

AnhePlayer v2.0.1

AnhePlayer v2.0.1

音效

• 修复部分设备误提示「当前设备不支持均衡器」的问题：播放器启动时主动分配音频会话，避免会话未建立时创建效果器失败被误判为不支持。
• 均衡器改为仅在开启时创建，并按设备真实音效能力判定可用性；音频流开始播放后会自动重试绑定，兼容要求音频流激活后才允许挂载效果器的 ROM。

AnhePlayer v2.0.0

AnhePlayer v2.0.0

品牌与图标

• 修正自适应启动器图标：音符按 Android 自适应图标中心 72dp 可见视口等比缩放，桌面、抽屉与 Android 12+ 启动画面不再出现符号放大。
• 同步校正 Android 13+ 主题单色图标与通知栏小图标比例。
• 更新 README 播放器界面预览截图。

开发与构建

• 项目文档补充本地固定 JDK / Android SDK 路径与构建命令，避免环境缺失导致构建失败。

AnhePlayer v1.0.19

AnhePlayer v1.0.19

音效

• 播放页底部「音效」与播放器菜单「均衡器」改为进入应用内音效页，不再跳转系统音效面板。
• 新增卡片式音效预设列表：Original Sound、低音 Bass、清澈 Clear V2、清澈悦耳、AKG K240 MKII、Apple AirPods、Apple AirPods Max、Apple AirPods Pro、Beats Pro、Bose QuietComfort 35 II。
• 预设曲线基于公开 AutoEQ FixedBandEQ 数据，并自动适配设备实际均衡器频段。
• 支持顶部总开关、选中高亮与持久化；重启、切歌后保持当前音效设置。
• 设置页新增「音效」入口；设备不支持均衡器或开启音频硬件卸载时给出提示。

OuterTune v1.0.18

OuterTune v1.0.18

播放器与界面体验

• 全新竖屏播放页架构：抽离为独立 PortraitPlayer 组件，支持封面页与完整歌词页通过水平手势平滑左右滑动切换（HorizontalPager），并双向同步显示歌词偏好。
• 沉浸式暗色播放背景：竖屏非「跟随主题」模式下固定采用深色沉浸底色与渐变遮罩，状态栏与导航栏图标自动随深色背景调整。
• 封面页三行歌词预览：封面下方提供当前行居中、前后行淡化的三行紧凑歌词预览，点击可直接切到完整歌词页。
• 播放控制栏与进度条优化：全新设计的轻量圆角药丸进度条与时间提示，底栏集成单曲循环/随机播放模式快捷切换、睡眠定时器弹窗及快捷均衡器入口。

歌词系统重构与平滑滚动

• 独立歌词渲染引擎 LyricsView：支持卡拉OK式逐字平滑渐变擦除与逐行高亮平滑动画，歌词行支持点击跳转播放进度。
• 智能防冲突居中机制：监听手势拖拽行为，用户手动翻阅歌词时暂停自动居中，停止交互 3 秒后平滑恢复居中，避免打断阅读。
• 歌词后台流水线优化：歌词加载（TagLib JNI 与网络查询）移至后台 IO 线程调度，切歌时不再阻塞主线程；增加当前歌曲缓存与即时覆盖更新流，重开播放页不闪烁重载。
• 歌词来源标识：支持清晰标记当前歌词来源于内嵌元数据、本地同名文件还是在线音源。
• 根目录推荐音源脚本更新为长青 SVIP v1.3.0。

OuterTune v1.0.17

OuterTune v1.0.17

本地媒体

• 本地媒体整合为统一文件夹管理页面：进入后自动扫描设备所有含音乐的文件夹，列出文件夹名称、所在路径与歌曲数量。
• 每个文件夹条目右侧提供「⋮」更多菜单，可快捷隐藏 / 取消隐藏，隐藏目录自动排除并立即从媒体库中同步移除。
• 移除冗余的扫描配置选项，简化使用流程。

设置精简

• 移除“歌词”、“音乐库和内容”及“接口”冗余设置页面与入口。

歌词加载

• 精简歌词菜单，移除手动格式/源/解析器配置弹窗；歌词统一由音源、内嵌元数据自动加载。

OuterTune v1.0.16

本地媒体

• 「音乐文件夹」改成独立页面：进入后自动扫描，列出所有含音乐的文件夹（文件夹名、所在路径、曲目数）。
• 每个文件夹右侧有「⋮」菜单，可直接隐藏 / 取消隐藏该文件夹；已隐藏的文件夹会显示红色「已隐藏」标记，后续扫描整棵跳过。
• 未配置扫描路径时，音乐文件夹列表同样可用（直接读取内部存储 Music / Download）。
• 修复子文件夹路径被显示成根目录路径的问题（绝对路径解析退化成树根）。

OuterTune v1.0.15

首次启动

• 移除首次启动的初始化向导：安装后直接进入歌曲页，所有设置使用默认值，需要时再自行调整。
• 本地媒体默认扫描「内部存储 / Music」与「Download」，只需一次媒体读取权限，无需手动选择扫描目录。
• 下载目录默认「内部存储 / Music / OuterTune」，Android 10 及以上免授权直接可写；用户仍可在设置里改成任意文件夹。

下载

• 下载歌曲现在会写入内嵌封面与歌词（洛雪音源优先），并修正艺术家标签写成对象字符串的问题。
• 歌词来源统一走洛雪音源，移除酷狗歌词源。

设置

• 重新整理设置分类：内容与下载 / 播放与界面，去掉「音乐库和内容」里重复的本地媒体与存储入口。

本地媒体

• 修复点击「隐藏文件夹」闪退的问题：扫描结果去重并防目录成环、列表不再使用重复 key、对话框改为独立布局。
• 「隐藏文件夹」不再一打开就自动扫描，改为手动点「扫描包含音乐的文件夹」，扫描过程可取消。

OuterTune v1.0.14

下载

• 下载失败不再静默：新增失败提示浮条，显示《歌曲》与具体原因（HTTP 状态、音源无资源、超时、网络不可用、未设置下载目录等），并提供「重试」。
• 下载失败时在音质档位间自动降级重试（HTTP 404 与音源解析失败），并修复进度事件挤掉成功/失败事件导致的「永远卡在下载中」。
• 未设置下载目录、歌曲缺少音源信息时立即提示，不再出现点了下载毫无反应的情况。
• 下载请求改用浏览器 UA，避免部分音源 CDN 因 UA 拒绝而返回 403。

洛雪音源

• 修复导入或切换音源后首次解析失败的问题：QuickJS 运行时的创建与销毁统一回到同一线程执行。
• 洛雪音源设置新增「恢复内置音源」，并显示导入脚本的真实文件名。

本地媒体

• 「排除的扫描路径」改为「隐藏文件夹」：自动扫描扫描路径下所有含音乐的文件夹并列出曲目数，用开关直接隐藏，支持搜索、重新扫描和全部取消隐藏。
• 修复旧排除逻辑拿 URI 路径与文件真实路径比较、永远不生效的问题，隐藏的文件夹在扫描时整棵跳过。

OuterTune v1.0.13

首次使用

• 首次安装引导精简为欢迎、本地媒体和完成三步。
• 主题、下载目录和歌曲缓存改为进入应用后按需配置，洛雪在线播放继续使用内置默认音源。

OuterTune v1.0.12

本地媒体

• 在本地媒体设置中明确区分“扫描路径”和“排除的扫描路径”。
• 支持单独添加不参与扫描的文件夹，其子目录也会一并排除。

OuterTune v1.0.11

播放与音源

• 修复酷狗、网易云和 QQ 音乐搜索结果在默认 320k 音质下播放失败的问题，按歌曲实际支持的音质自动降级。
• 保留酷我播放流程，并统一多音源的播放参数处理。

下载

• 下载地址返回 404 时按音质自动降级重试。
• 下载完成后写入标题、歌手、专辑、封面和内嵌 LYRICS 歌词。
• 下载歌曲、最近播放和播放器通知优先读取本地文件封面，改善离线显示。

OuterTune v1.0.10

修复

• 修复 SAF 下载目录中的歌曲完成下载后因路径解析失败而从已下载列表消失的问题。
• 修复下载扫描在目录权限暂时失效或扫描结果为空时误清理下载记录的问题。
• 本地媒体扫描过滤时长少于 30 秒的音频，避免录音片段进入媒体库。

OuterTune v1.0.9

导航与歌曲

• 移除底部导航，改用左侧抽屉，统一提供歌曲、歌单、设置和关于入口。
• 应用默认进入歌曲页，歌曲分组支持喜欢、媒体库、已下载和最近播放，默认显示媒体库。
• 收回底部导航预留空间，迷你播放器布局更紧凑。

搜索

• 顶部搜索框改为按需展开，主页面只显示搜索按钮。
• 搜索结果移除重复的顶部系统 inset，减少搜索框与结果之间的空白。

OuterTune v1.0.8

界面

• 移除设置中的“播放器与音频”入口及独立设置页。
• 清理失效的播放器设置导航；系统数据备份规则保留，不再显示为应用设置项。

OuterTune v1.0.7

构建

• 正式构建仅输出 core-arm64-v8a APK，移除 x86、armeabi-v7a、universal 和 full 变体产物，减少下载数量并缩短构建时间。

OuterTune v1.0.6

修复

• 允许洛雪音源返回的 HTTP 音频地址播放，修复酷狗、网易云和 QQ 音乐搜索结果播放时报 CLEARTEXT communication not permitted。
• 记录音源播放地址协议，便于定位自定义音源的网络问题。

OuterTune v1.0.5

构建

• Debug APK 与 JVM 单测保持阻断校验；Android Lint 改为独立非阻断检查，保留现有规则报告而不影响 APK 交付。

OuterTune v1.0.4

修复

• 修复 GitHub Actions 不允许在步骤条件中直接读取签名 Secrets 导致工作流校验失败的问题。

OuterTune v1.0.3

修复

• 修复未配置 GitHub Actions 签名 Secrets 时 Release 构建失败的问题，自动回退到 Debug 签名。
• 修复 Android 媒体搜索入口缺少 MEDIA_PLAY_FROM_SEARCH 声明导致的 Lint 构建失败。
• Release 草稿发布在未配置 REL_TOKEN 时自动使用 GitHub Actions 默认令牌。

OuterTune v1.0.2

修复

• 恢复 ffMetadataEx Git 子模块，确保 GitHub Actions checkout 后可配置 Gradle 项目。

OuterTune v1.0.1

修复

• 修复 GitHub Actions 中 Gradle Wrapper 缺少执行权限导致 Release 构建失败的问题。

OuterTune v1.0.0

首个洛雪音源版公开版本。

主要更新

• 保留 Material 3 播放器界面，首页精简为最近播放。
• 移除 YouTube/InnerTube 登录、推荐、浏览、同步和相关播放链路。
• 接入洛雪 JS 音源运行时，支持导入自定义音源。
• 搜索支持本地优先，并可切换酷狗、网易云、QQ 音乐和酷我音源。
• 搜索结果先显示文字，封面异步加载；播放时补齐缺失封面。
• 修复酷狗 union_cover 和网易云 picId 封面解析。
• 最近播放保留本地歌曲记录；内嵌歌词优先于联网歌词。
• 下载音质支持低品质、标准、高品质和 Hi-Res，直接保存到设置的下载文件夹。
• 移除 Media3 下载缓存和迁移逻辑。
• 使用系统字体与简体中文界面。

构建

GitHub Actions 会在 main 推送时构建 Debug APK；推送 v* 标签时构建 Release APK 并自动发布 GitHub Release。

OuterTune v1.0.16

OuterTune v1.0.16

本地媒体

• 「音乐文件夹」改成独立页面：进入后自动扫描，列出所有含音乐的文件夹（文件夹名、所在路径、曲目数）。
• 每个文件夹右侧有「⋮」菜单，可直接隐藏 / 取消隐藏该文件夹；已隐藏的文件夹会显示红色「已隐藏」标记，后续扫描整棵跳过。
• 未配置扫描路径时，音乐文件夹列表同样可用（直接读取内部存储 Music / Download）。
• 修复子文件夹路径被显示成根目录路径的问题（绝对路径解析退化成树根）。

OuterTune v1.0.15

首次启动

• 移除首次启动的初始化向导：安装后直接进入歌曲页，所有设置使用默认值，需要时再自行调整。
• 本地媒体默认扫描「内部存储 / Music」与「Download」，只需一次媒体读取权限，无需手动选择扫描目录。
• 下载目录默认「内部存储 / Music / OuterTune」，Android 10 及以上免授权直接可写；用户仍可在设置里改成任意文件夹。

下载

• 下载歌曲现在会写入内嵌封面与歌词（洛雪音源优先），并修正艺术家标签写成对象字符串的问题。
• 歌词来源统一走洛雪音源，移除酷狗歌词源。

设置

• 重新整理设置分类：内容与下载 / 播放与界面，去掉「音乐库和内容」里重复的本地媒体与存储入口。

本地媒体

• 修复点击「隐藏文件夹」闪退的问题：扫描结果去重并防目录成环、列表不再使用重复 key、对话框改为独立布局。
• 「隐藏文件夹」不再一打开就自动扫描，改为手动点「扫描包含音乐的文件夹」，扫描过程可取消。

OuterTune v1.0.14

下载

• 下载失败不再静默：新增失败提示浮条，显示《歌曲》与具体原因（HTTP 状态、音源无资源、超时、网络不可用、未设置下载目录等），并提供「重试」。
• 下载失败时在音质档位间自动降级重试（HTTP 404 与音源解析失败），并修复进度事件挤掉成功/失败事件导致的「永远卡在下载中」。
• 未设置下载目录、歌曲缺少音源信息时立即提示，不再出现点了下载毫无反应的情况。
• 下载请求改用浏览器 UA，避免部分音源 CDN 因 UA 拒绝而返回 403。

洛雪音源

• 修复导入或切换音源后首次解析失败的问题：QuickJS 运行时的创建与销毁统一回到同一线程执行。
• 洛雪音源设置新增「恢复内置音源」，并显示导入脚本的真实文件名。

本地媒体

• 「排除的扫描路径」改为「隐藏文件夹」：自动扫描扫描路径下所有含音乐的文件夹并列出曲目数，用开关直接隐藏，支持搜索、重新扫描和全部取消隐藏。
• 修复旧排除逻辑拿 URI 路径与文件真实路径比较、永远不生效的问题，隐藏的文件夹在扫描时整棵跳过。

OuterTune v1.0.13

首次使用

• 首次安装引导精简为欢迎、本地媒体和完成三步。
• 主题、下载目录和歌曲缓存改为进入应用后按需配置，洛雪在线播放继续使用内置默认音源。

OuterTune v1.0.12

本地媒体

• 在本地媒体设置中明确区分“扫描路径”和“排除的扫描路径”。
• 支持单独添加不参与扫描的文件夹，其子目录也会一并排除。

OuterTune v1.0.11

播放与音源

• 修复酷狗、网易云和 QQ 音乐搜索结果在默认 320k 音质下播放失败的问题，按歌曲实际支持的音质自动降级。
• 保留酷我播放流程，并统一多音源的播放参数处理。

下载

• 下载地址返回 404 时按音质自动降级重试。
• 下载完成后写入标题、歌手、专辑、封面和内嵌 LYRICS 歌词。
• 下载歌曲、最近播放和播放器通知优先读取本地文件封面，改善离线显示。

OuterTune v1.0.10

修复

• 修复 SAF 下载目录中的歌曲完成下载后因路径解析失败而从已下载列表消失的问题。
• 修复下载扫描在目录权限暂时失效或扫描结果为空时误清理下载记录的问题。
• 本地媒体扫描过滤时长少于 30 秒的音频，避免录音片段进入媒体库。

OuterTune v1.0.9

导航与歌曲

• 移除底部导航，改用左侧抽屉，统一提供歌曲、歌单、设置和关于入口。
• 应用默认进入歌曲页，歌曲分组支持喜欢、媒体库、已下载和最近播放，默认显示媒体库。
• 收回底部导航预留空间，迷你播放器布局更紧凑。

搜索

• 顶部搜索框改为按需展开，主页面只显示搜索按钮。
• 搜索结果移除重复的顶部系统 inset，减少搜索框与结果之间的空白。

OuterTune v1.0.8

界面

• 移除设置中的“播放器与音频”入口及独立设置页。
• 清理失效的播放器设置导航；系统数据备份规则保留，不再显示为应用设置项。

OuterTune v1.0.7

构建

• 正式构建仅输出 core-arm64-v8a APK，移除 x86、armeabi-v7a、universal 和 full 变体产物，减少下载数量并缩短构建时间。

OuterTune v1.0.6

修复

• 允许洛雪音源返回的 HTTP 音频地址播放，修复酷狗、网易云和 QQ 音乐搜索结果播放时报 CLEARTEXT communication not permitted。
• 记录音源播放地址协议，便于定位自定义音源的网络问题。

OuterTune v1.0.5

构建

• Debug APK 与 JVM 单测保持阻断校验；Android Lint 改为独立非阻断检查，保留现有规则报告而不影响 APK 交付。

OuterTune v1.0.4

修复

• 修复 GitHub Actions 不允许在步骤条件中直接读取签名 Secrets 导致工作流校验失败的问题。

OuterTune v1.0.3

修复

• 修复未配置 GitHub Actions 签名 Secrets 时 Release 构建失败的问题，自动回退到 Debug 签名。
• 修复 Android 媒体搜索入口缺少 MEDIA_PLAY_FROM_SEARCH 声明导致的 Lint 构建失败。
• Release 草稿发布在未配置 REL_TOKEN 时自动使用 GitHub Actions 默认令牌。

OuterTune v1.0.2

修复

• 恢复 ffMetadataEx Git 子模块，确保 GitHub Actions checkout 后可配置 Gradle 项目。

OuterTune v1.0.1

修复

• 修复 GitHub Actions 中 Gradle Wrapper 缺少执行权限导致 Release 构建失败的问题。

OuterTune v1.0.0

首个洛雪音源版公开版本。

主要更新

• 保留 Material 3 播放器界面，首页精简为最近播放。
• 移除 YouTube/InnerTube 登录、推荐、浏览、同步和相关播放链路。
• 接入洛雪 JS 音源运行时，支持导入自定义音源。
• 搜索支持本地优先，并可切换酷狗、网易云、QQ 音乐和酷我音源。
• 搜索结果先显示文字，封面异步加载；播放时补齐缺失封面。
• 修复酷狗 union_cover 和网易云 picId 封面解析。
• 最近播放保留本地歌曲记录；内嵌歌词优先于联网歌词。
• 下载音质支持低品质、标准、高品质和 Hi-Res，直接保存到设置的下载文件夹。
• 移除 Media3 下载缓存和迁移逻辑。
• 使用系统字体与简体中文界面。

构建

GitHub Actions 会在 main 推送时构建 Debug APK；推送 v* 标签时构建 Release APK 并自动发布 GitHub Release。

OuterTune v1.0.15

OuterTune v1.0.15

首次启动

• 移除首次启动的初始化向导：安装后直接进入歌曲页，所有设置使用默认值，需要时再自行调整。
• 本地媒体默认扫描「内部存储 / Music」与「Download」，只需一次媒体读取权限，无需手动选择扫描目录。
• 下载目录默认「内部存储 / Music / OuterTune」，Android 10 及以上免授权直接可写；用户仍可在设置里改成任意文件夹。

下载

• 下载歌曲现在会写入内嵌封面与歌词（洛雪音源优先），并修正艺术家标签写成对象字符串的问题。
• 歌词来源统一走洛雪音源，移除酷狗歌词源。

设置

• 重新整理设置分类：内容与下载 / 播放与界面，去掉「音乐库和内容」里重复的本地媒体与存储入口。

本地媒体

• 修复点击「隐藏文件夹」闪退的问题：扫描结果去重并防目录成环、列表不再使用重复 key、对话框改为独立布局。
• 「隐藏文件夹」不再一打开就自动扫描，改为手动点「扫描包含音乐的文件夹」，扫描过程可取消。

OuterTune v1.0.14

下载

• 下载失败不再静默：新增失败提示浮条，显示《歌曲》与具体原因（HTTP 状态、音源无资源、超时、网络不可用、未设置下载目录等），并提供「重试」。
• 下载失败时在音质档位间自动降级重试（HTTP 404 与音源解析失败），并修复进度事件挤掉成功/失败事件导致的「永远卡在下载中」。
• 未设置下载目录、歌曲缺少音源信息时立即提示，不再出现点了下载毫无反应的情况。
• 下载请求改用浏览器 UA，避免部分音源 CDN 因 UA 拒绝而返回 403。

洛雪音源

• 修复导入或切换音源后首次解析失败的问题：QuickJS 运行时的创建与销毁统一回到同一线程执行。
• 洛雪音源设置新增「恢复内置音源」，并显示导入脚本的真实文件名。

本地媒体

• 「排除的扫描路径」改为「隐藏文件夹」：自动扫描扫描路径下所有含音乐的文件夹并列出曲目数，用开关直接隐藏，支持搜索、重新扫描和全部取消隐藏。
• 修复旧排除逻辑拿 URI 路径与文件真实路径比较、永远不生效的问题，隐藏的文件夹在扫描时整棵跳过。

OuterTune v1.0.13

首次使用

• 首次安装引导精简为欢迎、本地媒体和完成三步。
• 主题、下载目录和歌曲缓存改为进入应用后按需配置，洛雪在线播放继续使用内置默认音源。

OuterTune v1.0.12

本地媒体

• 在本地媒体设置中明确区分“扫描路径”和“排除的扫描路径”。
• 支持单独添加不参与扫描的文件夹，其子目录也会一并排除。

OuterTune v1.0.11

播放与音源

• 修复酷狗、网易云和 QQ 音乐搜索结果在默认 320k 音质下播放失败的问题，按歌曲实际支持的音质自动降级。
• 保留酷我播放流程，并统一多音源的播放参数处理。

下载

• 下载地址返回 404 时按音质自动降级重试。
• 下载完成后写入标题、歌手、专辑、封面和内嵌 LYRICS 歌词。
• 下载歌曲、最近播放和播放器通知优先读取本地文件封面，改善离线显示。

OuterTune v1.0.10

修复

• 修复 SAF 下载目录中的歌曲完成下载后因路径解析失败而从已下载列表消失的问题。
• 修复下载扫描在目录权限暂时失效或扫描结果为空时误清理下载记录的问题。
• 本地媒体扫描过滤时长少于 30 秒的音频，避免录音片段进入媒体库。

OuterTune v1.0.9

导航与歌曲

• 移除底部导航，改用左侧抽屉，统一提供歌曲、歌单、设置和关于入口。
• 应用默认进入歌曲页，歌曲分组支持喜欢、媒体库、已下载和最近播放，默认显示媒体库。
• 收回底部导航预留空间，迷你播放器布局更紧凑。

搜索

• 顶部搜索框改为按需展开，主页面只显示搜索按钮。
• 搜索结果移除重复的顶部系统 inset，减少搜索框与结果之间的空白。

OuterTune v1.0.8

界面

• 移除设置中的“播放器与音频”入口及独立设置页。
• 清理失效的播放器设置导航；系统数据备份规则保留，不再显示为应用设置项。

OuterTune v1.0.7

构建

• 正式构建仅输出 core-arm64-v8a APK，移除 x86、armeabi-v7a、universal 和 full 变体产物，减少下载数量并缩短构建时间。

OuterTune v1.0.6

修复

• 允许洛雪音源返回的 HTTP 音频地址播放，修复酷狗、网易云和 QQ 音乐搜索结果播放时报 CLEARTEXT communication not permitted。
• 记录音源播放地址协议，便于定位自定义音源的网络问题。

OuterTune v1.0.5

构建

• Debug APK 与 JVM 单测保持阻断校验；Android Lint 改为独立非阻断检查，保留现有规则报告而不影响 APK 交付。

OuterTune v1.0.4

修复

• 修复 GitHub Actions 不允许在步骤条件中直接读取签名 Secrets 导致工作流校验失败的问题。

OuterTune v1.0.3

修复

• 修复未配置 GitHub Actions 签名 Secrets 时 Release 构建失败的问题，自动回退到 Debug 签名。
• 修复 Android 媒体搜索入口缺少 MEDIA_PLAY_FROM_SEARCH 声明导致的 Lint 构建失败。
• Release 草稿发布在未配置 REL_TOKEN 时自动使用 GitHub Actions 默认令牌。

OuterTune v1.0.2

修复

• 恢复 ffMetadataEx Git 子模块，确保 GitHub Actions checkout 后可配置 Gradle 项目。

OuterTune v1.0.1

修复

• 修复 GitHub Actions 中 Gradle Wrapper 缺少执行权限导致 Release 构建失败的问题。

OuterTune v1.0.0

首个洛雪音源版公开版本。

主要更新

• 保留 Material 3 播放器界面，首页精简为最近播放。
• 移除 YouTube/InnerTube 登录、推荐、浏览、同步和相关播放链路。
• 接入洛雪 JS 音源运行时，支持导入自定义音源。
• 搜索支持本地优先，并可切换酷狗、网易云、QQ 音乐和酷我音源。
• 搜索结果先显示文字，封面异步加载；播放时补齐缺失封面。
• 修复酷狗 union_cover 和网易云 picId 封面解析。
• 最近播放保留本地歌曲记录；内嵌歌词优先于联网歌词。
• 下载音质支持低品质、标准、高品质和 Hi-Res，直接保存到设置的下载文件夹。
• 移除 Media3 下载缓存和迁移逻辑。
• 使用系统字体与简体中文界面。

构建

GitHub Actions 会在 main 推送时构建 Debug APK；推送 v* 标签时构建 Release APK 并自动发布 GitHub Release。

OuterTune v1.0.14

OuterTune v1.0.14

下载

• 下载失败不再静默：新增失败提示浮条，显示《歌曲》与具体原因（HTTP 状态、音源无资源、超时、网络不可用、未设置下载目录等），并提供「重试」。
• 下载失败时在音质档位间自动降级重试（HTTP 404 与音源解析失败），并修复进度事件挤掉成功/失败事件导致的「永远卡在下载中」。
• 未设置下载目录、歌曲缺少音源信息时立即提示，不再出现点了下载毫无反应的情况。
• 下载请求改用浏览器 UA，避免部分音源 CDN 因 UA 拒绝而返回 403。

洛雪音源

• 修复导入或切换音源后首次解析失败的问题：QuickJS 运行时的创建与销毁统一回到同一线程执行。
• 洛雪音源设置新增「恢复内置音源」，并显示导入脚本的真实文件名。

本地媒体

• 「排除的扫描路径」改为「隐藏文件夹」：自动扫描扫描路径下所有含音乐的文件夹并列出曲目数，用开关直接隐藏，支持搜索、重新扫描和全部取消隐藏。
• 修复旧排除逻辑拿 URI 路径与文件真实路径比较、永远不生效的问题，隐藏的文件夹在扫描时整棵跳过。

OuterTune v1.0.13

首次使用

• 首次安装引导精简为欢迎、本地媒体和完成三步。
• 主题、下载目录和歌曲缓存改为进入应用后按需配置，洛雪在线播放继续使用内置默认音源。

OuterTune v1.0.12

本地媒体

• 在本地媒体设置中明确区分“扫描路径”和“排除的扫描路径”。
• 支持单独添加不参与扫描的文件夹，其子目录也会一并排除。

OuterTune v1.0.11

播放与音源

• 修复酷狗、网易云和 QQ 音乐搜索结果在默认 320k 音质下播放失败的问题，按歌曲实际支持的音质自动降级。
• 保留酷我播放流程，并统一多音源的播放参数处理。

下载

• 下载地址返回 404 时按音质自动降级重试。
• 下载完成后写入标题、歌手、专辑、封面和内嵌 LYRICS 歌词。
• 下载歌曲、最近播放和播放器通知优先读取本地文件封面，改善离线显示。

OuterTune v1.0.10

修复

• 修复 SAF 下载目录中的歌曲完成下载后因路径解析失败而从已下载列表消失的问题。
• 修复下载扫描在目录权限暂时失效或扫描结果为空时误清理下载记录的问题。
• 本地媒体扫描过滤时长少于 30 秒的音频，避免录音片段进入媒体库。

OuterTune v1.0.9

导航与歌曲

• 移除底部导航，改用左侧抽屉，统一提供歌曲、歌单、设置和关于入口。
• 应用默认进入歌曲页，歌曲分组支持喜欢、媒体库、已下载和最近播放，默认显示媒体库。
• 收回底部导航预留空间，迷你播放器布局更紧凑。

搜索

• 顶部搜索框改为按需展开，主页面只显示搜索按钮。
• 搜索结果移除重复的顶部系统 inset，减少搜索框与结果之间的空白。

OuterTune v1.0.8

界面

• 移除设置中的“播放器与音频”入口及独立设置页。
• 清理失效的播放器设置导航；系统数据备份规则保留，不再显示为应用设置项。

OuterTune v1.0.7

构建

• 正式构建仅输出 core-arm64-v8a APK，移除 x86、armeabi-v7a、universal 和 full 变体产物，减少下载数量并缩短构建时间。

OuterTune v1.0.6

修复

• 允许洛雪音源返回的 HTTP 音频地址播放，修复酷狗、网易云和 QQ 音乐搜索结果播放时报 CLEARTEXT communication not permitted。
• 记录音源播放地址协议，便于定位自定义音源的网络问题。

OuterTune v1.0.5

构建

• Debug APK 与 JVM 单测保持阻断校验；Android Lint 改为独立非阻断检查，保留现有规则报告而不影响 APK 交付。

OuterTune v1.0.4

修复

• 修复 GitHub Actions 不允许在步骤条件中直接读取签名 Secrets 导致工作流校验失败的问题。

OuterTune v1.0.3

修复

• 修复未配置 GitHub Actions 签名 Secrets 时 Release 构建失败的问题，自动回退到 Debug 签名。
• 修复 Android 媒体搜索入口缺少 MEDIA_PLAY_FROM_SEARCH 声明导致的 Lint 构建失败。
• Release 草稿发布在未配置 REL_TOKEN 时自动使用 GitHub Actions 默认令牌。

OuterTune v1.0.2

修复

• 恢复 ffMetadataEx Git 子模块，确保 GitHub Actions checkout 后可配置 Gradle 项目。

OuterTune v1.0.1

修复

• 修复 GitHub Actions 中 Gradle Wrapper 缺少执行权限导致 Release 构建失败的问题。

OuterTune v1.0.0

首个洛雪音源版公开版本。

主要更新

• 保留 Material 3 播放器界面，首页精简为最近播放。
• 移除 YouTube/InnerTube 登录、推荐、浏览、同步和相关播放链路。
• 接入洛雪 JS 音源运行时，支持导入自定义音源。
• 搜索支持本地优先，并可切换酷狗、网易云、QQ 音乐和酷我音源。
• 搜索结果先显示文字，封面异步加载；播放时补齐缺失封面。
• 修复酷狗 union_cover 和网易云 picId 封面解析。
• 最近播放保留本地歌曲记录；内嵌歌词优先于联网歌词。
• 下载音质支持低品质、标准、高品质和 Hi-Res，直接保存到设置的下载文件夹。
• 移除 Media3 下载缓存和迁移逻辑。
• 使用系统字体与简体中文界面。

构建

GitHub Actions 会在 main 推送时构建 Debug APK；推送 v* 标签时构建 Release APK 并自动发布 GitHub Release。