ErisPulse 2.2.0.dev0__py3-none-any.whl → 2.2.0.dev2__py3-none-any.whl

ErisPulse/Core/Event/__init__.py

@@ -1,31 +1,34 @@
-from .. import adapter
 """
 ErisPulse 事件处理模块
 
 提供统一的事件处理接口，支持命令、消息、通知、请求和元事件处理
+
+{!--< tips >!--}
+1. 所有事件处理都基于OneBot12标准事件格式
+2. 通过装饰器方式注册事件处理器
+3. 支持优先级和条件过滤
+{!--< /tips >!--}
 """
 
-from .cmd import command
+from .command import command
 from .message import message
 from .notice import notice
 from .request import request
 from .meta import meta
-from .manager import event_manager
 from . import exceptions
 from .. import config
 
 # 初始化默认配置
 def _setup_default_config():
     """
-    设置默认配置
-    
     {!--< internal-use >!--}
-    内部使用的方法，用于初始化默认配置
+    设置默认配置
     """
     default_config = {
         "command": {
             "prefix": "/",
-            "case_sensitive": True
+            "case_sensitive": True,
+            "allow_space_prefix": False
         },
         "message": {
             "ignore_self": True
@@ -44,6 +47,5 @@ __all__ = [
     "notice",
     "request",
     "meta",
-    "event_manager",
     "exceptions"
 ]

ErisPulse/Core/Event/base.py

@@ -1,19 +1,23 @@
 """
 ErisPulse 事件处理基础模块
 
-提供事件处理的核心功能，包括事件注册、处理和中间件支持
+提供事件处理的核心功能，包括事件注册和处理
+
+{!--< tips >!--}
+1. 所有事件处理都基于OneBot12标准事件格式
+2. 通过适配器系统进行事件分发和接收
+{!--< /tips >!--}
 """
 
 from .. import adapter, logger
-from typing import Callable, Any, Dict, List, Optional, Union
+from typing import Callable, Any, Dict, List, Optional
 import asyncio
-import functools
 
 class BaseEventHandler:
     """
     基础事件处理器
     
-    提供事件处理的基本功能，包括处理器注册、中间件支持等
+    提供事件处理的基本功能，包括处理器注册等
     """
     
     def __init__(self, event_type: str, module_name: str = None):
@@ -26,17 +30,6 @@ class BaseEventHandler:
         self.event_type = event_type
         self.module_name = module_name
         self.handlers: List[Dict] = []
-        self.middlewares: List[Callable] = []
-    
-    def middleware(self, func: Callable) -> Callable:
-        """
-        添加中间件
-        
-        :param func: 中间件函数
-        :return: 中间件函数
-        """
-        self.middlewares.append(func)
-        return func
     
     def register(self, handler: Callable, priority: int = 0, condition: Callable = None):
         """
@@ -82,30 +75,19 @@ class BaseEventHandler:
         
         :param event: 事件数据
         """
-        # 执行中间件
-        processed_event = event
-        for middleware in self.middlewares:
-            try:
-                if asyncio.iscoroutinefunction(middleware):
-                    processed_event = await middleware(processed_event)
-                else:
-                    processed_event = middleware(processed_event)
-            except Exception as e:
-                logger.error(f"中间件执行错误: {e}")
-        
         # 执行处理器
         for handler_info in self.handlers:
             condition = handler_info.get("condition")
             # 检查条件
-            if condition and not condition(processed_event):
+            if condition and not condition(event):
                 continue
                 
             handler = handler_info["func"]
             try:
                 if asyncio.iscoroutinefunction(handler):
-                    await handler(processed_event)
+                    await handler(event)
                 else:
-                    handler(processed_event)
+                    handler(event)
             except Exception as e:
                 logger.error(f"事件处理器执行错误: {e}")
     

ErisPulse/Core/Event/{cmd.py → command.py}

@@ -1,33 +1,34 @@
+# ErisPulse/Core/Event/cmd.py
 """
 ErisPulse 命令处理模块
 
 提供基于装饰器的命令注册和处理功能
+
+{!--< tips >!--}
+1. 支持命令别名和命令组
+2. 支持命令权限控制
+3. 支持命令帮助系统
+{!--< /tips >!--}
 """
 
 from .base import BaseEventHandler
-from .manager import event_manager
 from .. import adapter, config, logger
 from typing import Callable, Union, List, Dict, Any, Optional
-import re
 import asyncio
+import re
 
 class CommandHandler:
-    """
-    命令处理器
-    
-    提供命令注册、解析和执行功能
-    """
-    
     def __init__(self):
-        """
-        初始化命令处理器
-        """
         self.commands: Dict[str, Dict] = {}
         self.aliases: Dict[str, str] = {}  # 别名映射
         self.groups: Dict[str, List[str]] = {}  # 命令组
+        self.permissions: Dict[str, Callable] = {}  # 权限检查函数
         self.prefix = config.getConfig("ErisPulse.event.command.prefix", "/")
-        self.handler = event_manager.create_event_handler("message", "command")
+        self.case_sensitive = config.getConfig("ErisPulse.event.command.case_sensitive", True)
+        self.allow_space_prefix = config.getConfig("ErisPulse.event.command.allow_space_prefix", False)
         
+        # 创建消息事件处理器
+        self.handler = BaseEventHandler("message", "command")
         # 注册消息处理器
         self.handler.register(self._handle_message)
     
@@ -36,8 +37,10 @@ class CommandHandler:
                  aliases: List[str] = None,
                  group: str = None,
                  priority: int = 0,
+                 permission: Callable = None,
                  help: str = None,
-                 usage: str = None):
+                 usage: str = None,
+                 hidden: bool = False):
         """
         命令装饰器
         
@@ -45,8 +48,10 @@ class CommandHandler:
         :param aliases: 命令别名列表
         :param group: 命令组名称
         :param priority: 处理器优先级
+        :param permission: 权限检查函数，返回True时允许执行命令
         :param help: 命令帮助信息
         :param usage: 命令使用方法
+        :param hidden: 是否在帮助中隐藏命令
         :return: 装饰器函数
         """
         def decorator(func: Callable):
