ErisPulse 2.4.2.dev1__tar.gz → 2.4.3.dev0__tar.gz

{erispulse-2.4.2.dev1 → erispulse-2.4.3.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.4.2.dev1
+Version: 2.4.3.dev0
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: ErisDev <erisdev@88.com>
 Maintainer-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>
@@ -44,11 +44,11 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Requires-Dist: aiohttp>=3.9.0
 Requires-Dist: fastapi>=0.116.1
-Requires-Dist: hypercorn>=0.14.0
 Requires-Dist: packaging>=25.0
 Requires-Dist: pip>=23.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: toml>=0.10.2
+Requires-Dist: uvicorn>=0.30.0
 Requires-Dist: watchdog>=4.0.0
 Provides-Extra: dev
 Requires-Dist: httpx>=0.24.0; extra == 'dev'
@@ -112,6 +112,25 @@ ErisPulse 是一个基于 Python 的事件驱动型多平台机器人开发框
 - **热重载支持** - 开发时无需重启即可重新加载代码
 - **完整工具链** - 提供 CLI 工具、包管理和自动化脚本
 
+## 支持的适配器
+
+欢迎您贡献适配器！
+
+| 适配器 | 说明 |
+|--------|------|
+| <img src=".github/assets/adapter_logo/kook.svg" width="20" /> [Kook](https://github.com/shanfishapp/ErisPulse-KookAdapter) | Kook（开黑啦）即时通讯平台 |
+| <img src=".github/assets/adapter_logo/matrix.svg" width="20" /> [Matrix](https://github.com/ErisPulse/ErisPulse-MatrixAdapter) | Matrix 去中心化通讯协议 |
+| <img src=".github/assets/adapter_logo/onebot.png" width="20" /> [OneBot11](https://github.com/ErisPulse/ErisPulse-OneBot11Adapter) | OneBot v11 通用机器人协议 |
+| <img src=".github/assets/adapter_logo/onebot.png" width="20" /> [OneBot12](https://github.com/ErisPulse/ErisPulse-OneBot12Adapter) | OneBot v12 标准协议 |
+| <img src=".github/assets/adapter_logo/qqbot.svg" width="20" /> [QQ](https://github.com/ErisPulse/ErisPulse-QQBotAdapter) | QQ 官方机器人平台 |
+| <img src=".github/assets/adapter_logo/sandbox.png" width="20" /> [沙箱](https://github.com/ErisPulse/ErisPulse-SandboxAdapter) | 网页端调试，无需接入真实平台 |
+| <img src=".github/assets/adapter_logo/telegram.svg" width="20" /> [Telegram](https://github.com/ErisPulse/ErisPulse-TelegramAdapter) | 全球性即时通讯平台 |
+| <img src=".github/assets/adapter_logo/email.svg" width="20" /> [邮件](https://github.com/ErisPulse/ErisPulse-EmailAdapter) | 邮件协议收发适配器 |
+| <img src=".github/assets/adapter_logo/yunhu.png" width="20" /> [云湖](https://github.com/ErisPulse/ErisPulse-YunhuAdapter) | 企业级即时通讯平台（机器人接入） |
+| <img src=".github/assets/adapter_logo/yunhu.png" width="20" /> [云湖用户](https://github.com/wsu2059q/ErisPulse-YunhuUserAdapter) | 基于云湖用户协议的接入适配器 |
+
+查看 [适配器详情介绍](docs/zh-CN/platform-guide/README.md)
+
 ## 快速开始
 
 ### 使用 Docker (推荐)
@@ -231,23 +250,6 @@ epsdk run main.py --reload
 - **自动化工具** - 消息通知、任务管理、数据收集
 - **消息转发** - 跨平台消息同步和转发
 
-## 支持的适配器
-
-欢迎您贡献适配器！
-
-| 适配器 | 说明 |
-|--------|------|
-| [云湖](https://github.com/ErisPulse/ErisPulse-YunhuAdapter) | 企业级即时通讯平台（机器人账户） |
-| [云湖用户](https://github.com/wsu2059q/ErisPulse-YunhuUserAdapter) | 基于云湖用户账户的适配器 |
-| [Telegram](https://github.com/ErisPulse/ErisPulse-TelegramAdapter) | 全球性即时通讯软件 |
-| [OneBot11](https://github.com/ErisPulse/ErisPulse-OneBot11Adapter) | 通用机器人接口标准 |
-| [OneBot12](https://github.com/ErisPulse/ErisPulse-OneBot12Adapter) | OneBot12 标准 |
-| [邮件](https://github.com/ErisPulse/ErisPulse-EmailAdapter) | 邮件收发处理 |
-| [沙箱](https://github.com/ErisPulse/ErisPulse-SandboxAdapter) | 网页调试界面，无需接入实际平台 |
-| [Kook](https://github.com/shanfishapp/ErisPulse-KookAdapter) | Kook(开黑啦)即时通讯平台 |
-
-查看 [适配器详情介绍](docs/zh-CN/platform-guide/README.md)
-
 ## 文档资源
 
 | 简体中文 | English | 繁體中文 |

{erispulse-2.4.2.dev1 → erispulse-2.4.3.dev0}/README.md

@@ -40,6 +40,25 @@ ErisPulse 是一个基于 Python 的事件驱动型多平台机器人开发框
 - **热重载支持** - 开发时无需重启即可重新加载代码
 - **完整工具链** - 提供 CLI 工具、包管理和自动化脚本
 
+## 支持的适配器
+
+欢迎您贡献适配器！
+
+| 适配器 | 说明 |
+|--------|------|
+| <img src=".github/assets/adapter_logo/kook.svg" width="20" /> [Kook](https://github.com/shanfishapp/ErisPulse-KookAdapter) | Kook（开黑啦）即时通讯平台 |
+| <img src=".github/assets/adapter_logo/matrix.svg" width="20" /> [Matrix](https://github.com/ErisPulse/ErisPulse-MatrixAdapter) | Matrix 去中心化通讯协议 |
+| <img src=".github/assets/adapter_logo/onebot.png" width="20" /> [OneBot11](https://github.com/ErisPulse/ErisPulse-OneBot11Adapter) | OneBot v11 通用机器人协议 |
+| <img src=".github/assets/adapter_logo/onebot.png" width="20" /> [OneBot12](https://github.com/ErisPulse/ErisPulse-OneBot12Adapter) | OneBot v12 标准协议 |
+| <img src=".github/assets/adapter_logo/qqbot.svg" width="20" /> [QQ](https://github.com/ErisPulse/ErisPulse-QQBotAdapter) | QQ 官方机器人平台 |
+| <img src=".github/assets/adapter_logo/sandbox.png" width="20" /> [沙箱](https://github.com/ErisPulse/ErisPulse-SandboxAdapter) | 网页端调试，无需接入真实平台 |
+| <img src=".github/assets/adapter_logo/telegram.svg" width="20" /> [Telegram](https://github.com/ErisPulse/ErisPulse-TelegramAdapter) | 全球性即时通讯平台 |
+| <img src=".github/assets/adapter_logo/email.svg" width="20" /> [邮件](https://github.com/ErisPulse/ErisPulse-EmailAdapter) | 邮件协议收发适配器 |
+| <img src=".github/assets/adapter_logo/yunhu.png" width="20" /> [云湖](https://github.com/ErisPulse/ErisPulse-YunhuAdapter) | 企业级即时通讯平台（机器人接入） |
+| <img src=".github/assets/adapter_logo/yunhu.png" width="20" /> [云湖用户](https://github.com/wsu2059q/ErisPulse-YunhuUserAdapter) | 基于云湖用户协议的接入适配器 |
+
+查看 [适配器详情介绍](docs/zh-CN/platform-guide/README.md)
+
 ## 快速开始
 
 ### 使用 Docker (推荐)
@@ -159,23 +178,6 @@ epsdk run main.py --reload
 - **自动化工具** - 消息通知、任务管理、数据收集
 - **消息转发** - 跨平台消息同步和转发
 
-## 支持的适配器
-
-欢迎您贡献适配器！
-
-| 适配器 | 说明 |
-|--------|------|
-| [云湖](https://github.com/ErisPulse/ErisPulse-YunhuAdapter) | 企业级即时通讯平台（机器人账户） |
-| [云湖用户](https://github.com/wsu2059q/ErisPulse-YunhuUserAdapter) | 基于云湖用户账户的适配器 |
-| [Telegram](https://github.com/ErisPulse/ErisPulse-TelegramAdapter) | 全球性即时通讯软件 |
-| [OneBot11](https://github.com/ErisPulse/ErisPulse-OneBot11Adapter) | 通用机器人接口标准 |
-| [OneBot12](https://github.com/ErisPulse/ErisPulse-OneBot12Adapter) | OneBot12 标准 |
-| [邮件](https://github.com/ErisPulse/ErisPulse-EmailAdapter) | 邮件收发处理 |
-| [沙箱](https://github.com/ErisPulse/ErisPulse-SandboxAdapter) | 网页调试界面，无需接入实际平台 |
-| [Kook](https://github.com/shanfishapp/ErisPulse-KookAdapter) | Kook(开黑啦)即时通讯平台 |
-
-查看 [适配器详情介绍](docs/zh-CN/platform-guide/README.md)
-
 ## 文档资源
 
 | 简体中文 | English | 繁體中文 |

{erispulse-2.4.2.dev1 → erispulse-2.4.3.dev0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.4.2-dev.1"
+version = "2.4.3-dev.0"
 description = "ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -55,7 +55,7 @@ dependencies = [
     "watchdog>=4.0.0",
     "toml>=0.10.2",
     "fastapi>=0.116.1",
-    "hypercorn>=0.14.0",
+    "uvicorn>=0.30.0",
     "packaging>=25.0",
 ]
 

erispulse-2.4.3.dev0/src/ErisPulse/CLI/commands/run.py

@@ -0,0 +1,152 @@
+"""
+Run 命令实现
+
+直接运行主程序，支持热重载模式
+"""
+
+import os
+import time
+import asyncio
+from argparse import ArgumentParser
+from watchdog.observers import Observer
+from rich.panel import Panel
+from watchdog.events import FileSystemEventHandler
+
+from ..console import console
+from ..base import Command
+
+
+class ReloadHandler(FileSystemEventHandler):
+    """
+    文件系统事件处理器
+    
+    监控 .py 文件变更并触发 sdk.restart() 热重载
+
+    {!--< tips >!--}
+    1. 文件监控运行在独立线程
+    2. 通过 run_coroutine_threadsafe 安全调度到事件循环
+    3. 内置 1 秒防抖，避免短时间内多次重载
+    {!--< /tips >!--}
+    """
+
+    def __init__(self, loop: asyncio.AbstractEventLoop):
+        super().__init__()
+        self._loop = loop
+        self._last_reload = 0.0
+
+    def on_modified(self, event):
+        now = time.time()
+        if now - self._last_reload < 1.0:
+            return
+        if event.src_path.endswith(".py"):
+            self._last_reload = now
+            self._schedule_reload(event)
+
+    def _schedule_reload(self, event):
+        async def _do_reload():
+            try:
+                from ... import sdk
+                await sdk.restart()
+            except Exception as e:
+                console.print(f"[error]热重载失败: {e}[/]")
+
+        console.print(f"检测到文件变更 ({os.path.basename(event.src_path)})，正在热重载...")
+        asyncio.run_coroutine_threadsafe(_do_reload(), self._loop)
+
+
+class RunCommand(Command):
+    """
+    Run 命令
+    
+    运行主程序，支持热重载模式
+    """
+
+    name = "run"
+    description = "运行主程序"
+    
+    def add_arguments(self, parser: ArgumentParser):
+        parser.add_argument(
+            'script',
+            nargs='?',
+            default=None,
+            help='要运行的主程序路径 (不指定则直接运行 SDK)'
+        )
+        parser.add_argument(
+            '--reload',
+            action='store_true',
+            default=False,
+            help='启用热重载模式'
+        )
+    
+    def execute(self, args):
+        script = args.script
+        reload_mode = args.reload
+        
+        if script:
+            if not os.path.exists(script):
+                console.print(f"[error]脚本 [path]{script}[/] 不存在[/]")
+                console.print("[info]使用 [cyan]epsdk init[/cyan] 创建新项目[/]")
+                return
+            self._run_script(script, reload_mode)
+        else:
+            self._run_internal(reload_mode)
+
+    def _run_internal(self, reload_mode: bool):
+        """
+        直接运行 SDK（不指定脚本时）
+        """
+        async def _run():
+            from ... import sdk
+
+            if reload_mode:
+                loop = asyncio.get_running_loop()
+                self._setup_watchdog(".", loop)
+
+            await sdk.run(keep_running=True)
+
+        try:
+            asyncio.run(_run())
+        except KeyboardInterrupt:
+            pass
+        finally:
+            if reload_mode and hasattr(self, '_observer'):
+                self._observer.stop()
+                self._observer.join()
+
+    def _run_script(self, script_path: str, reload_mode: bool):
+        """
+        运行指定脚本文件
+        """
+        async def _run():
+            from ... import sdk
+
+            if reload_mode:
+                loop = asyncio.get_running_loop()
+                watch_dir = os.path.dirname(os.path.abspath(script_path))
+                self._setup_watchdog(watch_dir, loop)
+
+            await sdk.run(keep_running=True)
+
+        try:
+            asyncio.run(_run())
+        except KeyboardInterrupt:
+            pass
+        finally:
+            if reload_mode and hasattr(self, '_observer'):
+                self._observer.stop()
+                self._observer.join()
+
+    def _setup_watchdog(self, watch_dir: str, loop: asyncio.AbstractEventLoop):
+        if not os.path.exists(watch_dir):
+            return
+
+        self._observer = Observer()
+        self._handler = ReloadHandler(loop=loop)
+        self._observer.schedule(self._handler, watch_dir, recursive=True)
+        self._observer.start()
+
+        console.print(Panel(
+            f"[bold]开发重载模式[/]\n监控目录: [path]{watch_dir}[/]",
+            title="热重载已启动",
+            border_style="info"
+        ))

erispulse-2.4.3.dev0/src/ErisPulse/CLI/commands/run.pyi

@@ -0,0 +1,63 @@
+# type: ignore
+#
+# Auto-generated type stub for run.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+Run 命令实现
+
+直接运行主程序，支持热重载模式
+"""
+
+import os
+import time
+import asyncio
+from argparse import ArgumentParser
+from watchdog.observers import Observer
+from rich.panel import Panel
+from watchdog.events import FileSystemEventHandler
+from ..console import console
+from ..base import Command
+
+class ReloadHandler(FileSystemEventHandler):
+    """
+    文件系统事件处理器
+    
+    监控 .py 文件变更并触发 sdk.restart() 热重载
+    
+    {!--< tips >!--}
+    1. 文件监控运行在独立线程
+    2. 通过 run_coroutine_threadsafe 安全调度到事件循环
+    3. 内置 1 秒防抖，避免短时间内多次重载
+    {!--< /tips >!--}
+    """
+    def __init__(self: None, loop: asyncio.AbstractEventLoop) -> ...:
+        ...
+    def on_modified(self: object, event: ...) -> ...:
+        ...
+    def _schedule_reload(self: object, event: ...) -> ...:
+        ...
+
+class RunCommand(Command):
+    """
+    Run 命令
+    
+    运行主程序，支持热重载模式
+    """
+    def add_arguments(self: object, parser: ArgumentParser) -> ...:
+        ...
+    def execute(self: object, args: ...) -> ...:
+        ...
+    def _run_internal(self: object, reload_mode: bool) -> ...:
+        """
+        直接运行 SDK（不指定脚本时）
+        """
+        ...
+    def _run_script(self: object, script_path: str, reload_mode: bool) -> ...:
+        """
+        运行指定脚本文件
+        """
+        ...
+    def _setup_watchdog(self: object, watch_dir: str, loop: asyncio.AbstractEventLoop) -> ...:
+        ...

{erispulse-2.4.2.dev1 → erispulse-2.4.3.dev0}/src/ErisPulse/Core/Bases/adapter.py

@@ -341,11 +341,10 @@ class BaseAdapter(ABC):
         """
         raise NotImplementedError("适配器必须实现shutdown方法")
 
-    async def emit(self) -> None:
-        from ..logger import logger
-
-        logger.error(
-            "适配器调用了一个被弃用的原生方法emit，请检查适配器的实现，如果你是开发者请查看ErisPulse的文档进行更新。如果你是普通用户请查看本适配器是否有更新"
+    async def emit(self, *args, **kwargs):
+        raise NotImplementedError(
+            "适配器的 emit 方法已被弃用。请使用 adapter.emit() 通过 AdapterManager 提交事件。"
+            "如果你是适配器开发者，请查看 ErisPulse 文档进行更新。"
         )
 
     def send(

{erispulse-2.4.2.dev1 → erispulse-2.4.3.dev0}/src/ErisPulse/Core/Bases/adapter.pyi

@@ -158,7 +158,7 @@ class BaseAdapter(ABC):
         :raises NotImplementedError: 必须由子类实现
         """
         ...
-    async def emit(self: object) -> None:
+    async def emit(self: object, *args: ..., **kwargs: ...) -> ...:
         ...
     def send(self: object, target_type: str, target_id: str, message: Any, **kwargs: Any) -> asyncio.Task:
         """

erispulse-2.4.3.dev0/src/ErisPulse/Core/__init__.py

@@ -0,0 +1,47 @@
+"""
+ErisPulse 核心模块
+
+提供了一系列用于构建和管理应用的核心组件，包括适配器、模块、存储、配置、路由和生命周期管理等。
+"""
+
+from .lifecycle import lifecycle, LifecycleManager
+from .adapter import adapter, AdapterManager
+from .Bases import BaseAdapter, BaseModule, SendDSL
+from .storage import storage, StorageManager
+from .logger import logger, Logger, LoggerChild
+from .module import module, ModuleManager
+from .router import router, RouterManager
+from .config import config, ConfigManager
+from . import Event
+from .Event.message_builder import MessageBuilder
+
+env             = storage       # 存储管理器别名
+
+__all__ = [
+    'Event',
+
+    'adapter',
+    'AdapterManager',
+    'BaseAdapter',
+    'SendDSL',
+    'MessageBuilder',
+
+    'module',
+    'ModuleManager',
+    'BaseModule',
+
+    'storage',
+    'StorageManager',
+    'config',
+    'env',              # 配置管理器别名
+    'ConfigManager',
+
+    'router',
+    'RouterManager',
+
+    'logger',
+    'Logger',
+    'LoggerChild',
+    'lifecycle',
+    'LifecycleManager',
+]

{erispulse-2.4.2.dev1 → erispulse-2.4.3.dev0}/src/ErisPulse/Core/adapter.py

@@ -8,6 +8,7 @@ import functools
 import asyncio
 import inspect
 import time
+import warnings
 from typing import Any
 from collections.abc import Callable
 from collections import defaultdict
@@ -586,13 +587,11 @@ class AdapterManager(ManagerBase):
 
     # 兼容性方法 - 保持向后兼容
     def list_adapters(self) -> dict[str, bool]:
-        """
-        列出所有平台适配器状态
-
-        {!--< deprecated >!--} 请使用 list_items() 代替
-
-        :return: [dict[str, bool]] 平台适配器状态字典
-        """
+        warnings.warn(
+            "list_adapters() 已弃用，请使用 list_items() 代替",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         return self.list_items()
 
     # ==================== 事件处理与消息发送 ====================
@@ -851,15 +850,19 @@ class AdapterManager(ManagerBase):
                 )
 
         if status == "offline":
-            # 只有在非主动关闭的情况下才提交事件（避免与 shutdown() 重复）
             if not self._is_being_shutdown:
-                asyncio.ensure_future(
-                    lifecycle.submit_event(
-                        "adapter.bot.offline",
-                        msg=f"Bot {platform}/{bot_id} 离线",
-                        data={"platform": platform, "bot_id": bot_id, "status": "offline"},
+                try:
+                    loop = asyncio.get_running_loop()
+                    task = loop.create_task(
+                        lifecycle.submit_event(
+                            "adapter.bot.offline",
+                            msg=f"Bot {platform}/{bot_id} 离线",
+                            data={"platform": platform, "bot_id": bot_id, "status": "offline"},
+                        )
                     )
-                )
+                    self._adapter_tasks.setdefault(f"_bot_offline_{platform}_{bot_id}", task)
+                except RuntimeError:
+                    pass
 
     def _update_bot_heartbeat(self, platform: str, self_info: dict) -> None:
         """
@@ -1171,6 +1174,11 @@ class AdapterManager(ManagerBase):
         """
         return self.exists(platform) and self.is_enabled(platform)
 
+    def __repr__(self) -> str:
+        registered = list(self._adapters.keys())
+        running = [p for p, a in self._adapters.items() if a in self._started_instances]
+        return f"<AdapterManager registered={registered} running={running}>"
+
 
 adapter: AdapterManager = AdapterManager()
 

{erispulse-2.4.2.dev1 → erispulse-2.4.3.dev0}/src/ErisPulse/Core/adapter.pyi

@@ -14,6 +14,7 @@ import functools
 import asyncio
 import inspect
 import time
+import warnings
 from typing import Any
 from collections.abc import Callable
 from collections import defaultdict
@@ -157,13 +158,6 @@ class AdapterManager(ManagerBase):
         """
         ...
     def list_adapters(self: object) -> dict[(str, bool)]:
-        """
-        列出所有平台适配器状态
-        
-        {!--< deprecated >!--} 请使用 list_items() 代替
-        
-        :return: [dict[str, bool]] 平台适配器状态字典
-        """
         ...
     def on(self: object, event_type: str = ...) -> Callable[([Callable], Callable)]:
         """
@@ -391,5 +385,7 @@ class AdapterManager(ManagerBase):
         :return: [bool] 平台是否存在且启用
         """
         ...
+    def __repr__(self: object) -> str:
+        ...
 
 adapter: AdapterManager

{erispulse-2.4.2.dev1 → erispulse-2.4.3.dev0}/src/ErisPulse/Core/config.py

@@ -90,8 +90,9 @@ class ConfigManager:
             os.remove(old_config_path)
 
         except Exception as e:
-            # 静默处理迁移失败
-            pass
+            from .logger import logger
+
+            logger.warning(f"配置文件迁移失败: {e}")
 
     def _load_config(self) -> None:
         """

{erispulse-2.4.2.dev1 → erispulse-2.4.3.dev0}/src/ErisPulse/Core/lifecycle.py

@@ -137,9 +137,11 @@ class LifecycleManager:
         *,
         source: str = "ErisPulse",
         msg: str = "",
-        data: dict = {},
+        data: dict | None = None,
         timestamp=time.time(),
     ) -> None:
+        if data is None:
+            data = {}
         """
         提交生命周期事件
 

{erispulse-2.4.2.dev1 → erispulse-2.4.3.dev0}/src/ErisPulse/Core/lifecycle.pyi

@@ -77,15 +77,6 @@ class LifecycleManager:
         """
         ...
     async def submit_event(self: object, event_type: str) -> None:
-        """
-        提交生命周期事件
-        
-        :param event_type: 事件名称
-        :param source: 事件来源(默认"ErisPulse")
-        :param msg: 事件描述
-        :param data: 事件相关数据
-        :param timestamp: 时间戳(默认当前时间)
-        """
         ...
     async def _execute_handlers(self: object, event: str, event_data: dict[(str, Any)]) -> None:
         """

{erispulse-2.4.2.dev1 → erispulse-2.4.3.dev0}/src/ErisPulse/Core/module.py

@@ -5,6 +5,7 @@ ErisPulse 模块系统
 """
 
 import inspect
+import warnings
 from typing import Any
 from .logger import logger
 from .config import config
@@ -530,13 +531,11 @@ class ModuleManager(ManagerBase):
 
     # 兼容性方法 - 保持向后兼容
     def list_modules(self) -> dict[str, bool]:
-        """
-        列出所有模块状态
-
-        {!--< deprecated >!--} 请使用 list_items() 代替
-
-        :return: [dict[str, bool]] 模块状态字典
-        """
+        warnings.warn(
+            "list_modules() 已弃用，请使用 list_items() 代替",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         return self.list_items()
 
     # ==================== 工具方法 ====================
@@ -568,6 +567,11 @@ class ModuleManager(ManagerBase):
         """
         return self.exists(module_name) and self.is_enabled(module_name)
 
+    def __repr__(self) -> str:
+        registered = list(self._module_classes.keys())
+        loaded = list(self._loaded_modules)
+        return f"<ModuleManager registered={registered} loaded={loaded}>"
+
 
 module: ModuleManager = ModuleManager()
 

{erispulse-2.4.2.dev1 → erispulse-2.4.3.dev0}/src/ErisPulse/Core/module.pyi

@@ -11,6 +11,7 @@ ErisPulse 模块系统
 """
 
 import inspect
+import warnings
 from typing import Any
 from .logger import logger
 from .config import config
@@ -228,13 +229,6 @@ class ModuleManager(ManagerBase):
         """
         ...
     def list_modules(self: object) -> dict[(str, bool)]:
-        """
-        列出所有模块状态
-        
-        {!--< deprecated >!--} 请使用 list_items() 代替
-        
-        :return: [dict[str, bool]] 模块状态字典
-        """
         ...
     def __getattr__(self: object, module_name: str) -> Any:
         """
@@ -259,5 +253,7 @@ class ModuleManager(ManagerBase):
         >>> if "MyModule" in module: ...
         """
         ...
+    def __repr__(self: object) -> str:
+        ...
 
 module: ModuleManager