Lyra：自托管音乐库的歌词、标签与整理工具（开源程序，欢迎测试与 PR）

项目地址： https://github.com/astralwaveorg/lyra
文档： https://github.com/astralwaveorg/lyra/tree/main/docs
镜像：ghcr.io/astralwaveorg/lyra:1.0.0

Lyra 是一个自托管的音乐库维护工具。它不下载音乐，也不接管播放，只维护你已有的本地文件。

它主要做四件事

- 歌词：从 QQ 音乐、网易云音乐、LRCLIB 抓取，写入内嵌歌词和同名 .lrc；已有有效歌词默认跳过；支持逐行对比、批量采纳和撤销。

- 标签：按 MusicBrainz 补齐缺失字段，逐字段显示本地值、来源值和冲突；冲突不会自动覆盖；缺 MBID 或候选有歧义时可以用 AcoustID 指纹兜底。

- 整理：按 艺人 / 专辑 / 音轨号 - 曲名 生成路径；目录可多选，也可以多选排除；所有移动先预览，目标存在不覆盖，移动后为空的目录可以清理，支持批量撤销。

- 重复音频：按“音频完全一致 / 同一录音 / 标题、艺人、时长相近”分类；只检测，不自动删除；删除进入回收站，可以撤销。

为什么做这个

我的曲库在 NAS 上攒了很多年，标签和歌词状态很乱。试过一些工具，最大的顾虑是一键写入之后不知道改了什么，冲突被直接覆盖，出错也退不回去。

所以 Lyra 的原则是：

- 写入前备份，只改目标字段，失败自动回滚；

- 所有移动先给出新旧路径，确认后才执行；

- 删除是移入回收站，不是直接抹掉；

- 重复音频只列出来，删不删由人决定。

- 当然尽可能自动处理，引入 AI 决策能力（我个人使用 MiniMax ）

界面（测试曲库）

http://127.0.0.1:8080。用户名 admin，首次启动的随机密码在 data/initial-password.txt，登录后先改密码。

目前的限制

- 版本是 v1.0.0 ，主要在我自己的曲库上验证，边界情况还需要更多样本。

- 支持 FLAC 、MP3 、OGG Vorbis 、Opus ； OGG / Opus 的封面写入还没做。

- QQ 音乐和网易云的可用性受地区、网络影响； MusicBrainz 公共 API 每秒最多一次请求，大库建议自建镜像。

- 单管理员，没有多用户权限（似乎也不需要）。

- 不会自动整理目录，也不会自动删除重复音频（手动处理，自动风险太高）。

想听听大家的反馈

- 部署有没有卡住或者什么问题

- 歌词或标签匹配有没有明显误判；

- 重复音频的分类是否合理，有没有把不该删的放进待删除；

- 移动端布局、文档和错误提示是否清楚。

回帖或提 Issue 都行。附上版本、部署方式和错误日志即可，记得去掉密码、Token 和私人路径。

项目刚发布，欢迎试用。

觉得有用的话点个 Star 就好。