ErisPulse 2.3.9.dev2__tar.gz → 2.3.9.dev3__tar.gz

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/.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.9.dev2 → erispulse-2.3.9.dev3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.3.9.dev2
+Version: 2.3.9.dev3
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: ErisDev <erisdev@88.com>
 Maintainer-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>
@@ -60,7 +60,7 @@ Description-Content-Type: text/markdown
 
 <div align="center">
 
-[English](README.en.md) | [简体中文](README.md) | [繁體中文](README.zh-Hant.md)
+[English](README.en.md) | [简体中文](README.md) | [繁體中文](README.zh-TW.md)
 
 </div>
 
@@ -184,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/)
 
 ## 应用场景
 
@@ -206,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) |
@@ -226,7 +232,7 @@ ErisPulse 项目的健全性还需要您的一份力！我们欢迎各种形式
    通过 [社区讨论](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.9.dev2 → erispulse-2.3.9.dev3}/README.md

@@ -1,19 +1,19 @@
-<div align="center">
-
-[English](README.en.md) | [简体中文](README.md) | [繁體中文](README.zh-Hant.md)
-
-</div>
-
-<table>
-<tr>
-<td width="35%" valign="middle" align="center">
-<img src=".github/assets/erispulse_logo_1024.png" width="280" alt="ErisPulse" />
-</td>
-<td width="65%" valign="middle">
-
-# ErisPulse
-
-**事件驱动的多平台机器人开发框架**
+<div align="center">
+
+[English](README.en.md) | [简体中文](README.md) | [繁體中文](README.zh-TW.md)
+
+</div>
+
+<table>
+<tr>
+<td width="35%" valign="middle" align="center">
+<img src=".github/assets/erispulse_logo_1024.png" width="280" alt="ErisPulse" />
+</td>
+<td width="65%" valign="middle">
+
+# ErisPulse
+
+**事件驱动的多平台机器人开发框架**
 
 [![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/)
@@ -124,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/)
 
 ## 应用场景
 
