refactor(chain): 处理链功能域 mixin 化，清理未使用导入并根治兼容层循环导入

- ChainBase 拆分为 RecognitionMixin/MessageProcessingMixin/NotificationMixin
- TransferChain 拆分为 7 个功能 mixin（_mixins.py），SubscribeChain 音乐订阅域拆出 _music.py
- 斜杠命令交互四件套收敛为 InteractionChainMixin 委托，会话管理器移至 application 层，chain 层不再 re-export
- 模块基础类收敛到 app/modules/_base（notification/mediaserver 语义重命名）
- 清理 app/chain/__init__.py 24 个未使用导入，修正 49 处测试 patch 目标到实际命名空间
- 兼容层 legacy 符号不再并入 __all__，根治 schemas 初始化反向拉起 application.transfer 的循环导入
- 修复 bangumi 集数为字符串时 set_bangumi_info 抛 TypeError
- 新增重复代码等架构门禁测试；capability 清单校验排除下划线内部目录

app/modules/qbittorrent/__init__.py

@@ -2,14 +2,12 @@ from pathlib import Path
 from typing import Set, Tuple, Optional, Union, List, Dict
 
 from qbittorrentapi import TorrentFilesList
-from torrentool.torrent import Torrent
 
 from app import schemas
-from app.runtime.cache import FileCache
 from app.runtime.config import settings
 from app.domain.metainfo import MetaInfo
 from app.runtime.log import logger
-from app.modules import _ModuleBase, _DownloaderBase
+from app.modules._base import _DownloaderModuleBase
 from app.modules.qbittorrent.qbittorrent import Qbittorrent
 from app.schemas import DownloaderTorrent
 from app.schemas.types import (
@@ -19,7 +17,6 @@ from app.schemas.types import (
     TorrentQueryStatus,
     TorrentStatus,
 )
-from app.domain import torrent as torrent_rules
 from app.foundation import size as size_tools
 from app.foundation import temporal as time_tools
 from app.foundation import text as text_tools
@@ -44,7 +41,7 @@ _TORRENT_FILES_RETRY_TIMES = 5
 _TORRENT_FILES_RETRY_INTERVAL = 1
 
 
-class QbittorrentModule(_ModuleBase, _DownloaderBase[Qbittorrent]):
+class QbittorrentModule(_DownloaderModuleBase[Qbittorrent]):
     """
     qBittorrent 下载器模块，负责下载任务添加、文件选择和任务管理。
     """
@@ -90,34 +87,12 @@ class QbittorrentModule(_ModuleBase, _DownloaderBase[Qbittorrent]):
         """
         pass
 
-    def test(self) -> Optional[Tuple[bool, str]]:
-        """
-        测试模块连接性
-        """
-        if not self.get_instances():
-            return None
-        for name, server in self.get_instances().items():
-            if server.is_inactive():
-                server.reconnect()
-            if not server.transfer_info():
-                return False, f"无法连接Qbittorrent下载器：{name}"
-        return True, ""
-
     def init_setting(self) -> Tuple[str, Union[str, bool]]:
         """
         返回控制模块启用状态的配置项
         """
         pass
 
-    def scheduler_job(self) -> None:
-        """
-        定时任务，每10分钟调用一次
-        """
-        for name, server in self.get_instances().items():
-            if server.is_inactive():
-                logger.info(f"Qbittorrent下载器 {name} 连接断开，尝试重连 ...")
-                server.reconnect()
-
     def download(self, content: Union[Path, str, bytes], download_dir: Path, cookie: str,
                  episodes: Set[int] = None, category: Optional[str] = None, label: Optional[str] = None,
                  downloader: Optional[str] = None) -> Optional[Tuple[Optional[str], Optional[str], Optional[str], str]]:
@@ -132,39 +107,11 @@ class QbittorrentModule(_ModuleBase, _DownloaderBase[Qbittorrent]):
         :param downloader:  下载器
         :return: 下载器名称、种子Hash、种子文件布局、错误原因
         """
-
-        def __get_torrent_info() -> Tuple[Optional[Torrent], Optional[bytes]]:
-            """
-            获取种子名称
-            """
-            torrent_info, torrent_content = None, None
-            try:
-                if isinstance(content, Path):
-                    if content.exists():
-                        torrent_content = content.read_bytes()
-                    else:
-                        # 读取缓存的种子文件
-                        torrent_content = FileCache().get(content.as_posix(), region="torrents")
-                else:
-                    torrent_content = content
-
-                if torrent_content:
-                    # 检查是否为磁力链接
-                    if torrent_rules.is_magnet_link(torrent_content):
-                        return None, torrent_content
-                    else:
-                        torrent_info = Torrent.from_string(torrent_content)
-
-                return torrent_info, torrent_content
-            except Exception as e:
-                logger.error(f"获取种子名称失败：{e}")
-                return None, None
-
         if not content:
             return None, None, None, "下载内容为空"
 
         # 读取种子的名称
-        torrent_from_file, content = __get_torrent_info()
+        torrent_from_file, content = self._get_torrent_info(content)
         # 检查是否为磁力链接
         is_magnet = isinstance(content, str) and content.startswith("magnet:") or isinstance(content,
                                                                                              bytes) and content.startswith(
@@ -302,7 +249,7 @@ class QbittorrentModule(_ModuleBase, _DownloaderBase[Qbittorrent]):
         else:
             servers: Dict[str, Qbittorrent] = self.get_instances()
         ret_torrents = []
-        query_status = self.__normalize_query_status(status)
+        query_status = self._normalize_query_status(status)
         query_tags = None if include_all_tags else settings.TORRENT_TAG
 
         def __get_torrent_path(torrent_data: dict) -> Path:
@@ -408,41 +355,6 @@ class QbittorrentModule(_ModuleBase, _DownloaderBase[Qbittorrent]):
             return None
         return ret_torrents  # noqa
 
-    @staticmethod
-    def __normalize_query_status(
-            status: Optional[Union[TorrentStatus, TorrentQueryStatus, str]]
-    ) -> TorrentQueryStatus:
-        """
-        归一任务查询状态。
-        """
-        status_value = getattr(status, "value", status)
-        status_text = str(status_value or "").strip().lower()
-        if not status_text or status_text in {"all", "全部"}:
-            return TorrentQueryStatus.ALL
-        if status_text in {
-            TorrentStatus.TRANSFER.value,
-            TorrentQueryStatus.TRANSFER.value,
-            "transfer",
-        }:
-            return TorrentQueryStatus.TRANSFER
-        if status_text in {
-            TorrentStatus.DOWNLOADING.value,
-            TorrentQueryStatus.DOWNLOADING.value,
-            "downloading",
-        }:
-            return TorrentQueryStatus.DOWNLOADING
-        if status_text in {
-            TorrentQueryStatus.COMPLETED.value,
-            "complete",
-            "seeding",
-            "完成",
-            "已完成",
-        }:
-            return TorrentQueryStatus.COMPLETED
-        if status_text in {TorrentQueryStatus.PAUSED.value, "pause", "暂停", "已暂停"}:
-            return TorrentQueryStatus.PAUSED
-        return TorrentQueryStatus.ALL
-
     @staticmethod
     def __normalize_torrent_state(state: Optional[Union[str, int]]) -> str:
         """