@@ -73,12 +78,18 @@ class CommandHandler:
                     "help": help,
                     "usage": usage,
                     "group": group,
+                    "permission": permission,
+                    "hidden": hidden,
                     "main_name": main_name
                 }
                 
                 # 注册别名映射
                 if cmd_name != main_name:
                     self.aliases[cmd_name] = main_name
+                
+                # 注册权限检查函数
+                if permission and cmd_name not in self.permissions:
+                    self.permissions[cmd_name] = permission
             
             # 添加到命令组
             if group:
@@ -114,12 +125,20 @@ class CommandHandler:
         if not text_content:
             return
         
+        # 处理大小写敏感性
+        check_text = text_content if self.case_sensitive else text_content.lower()
+        prefix = self.prefix if self.case_sensitive else self.prefix.lower()
+        
         # 检查前缀
-        if not text_content.startswith(self.prefix):
-            return
+        if not check_text.startswith(prefix):
+            # 检查是否允许空格前缀 (例如: "/ command")
+            if self.allow_space_prefix and check_text.startswith(prefix + " "):
+                pass
+            else:
+                return
         
         # 解析命令和参数
-        command_text = text_content[len(self.prefix):].strip()
+        command_text = check_text[len(prefix):].strip()
         parts = command_text.split()
         if not parts:
             return
@@ -127,6 +146,10 @@ class CommandHandler:
         cmd_name = parts[0]
         args = parts[1:] if len(parts) > 1 else []
         
+        # 处理大小写敏感性
+        if not self.case_sensitive:
+            cmd_name = cmd_name.lower()
+        
         # 处理别名
         actual_cmd_name = self.aliases.get(cmd_name, cmd_name)
         
@@ -135,6 +158,20 @@ class CommandHandler:
             cmd_info = self.commands[actual_cmd_name]
             handler = cmd_info["func"]
             
