feat: fetch and backfill cover art

README.md

@@ -46,7 +46,13 @@ BasePath/
 ## Library 健康检查（只读，修复需确认）
 
 - **只读扫描**：`POST /api/library/health/scan`（可选 `?checkDecode=true` 执行完整解码校验）统计缺元数据、缺封面、缺歌词、孤立侧车（无对应音频的 `.lrc`）与重复曲目，**绝不修改任何文件**。
-- **确认后修复**：`POST /api/library/health/repair` 需请求体 `confirm=true` 才会执行（歌词回填、删除孤立侧车、可选删除解码失败音频）；`confirm=false` 仅演练，不改动磁盘。匹配到音频的侧车永不删除。
+- **确认后修复**：`POST /api/library/health/repair` 需请求体 `confirm=true` 才会执行（歌词回填、封面回填、删除孤立侧车、可选删除解码失败音频）；`confirm=false` 仅演练，不改动磁盘。匹配到音频的侧车永不删除。
+
+**修复示例（含封面回填）**：
+```bash
+# 默认配置下不修改磁盘。加上 confirm=true 与 backfillCovers=true 即可安全回填封面与修复曲库
+curl -X POST -H "Content-Type: application/json" -d '{"confirm": true, "backfillCovers": true}' http://localhost:8080/api/library/health/repair
+```
 
 ## 备份与恢复
 
@@ -98,3 +104,10 @@ cd docker && docker compose up -d --build
 - 音频元数据：jaudiotagger
 - 繁简转换：opencc4j
 - 格式转换：FFmpeg
+
+
+## Cover Art Settings
+- `MANGTOOL_COVER_ENABLED` (default: false) - Enable Cover Art Fetch
+- `MANGTOOL_MB_BASE_URL` (default: https://musicbrainz.org/ws/2)
+- `MANGTOOL_CAA_BASE_URL` (default: https://coverartarchive.org)
+- `MANGTOOL_MB_USER_AGENT` (default: MangTool/1.0 (https://gitea.mangmang.fun/LiuMangMang/MyTool)) - User-Agent for MusicBrainz API requests