fix: enforce artwork-safe music ingestion

2026-07-20 01:56:13 +08:00
parent 4c68e415ee
commit 484c9c0d24
6 changed files with 1223 additions and 78 deletions
@@ -40,6 +40,22 @@ cd frontend && npm ci && npm run dev
 cd docker && docker compose up -d --build
 ```

+## 一次性清理历史曲库
+
+正常导入不会扫描或删除 `Library` 中的历史文件。升级后如需清理旧数据，先运行默认的预览模式：
+
+```bash
+./scripts/cleanup-library.sh --library /path/to/Library --dry-run
+```
+
+确认输出后再显式执行：
+
+```bash
+./scripts/cleanup-library.sh --library /path/to/Library --execute
+```
+
+脚本会优先把音频内嵌封面提取为专辑目录的 `cover.jpg/png`。只有目录和音频都没有封面时，才删除音频及同 basename 的 `.lrc`、`.cue`、`.json`、`.txt` 和图片 sidecar；不会删除公共 `cover.jpg/png` 或其他曲目文件。
+
 ## 技术栈

 - 后端：Spring Boot 2.7 + Java 8 + Maven