ErisPulse 2.3.8.dev0__tar.gz → 2.3.9__tar.gz

{erispulse-2.3.8.dev0 → erispulse-2.3.9}/.gitignore

@@ -205,4 +205,23 @@ cython_debug/
 bin
 include
 lib
-pyvenv.cfg
+pyvenv.cfg
+
+# i18n 翻译文档（自动生成）
+# 已提交到版本控制以支持 CI/CD 和状态追踪
+# docs/zh-TW/
+# docs/en/
+# docs/ja/
+# docs/ko/
+# docs/fr/
+# docs/de/
+# docs/es/
+# docs/it/
+# docs/ru/
+# docs/ar/
+
+# 翻译缓存（已提交到版本控制）
+# .translate_cache/
+
+# 但保留源中文文档
+!docs/zh-CN/

{erispulse-2.3.8.dev0 → erispulse-2.3.9}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.3.8.dev0
+Version: 2.3.9
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
-Author-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>
+Author-email: ErisDev <erisdev@88.com>
 Maintainer-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>
 License: MIT License
         
@@ -58,6 +58,12 @@ Requires-Dist: pytest-xdist>=3.0.0; extra == 'test'
 Requires-Dist: pytest>=7.0.0; extra == 'test'
 Description-Content-Type: text/markdown
 
+<div align="center">
+
+[English](README.en.md) | [简体中文](README.md) | [繁體中文](README.zh-TW.md)
+
+</div>
+
 <table>
 <tr>
 <td width="35%" valign="middle" align="center">
@@ -105,6 +111,9 @@ pip install -i https://pypi.tuna.tsinghua.edu.cn/simple ErisPulse
 # 使用 `uv` 安装
 uv install ErisPulse
 ```
+
+![安装演示](.github/assets/docs/install_pip.gif)
+
 > 如果您的 Python 版本低于 3.10，可以使用一键安装脚本自动配置环境。详见 [安装脚本说明](scripts/install/)。
 
 ### 初始化项目
@@ -175,8 +184,8 @@ epsdk run main.py --reload
 </table>
 
 更多详细说明请参阅：
-- [快速开始指南](docs/quick-start.md)
-- [入门指南](docs/getting-started/)
+- [快速开始指南](docs/zh-CN/quick-start.md)
+- [入门指南](docs/zh-CN/getting-started/)
 
 ## 应用场景
 
@@ -197,10 +206,16 @@ epsdk run main.py --reload
 - [邮件](https://github.com/ErisPulse/ErisPulse-EmailAdapter) - 邮件收发处理
 - [沙箱](https://github.com/ErisPulse/ErisPulse-SandboxAdapter) - 网页调试界面，无需接入实际平台
 
-查看 [适配器详情介绍](docs/platform-guide/README.md)
+查看 [适配器详情介绍](docs/zh-CN/platform-guide/README.md)
 
 ## 文档资源
 
+| 简体中文 | English | 繁體中文 |
+|----------------|----------------|----------------|
+| [文档入口](docs/zh-CN/README.md) | [Documentation](docs/en/README.md) | [文檔入口](docs/zh-TW/README.md) |
+
+## 外部资源
+
 | 平台 | 主站点 | 备用站点 |
 |------|--------|---------|
 | 文档 | [erisdev.com](https://www.erisdev.com/#docs) | [Cloudflare](https://erispulse.pages.dev/#docs) • [GitHub](https://erispulse.github.io/#docs) • [Netlify](https://erispulse.netlify.app/#docs) |
@@ -208,7 +223,7 @@ epsdk run main.py --reload
 
 ## 贡献指南
 
-我们欢迎各种形式的贡献，包括但不限于：
+ErisPulse 项目的健全性还需要您的一份力！我们欢迎各种形式的贡献，包括但不限于：
 
 1. **报告问题**
    在 [GitHub Issues](https://github.com/ErisPulse/ErisPulse/issues) 提交 bug 报告
@@ -217,7 +232,7 @@ epsdk run main.py --reload
    通过 [社区讨论](https://github.com/ErisPulse/ErisPulse/discussions) 提出新想法
 
 3. **代码贡献**
-   提交 Pull Request 前请阅读我们的 [代码风格](docs/styleguide/) 以及 [贡献指南](CONTRIBUTING.md)
+   提交 Pull Request 前请阅读我们的 [代码风格](docs/zh-CN/styleguide/) 以及 [贡献指南](CONTRIBUTING.md)
 
 4. **文档改进**
    帮助完善文档和示例代码

{erispulse-2.3.8.dev0 → erispulse-2.3.9}/README.md

@@ -1,3 +1,9 @@
+<div align="center">
+
+[English](README.en.md) | [简体中文](README.md) | [繁體中文](README.zh-TW.md)
+
+</div>
+
 <table>
 <tr>
 <td width="35%" valign="middle" align="center">
@@ -45,6 +51,9 @@ pip install -i https://pypi.tuna.tsinghua.edu.cn/simple ErisPulse
 # 使用 `uv` 安装
 uv install ErisPulse
 ```
