refactor(chain): P2 结构治理 — 拆 ChainBase 上帝基类为 6 域内聚 Mixin（审计 #16）

[Aqr-K]

背景

P2 结构治理续作（PR #95 拆分 message.py 上帝文件后），处理审计 §6 路线图旗舰项 #16 拆 ChainBase 上帝基类。

变更

app/chain/__init__.py 的 ChainBase（1827 行 / 88 方法）按域拆为 6 个 in-file Mixin：

Mixin	域
_CacheChainMixin	缓存 load/save/remove
_RecognizeMediaChainMixin	识别 / TMDB / 豆瓣 / Bangumi / 图片
_SearchChainMixin	媒体 / 人物 / 集合 / 种子 / 字幕搜索
_DownloadTransferChainMixin	下载 / 转移 / 种子管理 / 媒体存在
_NotificationChainMixin	消息发送 / 编辑 / 删除 / 解析 / 处理状态
_MetadataCategoryChainMixin	元数据图 / 分类 / 命令注册 / 调度

class ChainBase(<6 Mixin>, metaclass=ABCMeta) 继承之；__init__ 与 12 个 name-mangling 分发内核方法（__execute_*/__handle_*/__*_entries/__is_valid_empty/run_module/async_run_module）保留本类——name-mangling 簇须与调用方同类，不可跨类拆分。

为何 in-file 而非分文件

测试有 ~21 处 patch("app.chain.MoviePilotServerHelper…" / "app.chain.MessageTemplateHelper…") 直接 patch chain 模块命名空间的协作者。分文件会使这些 mock 注入点失效（符号查找移到子模块），须逐一重定向、churn 大、易错。in-file Mixin 让模块级符号留原命名空间 → 零测试改动、零 patch 失效，同时完成上帝类按域内聚拆分（审计 #16 核心诉求）。

行为保持证明

证据	结果
88 个方法体 vs 重构前	逐字节一致（纯移动）
方法集（含 name-mangling 改写）	等价 88=88，零丢失/新增
全量 pytest	1970 passed / 19 skipped（=基线）
ruff F401	全通过
__dict__/vars/__mro__ 内省依赖	无
对抗审查（MRO / 子类 override / 契约）	无新回归

28 子类 + 插件

公共 API、from app.chain import ChainBase 导入路径、方法名/签名全不变；27 个子类 + PluginChian(ChainBase) 零改动。

P2 剩余

• refactor(plugin): 抽取 local:// URL 纯工具至 app.utils.plugin_repo(S5a) #9 拆 Scheduler/Monitor、test(S8-step2 #1): transfer 共享工厂 + make_queue_chain（安全网奠基） #38 扩展点登记表：经多 agent 分析判定存在无法行为保持的特例（spider 多触发 / 通知注册顺序），需逻辑重设计，不在本轮。