@@ -146,32 +146,38 @@ 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) |
 | 模块市场 | [erisdev.com](https://www.erisdev.com/#market) | [Cloudflare](https://erispulse.pages.dev/#market) • [GitHub](https://erispulse.github.io/#market) • [Netlify](https://erispulse.netlify.app/#market) |
 
-## 贡献指南
-
-ErisPulse 项目的健全性还需要您的一份力！我们欢迎各种形式的贡献，包括但不限于：
-
-1. **报告问题**
-   在 [GitHub Issues](https://github.com/ErisPulse/ErisPulse/issues) 提交 bug 报告
-
-2. **功能请求**
-   通过 [社区讨论](https://github.com/ErisPulse/ErisPulse/discussions) 提出新想法
-
-3. **代码贡献**
-   提交 Pull Request 前请阅读我们的 [代码风格](docs/styleguide/) 以及 [贡献指南](CONTRIBUTING.md)
-
-4. **文档改进**
-   帮助完善文档和示例代码
-
-[加入社区讨论](https://github.com/ErisPulse/ErisPulse/discussions)
+## 贡献指南
+
+ErisPulse 项目的健全性还需要您的一份力！我们欢迎各种形式的贡献，包括但不限于：
+
+1. **报告问题**
+   在 [GitHub Issues](https://github.com/ErisPulse/ErisPulse/issues) 提交 bug 报告
+
+2. **功能请求**
+   通过 [社区讨论](https://github.com/ErisPulse/ErisPulse/discussions) 提出新想法
+
+3. **代码贡献**
+   提交 Pull Request 前请阅读我们的 [代码风格](docs/zh-CN/styleguide/) 以及 [贡献指南](CONTRIBUTING.md)
+
+4. **文档改进**
+   帮助完善文档和示例代码
+
+[加入社区讨论](https://github.com/ErisPulse/ErisPulse/discussions)
 
 ---
 

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.3.9-dev.2"
+version = "2.3.9-dev.3"
 description = "ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。"
 readme = "README.md"
 requires-python = ">=3.10"

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/Event/command.py

@@ -558,4 +558,4 @@ class CommandHandler:
                 help_lines.append(f"  {self.prefix}{cmd_name} - {help_text}")
             return "\n".join(help_lines)
 
-command = CommandHandler()
+command : CommandHandler = CommandHandler()

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/Event/command.pyi

@@ -114,3 +114,5 @@ class CommandHandler:
         :return: 帮助信息字符串
         """
         ...
+
+command: CommandHandler

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/Event/message.py

@@ -132,4 +132,4 @@ class MessageHandler:
         """
         return self.handler._clear_handlers()
 
-message = MessageHandler()
+message : MessageHandler = MessageHandler()

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/Event/message.pyi

@@ -91,3 +91,5 @@ class MessageHandler:
         :return: 是否成功取消注册
         """
         ...
+
+message: MessageHandler

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/Event/meta.py

@@ -124,4 +124,4 @@ class MetaHandler:
         """
         return self.handler._clear_handlers()
 
-meta = MetaHandler()
+meta : MetaHandler = MetaHandler()

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/Event/meta.pyi

@@ -90,3 +90,5 @@ class MetaHandler:
         :return: 是否成功取消注册
         """
         ...
+
+meta: MetaHandler

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/Event/notice.py

@@ -148,4 +148,4 @@ class NoticeHandler:
         """
         return self.handler._clear_handlers()
 
-notice = NoticeHandler()
+notice : NoticeHandler = NoticeHandler()

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/Event/notice.pyi

@@ -106,3 +106,5 @@ class NoticeHandler:
         :return: 是否成功取消注册
         """
         ...
+
+notice: NoticeHandler

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/Event/request.py

@@ -100,4 +100,4 @@ class RequestHandler:
         """
         return self.handler._clear_handlers()
     
-request = RequestHandler()
+request : RequestHandler = RequestHandler()

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/Event/request.pyi

@@ -74,3 +74,5 @@ class RequestHandler:
         :return: 是否成功取消注册
         """
         ...
+
+request: RequestHandler

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/adapter.py

@@ -771,7 +771,7 @@ class AdapterManager(ManagerBase):
         """
         return self.exists(platform) and self.is_enabled(platform)
 
-adapter = AdapterManager()
+adapter : AdapterManager = AdapterManager()
 
 __all__ = [
     "adapter"

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/adapter.pyi

@@ -304,3 +304,5 @@ class AdapterManager(ManagerBase):
         :return: [bool] 平台是否存在且启用
         """
         ...
+
+adapter: AdapterManager

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/config.py

@@ -258,7 +258,7 @@ class ConfigManager:
             self._dirty_keys.clear()
             self._load_config()
 
-config = ConfigManager()
+config : ConfigManager = ConfigManager()
 
 __all__ = [
     "config"

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/config.pyi

@@ -81,3 +81,5 @@ class ConfigManager:
         重新从磁盘加载配置，丢弃所有未保存的更改
         """
         ...
+
+config: ConfigManager

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/lifecycle.py

@@ -182,7 +182,7 @@ class LifecycleManager:
             except Exception as e:
                 logger.error(f"生命周期事件处理器执行错误 {event}: {e}")
 
-lifecycle = LifecycleManager()
+lifecycle : LifecycleManager = LifecycleManager()
 
 __all__ = [
     "LifecycleManager",

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/lifecycle.pyi

@@ -94,3 +94,5 @@ class LifecycleManager:
         :param event_data: 事件数据
         """
         ...
+
+lifecycle: LifecycleManager

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/logger.py

@@ -511,6 +511,6 @@ class LoggerChild:
         return self.get_child(name)
 
 
-logger = Logger()
+logger : Logger = Logger()
 
 __all__ = ["logger"]

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/logger.pyi

@@ -304,3 +304,5 @@ class LoggerChild:
         >>> nested_child.info("db message")
         """
         ...
+
+logger: Logger

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/module.py

@@ -486,7 +486,7 @@ class ModuleManager(ManagerBase):
         """
         return self.exists(module_name) and self.is_enabled(module_name)
 
-module = ModuleManager()
+module : ModuleManager = ModuleManager()
 
 __all__ = [
     "module"

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/module.pyi

@@ -214,3 +214,5 @@ class ModuleManager(ManagerBase):
         >>> if "MyModule" in module: ...
         """
         ...
+
+module: ModuleManager

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/router.py

@@ -452,7 +452,7 @@ class RouterManager:
         
         return "\n".join(lines)
 
-router = RouterManager()
+router : RouterManager = RouterManager()
 
 __all__ = [
     "router",

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/router.pyi

@@ -136,3 +136,5 @@ class RouterManager:
             str: 格式化后的URL
         """
         ...
+
+router: RouterManager

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/storage.py

@@ -547,7 +547,7 @@ class StorageManager:
             from .logger import logger
             logger.error(f"设置存储项 {key} 失败: {e}")
 
-storage = StorageManager()
+storage : StorageManager = StorageManager()
 
 __all__ = [
     "storage"

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/Core/storage.pyi

@@ -207,3 +207,5 @@ class StorageManager:
         >>> storage.app_name = "MyApp"
         """
         ...
+
+storage: StorageManager

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/sdk.py

@@ -11,15 +11,24 @@ example:
 {!--< /tips >!--}
 """
 
+from __future__ import annotations
+
 import asyncio
 from pathlib import Path
-from typing import Any
+from typing import TYPE_CHECKING
 
 # 导入核心模块
 from .Core import Event, lifecycle, logger
 from .Core import storage, env, config
 from .Core import adapter, AdapterFather, BaseAdapter, SendDSL
 from .Core import module, router, adapter_server
+from .Core.lifecycle import LifecycleManager
+from .Core.adapter import AdapterManager
+from .Core.storage import StorageManager
+from .Core.logger import Logger
+from .Core.module import ModuleManager
+from .Core.router import RouterManager
+from .Core.config import ConfigManager
 
 # 导入懒加载模块类
 from .loaders.module import LazyModule
@@ -27,6 +36,9 @@ from .loaders.module import LazyModule
 from .loaders.adapter import AdapterLoader
 from .loaders.module import ModuleLoader
 
+if TYPE_CHECKING:
+    from types import ModuleType
+
 
 class SDK:
     """
@@ -54,43 +66,43 @@ class SDK:
     
     # ==================== 核心模块属性 ====================
     
-    Event: Any
+    Event: ModuleType
     """事件系统"""
     
-    lifecycle: Any
+    lifecycle: LifecycleManager
     """生命周期管理器"""
     
-    logger: Any
+    logger: Logger
     """日志管理器"""
     
-    storage: Any
+    storage: StorageManager
     """存储管理器"""
     
-    env: Any
+    env: StorageManager
     """存储管理器别名"""
     
-    config: Any
+    config: ConfigManager
     """配置管理器"""
     
-    adapter: Any
+    adapter: AdapterManager
     """适配器管理器"""
     
-    AdapterFather: Any
+    AdapterFather: type[BaseAdapter]
     """适配器基类别名"""
     
-    BaseAdapter: Any
+    BaseAdapter: type[BaseAdapter]
     """适配器基类"""
     
-    SendDSL: Any
+    SendDSL: type[SendDSL]
     """DSL 发送接口基类"""
     
-    module: Any
+    module: ModuleManager
     """模块管理器"""
     
-    router: Any
+    router: RouterManager
     """路由管理器"""
     
-    adapter_server: Any
+    adapter_server: RouterManager
     """路由管理器别名"""
     
     def __init__(self):
@@ -124,7 +136,7 @@ class SDK:
         self.adapter_server = adapter_server
         
         # 初始化协调器（在需要时创建）
-        self._initializer: Any = None  # type: ignore
+        self._initializer: SDK.Initializer | None = None
         self._initialized: bool = False
     
     def __getattribute__(self, name: str):
@@ -157,7 +169,7 @@ class SDK:
         {!--< /tips >!--}
         """
         
-        def __init__(self, sdk_instance: Any):
+        def __init__(self, sdk_instance: SDK) -> None:
             """
             初始化协调器
             
@@ -310,7 +322,7 @@ class SDK:
         {!--< /tips >!--}
         """
         
-        def __init__(self, sdk_instance: Any):
+        def __init__(self, sdk_instance: SDK) -> None:
             """
             反初始化协调器
             

{erispulse-2.3.9.dev2 → erispulse-2.3.9.dev3}/src/ErisPulse/sdk.pyi

@@ -17,13 +17,21 @@ example:
 {!--< /tips >!--}
 """
 
+from __future__ import annotations
 import asyncio
 from pathlib import Path
-from typing import Any
+from typing import TYPE_CHECKING
 from .Core import Event, lifecycle, logger
 from .Core import storage, env, config
 from .Core import adapter, AdapterFather, BaseAdapter, SendDSL
 from .Core import module, router, adapter_server
+from .Core.lifecycle import LifecycleManager
+from .Core.adapter import AdapterManager
+from .Core.storage import StorageManager
+from .Core.logger import Logger
+from .Core.module import ModuleManager
+from .Core.router import RouterManager
+from .Core.config import ConfigManager
 from .loaders.module import LazyModule
 from .loaders.adapter import AdapterLoader
 from .loaders.module import ModuleLoader
@@ -51,19 +59,19 @@ class SDK:
     - adapter_server: 路由管理器别名
     {!--< /tips >!--}
     """
-    Event: Any
-    lifecycle: Any
-    logger: Any
-    storage: Any
-    env: Any
-    config: Any
-    adapter: Any
-    AdapterFather: Any
-    BaseAdapter: Any
-    SendDSL: Any
-    module: Any
-    router: Any
-    adapter_server: Any
+    Event: ModuleType
+    lifecycle: LifecycleManager
+    logger: Logger
+    storage: StorageManager
+    env: StorageManager
+    config: ConfigManager
+    adapter: AdapterManager
+    AdapterFather: type[BaseAdapter]
+    BaseAdapter: type[BaseAdapter]
+    SendDSL: type[SendDSL]
+    module: ModuleManager
+    router: RouterManager
+    adapter_server: RouterManager
     def __init__(self: None) -> ...:
         """
         初始化 SDK 实例