+
+![安装演示](.github/assets/docs/install_pip.gif)
+
 > 如果您的 Python 版本低于 3.10，可以使用一键安装脚本自动配置环境。详见 [安装脚本说明](scripts/install/)。
 
 ### 初始化项目
@@ -115,8 +124,8 @@ epsdk run main.py --reload
 </table>
 
 更多详细说明请参阅：
-- [快速开始指南](docs/quick-start.md)
-- [入门指南](docs/getting-started/)
+- [快速开始指南](docs/zh-CN/quick-start.md)
+- [入门指南](docs/zh-CN/getting-started/)
 
 ## 应用场景
 
@@ -137,10 +146,16 @@ epsdk run main.py --reload
 - [邮件](https://github.com/ErisPulse/ErisPulse-EmailAdapter) - 邮件收发处理
 - [沙箱](https://github.com/ErisPulse/ErisPulse-SandboxAdapter) - 网页调试界面，无需接入实际平台
 
-查看 [适配器详情介绍](docs/platform-guide/README.md)
+查看 [适配器详情介绍](docs/zh-CN/platform-guide/README.md)
 
 ## 文档资源
 
+| 简体中文 | English | 繁體中文 |
+|----------------|----------------|----------------|
+| [文档入口](docs/zh-CN/README.md) | [Documentation](docs/en/README.md) | [文檔入口](docs/zh-TW/README.md) |
+
+## 外部资源
+
 | 平台 | 主站点 | 备用站点 |
 |------|--------|---------|
 | 文档 | [erisdev.com](https://www.erisdev.com/#docs) | [Cloudflare](https://erispulse.pages.dev/#docs) • [GitHub](https://erispulse.github.io/#docs) • [Netlify](https://erispulse.netlify.app/#docs) |
@@ -148,7 +163,7 @@ epsdk run main.py --reload
 
 ## 贡献指南
 
-我们欢迎各种形式的贡献，包括但不限于：
+ErisPulse 项目的健全性还需要您的一份力！我们欢迎各种形式的贡献，包括但不限于：
 
 1. **报告问题**
    在 [GitHub Issues](https://github.com/ErisPulse/ErisPulse/issues) 提交 bug 报告
@@ -157,7 +172,7 @@ epsdk run main.py --reload
    通过 [社区讨论](https://github.com/ErisPulse/ErisPulse/discussions) 提出新想法
 
 3. **代码贡献**
-   提交 Pull Request 前请阅读我们的 [代码风格](docs/styleguide/) 以及 [贡献指南](CONTRIBUTING.md)
+   提交 Pull Request 前请阅读我们的 [代码风格](docs/zh-CN/styleguide/) 以及 [贡献指南](CONTRIBUTING.md)
 
 4. **文档改进**
    帮助完善文档和示例代码

{erispulse-2.3.8.dev0 → erispulse-2.3.9}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.3.8-dev.0"
+version = "2.3.9"
 description = "ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。"
 readme = "README.md"
 requires-python = ">=3.10"
 license = { file = "LICENSE" }
 
 authors = [
-    { name = "艾莉丝·格雷拉特(WSu2059)", email = "wsu2059@qq.com" }
+    { name = "ErisDev", email = "erisdev@88.com" }
 ]
 
 maintainers = [

{erispulse-2.3.8.dev0 → erispulse-2.3.9}/src/ErisPulse/CLI/commands/init.py

@@ -177,7 +177,7 @@ class InitCommand(Command):
             "email": "邮件适配器"
         }
     
-    def _configure_adapters_interactive_sync(self, project_path: str = None):
+    def _configure_adapters_interactive_sync(self, project_path: Path = None):
         """
         交互式配置适配器的同步版本
         
@@ -377,7 +377,7 @@ class InitCommand(Command):
             
             # 询问是否要配置适配器
             if Confirm.ask("\n[cyan]是否要配置适配器？[/cyan]", default=True):
-                self._configure_adapters_interactive_sync(str(project_path))
+                self._configure_adapters_interactive_sync(project_path)
             
             # 保存配置
             config.force_save()
@@ -392,4 +392,4 @@ class InitCommand(Command):
             
         except Exception as e:
             console.print(f"[red]交互式初始化失败: {e}[/]")
-            return False
+            return False

{erispulse-2.3.8.dev0 → erispulse-2.3.9}/src/ErisPulse/CLI/commands/init.pyi

@@ -44,7 +44,7 @@ class InitCommand(Command):
         :return: 适配器名称到描述的映射
         """
         ...
-    def _configure_adapters_interactive_sync(self: object, project_path: str = ...) -> ...:
+    def _configure_adapters_interactive_sync(self: object, project_path: Path = ...) -> ...:
         """
         交互式配置适配器的同步版本
         

erispulse-2.3.9/src/ErisPulse/CLI/commands/uninstall.py

@@ -0,0 +1,137 @@
+"""
+Uninstall 命令实现
+
+支持卸载模块、适配器、CLI 扩展
+"""
+
+import sys
+from argparse import ArgumentParser
+
+from rich.panel import Panel
+from rich.prompt import Prompt
+from rich.table import Table
+from rich.box import SIMPLE
+
+from ..utils import PackageManager
+from ..console import console
+from ..base import Command
+
+
+class UninstallCommand(Command):
+    
+    name = "uninstall"
+    description = "卸载模块/适配器包（不指定包名时进入交互式卸载）"
+    
+    def __init__(self):
+        self.package_manager = PackageManager()
+    
+    def add_arguments(self, parser: ArgumentParser):
+        parser.add_argument(
+            'package',
+            nargs='*',
+            help='要卸载的包名（可指定多个）'
+        )
+    
+    def execute(self, args):
+        if args.package:
+            # 直接卸载指定包
+            success = self.package_manager.uninstall_package(args.package)
+            if not success:
+                sys.exit(1)
+        else:
+            # 交互式卸载
+            self._interactive_uninstall()
+    
+    def _interactive_uninstall(self):
+        console.print(Panel(
+            "[bold cyan]ErisPulse 卸载向导[/]\n"
+            "选择要卸载的包",
+            title="卸载向导",
+            border_style="cyan"
+        ))
+        
+        # 获取已安装的包
+        installed = self.package_manager.get_installed_packages()
+        
+        # 收集所有已安装的包
+        all_packages = []
+        
+        # 添加适配器
+        for name, info in installed.get("adapters", {}).items():
+            all_packages.append({
+                "type": "适配器",
+                "name": name,
+                "package": info["package"],
+                "version": info["version"]
+            })
+        
+        # 添加模块
+        for name, info in installed.get("modules", {}).items():
+            all_packages.append({
+                "type": "模块",
+                "name": name,
+                "package": info["package"],
+                "version": info["version"]
+            })
+        
+        # 添加 CLI 扩展
+        for name, info in installed.get("cli_extensions", {}).items():
+            all_packages.append({
+                "type": "CLI",
+                "name": name,
+                "package": info["package"],
+                "version": info["version"]
+            })
+        
+        if not all_packages:
+            console.print("[yellow]没有已安装的包[/]")
+            return
+        
+        # 显示包列表
+        table = Table(box=SIMPLE)
+        table.add_column("序号", style="cyan")
+        table.add_column("类型", style="bold")
+        table.add_column("名称")
+        table.add_column("包名")
+        table.add_column("版本")
+        
+        for i, pkg in enumerate(all_packages, 1):
+            table.add_row(
+                str(i),
+                pkg["type"],
+                pkg["name"],
+                pkg["package"],
+                pkg["version"]
+            )
+        
+        console.print(table)
+        
+        # 选择要卸载的包
+        selected = Prompt.ask(
+            "\n[cyan]请输入要卸载的包序号（多个用逗号分隔，如: 1,3）或按 q 退出:[/cyan]"
+        )
+        
+        if selected.lower() == 'q':
+            console.print("[info]退出卸载向导[/]")
+            return
+        
+        try:
+            indices = [int(idx.strip()) for idx in selected.split(",")]
+            selected_packages = []
+            
+            for idx in indices:
+                if 1 <= idx <= len(all_packages):
+                    pkg_info = all_packages[idx - 1]
+                    selected_packages.append(pkg_info["package"])
+                    console.print(f"[green]已选择: {pkg_info['name']} ({pkg_info['package']})[/]")
+                else:
+                    console.print(f"[red]无效的序号: {idx}[/]")
+            
+            if selected_packages:
+                # 卸载选中的包
+                success = self.package_manager.uninstall_package(selected_packages)
+                if not success:
+                    sys.exit(1)
+        
+        except ValueError:
+            console.print("[red]输入格式错误，请输入数字序号[/]")

{erispulse-2.3.8.dev0 → erispulse-2.3.9}/src/ErisPulse/CLI/commands/uninstall.pyi

@@ -12,7 +12,12 @@ Uninstall 命令实现
 
 import sys
 from argparse import ArgumentParser
+from rich.panel import Panel
+from rich.prompt import Prompt
+from rich.table import Table
+from rich.box import SIMPLE
 from ..utils import PackageManager
+from ..console import console
 from ..base import Command
 
 class UninstallCommand(Command):
@@ -22,3 +27,5 @@ class UninstallCommand(Command):
         ...
     def execute(self: object, args: ...) -> ...:
         ...
+    def _interactive_uninstall(self: object) -> ...:
+        ...

{erispulse-2.3.8.dev0 → erispulse-2.3.9}/src/ErisPulse/Core/Bases/adapter.py

@@ -42,6 +42,41 @@ class SendDSL:
         self._target_to = target_id
         self._account_id = account_id
     
+    def __getattr__(self, name: str):
+        """
+        动态属性访问处理，实现大小写不敏感调用
+        
+        1. 如果找到匹配的方法（忽略大小写），返回该方法
+        2. 如果没找到，打印警告并抛出 AttributeError
+        
+        :param name: 属性名
+        :return: 匹配的方法或属性
+        :raises AttributeError: 当属性不存在时抛出
+        """
+        # 检查所有实际存在的方法
+        for attr_name in dir(self.__class__):
+            # 跳过特殊方法
+            if attr_name.startswith('_'):
+                continue
+            
+            # 大小写不敏感匹配
+            if attr_name.lower() == name.lower():
+                # 返回实际的方法绑定到当前实例
+                attr = getattr(self.__class__, attr_name)
+                if callable(attr):
+                    return attr.__get__(self, self.__class__)
+                return attr
+        
+        # 没有找到匹配的方法，打印警告
+        from .. import logger
+        logger.warning(
+            f"平台 {self._adapter.__class__.__name__} "
+            f"未实现 {name} 发送方法"
+        )
+        
+        # 抛出 AttributeError，这样 hasattr() 能正常工作
+        raise AttributeError(f"'{self.__class__.__name__}' object has no attribute '{name}'")
+    
     def At(self, **kwargs):
         from .. import logger
         logger.warning(
@@ -82,18 +117,41 @@ class SendDSL:
         """
         设置消息目标
         
+        支持自动类型转换：
+        - 当 target_type 为 "private" 时，自动转换为 "user"
+        - 当只提供 target_id（字符串或数字）时，默认推断为 "user"
+        
         :param target_type: 目标类型(可选)
         :param target_id: 目标ID(可选)
         :return: SendDSL实例
         
         :example:
+        >>> # 标准用法
         >>> adapter.Send.To("user", "123").Text("Hello")
-        >>> adapter.Send.To("123").Text("Hello")  # 简化形式
+        >>> # 自动转换 private → user
+        >>> adapter.Send.To("private", "123").Text("Hello")
+        >>> # 简化形式（默认推断为 user）
+        >>> adapter.Send.To("123").Text("Hello")
         """
+        from ..Event.session_type import is_standard_type
+        
+        # 处理简化形式：只提供一个参数作为 target_id
         if target_id is None and target_type is not None:
             target_id = target_type
             target_type = None
-
+        
+        # 如果没有明确指定 target_type，尝试推断
+        if target_type is None:
+            # 将 target_id 作为字符串处理
+            if target_id is not None:
+                # 默认推断为 user（对应 private）
+                # 这里我们假设如果只提供 ID，通常是发送给用户
+                target_type = "user"
+        
+        # 自动转换 private → user
+        if target_type == "private":
+            target_type = "user"
+        
         return self.__class__(self._adapter, target_type, target_id, self._account_id)
 
     def Using(self, account_id: Union[str, int]) -> 'SendDSL':

{erispulse-2.3.8.dev0 → erispulse-2.3.9}/src/ErisPulse/Core/Bases/adapter.pyi

@@ -39,6 +39,18 @@ class SendDSL:
         :param _account_id: 发送账号(可选)
         """
         ...
+    def __getattr__(self: object, name: str) -> ...:
+        """
+        动态属性访问处理，实现大小写不敏感调用
+        
+        1. 如果找到匹配的方法（忽略大小写），返回该方法
+        2. 如果没找到，打印警告并抛出 AttributeError
+        
+        :param name: 属性名
+        :return: 匹配的方法或属性
+        :raises AttributeError: 当属性不存在时抛出
+        """
+        ...
     def At(self: object, **kwargs: ...) -> ...:
         ...
     def Reply(self: object, **kwargs: ...) -> ...:
@@ -53,13 +65,21 @@ class SendDSL:
         """
         设置消息目标
         
+        支持自动类型转换：
+        - 当 target_type 为 "private" 时，自动转换为 "user"
+        - 当只提供 target_id（字符串或数字）时，默认推断为 "user"
+        
         :param target_type: 目标类型(可选)
         :param target_id: 目标ID(可选)
         :return: SendDSL实例
         
         :example:
+        >>> # 标准用法
         >>> adapter.Send.To("user", "123").Text("Hello")
-        >>> adapter.Send.To("123").Text("Hello")  # 简化形式
+        >>> # 自动转换 private → user
+        >>> adapter.Send.To("private", "123").Text("Hello")
+        >>> # 简化形式（默认推断为 user）
+        >>> adapter.Send.To("123").Text("Hello")
         """
         ...
     def Using(self: object, account_id: Union[(str, int)]) -> SendDSL:

{erispulse-2.3.8.dev0 → erispulse-2.3.9}/src/ErisPulse/Core/Bases/manager.py

@@ -26,6 +26,7 @@ class ManagerBase(ABC):
     - exists(): 检查是否存在
     - enable()/disable(): 启用/禁用
     - is_enabled(): 检查是否启用
+    - is_running(): 检查是否运行
     - list_*(): 列出相关项
     {!--< /tips >!--}
     """
@@ -129,6 +130,33 @@ class ManagerBase(ABC):
         :return: {名称: 是否启用} 字典
         """
         ...
+    
+    # ==================== 运行状态检查 ====================
+    
+    @abstractmethod
+    def is_running(self, name: str) -> bool:
+        """
+        检查项是否正在运行
+        
+        对于适配器：检查是否已启动
+        对于模块：检查是否已加载
+        
+        :param name: 名称
+        :return: 是否正在运行
+        """
+        ...
+    
+    @abstractmethod
+    def list_running(self) -> List[str]:
+        """
+        列出所有正在运行的项
+        
+        对于适配器：列出所有已启动的适配器
+        对于模块：列出所有已加载的模块
+        
+        :return: 名称列表
+        """
+        ...
 
 
 __all__ = [

{erispulse-2.3.8.dev0 → erispulse-2.3.9}/src/ErisPulse/Core/Bases/manager.pyi

@@ -31,6 +31,7 @@ class ManagerBase(ABC):
     - exists(): 检查是否存在
     - enable()/disable(): 启用/禁用
     - is_enabled(): 检查是否启用
+    - is_running(): 检查是否运行
     - list_*(): 列出相关项
     {!--< /tips >!--}
     """
@@ -106,3 +107,24 @@ class ManagerBase(ABC):
         :return: {名称: 是否启用} 字典
         """
         ...
+    def is_running(self: object, name: str) -> bool:
+        """
+        检查项是否正在运行
+        
+        对于适配器：检查是否已启动
+        对于模块：检查是否已加载
+        
+        :param name: 名称
+        :return: 是否正在运行
+        """
+        ...
+    def list_running(self: object) -> List[str]:
+        """
+        列出所有正在运行的项
+        
+        对于适配器：列出所有已启动的适配器
+        对于模块：列出所有已加载的模块
+        
+        :return: 名称列表
+        """
+        ...

erispulse-2.3.9/src/ErisPulse/Core/Event/__init__.py

@@ -0,0 +1,85 @@
+"""
+ErisPulse 事件处理模块
+
+提供统一的事件处理接口，支持命令、消息、通知、请求和元事件处理
+
+{!--< tips >!--}
+1. 所有事件处理都基于OneBot12标准事件格式
+2. 通过装饰器方式注册事件处理器
+3. 支持优先级和条件过滤
+{!--< /tips >!--}
+"""
+
+from .command import command
+from .message import message
+from .notice import notice
+from .request import request
+from .meta import meta
+from .wrapper import Event
+from .session_type import (
+    # 标准类型常量
+    RECEIVE_TYPES,
+    SEND_TYPES,
+    
+    # 自定义类型注册
+    register_custom_type,
+    unregister_custom_type,
+    
+    # 类型获取方法
+    get_id_field,
+    get_receive_type,
+    convert_to_send_type,
+    convert_to_receive_type,
+    
+    # 自动推断方法
+    infer_receive_type,
+    get_target_id,
+    get_send_type_and_target_id,
+    
+    # 工具方法
+    is_standard_type,
+    is_valid_send_type,
+    get_standard_types,
+    get_send_types,
+    clear_custom_types,
+)
+
+def _clear_all_handlers():
+    """
+    {!--< internal-use >!--}
+    清除所有已注册的事件处理器和命令
+    """
+    # 清除命令处理器
+    command._clear_commands()
+    
+    # 清除各类事件处理器
+    message._clear_message_handlers()
+    notice._clear_notice_handlers()
+    request._clear_request_handlers()
+    meta._clear_meta_handlers()
+
+__all__ = [
+    "command",
+    "message", 
+    "notice",
+    "request",
+    "meta",
+    "Event",
+    # 会话类型管理
+    "RECEIVE_TYPES",
+    "SEND_TYPES",
+    "register_custom_type",
+    "unregister_custom_type",
+    "get_id_field",
+    "get_receive_type",
+    "convert_to_send_type",
+    "convert_to_receive_type",
+    "infer_receive_type",
+    "get_target_id",
+    "get_send_type_and_target_id",
+    "is_standard_type",
+    "is_valid_send_type",
+    "get_standard_types",
+    "get_send_types",
+    "clear_custom_types",
+]

{erispulse-2.3.8.dev0 → erispulse-2.3.9}/src/ErisPulse/Core/Event/__init__.pyi

@@ -22,3 +22,4 @@ from .notice import notice
 from .request import request
 from .meta import meta
 from .wrapper import Event
+from .session_type import RECEIVE_TYPES, SEND_TYPES, register_custom_type, unregister_custom_type, get_id_field, get_receive_type, convert_to_send_type, convert_to_receive_type, infer_receive_type, get_target_id, get_send_type_and_target_id, is_standard_type, is_valid_send_type, get_standard_types, get_send_types, clear_custom_types