refactor: 重构事件处理器模块 - 分离处理器实现 (#147)

- 将事件处理器从 concrete_handlers.py 拆分到独立模块
- 创建 handlers/ 目录包含各类事件处理器
- 改进类型提示和文档字符串
- 修正分支名称拼写错误 (splie -> split)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude <noreply@anthropic.com>

Author: TommrraraSnow

.gitignore

@@ -33,6 +33,7 @@ node_modules/
 CLAUDE.md
 .mcp.json
 QWEN.md
+AGENTS.md
 # Ai学习用的文件
 knowledge_base*
 # 运行时生成的文件

zsim/sim_progress/ScheduledEvent/event_handlers/__init__.py

@@ -4,118 +4,8 @@
 该模块定义了事件处理的工厂类，用于管理各种类型的事件处理器。
 """
 
-from typing import Any
-
 from .base import EventHandlerABC
-from .concrete_handlers import register_all_handlers
 from .context import EventContext
+from .handlers import event_handler_factory, register_all_handlers
 
-
-class EventHandlerFactory:
-    """事件处理器工厂类"""
-
-    def __init__(self):
-        self._handlers: dict[str, EventHandlerABC] = {}
-        self._handler_cache: dict[type, EventHandlerABC] = {}
-        self._cache_hits = 0
-        self._cache_misses = 0
-
-    def register_handler(self, handler: EventHandlerABC) -> None:
-        """
-        注册事件处理器
-
-        Args:
-            handler: 事件处理器实例
-
-        Raises:
-            ValueError: 如果已存在相同事件类型的处理器
-        """
-        event_type = handler.event_type
-        if event_type in self._handlers:
-            raise ValueError(f"事件类型 '{event_type}' 的处理器已存在")
-        self._handlers[event_type] = handler
-
-    def get_handler(self, event: Any) -> EventHandlerABC | None:
-        """
-        获取适合处理指定事件的处理器（带缓存）
-
-        Args:
-            event: 待处理的事件对象
-
-        Returns:
-            EventHandler | None: 如果找到合适的处理器则返回，否则返回None
-        """
-        # 检查缓存
-        event_type = type(event)
-        if event_type in self._handler_cache:
-            self._cache_hits += 1
-            return self._handler_cache[event_type]
-
-        # 缓存未命中，查找处理器
-        for handler in self._handlers.values():
-            if handler.can_handle(event):
-                self._handler_cache[event_type] = handler
-                self._cache_misses += 1
-                return handler
-
-        self._cache_misses += 1
-        return None
-
-    def get_handler_by_type(self, event_type: str) -> EventHandlerABC | None:
-        """
-        根据事件类型获取处理器
-
-        Args:
-            event_type: 事件类型名称
-
-        Returns:
-            EventHandler | None: 如果找到处理器则返回，否则返回None
-        """
-        return self._handlers.get(event_type)
-
-    def list_handlers(self) -> list[str]:
-        """
-        获取所有已注册的处理器类型列表
-
-        Returns:
-            list[str]: 处理器类型名称列表
-        """
-        return list(self._handlers.keys())
-
-    def clear_handlers(self) -> None:
-        """清除所有已注册的处理器"""
-        self._handlers.clear()
-        self._handler_cache.clear()
-
-    def get_cache_stats(self) -> dict[str, int | float]:
-        """
-        获取缓存统计信息
-
-        Returns:
-            dict[str, int]: 包含缓存命中率和统计信息的字典
-        """
-        total_requests = self._cache_hits + self._cache_misses
-        hit_rate = (self._cache_hits / total_requests * 100) if total_requests > 0 else 0
-
-        return {
-            "cache_hits": self._cache_hits,
-            "cache_misses": self._cache_misses,
-            "total_requests": total_requests,
-            "hit_rate_percent": round(hit_rate, 2),
-        }
-
-    def reset_cache_stats(self) -> None:
-        """重置缓存统计信息"""
-        self._cache_hits = 0
-        self._cache_misses = 0
-
-    def clear_cache(self) -> None:
-        """清除处理器缓存"""
-        self._handler_cache.clear()
-        self.reset_cache_stats()
-
-
-# 全局处理器工厂实例
-event_handler_factory = EventHandlerFactory()
-
-__all__ = ["event_handler_factory", "register_all_handlers", "EventContext"]
+__all__ = ["EventHandlerABC", "event_handler_factory", "register_all_handlers", "EventContext"]

zsim/sim_progress/ScheduledEvent/event_handlers/base.py

@@ -6,12 +6,8 @@
 from .context import EventContext
 
 if TYPE_CHECKING:
-    from zsim.sim_progress.data_struct import (
-        ActionStack,
-    )
     from zsim.sim_progress.Enemy import Enemy
     from zsim.simulator.dataclasses import ScheduleData
-    from zsim.simulator.simulator_class import Simulator
 
 
 class EventHandlerABC(ABC):
@@ -78,19 +74,19 @@ def _get_context_enemy(self, context: EventContext) -> Enemy:
         """从上下文中获取敌人对象"""
         return context.get_enemy()
 
-    def _get_context_dynamic_buff(self, context: EventContext) -> dict:
+    def _get_context_dynamic_buff(self, context: EventContext):
         """从上下文中获取动态buff"""
         return context.get_dynamic_buff()
 
-    def _get_context_exist_buff_dict(self, context: EventContext) -> dict:
+    def _get_context_exist_buff_dict(self, context: EventContext):
         """从上下文中获取已存在buff字典"""
         return context.get_exist_buff_dict()
 
-    def _get_context_action_stack(self, context: EventContext) -> ActionStack:
+    def _get_context_action_stack(self, context: EventContext):
         """从上下文中获取动作栈"""
         return context.get_action_stack()
 
-    def _get_context_sim_instance(self, context: EventContext) -> Simulator:
+    def _get_context_sim_instance(self, context: EventContext):
         """从上下文中获取模拟器实例"""
         return context.get_sim_instance()
 
@@ -132,12 +128,14 @@ def _validate_context(self, context: EventContext) -> None:
         Raises:
             ValueError: 当上下文无效时
         """
-        if not isinstance(context, EventContext):
+        if not isinstance(context, EventContext):  # type: ignore
             raise TypeError("上下文必须是EventContext类型")
 
         # Pydantic模型已经确保了数据的完整性和有效性
 
-    def _handle_error(self, error: Exception, operation: str, event: Any = None) -> None:
+    def _handle_error(
+        self, error: Exception, operation: str, event: Any = None
+    ) -> None:
         """
         统一错误处理方法