feat(music): 音乐订阅刷新与识别缓存

app/api/endpoints/music.py

@@ -8,11 +8,14 @@ from app.chain.music import MusicChain
 from app.schemas.types import MediaType
 from app.core.context import MusicAlbumInfo, MusicArtistInfo, MusicInfo
 from app.core.security import verify_token
+from app.db.models.user import User
+from app.db.user_oper import get_current_active_superuser_async
 from app.modules.listenbrainz import (
     LISTENBRAINZ_CHART_RANGES,
     LISTENBRAINZ_FRESH_MAX_DAYS,
     LISTENBRAINZ_FRESH_SORTS,
 )
+from app.modules.musicbrainz.music_cache import MusicBrainzCache
 
 router = APIRouter()
 
@@ -67,6 +70,53 @@ async def recognize_music(
     return _serialize_music(info)
 
 
+@router.get(
+    "/cache", summary="查询音乐识别缓存", response_model=schemas.Response
+)
+async def music_recognition_cache(
+    _: User = Depends(get_current_active_superuser_async),
+) -> schemas.Response:
+    """查询可管理的 MusicBrainz 识别缓存。"""
+    cache_items = MusicBrainzCache().list_items()
+    recognized_count = sum(1 for item in cache_items if item["media_id"])
+    return schemas.Response(
+        success=True,
+        data={
+            "count": len(cache_items),
+            "recognized": recognized_count,
+            "unrecognized": len(cache_items) - recognized_count,
+            "data": cache_items,
+        },
+    )
+
+
+@router.delete(
+    "/cache/{cache_key:path}",
+    summary="删除指定音乐识别缓存",
+    response_model=schemas.Response,
+)
+async def delete_music_recognition_cache(
+    cache_key: str,
+    _: User = Depends(get_current_active_superuser_async),
+) -> schemas.Response:
+    """按缓存键删除单条 MusicBrainz 识别缓存。"""
+    deleted_item = MusicBrainzCache().delete(cache_key)
+    if not deleted_item:
+        return schemas.Response(success=False, message="音乐识别缓存不存在")
+    return schemas.Response(success=True, message="音乐识别缓存删除成功")
+
+
+@router.delete(
+    "/cache", summary="清空音乐识别缓存", response_model=schemas.Response
+)
+async def clear_music_recognition_cache(
+    _: User = Depends(get_current_active_superuser_async),
+) -> schemas.Response:
+    """清空全部 MusicBrainz 识别缓存。"""
+    MusicBrainzCache().clear()
+    return schemas.Response(success=True, message="音乐识别缓存清理完成")
+
+
 @router.get(
     "/explore",
     summary="探索音乐",

app/api/endpoints/torrent.py

@@ -118,8 +118,11 @@ async def delete_cache(
         if len(cache_data[domain]) == original_count:
             return schemas.Response(success=False, message="未找到指定的种子")
 
-        # 保存更新后的缓存
-        await torrents_chain.async_save_cache(cache_data, torrents_chain.cache_file)
+        # 保存更新后的缓存：影视与音乐分别回写各自存储文件
+        video_cache, music_cache = torrents_chain.split_cache_contexts(cache_data)
+        video_file, music_file = torrents_chain.cache_files()
+        await torrents_chain.async_save_cache(video_cache, video_file)
+        await torrents_chain.async_save_cache(music_cache, music_file)
 
         return schemas.Response(success=True, message="种子删除成功")
     except Exception as e:
@@ -248,8 +251,11 @@ async def reidentify_cache(
         # 更新上下文中的媒体信息
         target_context.media_info = mediainfo
 
-        # 保存更新后的缓存
-        await torrents_chain.async_save_cache(cache_data, TorrentsChain().cache_file)
+        # 保存更新后的缓存：影视与音乐分别回写各自存储文件
+        video_cache, music_cache = torrents_chain.split_cache_contexts(cache_data)
+        video_file, music_file = torrents_chain.cache_files()
+        await torrents_chain.async_save_cache(video_cache, video_file)
+        await torrents_chain.async_save_cache(music_cache, music_file)
 
         return schemas.Response(
             success=True,