+            # 检查权限
+            permission_func = cmd_info.get("permission") or self.permissions.get(actual_cmd_name)
+            if permission_func:
+                try:
+                    has_permission = permission_func(event) if not asyncio.iscoroutinefunction(permission_func) \
+                                    else await permission_func(event)
+                    if not has_permission:
+                        await self._send_permission_denied(event)
+                        return
+                except Exception as e:
+                    logger.error(f"权限检查错误: {e}")
+                    await self._send_permission_denied(event)
+                    return
+            
             # 添加命令相关信息到事件
             command_info = {
                 "name": actual_cmd_name,
@@ -155,7 +192,52 @@ class CommandHandler:
                     handler(event)
             except Exception as e:
                 logger.error(f"命令执行错误: {e}")
-                # 可以发送错误信息给用户
+                await self._send_command_error(event, str(e))
+    
+    async def _send_permission_denied(self, event: Dict[str, Any]):
+        """
+        发送权限拒绝消息
+        
+        {!--< internal-use >!--}
+        内部使用的方法
+        
+        :param event: 事件数据
+        """
+        try:
+            platform = event.get("platform")
+            user_id = event.get("user_id")
+            group_id = event.get("group_id")
+            detail_type = "group" if group_id else "private"
+            target_id = group_id or user_id
+            
+            if platform and hasattr(adapter, platform):
+                adapter_instance = getattr(adapter, platform)
+                await adapter_instance.Send.To(detail_type, target_id).Text("权限不足，无法执行该命令")
+        except Exception as e:
+            logger.error(f"发送权限拒绝消息失败: {e}")
+    
+    async def _send_command_error(self, event: Dict[str, Any], error: str):
+        """
+        发送命令错误消息
+        
+        {!--< internal-use >!--}
+        内部使用的方法
+        
+        :param event: 事件数据
+        :param error: 错误信息
+        """
+        try:
+            platform = event.get("platform")
+            user_id = event.get("user_id")
+            group_id = event.get("group_id")
+            detail_type = "group" if group_id else "private"
+            target_id = group_id or user_id
+            
+            if platform and hasattr(adapter, platform):
+                adapter_instance = getattr(adapter, platform)
+                await adapter_instance.Send.To(detail_type, target_id).Text(f"命令执行出错: {error}")
+        except Exception as e:
+            logger.error(f"发送命令错误消息失败: {e}")
     
     def get_command(self, name: str) -> Optional[Dict]:
         """
@@ -184,11 +266,21 @@ class CommandHandler:
         """
         return self.groups.get(group, [])
     
-    def help(self, command_name: str = None) -> str:
+    def get_visible_commands(self) -> Dict[str, Dict]:
+        """
+        获取所有可见命令（非隐藏命令）
+        
+        :return: 可见命令信息字典
+        """
+        return {name: info for name, info in self.commands.items() 
+                if not info.get("hidden", False) and name == info["main_name"]}
+    
+    def help(self, command_name: str = None, show_hidden: bool = False) -> str:
         """
         生成帮助信息
         
         :param command_name: 命令名称，如果为None则生成所有命令的帮助
+        :param show_hidden: 是否显示隐藏命令
         :return: 帮助信息字符串
         """
         if command_name:
@@ -201,12 +293,18 @@ class CommandHandler:
                 return f"未找到命令: {command_name}"
         else:
             # 生成所有命令的帮助
+            commands_to_show = self.get_visible_commands() if not show_hidden else {
+                name: info for name, info in self.commands.items() 
+                if name == info["main_name"]
+            }
+            
+            if not commands_to_show:
+                return "暂无可用命令"
+            
             help_lines = ["可用命令:"]
-            for cmd_name, cmd_info in self.commands.items():
-                if cmd_name == cmd_info["main_name"]:  # 只显示主命令
-                    help_text = cmd_info.get("help", "无说明")
-                    help_lines.append(f"  {self.prefix}{cmd_name} - {help_text}")
+            for cmd_name, cmd_info in commands_to_show.items():
+                help_text = cmd_info.get("help", "无说明")
+                help_lines.append(f"  {self.prefix}{cmd_name} - {help_text}")
             return "\n".join(help_lines)
 
-# 创建全局命令处理器实例
 command = CommandHandler()

ErisPulse/Core/Event/message.py

@@ -2,26 +2,20 @@
 ErisPulse 消息处理模块
 
 提供基于装饰器的消息事件处理功能
+
+{!--< tips >!--}
+1. 支持私聊、群聊消息分类处理
+2. 支持@消息特殊处理
+3. 支持自定义条件过滤
+{!--< /tips >!--}
 """
 
 from .base import BaseEventHandler
-from .manager import event_manager
-from .. import adapter
 from typing import Callable, Dict, Any
-import asyncio
 
 class MessageHandler:
-    """
-    消息处理器
-    
-    提供不同类型消息事件的处理功能
-    """
-    
     def __init__(self):
-        """
-        初始化消息处理器
-        """
-        self.handler = event_manager.create_event_handler("message", "message")
+        self.handler = BaseEventHandler("message", "message")
     
     def on_message(self, priority: int = 0):
         """
@@ -87,5 +81,4 @@ class MessageHandler:
             return func
         return decorator
 
-# 创建全局消息处理器实例
 message = MessageHandler()

ErisPulse/Core/Event/meta.py

@@ -1,25 +1,21 @@
+# ErisPulse/Core/Event/meta.py
 """
 ErisPulse 元事件处理模块
 
 提供基于装饰器的元事件处理功能
+
+{!--< tips >!--}
+1. 支持连接、断开连接等生命周期事件
+2. 适用于系统状态监控和初始化操作
+{!--< /tips >!--}
 """
 
 from .base import BaseEventHandler
-from .manager import event_manager
 from typing import Callable, Dict, Any
 
 class MetaHandler:
-    """
-    元事件处理器
-    
-    提供元事件（如连接、断开连接、心跳等）的处理功能
-    """
-    
     def __init__(self):
-        """
-        初始化元事件处理器
-        """
-        self.handler = event_manager.create_event_handler("meta", "meta")
+        self.handler = BaseEventHandler("meta", "meta")
     
     def on_meta(self, priority: int = 0):
         """
@@ -78,5 +74,4 @@ class MetaHandler:
             return func
         return decorator
 
-# 创建全局元事件处理器实例
 meta = MetaHandler()

ErisPulse/Core/Event/notice.py

@@ -2,24 +2,19 @@
 ErisPulse 通知处理模块
 
 提供基于装饰器的通知事件处理功能
+
+{!--< tips >!--}
+1. 支持好友、群组等不同类型通知
+2. 支持成员变动等细粒度事件
+{!--< /tips >!--}
 """
 
 from .base import BaseEventHandler
-from .manager import event_manager
 from typing import Callable, Dict, Any
 
 class NoticeHandler:
-    """
-    通知处理器
-    
-    提供不同类型通知事件的处理功能
-    """
-    
     def __init__(self):
-        """
-        初始化通知处理器
-        """
-        self.handler = event_manager.create_event_handler("notice", "notice")
+        self.handler = BaseEventHandler("notice", "notice")
     
     def on_notice(self, priority: int = 0):
         """
@@ -93,5 +88,4 @@ class NoticeHandler:
             return func
         return decorator
 
-# 创建全局通知处理器实例
 notice = NoticeHandler()

ErisPulse/Core/Event/request.py

@@ -2,24 +2,19 @@
 ErisPulse 请求处理模块
 
 提供基于装饰器的请求事件处理功能
+
+{!--< tips >!--}
+1. 支持好友请求、群邀请等不同类型请求
+2. 可以通过返回特定值来同意或拒绝请求
+{!--< /tips >!--}
 """
 
 from .base import BaseEventHandler
-from .manager import event_manager
 from typing import Callable, Dict, Any
 
 class RequestHandler:
-    """
-    请求处理器
-    
-    提供不同类型请求事件的处理功能（如好友申请、群邀请等）
-    """
-    
     def __init__(self):
-        """
-        初始化请求处理器
-        """
-        self.handler = event_manager.create_event_handler("request", "request")
+        self.handler = BaseEventHandler("request", "request")
     
     def on_request(self, priority: int = 0):
         """
@@ -63,5 +58,4 @@ class RequestHandler:
             return func
         return decorator
 
-# 创建全局请求处理器实例
 request = RequestHandler()

ErisPulse/Core/__init__.py

@@ -2,7 +2,8 @@ from .adapter import AdapterFather, SendDSL, adapter
 from .storage import storage
 from .env import env
 from .logger import logger
-from .mods import mods
+from .module_registry import module_registry
+from .module import module
 from .router import router, adapter_server
 from .config import config
 from . import exceptions
@@ -13,15 +14,15 @@ BaseAdapter = AdapterFather
 
 __all__ = [
     'Event',
-    
     'BaseAdapter',
     'AdapterFather',
     'SendDSL',
     'adapter',
+    'module',
     'storage',
     'env',
     'logger',
-    'mods',
+    'module_registry',
     'exceptions',
     'router',
     'adapter_server',

ErisPulse/Core/logger.py

@@ -90,8 +90,8 @@ class Logger:
         :param level: 日志级别(DEBUG/INFO/WARNING/ERROR/CRITICAL)
         :return: bool 设置是否成功
         """
-        from .mods import mods
-        if not mods.get_module_status(module_name):
+        from .module_registry import module_registry
+        if not module_registry.get_module_status(module_name):
             self._logger.warning(f"模块 {module_name} 未启用，无法设置日志等级。")
             return False
         level = level.upper()

ErisPulse/Core/module.py

@@ -0,0 +1,150 @@
+"""
+ErisPulse 模块管理模块
+
+提供便捷的模块访问接口
+"""
+
+from typing import Any, Optional, Dict
+from .module_registry import module_registry
+from .logger import logger
+
+class ModuleManager:
+    """
+    模块管理器
+    
+    提供便捷的模块访问接口，支持获取模块实例、检查模块状态等操作
+    """
+    
+    def __init__(self):
+        self._modules = {}
+    
+    def get(self, module_name: str) -> Any:
+        """
+        获取指定模块的实例
+        
+        :param module_name: [str] 模块名称
+        :return: [Any] 模块实例或None
+        """
+        # 是否已缓存
+        if module_name in self._modules:
+            return self._modules[module_name]
+            
+        # 从模块注册表获取模块信息
+        module_info = module_registry.get_module(module_name)
+        if not module_info:
+            logger.warning(f"模块 {module_name} 未注册")
+            return None
+            
+        # 模块是否启用
+        if not module_registry.get_module_status(module_name):
+            logger.warning(f"模块 {module_name} 已禁用")
+            return None
+            
+        try:
+            from .. import sdk
+            if hasattr(sdk, module_name):
+                module_instance = getattr(sdk, module_name)
+                self._modules[module_name] = module_instance
+                return module_instance
+            else:
+                logger.warning(f"模块 {module_name} 实例未找到")
+                return None
+        except Exception as e:
+            logger.error(f"获取模块 {module_name} 实例时出错: {e}")
+            return None
+    
+    def exists(self, module_name: str) -> bool:
+        """
+        检查模块是否存在
+        
+        :param module_name: [str] 模块名称
+        :return: [bool] 模块是否存在
+        """
+        return module_registry.get_module(module_name) is not None
+    
+    def is_enabled(self, module_name: str) -> bool:
+        """
+        检查模块是否启用
+        
+        :param module_name: [str] 模块名称
+        :return: [bool] 模块是否启用
+        """
+        return module_registry.get_module_status(module_name)
+    
+    def enable(self, module_name: str) -> bool:
+        """
+        启用模块
+        
+        :param module_name: [str] 模块名称
+        :return: [bool] 操作是否成功
+        """
+        if not self.exists(module_name):
+            logger.error(f"模块 {module_name} 不存在")
+            return False
+            
+        module_registry.set_module_status(module_name, True)
+        logger.info(f"模块 {module_name} 已启用")
+        return True
+    
+    def disable(self, module_name: str) -> bool:
+        """
+        禁用模块
+        
+        :param module_name: [str] 模块名称
+        :return: [bool] 操作是否成功
+        """
+        if not self.exists(module_name):
+            logger.error(f"模块 {module_name} 不存在")
+            return False
+            
+        module_registry.set_module_status(module_name, False)
+        logger.info(f"模块 {module_name} 已禁用")
+        # 如果模块在缓存中，移除它
+        if module_name in self._modules:
+            del self._modules[module_name]
+        return True
+    
+    def list_modules(self) -> Dict[str, Dict[str, Any]]:
+        """
+        列出所有模块信息
+        
+        :return: [Dict[str, Dict[str, Any]]] 模块信息字典
+        """
+        return module_registry.get_all_modules()
+    
+    def get_info(self, module_name: str) -> Optional[Dict[str, Any]]:
+        """
+        获取模块详细信息
+        
+        :param module_name: [str] 模块名称
+        :return: [Optional[Dict[str, Any]]] 模块信息字典
+        """
+        return module_registry.get_module(module_name)
+    
+    def __getattr__(self, module_name: str) -> Any:
+        """
+        通过属性访问获取模块实例
+        
+        :param module_name: [str] 模块名称
+        :return: [Any] 模块实例
+        :raises AttributeError: 当模块不存在或未启用时
+        """
+        module_instance = self.get(module_name)
+        if module_instance is None:
+            raise AttributeError(f"模块 {module_name} 不存在或未启用")
+        return module_instance
+    
+    def __contains__(self, module_name: str) -> bool:
+        """
+        检查模块是否存在且处于启用状态
+        
+        :param module_name: [str] 模块名称
+        :return: [bool] 模块是否存在且启用
+        """
+        return self.exists(module_name) and self.is_enabled(module_name)
+
+module = ModuleManager()
+
+__all__ = [
+    "module"
+]

ErisPulse/Core/{mods.py → module_registry.py}

@@ -10,19 +10,18 @@ ErisPulse 模块管理器
 {!--< /tips >!--}
 """
 
-import json
 from typing import Dict, Optional, Any, List, Set, Tuple, Union, Type, FrozenSet
 
-class ModuleManager:
+class ModuleRegistry:
     """
-    模块管理器
+    ErisPulse 模块注册表
     
-    管理所有模块的注册、状态和依赖关系
+    管理所有模块的注册信息和启用状态
     
     {!--< tips >!--}
-    1. 通过set_module/get_module管理模块信息
-    2. 通过set_module_status/get_module_status控制模块状态
-    3. 通过set_all_modules/get_all_modules批量操作模块
+    1. 模块信息通过 set_module/get_module 管理
+    2. 模块状态通过 set_module_status/get_module_status 控制
+    3. 支持批量操作模块信息
     {!--< /tips >!--}
     """
     
@@ -66,14 +65,14 @@ class ModuleManager:
         """
         设置模块启用状态
         
-        :param module_name: 模块名称
-        :param status: 启用状态
+        :param module_name: [str] 模块名称
+        :param status: [bool] 启用状态 (True=启用, False=禁用)
         
         :example:
         >>> # 启用模块
-        >>> mods.set_module_status("MyModule", True)
+        >>> module_registry.set_module_status("MyModule", True)
         >>> # 禁用模块
-        >>> mods.set_module_status("MyModule", False)
+        >>> module_registry.set_module_status("MyModule", False)
         """
         from .logger import logger
         self.storage.set(f"{self.status_prefix}{module_name}", bool(status))
@@ -83,11 +82,11 @@ class ModuleManager:
         """
         获取模块启用状态
         
-        :param module_name: 模块名称
-        :return: 模块是否启用
+        :param module_name: [str] 模块名称
+        :return: [bool] 模块是否启用
         
         :example:
-        >>> if mods.get_module_status("MyModule"):
+        >>> if module_registry.get_module_status("MyModule"):
         >>>     print("模块已启用")
         """
         status = self.storage.get(f"{self.status_prefix}{module_name}", True)
@@ -97,15 +96,19 @@ class ModuleManager:
 
     def set_module(self, module_name: str, module_info: Dict[str, Any]) -> None:
         """
-        设置模块信息
+        注册或更新模块信息
         
-        :param module_name: 模块名称
-        :param module_info: 模块信息字典
+        :param module_name: [str] 模块名称
+        :param module_info: [Dict[str, Any]] 模块信息字典
+            必须包含 version 和 description 字段
         
         :example:
-        >>> mods.set_module("MyModule", {
+        >>> module_registry.set_module("MyModule", {
         >>>     "version": "1.0.0",
         >>>     "description": "我的模块",
+        >>>     "dependencies": [],
+        >>>     "author": "开发者",
+        >>>     "license": "MIT"
         >>> })
         """
         self.storage.set(f"{self.module_prefix}{module_name}", module_info)
@@ -114,11 +117,11 @@ class ModuleManager:
         """
         获取模块信息
         
-        :param module_name: 模块名称
-        :return: 模块信息字典或None
+        :param module_name: [str] 模块名称
+        :return: [Optional[Dict[str, Any]]] 模块信息字典或None
         
         :example:
-        >>> module_info = mods.get_module("MyModule")
+        >>> module_info = module_registry.get_module("MyModule")
         >>> if module_info:
         >>>     print(f"模块版本: {module_info.get('version')}")
         """
@@ -126,12 +129,13 @@ class ModuleManager:
 
     def set_all_modules(self, modules_info: Dict[str, Dict[str, Any]]) -> None:
         """
-        批量设置多个模块信息
+        批量设置模块信息
         
-        :param modules_info: 模块信息字典
+        :param modules_info: [Dict[str, Dict[str, Any]]] 模块信息字典
+            格式: {模块名: 模块信息}
         
         :example:
-        >>> mods.set_all_modules({
+        >>> module_registry.set_all_modules({
         >>>     "Module1": {"version": "1.0", "status": True},
         >>>     "Module2": {"version": "2.0", "status": False}
         >>> })
@@ -141,12 +145,12 @@ class ModuleManager:
 
     def get_all_modules(self) -> Dict[str, Dict[str, Any]]:
         """
-        获取所有模块信息
+        获取所有已注册模块信息
         
-        :return: 模块信息字典
+        :return: [Dict[str, Dict[str, Any]]] 所有模块信息字典
         
         :example:
-        >>> all_modules = mods.get_all_modules()
+        >>> all_modules = module_registry.get_all_modules()
         >>> for name, info in all_modules.items():
         >>>     print(f"{name}: {info.get('status')}")
         """
@@ -173,13 +177,13 @@ class ModuleManager:
 
     def remove_module(self, module_name: str) -> bool:
         """
-        移除模块
+        移除模块注册信息
         
-        :param module_name: 模块名称
-        :return: 是否成功移除
+        :param module_name: [str] 模块名称
+        :return: [bool] 是否成功移除
         
         :example:
-        >>> if mods.remove_module("OldModule"):
+        >>> if module_registry.remove_module("OldModule"):
         >>>     print("模块已移除")
         """
         module_key = f"{self.module_prefix}{module_name}"
@@ -193,14 +197,14 @@ class ModuleManager:
 
     def update_prefixes(self, module_prefix: Optional[str] = None, status_prefix: Optional[str] = None) -> None:
         """
-        更新模块前缀配置
+        更新模块存储前缀配置
         
-        :param module_prefix: 新的模块数据前缀(可选)
-        :param status_prefix: 新的模块状态前缀(可选)
+        :param module_prefix: [Optional[str]] 模块数据前缀 (默认: "erispulse.data.modules.info:")
+        :param status_prefix: [Optional[str]] 模块状态前缀 (默认: "erispulse.data.modules.status:")
         
         :example:
         >>> # 更新模块前缀
-        >>> mods.update_prefixes(
+        >>> module_registry.update_prefixes(
         >>>     module_prefix="custom.module.data:",
         >>>     status_prefix="custom.module.status:"
         >>> )
@@ -216,8 +220,8 @@ class ModuleManager:
             self.storage.set("erispulse.system.status_prefix", status_prefix)
 
 
-mods = ModuleManager()
+module_registry = ModuleRegistry()
 
 __all__ = [
-    "mods",
+    "module_registry",
 ]

ErisPulse/__init__.py

@@ -10,9 +10,6 @@ ErisPulse SDK 主模块
 {!--< /tips >!--}
 """
 
-__version__ = "2.1.15-dev.4"
-__author__  = "ErisPulse"
-
 import os
 import sys
 import importlib
@@ -26,13 +23,20 @@ from pathlib import Path
 from .Core import logger
 from .Core import storage
 from .Core import env
-from .Core import mods
+from .Core import module_registry
 from .Core import adapter, AdapterFather, SendDSL
+from .Core import module
 from .Core import router, adapter_server
 from .Core import exceptions
 from .Core import config
 from .Core import Event
 
+try:
+    __version__ = importlib.metadata.version('ErisPulse')
+except importlib.metadata.PackageNotFoundError:
+    logger.critical("未找到ErisPulse版本信息，请检查是否正确安装ErisPulse")
+__author__  = "ErisPulse"
+
 sdk = sys.modules[__name__]
 
 BaseModules = {
@@ -42,8 +46,9 @@ BaseModules = {
     "exceptions": exceptions,
     "storage": storage,
     "env": env,
-    "mods": mods,
+    "module_registry": module_registry,
     "adapter": adapter,
+    "module": module,
     "router": router,
     "adapter_server": adapter_server,
     "SendDSL": SendDSL,
@@ -256,7 +261,7 @@ class AdapterLoader:
         :raises ImportError: 当适配器加载失败时抛出
         """
         meta_name = entry_point.name
-        adapter_status = mods.get_module_status(meta_name)
+        adapter_status = module_registry.get_module_status(meta_name)
         logger.debug(f"适配器 {meta_name} 状态: {adapter_status}")
         
         if adapter_status is False:
@@ -287,7 +292,7 @@ class AdapterLoader:
             adapter_obj.adapterInfo[meta_name] = adapter_info
             
             # 存储适配器信息
-            mods.set_module(meta_name, adapter_info)
+            module_registry.set_module(meta_name, adapter_info)
                 
             adapter_objs[meta_name] = adapter_obj
             enabled_adapters.append(meta_name)
@@ -371,7 +376,7 @@ class ModuleLoader:
         :raises ImportError: 当模块加载失败时抛出
         """
         meta_name = entry_point.name
-        module_status = mods.get_module_status(meta_name)
+        module_status = module_registry.get_module_status(meta_name)
         logger.debug(f"模块 {meta_name} 状态: {module_status}")
         
         # 首先检查模块状态，如果明确为False则直接跳过
@@ -403,7 +408,7 @@ class ModuleLoader:
             module_obj.moduleInfo = module_info
             
             # 存储模块信息
-            mods.set_module(meta_name, module_info)
+            module_registry.set_module(meta_name, module_info)
                 
             module_objs[meta_name] = module_obj
             enabled_modules.append(meta_name)

ErisPulse/__main__.py

@@ -249,8 +249,8 @@ class PackageManager:
         :raises ImportError: 核心模块不可用时抛出
         """
         try:
-            from ErisPulse.Core import mods
-            return mods.get_module_status(module_name)
+            from ErisPulse.Core import module_registry
+            return module_registry.get_module_status(module_name)
         except ImportError:
             return True
         except Exception:
@@ -1718,21 +1718,21 @@ class CLI:
                     sys.exit(1)
                     
             elif args.command == "module":
-                from ErisPulse.Core import mods
+                from ErisPulse.Core import module_registry
                 installed = self.package_manager.get_installed_packages()
                 
                 if args.module_command == "enable":
                     if args.module not in installed["modules"]:
                         console.print(f"[error]模块 [bold]{args.module}[/] 不存在或未安装[/]")
                     else:
-                        mods.set_module_status(args.module, True)
+                        module_registry.set_module_status(args.module, True)
                         console.print(f"[success]模块 [bold]{args.module}[/] 已启用[/]")
                         
                 elif args.module_command == "disable":
                     if args.module not in installed["modules"]:
                         console.print(f"[error]模块 [bold]{args.module}[/] 不存在或未安装[/]")
                     else:
-                        mods.set_module_status(args.module, False)
+                        module_registry.set_module_status(args.module, False)
                         console.print(f"[warning]模块 [bold]{args.module}[/] 已禁用[/]")
                 else:
                     self.parser.parse_args(["module", "--help"])

{erispulse-2.2.0.dev0.dist-info → erispulse-2.2.0.dev2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.2.0.dev0
+Version: 2.2.0.dev2
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>
 License: MIT License

erispulse-2.2.0.dev2.dist-info/RECORD

@@ -0,0 +1,26 @@
+ErisPulse/__init__.py,sha256=L-YLh-5qMYydReBiBO9weceeH7PVv2ONBo40o5ekr3Y,27133
+ErisPulse/__main__.py,sha256=GUh_30fEkWmE0udDFe1Kkwf41hg2v4WgbRY1RswJ9Uc,76331
+ErisPulse/Core/__init__.py,sha256=96QS7gD0QNt27wQkIprye7y_Nja_IH2XUqPstZ4uLsY,589
+ErisPulse/Core/adapter.py,sha256=y75u_heNmpYLDjIBtVTfMzTHZFixWtYFv0JVskNI-2w,18300
+ErisPulse/Core/config.py,sha256=y0ChfCuw-6jAqs9Ii2tPJg0e4A765qzQLRcK6O8zh4c,2425
+ErisPulse/Core/env.py,sha256=IT_6Xks5Ka089O_4SVTvYNIC9Ly1IHX_Esb3SsleRj8,338
+ErisPulse/Core/erispulse_config.py,sha256=QDx401hNX9JcSHqCSVK33X6VTubl6HI1znAK3T_J0K0,3034
+ErisPulse/Core/exceptions.py,sha256=zuTREGczwGzbYT4Z6dACqHwgNRpiJeLFR8aCxFdOg7k,3667
+ErisPulse/Core/logger.py,sha256=g8HgpzK3k-WpnuiU_UQKWdw4s7BLLHOS23uDFrO_7W8,11285
+ErisPulse/Core/module.py,sha256=wCIFC3qHukeu7DSj8TuNMw8s_gzTwk7_coM4oflmieA,4680
+ErisPulse/Core/module_registry.py,sha256=BeOQwh3Pwv2fceBLJEObF6Ek65td0VOFzv3L0aEudXY,7740
+ErisPulse/Core/router.py,sha256=s2EBh2qpt3UXYhB06Ppc1XTFuZ3u0ZfXENJxwkgPoq8,8542
+ErisPulse/Core/storage.py,sha256=oRum4eVaTc3yxcaafggoIvrk41LPbvApSCxkGM3YmzU,17904
+ErisPulse/Core/Event/__init__.py,sha256=ixL1jaF0qXt0LbHckRWPH7Xu159qeeXQcsp4ZOs8J6Y,1120
+ErisPulse/Core/Event/base.py,sha256=cimfKDvFviZsaFU_DGDaN0G_zlz8r7PdFZiUM7_WuAo,3080
+ErisPulse/Core/Event/command.py,sha256=k6aiAYkkCLg3MTxqDeNF9AIiEtPud9CkMbfJzICeZSM,11266
+ErisPulse/Core/Event/exceptions.py,sha256=iGcuPaC7F4cZeujcvBdZb9bzQGnHBdb9CcPKoB760Bo,711
+ErisPulse/Core/Event/message.py,sha256=dXB2-HYJ20jVzuWqUOzH1V4an-F9csF32n_qCG69Gss,2499
+ErisPulse/Core/Event/meta.py,sha256=KjEXilYe6Vj-t30gBlBRrFHxn8vkhKY1c6W99BOxUr4,2172
+ErisPulse/Core/Event/notice.py,sha256=3z7DDbgEAbY0RgcYw9MdaFwxEDzksqc4QriYSEPfHTY,2705
+ErisPulse/Core/Event/request.py,sha256=ojQpNMlYBGPNF9sh3IUwV-dwXZ8sjJRVcogFQLw_aJ8,1721
+erispulse-2.2.0.dev2.dist-info/METADATA,sha256=s6WbM3VyyFF8nYG2oRqFfC_trASCxMM1RveO7IzMO20,7290
+erispulse-2.2.0.dev2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+erispulse-2.2.0.dev2.dist-info/entry_points.txt,sha256=Jss71M6nEha0TA-DyVZugPYdcL14s9QpiOeIlgWxzOc,182
+erispulse-2.2.0.dev2.dist-info/licenses/LICENSE,sha256=b2XwzcfWuv_36Op3xGdjcuPHgfCz62yT3bXYjfStpxY,1852
+erispulse-2.2.0.dev2.dist-info/RECORD,,

ErisPulse/Core/Event/manager.py

@@ -1,128 +0,0 @@
-"""
-ErisPulse 事件管理器
-
-提供全局事件管理功能，包括事件处理器创建、模块事件管理等
-"""
-
-from .. import adapter, logger, mods
-from .base import BaseEventHandler
-from .exceptions import EventNotFoundException
-from typing import Dict, List, Optional, Callable, Any
-import asyncio
-
-class EventManager:
-    """
-    事件管理器
-    
-    管理所有事件处理器，提供全局事件处理功能
-    """
-    
-    def __init__(self):
-        """
-        初始化事件管理器
-        """
-        self.event_handlers: Dict[str, BaseEventHandler] = {}
-        self.module_events: Dict[str, List[str]] = {}
-        self.global_middlewares: List[Callable] = []
-    
-    def create_event_handler(self, event_type: str, module_name: str = None) -> BaseEventHandler:
-        """
-        创建事件处理器
-        
-        :param event_type: 事件类型
-        :param module_name: 模块名称
-        :return: 事件处理器实例
-        """
-        if event_type not in self.event_handlers:
-            handler = BaseEventHandler(event_type, module_name)
-            self.event_handlers[event_type] = handler
-        return self.event_handlers[event_type]
-    
-    def get_event_handler(self, event_type: str) -> Optional[BaseEventHandler]:
-        """
-        获取事件处理器
-        
-        :param event_type: 事件类型
-        :return: 事件处理器实例，如果不存在则返回None
-        """
-        return self.event_handlers.get(event_type)
-    
-    def register_module_event(self, module_name: str, event_type: str):
-        """
-        注册模块事件
-        
-        :param module_name: 模块名称
-        :param event_type: 事件类型
-        """
-        if module_name not in self.module_events:
-            self.module_events[module_name] = []
-        if event_type not in self.module_events[module_name]:
-            self.module_events[module_name].append(event_type)
-    
-    def middleware(self, func: Callable):
-        """
-        添加全局中间件
-        
-        :param func: 中间件函数
-        :return: 中间件函数
-        """
-        self.global_middlewares.append(func)
-        return func
-    
-    async def emit(self, event_type: str, event_data: Dict[str, Any]):
-        """
-        触发事件
-        
-        :param event_type: 事件类型
-        :param event_data: 事件数据
-        """
-        # 执行全局中间件
-        processed_data = event_data
-        for middleware in self.global_middlewares:
-            try:
-                if asyncio.iscoroutinefunction(middleware):
-                    processed_data = await middleware(processed_data)
-                else:
-                    processed_data = middleware(processed_data)
-            except Exception as e:
-                logger.error(f"全局中间件执行错误: {e}")
-        
-        # 触发事件处理器
-        if event_type in self.event_handlers:
-            handler = self.event_handlers[event_type]
-            await handler._process_event(processed_data)
-        
-        # 触发通配符处理器
-        if "*" in self.event_handlers:
-            handler = self.event_handlers["*"]
-            await handler._process_event(processed_data)
-    
-    def get_module_events(self, module_name: str) -> List[str]:
-        """
-        获取模块注册的事件
-        
-        :param module_name: 模块名称
-        :return: 事件类型列表
-        """
-        return self.module_events.get(module_name, [])
-    
-    def cleanup_module_events(self, module_name: str):
-        """
-        清理模块事件
-        
-        :param module_name: 模块名称
-        """
-        if module_name in self.module_events:
-            event_types = self.module_events[module_name]
-            for event_type in event_types:
-                if event_type in self.event_handlers:
-                    # 移除该模块注册的处理器
-                    handler = self.event_handlers[event_type]
-                    handler.handlers = [
-                        h for h in handler.handlers 
-                        if h.get("module") != module_name
-                    ]
-            del self.module_events[module_name]
-
-# 全局事件管理器实例
-event_manager = EventManager()

erispulse-2.2.0.dev0.dist-info/RECORD

@@ -1,26 +0,0 @@
-ErisPulse/__init__.py,sha256=c9pE-jRF89x4p5GF3QNU7wFxkli39tCOR_PyD_Tr8qQ,26834
-ErisPulse/__main__.py,sha256=HTq7Y7446eukTCHDX2_O9Ie8i-A7KHUCEJCmxx_j5co,76276
-ErisPulse/Core/__init__.py,sha256=gl-0UAI5_syGt1_23Lgy8P3vGjGxusWfYnTi281f5qI,520
-ErisPulse/Core/adapter.py,sha256=y75u_heNmpYLDjIBtVTfMzTHZFixWtYFv0JVskNI-2w,18300
-ErisPulse/Core/config.py,sha256=y0ChfCuw-6jAqs9Ii2tPJg0e4A765qzQLRcK6O8zh4c,2425
-ErisPulse/Core/env.py,sha256=IT_6Xks5Ka089O_4SVTvYNIC9Ly1IHX_Esb3SsleRj8,338
-ErisPulse/Core/erispulse_config.py,sha256=QDx401hNX9JcSHqCSVK33X6VTubl6HI1znAK3T_J0K0,3034
-ErisPulse/Core/exceptions.py,sha256=zuTREGczwGzbYT4Z6dACqHwgNRpiJeLFR8aCxFdOg7k,3667
-ErisPulse/Core/logger.py,sha256=6p53nQE7NFXSqs_lftW-HQB1BQcgruAYOpIYx25QLVA,11252
-ErisPulse/Core/mods.py,sha256=vKLEDr2nQ4kUULHmUQYFbRL04ePIKlwLEOGB-ldMYS8,7130
-ErisPulse/Core/router.py,sha256=s2EBh2qpt3UXYhB06Ppc1XTFuZ3u0ZfXENJxwkgPoq8,8542
-ErisPulse/Core/storage.py,sha256=oRum4eVaTc3yxcaafggoIvrk41LPbvApSCxkGM3YmzU,17904
-ErisPulse/Core/Event/__init__.py,sha256=fgK9bskLqVYau9ORfhGNBxSBJo7oZheeSYvwucigpEU,1042
-ErisPulse/Core/Event/base.py,sha256=NQb9_mA7OwxCGbcpunOQD_aV9Zq3i7xLQ1AzKM-ebl8,3758
-ErisPulse/Core/Event/cmd.py,sha256=B7c-PUaCn5qhubCqgI1pDSvvjofTLQHzmBaD0TuqJF4,6964
-ErisPulse/Core/Event/exceptions.py,sha256=iGcuPaC7F4cZeujcvBdZb9bzQGnHBdb9CcPKoB760Bo,711
-ErisPulse/Core/Event/manager.py,sha256=xIdK29jY2h-cCLFeq7JqPxuzYvuU7jAPdJMq2CPgwcQ,4270
-ErisPulse/Core/Event/message.py,sha256=n5ObSaGmyU3z5QSM5-5VwOBr69FY7p4TdRoy6Xy0Nzg,2640
-ErisPulse/Core/Event/meta.py,sha256=tr5aKoFtqCjybkpbUJ6JfuppZTk34eAipGvggPkGeSs,2282
-ErisPulse/Core/Event/notice.py,sha256=YLe5OphsF4sf1nvOokQ9bgCpCRf6MuGKRa1QjWotiK8,2825
-ErisPulse/Core/Event/request.py,sha256=FOkbW9WcUnc2uywkUWfUim4xJXXmlY1gYK6SD8Cd7So,1853
-erispulse-2.2.0.dev0.dist-info/METADATA,sha256=38Qx-4vuxUcOKVRUHlxg9qV76NE6QQtUtgsS9txSU6k,7290
-erispulse-2.2.0.dev0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-erispulse-2.2.0.dev0.dist-info/entry_points.txt,sha256=Jss71M6nEha0TA-DyVZugPYdcL14s9QpiOeIlgWxzOc,182
-erispulse-2.2.0.dev0.dist-info/licenses/LICENSE,sha256=b2XwzcfWuv_36Op3xGdjcuPHgfCz62yT3bXYjfStpxY,1852
-erispulse-2.2.0.dev0.dist-info/RECORD,,