Files
MoviePilot/app/chain/_interaction.py
jxxghp 7e851dbfa7 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 清单校验排除下划线内部目录
2026-08-16 16:30:16 +08:00

87 lines
2.9 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
from typing import Optional, Tuple, Union
from app.schemas.types import MessageChannel
class InteractionChainMixin:
"""
斜杠命令交互四件套委托remote_list / parse_callback /
handle_callback_interaction / handle_text_interaction。
subscribe、site 等业务链的交互入口完全同构,唯一差异是各自的
交互处理器构造参数。本 mixin 将四件套委托提取为公共实现,
子类只需注入处理器类并实现 _interaction_handler 构造器。
子类注入约定:
- `_interaction_handler_type`:交互处理器类,提供静态 parse_callback
- `_interaction_handler()`:按各链业务动作构造处理器实例。
"""
# 交互处理器类,子类注入(如 SubscribeInteractionHandler / SiteInteractionHandler
_interaction_handler_type: type = None
def _interaction_handler(self):
"""
构造交互处理器实例,由子类按各自业务动作注入实现。
"""
raise NotImplementedError
def remote_list(
self,
arg_str: str = "",
channel: MessageChannel = None,
userid: Union[str, int] = None,
source: Optional[str] = None,
):
"""
斜杠命令统一入口,委托交互处理器。
"""
return self._interaction_handler().remote_list(
arg_str=arg_str, channel=channel, userid=userid, source=source
)
@classmethod
def parse_callback(cls, callback_data: str) -> Optional[Tuple[str, str]]:
"""
解析斜杠命令按钮回调。
"""
return cls._interaction_handler_type.parse_callback(callback_data)
def handle_callback_interaction(
self,
callback_data: str,
channel: MessageChannel,
source: str,
userid: Union[str, int],
username: str,
original_message_id: Optional[Union[str, int]] = None,
original_chat_id: Optional[str] = None,
) -> bool:
"""委托交互处理器处理按钮回调。"""
return self._interaction_handler().handle_callback_interaction(
callback_data=callback_data,
channel=channel,
source=source,
userid=userid,
username=username,
original_message_id=original_message_id,
original_chat_id=original_chat_id,
)
def handle_text_interaction(
self,
channel: MessageChannel,
source: str,
userid: Union[str, int],
username: str,
text: str,
) -> bool:
"""委托交互处理器处理文本输入。"""
return self._interaction_handler().handle_text_interaction(
channel=channel,
source=source,
userid=userid,
username=username,
text=text,
)