Folia 的“本地音乐”是什么意思？
本地音乐指的是存放在你自己设备上的音频文件。Folia 会读取这些文件的位置、标题、艺术家、专辑、时长与内嵌封面，在你的设备上建立索引。音频文件本身不会被上传到服务器。
这与“云端曲库”不同：你不需要先上传歌曲才能播放，也不需要保持登录状态才能访问自己的音乐。只要文件还在本地，Folia 就能读取并播放。
音乐已经在你的设备里，播放器要做的只是把它好好呈现出来。
支持哪些音频格式？
Folia 可导入常见的本地音频格式，包括无损与有损压缩格式。实际播放能力还会受到操作系统解码支持的影响。
| 格式 | 类型 | 说明 |
|---|---|---|
| FLAC | 无损压缩 | 保留完整音频信息，体积较 WAV 小 |
| WAV | 无损未压缩 | 兼容性好，文件体积较大 |
| MP3 | 有损压缩 | 最常见的便携格式，兼容性最好 |
| M4A / AAC | 有损 / 无损 | Apple 生态常见格式 |
| OGG / OPUS | 有损压缩 | 部分系统与浏览器支持 |
关于“无损”：播放器不会把无损文件二次压缩，但最终听感仍取决于耳机、音箱、声卡与系统音量处理。关闭系统的音效增强，通常更接近文件本身的声音。
如何导入本地音乐？
- 打开 Folia，进入“本地音乐”或“音乐库”设置。
- 选择存放音乐的文件夹。建议一个文件夹只放音频与对应歌词，避免混入无关文件。
- 等待 Folia 扫描并读取歌曲信息。歌曲较多时，首次扫描需要一点时间。
- 扫描完成后，按艺术家、专辑或歌曲列表浏览。播放任意歌曲即可进入播放页。
- 如果后续新增了歌曲，可以重新扫描，或在设置中触发音乐库更新。
如果导入后没有显示歌曲，先确认文件夹权限与文件格式，再检查是否选择了正确的目录。部分系统会对“音乐”“下载”等目录设置额外访问权限。
歌词文件怎么放？
最简单的方式，是让歌词文件与音频文件同名，并放在同一目录：
- 音频：
夜曲.flac - 歌词：
夜曲.lrc或夜曲.ttml
Folia 会自动寻找同目录下的 .lrc、.vtt、.ttml、.qrc、.yrc、.krc 等歌词文件，也能读取音频内嵌的 LRC 歌词。若歌词文件命名与音频不一致，自动识别可能失败，需要手动匹配。
封面、艺术家与专辑信息不对怎么办？
本地文件的信息通常来自音频标签。标签不准确时，Folia 的在线匹配也可能跟着出错。建议先修正文件本身的标题、艺术家与专辑，再重新扫描。
- 优先使用完整的“艺术家 - 标题”命名，减少同名歌曲误匹配。
- 现场版、翻唱版、纯音乐与伴奏版，建议在标题中保留版本信息。
- 匹配错误时，可以在歌曲设置中重新选择候选，或恢复本地原始信息。
- 合并、拆分艺术家与专辑实体时，先确认不会影响其他歌曲的归类。
如何整理自己的音乐库？
Folia 按歌曲、艺术家、专辑与歌单组织本地音乐。一个清晰的文件结构，会让扫描和浏览都更轻松。可以参考下面的习惯：
- 按“艺术家 / 专辑 / 曲目”建立文件夹层级。
- 专辑封面统一命名为
cover.jpg或直接写入音频标签。 - 歌词与音频同名同目录，避免多版本歌词混用。
- 定期备份音乐文件夹，播放器的索引不等于音频备份。
本地音乐与隐私
Folia 的本地音乐索引保存在设备上，音频文件不会上传。使用在线歌词与封面匹配时，客户端会发送必要的歌曲信息来查询结果，但不会上传音频内容本身。
如果你完全不想联网，也可以只使用本地歌词与封面。提前准备好同名歌词和封面文件，断开网络后依然可以播放并显示歌词。
常见问题速查
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 导入后没有歌曲 | 目录权限不足或格式不支持 | 更换目录、检查文件格式后重新扫描 |
| 有歌曲但没有歌词 | 缺少同名歌词或在线匹配失败 | 放置同名 .lrc 文件，或手动选择歌词 |
| 歌词与声音不同步 | 歌词时间轴本身有偏差 | 更换歌词版本，或使用逐字歌词文件 |
| 封面显示错误 | 音频标签或匹配结果错误 | 修正标签，重新匹配或恢复本地信息 |
| 新增歌曲不显示 | 索引尚未更新 | 重新扫描音乐库 |
