音乐缓存机制：在线播放时自动下载临时文件

什么是缓存

AlgerMusicPlayer 在线播放歌曲时，会把音频文件的一部分下载到本地临时目录。下次再播放同一首歌时直接从本地读取，不用重复下载。

缓存 vs 下载：

• 缓存：临时文件，Alger 自动管理和清理，不是你主动保存的
• 下载：你主动操作保存的，永久留在磁盘（直到你手动删）

v5.1.0 缓存重构

v5.1.0 对音乐和歌词缓存逻辑做了统一重构：

• 支持可配置缓存目录（之前写死在系统临时目录）
• 进度追踪机制统一，移除重复的 rAF 更新循环
• 缓存目录结构优化，查找和清理更高效

默认缓存位置

缓存管理

自动过期

AlgerMusicPlayer 会自动清理过旧的缓存文件（超过一定时间未播放）。但清理策略保守，不会激进删。

手动清理

设置 → 缓存 → 音乐缓存 → 清理，可以：

• 一键清理全部缓存
• 按大小排序后选择性清理
• 查看缓存占用的磁盘空间

缓存大小限制

部分版本支持设置缓存大小上限（比如限制最多 5GB），超过时自动清理最旧的缓存。

缓存与灰色歌曲

灰色歌曲通过 UNM 解析后，播放的音源来自替代平台（QQ / 酷我等）。这些音源的缓存同样会被 Alger 缓存管理，和网易云音源的缓存混在一起。清理缓存时两者一起清。

缓存文件能直接用吗

缓存文件是 Alger 管理的内部格式（可能是加密或分块存储的），不要手动打开或直接用来播放。需要保存的话用「下载」功能。