本地音频从外部分享到授权文件夹扫描的完整导入链路

四种导入方式

所有导入入口都不需要任何平台账号授权，是 NeriPlayer 最轻量的使用方式。

歌词与封面 sidecar 识别

扫描时应用会自动识别音频文件附近的 sidecar 文件：

• 歌词：同名 .lrc 或 .txt 文件
• 封面：目录下的 cover.* / folder.* / front.* 图片

如果音频文件自身已嵌入 ID3v2 标签（封面、歌词），sidecar 文件会作为补充或回退。

大批量扫描的两阶段策略

大批量扫描不会一次性把所有元信息都处理完，而是分两步：

1. 快速预览：先快速提取文件名、大小、时长等基础信息，立刻展示扫描结果列表，支持按「已有元信息」过滤
2. 后台补全：选中确认后，在后台线程补全更完整的歌名、歌手、专辑和封面信息

这样用户不需要等很久就能看到扫描结果。

SAF 空目录不误清理

通过 SAF 选择目录后，如果应用读到空目录结果，不会自动清理之前已经索引好的旧目录内容——避免因临时权限变化或 SAF 延迟导致误删本地索引。

外部分享的处理

从其他应用用「打开方式 → NeriPlayer」时，应用会把这个文件加入本地列表并提示用户是否保存到本地歌单。分享多个文件时同样逐个处理。

• [本地歌手分类]${1}02-local-artist.md${2}
• [本地歌单操作]${1}03-local-playlist.md${2}