refactor(chain): chain 与 module 仅经 run_module 契约互联，实现模块内容封闭

- mTorrent 字幕链接解析下沉为 IndexerModule.site_subtitle_links，subtitle 模块自行跳过 API 站点
- TMDB/MusicBrainz 识别缓存管理改为模块方法（tmdb_cache_*/music_cache_*）经 run_module 分发
- WechatClawBot 客户端查找/临时客户端/缓存迁移内聚为 wechatclawbot_* 模块方法，
  chain 移除 WechatClawBot 类与 ModuleManager 内省
- LISTENBRAINZ_* 常量迁至 schemas/types.py，模块与链层再导入保持兼容
- TMDbException 升为 schemas/exception.py 跨层契约，vendored 异常保持类身份一致
- 架构守护测试新增 test_chain_does_not_import_module_internals（共 18 项）
- 文档同步：chain->module 仅允许 run_module 分发，直接导入禁止

app/api/endpoints/music.py

@@ -111,7 +111,7 @@ async def music_recognition_cache(
     _: User = Depends(get_current_active_superuser_async),
 ) -> schemas.Response:
     """查询可管理的 MusicBrainz 识别缓存。"""
-    cache_items = MusicBrainzChain.cache_items()
+    cache_items = MusicBrainzChain().cache_items()
     recognized_count = sum(1 for item in cache_items if item["media_id"])
     return schemas.Response(
         success=True,
@@ -134,7 +134,7 @@ async def delete_music_recognition_cache(
     _: User = Depends(get_current_active_superuser_async),
 ) -> schemas.Response:
     """按缓存键删除单条 MusicBrainz 识别缓存。"""
-    deleted_item = MusicBrainzChain.delete_cache(cache_key)
+    deleted_item = MusicBrainzChain().delete_cache(cache_key)
     if not deleted_item:
         return schemas.Response(success=False, message="音乐识别缓存不存在")
     return schemas.Response(success=True, message="音乐识别缓存删除成功")
@@ -147,7 +147,7 @@ async def clear_music_recognition_cache(
     _: User = Depends(get_current_active_superuser_async),
 ) -> schemas.Response:
     """清空全部 MusicBrainz 识别缓存。"""
-    MusicBrainzChain.clear_cache()
+    MusicBrainzChain().clear_cache()
     return schemas.Response(success=True, message="音乐识别缓存清理完成")
 
 

app/api/endpoints/notification.py

@@ -27,7 +27,7 @@ def wechatclawbot_status(
     _: User = Depends(get_current_active_superuser),
 ):
     """查询微信 ClawBot 登录状态和二维码。"""
-    client, errmsg = MessageChain.get_wechatclawbot_client(
+    client, errmsg = MessageChain().get_wechatclawbot_client(
         source=source,
         fallback_source=fallback_source,
         WECHATCLAWBOT_BASE_URL=WECHATCLAWBOT_BASE_URL,
@@ -62,7 +62,7 @@ def refresh_wechatclawbot_qrcode(
     _: User = Depends(get_current_active_superuser),
 ):
     """刷新微信 ClawBot 二维码。"""
-    client, errmsg = MessageChain.get_wechatclawbot_client(
+    client, errmsg = MessageChain().get_wechatclawbot_client(
         source=source,
         fallback_source=fallback_source,
         WECHATCLAWBOT_BASE_URL=WECHATCLAWBOT_BASE_URL,
@@ -96,7 +96,7 @@ def logout_wechatclawbot(
     _: User = Depends(get_current_active_superuser),
 ):
     """退出微信 ClawBot 登录。"""
-    client, errmsg = MessageChain.get_wechatclawbot_client(
+    client, errmsg = MessageChain().get_wechatclawbot_client(
         source=source,
         fallback_source=fallback_source,
         WECHATCLAWBOT_BASE_URL=WECHATCLAWBOT_BASE_URL,
@@ -130,7 +130,7 @@ def test_wechatclawbot(
     _: User = Depends(get_current_active_superuser),
 ):
     """测试微信 ClawBot 当前登录态是否可用。"""
-    client, errmsg = MessageChain.get_wechatclawbot_client(
+    client, errmsg = MessageChain().get_wechatclawbot_client(
         source=source,
         fallback_source=fallback_source,
         WECHATCLAWBOT_BASE_URL=WECHATCLAWBOT_BASE_URL,
@@ -158,7 +158,7 @@ def migrate_wechatclawbot_cache(
     _: User = Depends(get_current_active_superuser),
 ):
     """在通知名称变更时迁移对应的微信 ClawBot 登录缓存。"""
-    success, message = MessageChain.migrate_wechatclawbot_cache(
+    success, message = MessageChain().migrate_wechatclawbot_cache(
         old_name=old_source,
         new_name=new_source,
         cleanup_old=cleanup_old,

app/api/endpoints/recommend.py

@@ -7,7 +7,7 @@ from app.api.response import ResponseAPIRouter
 from app.chain.recommend import RecommendChain
 from app.runtime.events import eventmanager
 from app.application.security.access import verify_token
-from app.chain.tmdb import TMDbException
+from app.schemas.exception import TMDbException
 from app.schemas import RecommendSourceEventData
 from app.schemas.types import ChainEventType
 

app/api/endpoints/tmdb.py

@@ -24,7 +24,7 @@ async def tmdb_recognition_cache(
     _: User = Depends(get_current_active_superuser_async),
 ) -> schemas.Response:
     """查询可管理的 TheMovieDb 识别缓存。"""
-    cache_items = TmdbChain.cache_items()
+    cache_items = TmdbChain().cache_items()
     recognized_count = sum(1 for item in cache_items if item["tmdb_id"])
     return schemas.Response(
         success=True,
@@ -51,7 +51,7 @@ async def delete_tmdb_recognition_cache(
     _: User = Depends(get_current_active_superuser_async),
 ) -> schemas.Response:
     """按缓存键删除单条 TheMovieDb 识别缓存。"""
-    deleted_item = TmdbChain.delete_cache(cache_key)
+    deleted_item = TmdbChain().delete_cache(cache_key)
     if not deleted_item:
         return schemas.Response(success=False, message="TheMovieDb 识别缓存不存在")
     return schemas.Response(success=True, message="TheMovieDb 识别缓存删除成功")
@@ -64,7 +64,7 @@ async def clear_tmdb_recognition_cache(
     _: User = Depends(get_current_active_superuser_async),
 ) -> schemas.Response:
     """清空全部 TheMovieDb 识别缓存。"""
-    TmdbChain.clear_cache()
+    TmdbChain().clear_cache()
     return schemas.Response(success=True, message="TheMovieDb 识别缓存清理完成")