歌词缓存:LRC 文件自动存储复用
歌词缓存是什么
AlgerMusicPlayer 从网易云接口拉取歌词(LRC 格式)后,会缓存一份到本地。下次播放同一首歌时直接读本地缓存,减少 API 请求。
默认位置
| 平台 | 默认路径 |
|---|---|
| Windows | %APPDATA%/AlgerMusicPlayer/cache/lyrics/ |
| macOS | ~/Library/Application Support/AlgerMusicPlayer/cache/lyrics/ |
每个文件是标准的 .lrc 格式,文件名通常用歌曲 ID + 哈希命名。
缓存生命周期
| 事件 | 行为 |
|---|---|
| 第一次播放某歌 | 从网易云拉歌词 → 缓存到本地 |
| 再次播放同一歌 | 直接读缓存,不拉接口 |
| 网易云歌词有更新 | Alger 会定期检测 → 拉新覆盖旧缓存 |
| 手动清理缓存 | 删除缓存文件,下次播放重新拉 |
清理方式
设置 → 缓存 → 歌词缓存 → 清理。可以单独清理歌词缓存而不动音乐缓存。
缓存与下载歌词的区别
| 维度 | 缓存歌词 | 下载歌词 |
|---|---|---|
| 生成原因 | 播放时自动缓存 | 下载歌曲时附带 .lrc |
| 位置 | Alger 内部缓存目录 | 下载目录,与歌曲同级 |
| 管理 | Alger 自动管 | 你手动管理 |
| 格式 | 内部命名 | 标准同名 .lrc,可直接用文本编辑器打开 |
v5.1.0 歌词 IPC 修复
v5.1.0 修复了几个歌词相关的底层 bug:
- 歌词缓存 IPC 通道未接入初始化(启动时歌词功能不可用)
- 歌词组件卸载时
groupFadeTimer未清理导致内存泄漏 - preload 层
ipc.on解绑监听器失效
这些都是开发者才能看懂的技术细节,但修复后用户体验更稳定——歌词窗口不会无缘无故消失、内存不会慢慢吃掉。