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

{erispulse-2.4.2.dev1 → erispulse-2.4.3.dev1}/.gitignore

@@ -5,6 +5,7 @@ venvs
 config.toml
 uv.lock
 snapshots/
+logs/
 config.db*
 .website
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.4.2.dev1
+Version: 2.4.3.dev1
 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[standard]>=0.30.0
 Requires-Dist: watchdog>=4.0.0
 Provides-Extra: dev
 Requires-Dist: httpx>=0.24.0; extra == 'dev'
@@ -88,11 +88,10 @@ Description-Content-Type: text/markdown
 **事件驱动的多平台机器人开发框架**
 
 [![PyPI](https://img.shields.io/pypi/v/ErisPulse?style=flat-square)](https://pypi.org/project/ErisPulse/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/ErisPulse?style=flat-square)](https://pypi.org/project/ErisPulse/)
-[![Docker Pulls](https://img.shields.io/docker/pulls/erispulse/erispulse?style=flat-square&logo=docker&label=pulls)](https://hub.docker.com/r/erispulse/erispulse)
-[![Docker Pulls](https://img.shields.io/docker/pulls/wsu2059/erispulse?style=flat-square&logo=docker&label=pulls)](https://hub.docker.com/r/erispulse/erispulse)
-[![Docker Version](https://img.shields.io/docker/v/erispulse/erispulse?style=flat-square&logo=docker&label=docker)](https://hub.docker.com/r/erispulse/erispulse)
+[![Docker](https://img.shields.io/badge/Docker-2496ED?style=flat-square&logo=docker&logoColor=white)](https://hub.docker.com/r/erispulse/erispulse)
+[![Python](https://img.shields.io/badge/Python-3.10+-3776AB?style=flat-square&logo=python&logoColor=white)](https://pypi.org/project/ErisPulse/)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Socket Badge](https://socket.dev/api/badge/pypi/package/ErisPulse/latest)](https://socket.dev/pypi/package/ErisPulse)
 
 </td>
 </tr>
@@ -112,6 +111,25 @@ ErisPulse 是一个基于 Python 的事件驱动型多平台机器人开发框
 - **热重载支持** - 开发时无需重启即可重新加载代码
 - **完整工具链** - 提供 CLI 工具、包管理和自动化脚本
 
+## 支持的适配器
+
+欢迎您贡献适配器！
+
+| 适配器 | 说明 |
+|--------|------|
+| [Kook](https://github.com/shanfishapp/ErisPulse-KookAdapter) | Kook（开黑啦）即时通讯平台 |
+| [Matrix](https://github.com/ErisPulse/ErisPulse-MatrixAdapter) | Matrix 去中心化通讯协议 |
+| [OneBot11](https://github.com/ErisPulse/ErisPulse-OneBot11Adapter) | OneBot v11 通用机器人协议 |
+| [OneBot12](https://github.com/ErisPulse/ErisPulse-OneBot12Adapter) | OneBot v12 标准协议 |
+| [QQ](https://github.com/ErisPulse/ErisPulse-QQBotAdapter) | QQ 官方机器人平台 |
+| [沙箱](https://github.com/ErisPulse/ErisPulse-SandboxAdapter) | 网页端调试，无需接入真实平台 |
+| [Telegram](https://github.com/ErisPulse/ErisPulse-TelegramAdapter) | 全球性即时通讯平台 |
+| [邮件](https://github.com/ErisPulse/ErisPulse-EmailAdapter) | 邮件协议收发适配器 |
+| [云湖](https://github.com/ErisPulse/ErisPulse-YunhuAdapter) | 企业级即时通讯平台（机器人接入） |
+| [云湖用户](https://github.com/wsu2059q/ErisPulse-YunhuUserAdapter) | 基于云湖用户协议的接入适配器 |
+
+查看 [适配器详情介绍](docs/zh-CN/platform-guide/README.md)
+
 ## 快速开始
 
 ### 使用 Docker (推荐)
@@ -120,6 +138,22 @@ ErisPulse 是一个基于 Python 的事件驱动型多平台机器人开发框
 docker pull erispulse/erispulse:latest
 ```
 
+<details>
+<summary>Docker Hub不可用？</summary>
+
+如果 Docker Hub 无法访问，可以使用 GitHub Container Registry：
+
+```bash
+docker pull ghcr.io/erispulse/erispulse:latest
+```
+
+使用 ghcr.io 镜像时，需要修改 `docker-compose.yml` 中的 image：
+```yaml
+image: ghcr.io/erispulse/erispulse:latest
+```
+
+</details>
+
 <details>
 <summary>快速启动</summary>
 
@@ -133,9 +167,9 @@ ERISPULSE_DASHBOARD_TOKEN=your-token docker compose up -d
 
 > 镜像内置 ErisPulse 框架和 Dashboard 管理面板，支持 `linux/amd64` 和 `linux/arm64` 架构。
 
-</details>
+启动后访问 `http://<host>:<port>/Dashboard`，使用设置的令牌作为密码登录 Dashboard 管理面板。
 
-启动后访问 `http://localhost:8000/Dashboard`，使用设置的令牌作为密码登录 Dashboard 管理面板。
+</details>
 
 ### 使用 pip 安装
 
@@ -231,23 +265,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.dev1}/README.md

@@ -16,11 +16,10 @@
 **事件驱动的多平台机器人开发框架**
 
 [![PyPI](https://img.shields.io/pypi/v/ErisPulse?style=flat-square)](https://pypi.org/project/ErisPulse/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/ErisPulse?style=flat-square)](https://pypi.org/project/ErisPulse/)
-[![Docker Pulls](https://img.shields.io/docker/pulls/erispulse/erispulse?style=flat-square&logo=docker&label=pulls)](https://hub.docker.com/r/erispulse/erispulse)
-[![Docker Pulls](https://img.shields.io/docker/pulls/wsu2059/erispulse?style=flat-square&logo=docker&label=pulls)](https://hub.docker.com/r/erispulse/erispulse)
-[![Docker Version](https://img.shields.io/docker/v/erispulse/erispulse?style=flat-square&logo=docker&label=docker)](https://hub.docker.com/r/erispulse/erispulse)
+[![Docker](https://img.shields.io/badge/Docker-2496ED?style=flat-square&logo=docker&logoColor=white)](https://hub.docker.com/r/erispulse/erispulse)
+[![Python](https://img.shields.io/badge/Python-3.10+-3776AB?style=flat-square&logo=python&logoColor=white)](https://pypi.org/project/ErisPulse/)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Socket Badge](https://socket.dev/api/badge/pypi/package/ErisPulse/latest)](https://socket.dev/pypi/package/ErisPulse)
 
 </td>
 </tr>
@@ -40,6 +39,25 @@ ErisPulse 是一个基于 Python 的事件驱动型多平台机器人开发框
 - **热重载支持** - 开发时无需重启即可重新加载代码
 - **完整工具链** - 提供 CLI 工具、包管理和自动化脚本
 
+## 支持的适配器
+
+欢迎您贡献适配器！
+
+| 适配器 | 说明 |
+|--------|------|
+| [Kook](https://github.com/shanfishapp/ErisPulse-KookAdapter) | Kook（开黑啦）即时通讯平台 |
+| [Matrix](https://github.com/ErisPulse/ErisPulse-MatrixAdapter) | Matrix 去中心化通讯协议 |
+| [OneBot11](https://github.com/ErisPulse/ErisPulse-OneBot11Adapter) | OneBot v11 通用机器人协议 |
+| [OneBot12](https://github.com/ErisPulse/ErisPulse-OneBot12Adapter) | OneBot v12 标准协议 |
+| [QQ](https://github.com/ErisPulse/ErisPulse-QQBotAdapter) | QQ 官方机器人平台 |
+| [沙箱](https://github.com/ErisPulse/ErisPulse-SandboxAdapter) | 网页端调试，无需接入真实平台 |
+| [Telegram](https://github.com/ErisPulse/ErisPulse-TelegramAdapter) | 全球性即时通讯平台 |
+| [邮件](https://github.com/ErisPulse/ErisPulse-EmailAdapter) | 邮件协议收发适配器 |
+| [云湖](https://github.com/ErisPulse/ErisPulse-YunhuAdapter) | 企业级即时通讯平台（机器人接入） |
+| [云湖用户](https://github.com/wsu2059q/ErisPulse-YunhuUserAdapter) | 基于云湖用户协议的接入适配器 |
+
+查看 [适配器详情介绍](docs/zh-CN/platform-guide/README.md)
+
 ## 快速开始
 
 ### 使用 Docker (推荐)
@@ -48,6 +66,22 @@ ErisPulse 是一个基于 Python 的事件驱动型多平台机器人开发框
 docker pull erispulse/erispulse:latest
 ```
 
+<details>
+<summary>Docker Hub不可用？</summary>
+
+如果 Docker Hub 无法访问，可以使用 GitHub Container Registry：
+
+```bash
+docker pull ghcr.io/erispulse/erispulse:latest
+```
+
+使用 ghcr.io 镜像时，需要修改 `docker-compose.yml` 中的 image：
+```yaml
+image: ghcr.io/erispulse/erispulse:latest
+```
+
+</details>
+
 <details>
 <summary>快速启动</summary>
 
@@ -61,9 +95,9 @@ ERISPULSE_DASHBOARD_TOKEN=your-token docker compose up -d
 
 > 镜像内置 ErisPulse 框架和 Dashboard 管理面板，支持 `linux/amd64` 和 `linux/arm64` 架构。
 
-</details>
+启动后访问 `http://<host>:<port>/Dashboard`，使用设置的令牌作为密码登录 Dashboard 管理面板。
 
-启动后访问 `http://localhost:8000/Dashboard`，使用设置的令牌作为密码登录 Dashboard 管理面板。
+</details>
 
 ### 使用 pip 安装
 
@@ -159,23 +193,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.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.4.2-dev.1"
+version = "2.4.3-dev.1"
 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[standard]>=0.30.0",
     "packaging>=25.0",
 ]
 

erispulse-2.4.3.dev1/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.dev1/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.3.dev1/src/ErisPulse/Core/Bases/__init__.py

@@ -0,0 +1,17 @@
+"""
+ErisPulse 基础模块
+ 
+提供平台适配器、模块和存储后端的基类
+"""
+ 
+from .adapter import SendDSL, BaseAdapter
+from .module import BaseModule
+from .storage import BaseStorage, BaseQueryBuilder
+ 
+__all__ = [
+    "BaseAdapter",
+    "SendDSL",
+    "BaseModule",
+    "BaseStorage",
+    "BaseQueryBuilder",
+]

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

@@ -6,9 +6,10 @@
 
 """
 ErisPulse 基础模块
-
-提供平台适配器以及模块的基类
+ 
+提供平台适配器、模块和存储后端的基类
 """
 
 from .adapter import SendDSL, BaseAdapter
 from .module import BaseModule
+from .storage import BaseStorage, BaseQueryBuilder

{erispulse-2.4.2.dev1 → erispulse-2.4.3.dev1}/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.dev1}/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:
         """