ErisPulse 2.5.2.dev0__tar.gz → 2.5.2.dev1__tar.gz

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.5.2.dev0
+Version: 2.5.2.dev1
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Project-URL: Homepage, https://github.com/ErisPulse/ErisPulse
 Project-URL: Documentation, https://www.erisdev.com#docs

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/pyproject.toml

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

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/CLI/commands/run.py

@@ -128,13 +128,20 @@ class RunCommand(Command):
             self._run_internal(reload_mode)
 
     _RESTART_EXIT_CODE = 42
+    _MAX_CRASH_BACKOFF = 60.0
 
     def _run_internal(self, reload_mode: bool):
         """
         直接运行 SDK（不指定脚本时）
 
-        以子进程方式运行 SDK，支持硬重启：当 SDK 进程以特定退出码退出时，
-        自动重新启动新进程，确保资源完全释放。
+        以子进程方式运行 SDK，支持硬重启。
+
+        {!--< tips >!--}
+        重要设计原则：
+        1. 只有硬重启（退出码 42）或 KeyboardInterrupt 才能停止主进程
+        2. 模块/适配器的任何错误都**不会**导致主进程退出
+        3. 子进程异常退出时自动重试，使用递增退避策略避免刷屏
+        {!--< /tips >!--}
         """
 
         if reload_mode:
@@ -168,33 +175,30 @@ class RunCommand(Command):
             "asyncio.run(sdk.run(keep_running=True))",
         ]
 
-        import signal
-
+        crash_count = 0
         try:
             while True:
                 process = subprocess.Popen(cmd)
-
-                # 转发 SIGTERM/SIGINT 到子进程，使 SDK 能优雅关闭
-                def _forward_signal(signum, frame):
-                    try:
-                        process.send_signal(signum)
-                    except Exception:
-                        pass
-
-                old_term = signal.signal(signal.SIGTERM, _forward_signal)
-                old_int = signal.signal(signal.SIGINT, _forward_signal)
-
                 process.wait()
 
-                # 恢复默认信号处理
-                signal.signal(signal.SIGTERM, old_term)
-                signal.signal(signal.SIGINT, old_int)
-
                 if process.returncode == self._RESTART_EXIT_CODE:
                     console.print(f"[info]{i18n.t('cli.run.restart_request')}[/]")
+                    crash_count = 0
                     time.sleep(0.5)
                     continue
-                break
+
+                # 非硬重启退出码：模块/适配器内部错误导致子进程异常终止
+                # 不退出主进程，等待后自动重试
+                crash_count += 1
+                backoff = min(self._MAX_CRASH_BACKOFF, 3.0 * crash_count)
+                console.print(
+                    f"[warning]{i18n.t('cli.run.process_crashed', code=process.returncode)}[/]"
+                )
+                console.print(
+                    f"[info]{i18n.t('cli.run.subprocess_crashed_retry', seconds=backoff)}[/]"
+                )
+                time.sleep(backoff)
+                # 继续循环，重新启动子进程
         except KeyboardInterrupt:
             pass
 

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/CLI/commands/run.pyi

@@ -72,8 +72,14 @@ class RunCommand(Command):
         """
         直接运行 SDK（不指定脚本时）
         
-        以子进程方式运行 SDK，支持硬重启：当 SDK 进程以特定退出码退出时，
-        自动重新启动新进程，确保资源完全释放。
+        以子进程方式运行 SDK，支持硬重启。
+        
+        {!--< tips >!--}
+        重要设计原则：
+        1. 只有硬重启（退出码 42）或 KeyboardInterrupt 才能停止主进程
+        2. 模块/适配器的任何错误都**不会**导致主进程退出
+        3. 子进程异常退出时自动重试，使用递增退避策略避免刷屏
+        {!--< /tips >!--}
         """
         ...
     def _run_script(self: object, script_path: str, reload_mode: bool) -> ...:

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/CLI/i18n/locales/en.py

