本地音乐扫描：v5.1.0 全新能力解析

功能简述

v5.1.0 之前 AlgerMusicPlayer 不支持本地音乐。v5.1.0 完整实现了本地音乐扫描播放功能，可以把你电脑上的本地音乐库全部导入管理。

能做什么

• 扫描指定文件夹，自动识别音乐文件
• 解析元数据（封面、歌手、专辑、年份、流派）
• 支持增量扫描（只扫描新增/修改的文件）
• 扫描完成后自动加入本地音乐库，可以和在线音乐混合播放

如何添加本地音乐

设置 → 本地音乐 → 添加目录：

1. 点击「添加扫描目录」
2. 选择包含音乐文件的文件夹（支持多级子目录递归）
3. 支持添加多个目录

添加后点击「开始扫描」，进度条显示扫描状态。首次扫描大量文件时可能需要几分钟。

增量扫描

v5.1.0 修复了本地音乐扫描的增量判断逻辑——扫描过一次后，下次只扫描：

• 新增的文件
• 修改过的文件（文件修改时间戳变化）
• 被删除的文件（自动从库中移除）

所以你定期点一下扫描就能保持本地库最新，不会每次都全量扫描。

元数据解析

v5.1.0 重写了本地音乐元数据解析：

• 并发限流（避免大量文件同时解析卡死）
• 封面体积限制（大封面图片会自动缩小后缓存）
• 支持 ID3v1 / ID3v2 / Vorbis Comment 等常见标签格式

扫描后的使用

扫描完成后，本地音乐可以在首页「本地」板块访问：

• 按歌手浏览
• 按专辑浏览
• 按文件路径浏览
• 可以添加到播放列表
• 可以收藏、添加到歌单

本地音乐和在线音乐的播放体验完全一致，支持歌词、EQ、倍速等全部功能。

隐私数据提示

本地音乐扫描不会上传任何文件或元数据到第三方服务器，全程在本地 Electron 应用内完成。