抽象send方法，添加注释

core/command_manager.py

@@ -1,3 +1,8 @@
+"""
+命令管理器模块
+
+提供装饰器用于注册消息指令、通知处理器和请求处理器，并负责事件的分发。
+"""
 import inspect
 from typing import Any, Callable, Dict, List, Tuple
 
@@ -8,7 +13,16 @@ comm_prefixes = global_config.bot.get("command", ("/",))
 
 
 class CommandManager:
+    """
+    命令管理器，负责注册和分发指令、通知和请求事件
+    """
+
     def __init__(self, prefixes: Tuple[str, ...] = ("/",)):
+        """
+        初始化命令管理器
+
+        :param prefixes: 命令前缀元组
+        """
         self.prefixes = prefixes
         self.commands: Dict[str, Callable] = {}  # 存储消息指令
         self.notice_handlers: List[Dict] = []  # 存储通知处理器
@@ -16,7 +30,12 @@ class CommandManager:
 
     # --- 1. 消息指令装饰器 ---
     def command(self, name: str):
-        """装饰器：注册消息指令，例如 @matcher.command("echo")"""
+        """
+        装饰器：注册消息指令
+
+        :param name: 指令名称（不含前缀）
+        :return: 装饰器函数
+        """
 
         def decorator(func):
             self.commands[name] = func
@@ -26,7 +45,12 @@ class CommandManager:
 
     # --- 2. 通知事件装饰器 ---
     def on_notice(self, notice_type: str = None):
-        """装饰器：注册通知处理器"""
+        """
+        装饰器：注册通知处理器
+
+        :param notice_type: 通知类型，如果为 None 则处理所有通知
+        :return: 装饰器函数
+        """
 
         def decorator(func):
             self.notice_handlers.append({"type": notice_type, "func": func})
@@ -36,7 +60,12 @@ class CommandManager:
 
     # --- 3. 请求事件装饰器 ---
     def on_request(self, request_type: str = None):
-        """装饰器：注册请求处理器"""
+        """
+        装饰器：注册请求处理器
+
+        :param request_type: 请求类型，如果为 None 则处理所有请求
+        :return: 装饰器函数
+        """
 
         def decorator(func):
             self.request_handlers.append({"type": request_type, "func": func})
@@ -46,7 +75,12 @@ class CommandManager:
 
     # --- 消息分发逻辑 ---
     async def handle_message(self, bot, event):
-        """解析并分发消息指令"""
+        """
+        解析并分发消息指令
+
+        :param bot: Bot 实例
+        :param event: 消息事件对象
+        """
         if not event.raw_message:
             return
 
@@ -77,21 +111,38 @@ class CommandManager:
 
     # --- 通知分发逻辑 ---
     async def handle_notice(self, bot, event):
-        """分发通知事件"""
+        """
+        分发通知事件
+
+        :param bot: Bot 实例
+        :param event: 通知事件对象
+        """
         for handler in self.notice_handlers:
             if handler["type"] is None or handler["type"] == event.notice_type:
                 await self._run_handler(handler["func"], bot, event)
 
     # --- 请求分发逻辑 ---
     async def handle_request(self, bot, event):
-        """分发请求事件"""
+        """
+        分发请求事件
+
+        :param bot: Bot 实例
+        :param event: 请求事件对象
+        """
         for handler in self.request_handlers:
             if handler["type"] is None or handler["type"] == event.request_type:
                 await self._run_handler(handler["func"], bot, event)
 
     # --- 通用执行器：自动注入参数 ---
     async def _run_handler(self, func, bot, event, args=None):
-        """根据函数签名自动注入 bot, event 或 args"""
+        """
+        根据函数签名自动注入 bot, event 或 args
+
+        :param func: 目标处理函数
+        :param bot: Bot 实例
+        :param event: 事件对象
+        :param args: 指令参数（仅消息指令有效）
+        """
         sig = inspect.signature(func)
         params = sig.parameters
         kwargs = {}