@@ -249,6 +249,7 @@ TRANSLATIONS = {
     "cli.run.file_changed_restart": "File change detected ([cmd]{file}[/]), restarting...",
     "cli.run.process_exited": "Process exited normally, waiting for file changes to restart",
     "cli.run.process_crashed": "Process crashed (exit code {code}), fix and save to restart",
+    "cli.run.subprocess_crashed_retry": "Subprocess crashed, will auto-retry in {seconds}s...",
     # ==================== uninstall command ====================
     "cli.uninstall.description": "Uninstall module/adapter packages",
     "cli.uninstall.package_help": "Package name(s) to uninstall (multiple allowed)",

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/CLI/i18n/locales/ja.py

@@ -249,6 +249,7 @@ TRANSLATIONS = {
     "cli.run.file_changed_restart": "ファイル変更を検出 ([cmd]{file}[/])、再起動中...",
     "cli.run.process_exited": "プロセスが正常に終了しました。ファイルの変更を待機して再起動",
     "cli.run.process_crashed": "プロセスが異常終了しました（終了コード {code}）。修正して保存すると自動再起動",
+    "cli.run.subprocess_crashed_retry": "サブプロセスが異常終了しました。{seconds} 秒後に自動再試行します...",
     # ==================== uninstall コマンド ====================
     "cli.uninstall.description": "モジュール/アダプターパッケージをアンインストール",
     "cli.uninstall.package_help": "アンインストールするパッケージ名（複数指定可）",

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/CLI/i18n/locales/ru.py

@@ -249,6 +249,7 @@ TRANSLATIONS = {
     "cli.run.file_changed_restart": "Обнаружено изменение файла ([cmd]{file}[/]), перезапуск...",
     "cli.run.process_exited": "Процесс завершен нормально, ожидание изменений файлов для перезапуска",
     "cli.run.process_crashed": "Процесс аварийно завершен (код {code}), исправьте и сохраните для перезапуска",
+    "cli.run.subprocess_crashed_retry": "Подпроцесс аварийно завершен, автоматическая перезагрузка через {seconds}с...",
     # ==================== команда uninstall ====================
     "cli.uninstall.description": "Удалить пакеты модулей/адаптеров",
     "cli.uninstall.package_help": "Имя(ена) пакета(ов) для удаления (можно указать несколько)",

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/CLI/i18n/locales/zh_cn.py

@@ -249,6 +249,7 @@ TRANSLATIONS = {
     "cli.run.file_changed_restart": "检测到文件变更 ([cmd]{file}[/])，正在重启...",
     "cli.run.process_exited": "进程已正常退出，等待文件变更后重启",
     "cli.run.process_crashed": "进程异常退出（退出码 {code}），修复后保存文件将自动重启",
+    "cli.run.subprocess_crashed_retry": "子进程异常终止，将在 {seconds} 秒后自动重试...",
     # ==================== uninstall 命令 ====================
     "cli.uninstall.description": "卸载模块/适配器包",
     "cli.uninstall.package_help": "要卸载的包名（可指定多个）",

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/CLI/i18n/locales/zh_tw.py

@@ -249,6 +249,7 @@ TRANSLATIONS = {
     "cli.run.file_changed_restart": "檢測到檔案變更 ([cmd]{file}[/])，正在重啟...",
     "cli.run.process_exited": "程式已正常退出，等待檔案變更後重啟",
     "cli.run.process_crashed": "程式異常退出（退出碼 {code}），修復後儲存檔案將自動重啟",
+    "cli.run.subprocess_crashed_retry": "子程序異常終止，將在 {seconds} 秒後自動重試...",
     # ==================== uninstall 命令 ====================
     "cli.uninstall.description": "解除安裝模組/適配器包",
     "cli.uninstall.package_help": "要解除安裝的包名（可指定多個）",

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/CLI/utils/package_manager.py

@@ -673,59 +673,18 @@ class PackageManager:
            并将目标 Python 解析为当前虚拟环境的解释器，
            避免安装到全局环境。
 
-        操作成功后自动保存包快照到持久化目录，
-        供 Docker 容器重建后恢复使用。
-
         :param args: [List[str]] pip 子命令与参数，如 ["install", "--upgrade", pkg]
         :param description: [str] 展示给用户的操作描述
         :return: [bool] 执行成功返回 True
         """
         uv_cmd = self._get_uv_command()
-        success = False
         if uv_cmd:
             if self._execute_backend(uv_cmd + ["pip"], args, description, "uv"):
-                success = True
-            else:
-                console.print(f"[warning]{i18n.t('cli.package.uv_fallback_to_pip')}[/]")
-
-        if not success:
-            pip_cmd = [self._get_target_python(), "-m", "pip"]
-            success = self._execute_backend(pip_cmd, args, description, "pip")
-
-        # 操作成功后保存包快照（非关键，失败不影响主流程）
-        if success:
-            self._save_package_snapshot()
-
-        return success
-
-    def _save_package_snapshot(self) -> None:
-        """
-        {!--< internal-use >!--}
-        将当前已安装的包列表保存到持久化目录。
-
-        快照文件用于 Docker 容器重建后的包恢复：
-        entrypoint 创建新 venv 时会读取 .pip-snapshot.txt
-        并尝试重新安装这些包。
+                return True
+            console.print(f"[warning]{i18n.t('cli.package.uv_fallback_to_pip')}[/]")
 
-        仅在 config/ 目录存在时保存（即项目环境或 Docker 环境）。
-        """
-        try:
-            config_dir = os.path.join(os.getcwd(), "config")
-            if not os.path.isdir(config_dir):
-                return
-
-            result = subprocess.run(
-                [sys.executable, "-m", "pip", "freeze"],
-                capture_output=True,
-                text=True,
-                timeout=30,
-            )
-            if result.returncode == 0:
-                snapshot_path = os.path.join(config_dir, ".pip-snapshot.txt")
-                with open(snapshot_path, "w", encoding="utf-8") as f:
-                    f.write(result.stdout)
-        except Exception:
-            pass
+        pip_cmd = [self._get_target_python(), "-m", "pip"]
+        return self._execute_backend(pip_cmd, args, description, "pip")
 
     def _version_key(self, version: str) -> tuple:
         """

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/CLI/utils/package_manager.pyi

@@ -243,9 +243,6 @@ class PackageManager:
            并将目标 Python 解析为当前虚拟环境的解释器，
            避免安装到全局环境。
         
-        操作成功后自动保存包快照到持久化目录，
-        供 Docker 容器重建后恢复使用。
-        
         :param args: [List[str]] pip 子命令与参数，如 ["install", "--upgrade", pkg]
         :param description: [str] 展示给用户的操作描述
         :return: [bool] 执行成功返回 True

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/Core/Event/__init__.py

@@ -12,48 +12,55 @@ ErisPulse 事件处理模块
 
 from .command import command
 from .message import message
+from .message_builder import MessageBuilder
+from .meta import meta
 from .notice import notice
 from .request import request
-from .meta import meta
-from .wrapper import (
-    Event,
-    Conversation,
-    CONFIRM_YES_WORDS,
-    CONFIRM_NO_WORDS,
-    register_event_mixin,
-    register_event_method,
-    unregister_event_method,
-    unregister_platform_event_methods,
-    get_platform_event_methods,
-    _builtin_wait_reply,
-    _builtin_confirm,
-    _builtin_choose,
-    _builtin_collect,
-)
-from .message_builder import MessageBuilder
 from .session_type import (
     # 标准类型常量
     RECEIVE_TYPES,
     SEND_TYPES,
     # 自定义类型注册
-    register_custom_type,
-    unregister_custom_type,
+    clear_custom_types,
+    convert_to_receive_type,
+    convert_to_send_type,
     # 类型获取方法
     get_id_field,
     get_receive_type,
-    convert_to_send_type,
-    convert_to_receive_type,
+    get_send_type_and_target_id,
+    get_send_types,
+    get_standard_types,
+    get_target_id,
     # 自动推断方法
     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,
+    # 自定义类型注册
+    register_custom_type,
+    unregister_custom_type,
 )
+from .wrapper import (
+    CONFIRM_NO_WORDS,
+    CONFIRM_YES_WORDS,
+    Conversation,
+    Event,
+    _builtin_choose,
+    _builtin_collect,
+    _builtin_confirm,
+    _builtin_wait_reply,
+    get_platform_event_methods,
+    register_event_method,
+    register_event_mixin,
+    unregister_event_method,
+    unregister_platform_event_methods,
+)
+
+# 将 command 的命令分发器绑定到 message 的共享 BaseEventHandler，
+# 使命令处理和消息处理共享同一个优先级队列。
+# 命令分发器 _handle_message 以 DEFAULT_COMMAND_DISPATCHER_PRIORITY (100) 注册，
+# 确保命令 /xxx 始终优先于 on_message / on_group_message 等处理器触发。
+command.bind_message_handler(message.handler)
 
 
 def _clear_all_handlers():

erispulse-2.5.2.dev1/src/ErisPulse/Core/Event/__init__.pyi

@@ -0,0 +1,26 @@
+# type: ignore
+#
+# Auto-generated type stub for __init__.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 事件处理模块
+
+提供统一的事件处理接口，支持命令、消息、通知、请求和元事件处理
+
+{!--< tips >!--}
+1. 所有事件处理都基于OneBot12标准事件格式
+2. 通过装饰器方式注册事件处理器
+3. 支持优先级和条件过滤
+{!--< /tips >!--}
+"""
+
+from .command import command
+from .message import message
+from .message_builder import MessageBuilder
+from .meta import meta
+from .notice import notice
+from .request import request
+from .session_type import RECEIVE_TYPES, SEND_TYPES, clear_custom_types, convert_to_receive_type, convert_to_send_type, get_id_field, get_receive_type, get_send_type_and_target_id, get_send_types, get_standard_types, get_target_id, infer_receive_type, is_standard_type, is_valid_send_type, register_custom_type, unregister_custom_type
+from .wrapper import CONFIRM_NO_WORDS, CONFIRM_YES_WORDS, Conversation, Event, _builtin_choose, _builtin_collect, _builtin_confirm, _builtin_wait_reply, get_platform_event_methods, register_event_method, register_event_mixin, unregister_event_method, unregister_platform_event_methods

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/Core/Event/command.py

@@ -21,6 +21,7 @@ from ...runtime.context import current_owner, handler_waits
 from .. import adapter, logger
 from ..constants import (
     DEFAULT_COMMAND_ALLOW_SPACE_PREFIX,
+    DEFAULT_COMMAND_DISPATCHER_PRIORITY,
     DEFAULT_COMMAND_MUST_AT_BOT,
     DEFAULT_SEND_METHOD,
     DEFAULT_WAIT_TIMEOUT_SECS,
@@ -65,12 +66,11 @@ class CommandHandler:
         # 等待回复相关
         self._waiting_replies = {}  # 存储等待回复的用户信息
 
-        # 创建消息事件处理器
-        self.handler = BaseEventHandler("message", "command")
-
-        # 将命令分发器 _handle_message 挂载到适配器消息事件总线
-        if not self.handler._linked_to_adapter_bus:
-            self.handler.register(self._handle_message)
+        # 共享的消息事件处理器引用（由 bind_message_handler() 设置）
+        # 命令分发器 _handle_message 以高优先级注册在同一个队列中，
+        # 确保命令 /xxx 始终优先于 on_message / on_group_message 触发
+        self._bound_handler: BaseEventHandler | None = None
+        self._dispatcher_registered: bool = False
 
     def __call__(
         self,
@@ -98,8 +98,9 @@ class CommandHandler:
         """
 
         def decorator(func: Callable):
-            if not self.handler._linked_to_adapter_bus:
-                self.handler.register(self._handle_message)
+            # 确保命令分发器已注册到共享 handler
+            if not self._dispatcher_registered:
+                self._register_dispatcher()
 
             cmd_names = []
             if isinstance(name, str):
@@ -162,8 +163,10 @@ class CommandHandler:
         :param handler: 要注销的命令处理器
         :return: 是否成功注销
         """
-        # 从基础处理器中移除
-        result = self.handler.unregister(handler)
+        # 从共享 handler 中注销命令函数（如已注册）
+        result = False
+        if self._bound_handler is not None:
+            result = self._bound_handler.unregister(handler)
 
         # 从命令映射中移除
         commands_to_remove = []
@@ -667,10 +670,35 @@ class CommandHandler:
         except Exception as e:
             logger.error(f"发送命令错误消息失败: {e}")
 
+    def bind_message_handler(self, handler: BaseEventHandler) -> None:
+        """
+        {!--< internal-use >!--}
+        绑定到共享的消息事件处理器
+
+        将命令分发器 _handle_message 注册到共享的 BaseEventHandler 中，
+        使命令处理和通用消息处理共享同一个优先级队列。
+
+        :param handler: MessageHandler 持有的 BaseEventHandler 实例
+        """
+        self._bound_handler = handler
+        self._register_dispatcher()
+
+    def _register_dispatcher(self) -> None:
+        """
+        {!--< internal-use >!--}
+        将命令分发器注册到共享 handler（如尚未注册）
+        """
+        if self._bound_handler is not None and not self._dispatcher_registered:
+            self._bound_handler.register(
+                self._handle_message,
+                priority=DEFAULT_COMMAND_DISPATCHER_PRIORITY,
+            )
+            self._dispatcher_registered = True
+
     def _clear_commands(self):
         """
         {!--< internal-use >!--}
-        清除所有已注册的命令，并断开与适配器事件总线的连接
+        清除所有已注册的命令，并从共享 handler 中注销命令分发器
 
         :return: 被清除的命令数量
         """
@@ -680,7 +708,10 @@ class CommandHandler:
         self.groups.clear()
         self.permissions.clear()
         self._waiting_replies.clear()
-        self.handler._clear_handlers()
+        # 从共享 handler 中注销命令分发器（不清除其他 handler 的消息处理器）
+        if self._bound_handler is not None and self._dispatcher_registered:
+            self._bound_handler.unregister(self._handle_message)
+            self._dispatcher_registered = False
         return count
 
     def get_command(self, name: str) -> dict | None:

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/Core/Event/command.pyi

@@ -24,7 +24,7 @@ from typing import Any
 from ...runtime import get_event_config
 from ...runtime.context import current_owner, handler_waits
 from .. import adapter, logger
-from ..constants import DEFAULT_COMMAND_ALLOW_SPACE_PREFIX, DEFAULT_COMMAND_MUST_AT_BOT, DEFAULT_SEND_METHOD, DEFAULT_WAIT_TIMEOUT_SECS, DETAIL_TYPE_PRIVATE, DETAIL_TYPE_USER, UNKNOWN_PLATFORM
+from ..constants import DEFAULT_COMMAND_ALLOW_SPACE_PREFIX, DEFAULT_COMMAND_DISPATCHER_PRIORITY, DEFAULT_COMMAND_MUST_AT_BOT, DEFAULT_SEND_METHOD, DEFAULT_WAIT_TIMEOUT_SECS, DETAIL_TYPE_PRIVATE, DETAIL_TYPE_USER, UNKNOWN_PLATFORM
 from .base import BaseEventHandler
 from .session_type import get_send_type_and_target_id, infer_receive_type
 

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/Core/constants.py

@@ -319,6 +319,10 @@ DEFAULT_MESSAGE_IGNORE_SELF = True
 # 修改影响: 未指定 priority 的处理器的执行顺序。
 DEFAULT_HANDLER_PRIORITY = 0
 
+# 命令分发器优先级（远高于默认值，确保命令在消息处理器之前执行）。
+# 修改影响: 命令 /xxx 总是优先于 on_message / on_group_message 等处理器触发。
+DEFAULT_COMMAND_DISPATCHER_PRIORITY = 100
+
 # 等待用户回复的默认超时时间（秒）。
 # 使用位置: command.wait_reply(), Event.wait_reply(), Event.wait_for() 等 8 处。
 # 修改影响: 所有等待用户交互的默认超时。设大用户有更多反应时间，设小释放资源更快。

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/Core/i18n/locales/en.py

@@ -57,6 +57,7 @@ TRANSLATIONS = {
     # ==================== SDK Run ====================
     "core.sdk.run.init_failed": "ErisPulse initialization failed, please check the logs",
     "core.sdk.run.shutdown_signal": "Shutdown signal received, cleaning up...",
+    "core.sdk.run.unexpected_error": "Unexpected termination signal intercepted: {error}, process kept alive",
     # ==================== SDK Reload ====================
     "core.sdk.reload.starting": "[Reload] Starting SDK reload...",
     "core.sdk.reload.collected_top_modules": "[Reload] Collected external package top-level modules: {modules}",

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/Core/i18n/locales/ja.py

@@ -57,6 +57,7 @@ TRANSLATIONS = {
     # ==================== SDK 実行 ====================
     "core.sdk.run.init_failed": "ErisPulse の初期化に失敗しました、ログを確認してください",
     "core.sdk.run.shutdown_signal": "シャットダウンシグナルを受信しました、クリーンアップ中...",
+    "core.sdk.run.unexpected_error": "予期しない終了シグナルを遮断しました: {error}、プロセスは維持されます",
     # ==================== SDK リロード ====================
     "core.sdk.reload.starting": "[Reload] SDK の再読み込みを開始しています...",
     "core.sdk.reload.collected_top_modules": "[Reload] 外部パッケージのトップレベルモジュールを収集しました: {modules}",

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/Core/i18n/locales/ru.py

@@ -57,6 +57,7 @@ TRANSLATIONS = {
     # ==================== Запуск SDK ====================
     "core.sdk.run.init_failed": "Ошибка инициализации ErisPulse, проверьте журналы",
     "core.sdk.run.shutdown_signal": "Получен сигнал завершения, выполняется очистка...",
+    "core.sdk.run.unexpected_error": "Перехвачен неожиданный сигнал завершения: {error}, процесс продолжает работу",
     # ==================== Перезагрузка SDK ====================
     "core.sdk.reload.starting": "[Reload] Начинается перезагрузка SDK...",
     "core.sdk.reload.collected_top_modules": "[Reload] Собраны модули верхнего уровня внешних пакетов: {modules}",

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/Core/i18n/locales/zh_cn.py

@@ -57,6 +57,7 @@ TRANSLATIONS = {
     # ==================== SDK 运行 ====================
     "core.sdk.run.init_failed": "ErisPulse 初始化失败，请检查日志",
     "core.sdk.run.shutdown_signal": "收到关闭信号，正在清理...",
+    "core.sdk.run.unexpected_error": "拦截到意外终止信号: {error}，已阻止进程退出",
     # ==================== SDK 重载 ====================
     "core.sdk.reload.starting": "[Reload] 开始重新加载SDK...",
     "core.sdk.reload.collected_top_modules": "[Reload] 收集到外部包顶层模块: {modules}",

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/Core/i18n/locales/zh_tw.py

@@ -57,6 +57,7 @@ TRANSLATIONS = {
     # ==================== SDK 執行 ====================
     "core.sdk.run.init_failed": "ErisPulse 初始化失敗，請檢查日誌",
     "core.sdk.run.shutdown_signal": "收到關閉訊號，正在清理...",
+    "core.sdk.run.unexpected_error": "攔截到意外終止訊號: {error}，已阻止程序退出",
     # ==================== SDK 重新載入 ====================
     "core.sdk.reload.starting": "[Reload] 開始重新載入SDK...",
     "core.sdk.reload.collected_top_modules": "[Reload] 收集到外部套件頂層模組: {modules}",

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/sdk.py

@@ -898,37 +898,19 @@ class SDK:
         """
         无头模式运行 ErisPulse
 
-        监听 SIGTERM/SIGINT 信号以实现优雅关闭：
-        收到信号后触发 shutdown_event，使 finally 块中的 uninit() 正常执行，
-        确保适配器断开、模块卸载、数据落盘等清理工作完成。
+        {!--< tips >!--}
+        异常处理原则：
+        1. 模块/适配器的任何错误都会被拦截，不会导致进程退出
+        2. 只有 KeyboardInterrupt（Ctrl+C）会正常向上传播，触发优雅关闭
+        3. 其他 BaseException（如 SystemExit）会被拦截并记录，防止意外终止
+        {!--< /tips >!--}
 
         :param keep_running: bool 是否保持运行
 
         :example:
         >>> await sdk.run(keep_running=True)
         """
-        import signal
-
-        shutdown_event = asyncio.Event()
-        loop = asyncio.get_running_loop()
-        _registered_signals: list[int] = []
-
-        def _request_shutdown() -> None:
-            """信号回调：设置关闭事件，使 run() 退出等待并进入清理流程"""
-            if not shutdown_event.is_set():
-                self.logger.info(i18n.t("core.sdk.run.shutdown_signal"))
-                shutdown_event.set()
-
         try:
-            # 注册信号处理器，使 Docker SIGTERM / Ctrl+C 能触发优雅关闭
-            for sig in (signal.SIGTERM, signal.SIGINT):
-                try:
-                    loop.add_signal_handler(sig, _request_shutdown)
-                    _registered_signals.append(sig)
-                except (NotImplementedError, RuntimeError):
-                    # Windows 不支持 add_signal_handler，跳过
-                    pass
-
             isInit = await self.init()
 
             if not isInit:
@@ -936,19 +918,22 @@ class SDK:
                 return
 
             if keep_running:
+                shutdown_event = asyncio.Event()
                 await shutdown_event.wait()
         except asyncio.CancelledError:
             self.logger.info(i18n.t("core.sdk.run.shutdown_signal"))
+        except KeyboardInterrupt:
+            # Ctrl+C / SIGINT: 允许正常传播，触发优雅关闭
+            self.logger.info(i18n.t("core.sdk.run.shutdown_signal"))
+            raise
         except Exception as e:
+            # 常规异常（模块/适配器错误等），记录但不向上传播
             self.logger.error(e)
+        except BaseException as e:
+            # 其他 BaseException（SystemExit 等），拦截并记录
+            # 模块/适配器不应能终止进程
+            self.logger.error(i18n.t("core.sdk.run.unexpected_error", error=repr(e)))
         finally:
-            # 清理信号处理器，避免重复触发
-            for sig in _registered_signals:
-                try:
-                    loop.remove_signal_handler(sig)
-                except Exception:
-                    pass
-
             if keep_running:
                 try:
                     await self.uninit()

{erispulse-2.5.2.dev0 → erispulse-2.5.2.dev1}/src/ErisPulse/sdk.pyi

@@ -142,9 +142,12 @@ class SDK:
         """
         无头模式运行 ErisPulse
         
-        监听 SIGTERM/SIGINT 信号以实现优雅关闭：
-        收到信号后触发 shutdown_event，使 finally 块中的 uninit() 正常执行，
-        确保适配器断开、模块卸载、数据落盘等清理工作完成。
+        {!--< tips >!--}
+        异常处理原则：
+        1. 模块/适配器的任何错误都会被拦截，不会导致进程退出
+        2. 只有 KeyboardInterrupt（Ctrl+C）会正常向上传播，触发优雅关闭
+        3. 其他 BaseException（如 SystemExit）会被拦截并记录，防止意外终止
+        {!--< /tips >!--}
         
         :param keep_running: bool 是否保持运行
         

erispulse-2.5.2.dev0/src/ErisPulse/Core/Event/__init__.pyi

@@ -1,26 +0,0 @@
-# type: ignore
-#
-# Auto-generated type stub for __init__.py
-# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
-#
-
-"""
-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, Conversation, CONFIRM_YES_WORDS, CONFIRM_NO_WORDS, register_event_mixin, register_event_method, unregister_event_method, unregister_platform_event_methods, get_platform_event_methods, _builtin_wait_reply, _builtin_confirm, _builtin_choose, _builtin_collect
-from .message_builder import MessageBuilder
-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