3.0.4

这一版主打体验优化，大部分改动来自粉丝在爱发电和贴吧的建议，逐条都做了。

---

🩹 修复 · 一键扫描文件库根本点不动（重要）

有用户反馈：设置里点「一键扫描文件库」，提示要权限，但手机的应用权限页里显示「未请求任何权限」，点了也没反应。

这是真的 bug：应用清单里漏声明了读取媒体库的权限，所以系统永远不会弹授权框 —— 不是你不会操作，是这个功能之前完全不可用。

现在正常弹授权；如果之前点过「拒绝 / 不再询问」，会弹一个说明框，点「去设置」直接跳到本应用的权限页。

⏳ 新增 · 扫描时能看到进度

以前大库（几万首）扫描只有一句「扫描中」，等半天不知道是不是卡死了。现在会显示已扫描文件夹数 / 已收歌曲数，一直在动就说明在干活。

🎛 新增 · 音乐库顶部栏高度可自己定

「最上方的固定栏占据面积太大，明显挤压了文件夹的显示」—— 所以做成可选的：

设置 → 媒体库 → 顶部标题栏：完整 / 精简 / 极简

档位	效果
完整	和以前一样（大标题 + 副标题）
精简	去掉副标题、标题缩小，边距收紧
极简	只留搜索栏，标题整行去掉

顶栏越矮，下面能看到的文件夹越多。搜索栏和设置按钮在任何档位都保留（不然就进不去设置了）。

🔀 新增 · 歌单拖动排序可以关掉

「我本身有整理归纳文件夹的习惯，这个功能完全用不到而且很容易误触，希望这个功能和对应的图标遮挡能关闭」

设置 → 媒体库 → 歌单可拖动排序：关掉后卡片左上角的 ≡ 把手一并隐藏，也不会再误触拖动。默认开启（和以前一样）。

🔤 新增 · 首字母快捷导航（默认关闭）

「搜索栏下方的歌单/歌手切换栏我用不到，右侧加个首字母导航会实用得多」

• 设置 → 媒体库 → 显示首字母导航（默认关闭，需要的人自己开）
• 列表右边缘出现 A–Z 字母条，像微信通讯录那样按住上下拖动：手指划过哪个字母就跳到哪
• 拖动时当前字母高亮（主题色圆底白字），并在屏幕中央弹出大气泡显示当前字母
• 中文按拼音归桶（「周杰伦」在 Z、「林俊杰」在 L）
• 只有条目够多、且能分出 2 个以上字母时才出现
• 只在「默认顺序」下出现；切到随机 / 按名称 / 按最近播放会自动隐藏（那些顺序里字母位置没有规律）

👀 新增 · 「歌单 / 歌手」切换栏可以隐藏

设置 → 媒体库 → 显示「歌单 / 歌手」切换栏，关掉能省一整行。

⚠️ 关掉后歌手列表就没有入口了（底部导航从 3.0 起已经没有「歌手」标签页），若要按歌手找歌请保持开启。关掉时歌单排序入口会自动挪到搜索栏右侧，不会丢。

🧭 改版 · 设置界面分成 6 类，一眼看得懂

设置项越加越多，打开第一眼确实不知道从哪看起。现在改成两级：一级页先看到 6 个分类，每类带一句说明，点进去才是具体选项。

分类	里面有什么
媒体库	扫描文件夹、歌名来源、列表布局、顶部标题栏、首字母导航、封面显示
歌词显示	歌词字号与字体、自动翻译、状态栏歌词
桌面歌词	悬浮歌词的字号、透明度、颜色、锁定与居中
播放控制	切歌手势、快进时长、返回层级、定时播放、均衡器
外观与主题	界面字号，以及主题色 / 背景图 / 深色模式 / 导航栏 / 沉浸模式等全部主题设置
工具与数据	歌词识别、翻译设置、运行日志、已隐藏内容、关于

• 每个二级页左上角有「‹ 返回」，右上角标着当前分类名
• 不再有三级菜单：「外观与主题」点进去就是完整的主题设置，不用再点一次「主题」
• 扫描入口提到一级页最前面：新用户不用先去「媒体库」里找

🖼 新增 · 封面显示方式：裁满 / 完整

「音频封面显示不全，好像是封面比较大的话就只显示中间一小块」—— 查清楚了：封面框都是正方形，非正方形的封面必然被裁掉两侧或上下。

设置 → 媒体库 → 封面显示方式：

• 裁满（默认）：铺满整个方框，边缘会裁掉 —— 和以前一模一样
• 完整：整张图缩放显示、一点不裁，空出来的地方是原来的渐变底色

列表、播放页大封面、发现页主推荐都跟随这一个开关。

🌱 新增 · 第一次使用的引导

新用户第一次进来一首歌都没有时会一脸茫然。现在音乐库页不再是空白，而是写明「为什么空 + 该怎么做」：

还没有音乐
拾音需要你告诉它音乐放在哪：从手机里找出所有含音乐的文件夹，逐个授权即可（Android 不允许一次授权整个存储）。

配有两个按钮：一键扫描（推荐） / 手动选择文件夹。
发现页的副标题也会跟着改说「还没有音乐，去『音乐库』扫描一下文件夹」。

---

📝 说明

• 版本号：3.0.4（内部版本号 37）
• 覆盖安装即可，数据保留（与 3.0.x 同一签名）
• 本版为 debug 构建（与历史版本一致，可直接安装）
• 封面如果还有异常，麻烦把「导出运行日志」发来并说明是在哪个页面，我再针对性定位