曲库管理

ECHO 的曲库以本地文件为核心。导入文件夹后，ECHO 会读取音频文件、嵌入标签、封面、时长、编码信息，并把它们写入可搜索、可分页、可恢复的本地索引。

首次导入建议

第一次使用时不要直接导入整个硬盘。建议先做一个小规模验证：

1. 准备一个只含 3 到 10 首正常歌曲的小文件夹。
2. 在 Import Folder 导入它。
3. 到 Songs、Albums、Inbox 检查歌曲、封面和专辑分组。
4. 双击歌曲确认能播放。
5. 再导入完整曲库。

这个流程能把“软件能不能正常工作”和“你的大曲库是否需要整理”分开，排障更快。

导入时卡顿是正常现象

首次导入大曲库时，短时间卡顿、进度变慢、CPU 或磁盘占用升高是正常现象。ECHO 需要完成这些工作：

• 枚举文件夹里的音频文件。
• 读取 MP3、FLAC、M4A、WAV、OGG 等文件的标签。
• 提取或缓存封面。
• 计算时长、编码、采样率、位深等信息。
• 写入 SQLite 索引。
• 按专辑、艺术家、文件夹刷新分组。

导入期间尽量不要同时执行全量远程同步、大量下载、全库封面补全或其它重型后台任务。等第一轮导入完成后，再做标签修复、封面补全或远程同步会更稳定。

扫描和重扫

重复导入同一路径通常应视为重新扫描，不应该创建重复曲库。重扫适合这些情况：

• 文件夹里新增了大量歌曲。
• 你批量修改了标签。
• 专辑封面或曲序更新了。
• 某些文件被移动、替换或恢复。

不要把全库重扫当成万能修复。只有一张专辑显示异常时，优先修那张专辑的标签；只有一个文件夹异常时，优先重扫那个文件夹。

标签和专辑分组

专辑显示混乱时，重点看这些字段：

字段	影响
title	歌曲名
artist	歌曲艺术家
album	专辑名
albumArtist	专辑艺术家，决定同名专辑是否合并
trackNo	曲序
discNo	多碟专辑顺序
year	年份显示
封面	专辑墙、播放栏和详情页显示

同一张专辑的 album 和 albumArtist 最好保持一致。合辑、原声带和多艺术家专辑尤其要检查 albumArtist。

网络元数据

网络元数据适合补全缺失信息，不适合覆盖你已经整理好的高可信标签。推荐策略：

• 本地手动编辑优先。
• 文件内嵌标签优先。
• 文件夹结构和同目录封面优先。
• 网络结果作为候选或弱补全。

批量应用网络结果前，先选少量歌曲试一次。不要一次性覆盖整个曲库。

文件安全边界

ECHO 的曲库索引不等于你的真实音频文件。正常曲库维护应遵守这些边界：

• 从曲库移除记录不应自动删除真实音乐文件。
• 扫描发现文件消失时，应标记为缺失或等待修复，不应擅自删除历史记录。
• 标签写入、移动修复和批量操作都应由用户明确确认。
• 删除、重命名、移动真实文件前，请先确认路径和备份。

大曲库使用建议

• 优先使用搜索、分页、排序和文件夹入口定位问题。
• 批量修标签前先备份重要音乐文件。
• 扫描期间保持电脑供电稳定，避免外置硬盘休眠。
• 网络盘、移动硬盘和 NAS 的扫描速度取决于设备和网络。
• 遇到异常时截图扫描进度和错误信息，再反馈报告。