ErisPulse 2.4.6.dev2__tar.gz → 2.4.6.dev4__tar.gz

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.4.6.dev2
+Version: 2.4.6.dev4
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: ErisDev <erisdev@88.com>
 Maintainer-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/pyproject.toml

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

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/src/ErisPulse/CLI/commands/run.py

@@ -116,28 +116,50 @@ class RunCommand(Command):
         else:
             self._run_internal(reload_mode)
 
+    _RESTART_EXIT_CODE = 42
+
     def _run_internal(self, reload_mode: bool):
         """
         直接运行 SDK（不指定脚本时）
+
+        以子进程方式运行 SDK，支持硬重启：当 SDK 进程以特定退出码退出时，
+        自动重新启动新进程，确保资源完全释放。
         """
 
-        async def _run():
-            from ... import sdk
+        if reload_mode:
+            async def _run():
+                from ... import sdk
 
-            if reload_mode:
                 loop = asyncio.get_running_loop()
                 self._setup_watchdog(".", loop)
+                await sdk.run(keep_running=True)
 
-            await sdk.run(keep_running=True)
+            try:
+                asyncio.run(_run())
+            except KeyboardInterrupt:
+                pass
+            finally:
+                if hasattr(self, "_observer"):
+                    self._observer.stop()
+                    self._observer.join()
+            return
+
+        cmd = [sys.executable, "-c",
+               "import asyncio; from ErisPulse import sdk; "
+               "asyncio.run(sdk.run(keep_running=True))"]
 
         try:
-            asyncio.run(_run())
+            while True:
+                process = subprocess.Popen(cmd)
+                process.wait()
+
+                if process.returncode == self._RESTART_EXIT_CODE:
+                    console.print("[info]收到硬重启请求，正在重新启动...[/]")
+                    time.sleep(0.5)
+                    continue
+                break
         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):
         script_path_abs = os.path.abspath(script_path)

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/src/ErisPulse/CLI/commands/run.pyi

@@ -53,6 +53,9 @@ class RunCommand(Command):
     def _run_internal(self: object, reload_mode: bool) -> ...:
         """
         直接运行 SDK（不指定脚本时）
+        
+        以子进程方式运行 SDK，支持硬重启：当 SDK 进程以特定退出码退出时，
+        自动重新启动新进程，确保资源完全释放。
         """
         ...
     def _run_script(self: object, script_path: str, reload_mode: bool) -> ...:

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/src/ErisPulse/Core/Event/base.py

@@ -12,11 +12,12 @@ ErisPulse 事件处理基础模块
 from .. import adapter, logger
 from ...runtime import get_event_config
 from ...runtime.context import current_owner
-from ..constants import DEFAULT_HANDLER_PRIORITY, UNKNOWN_PLATFORM, EVENT_TYPE_MESSAGE
+from ..constants import DEFAULT_HANDLER_PRIORITY, UNKNOWN_PLATFORM, EVENT_TYPE_MESSAGE, HANDLER_SLOW_THRESHOLD_SECS
 from typing import Any
 from collections.abc import Callable
 import asyncio
 import inspect
+import time as _time
 from itertools import groupby
 from .wrapper import Event
 from ..lifecycle import lifecycle
@@ -34,11 +35,16 @@ async def _invoke_handler(handler_info: dict, event: Event) -> None:
     :param event: 事件对象
     """
     handler = handler_info["func"]
+    _hname = getattr(handler, "__qualname__", getattr(handler, "__name__", str(handler)))
     try:
+        _t = _time.monotonic()
         if inspect.iscoroutinefunction(handler):
             await handler(event)
         else:
             handler(event)
+        _elapsed = _time.monotonic() - _t
+        if _elapsed > HANDLER_SLOW_THRESHOLD_SECS:
+            logger.warning(f"[EventHandler] Slow handler {_hname} took {_elapsed:.4f}s")
     except Exception as e:
         logger.error(f"事件处理器执行错误: {e}")
 

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/src/ErisPulse/Core/Event/base.pyi

@@ -18,11 +18,12 @@ ErisPulse 事件处理基础模块
 from .. import adapter, logger
 from ...runtime import get_event_config
 from ...runtime.context import current_owner
-from ..constants import DEFAULT_HANDLER_PRIORITY, UNKNOWN_PLATFORM, EVENT_TYPE_MESSAGE
+from ..constants import DEFAULT_HANDLER_PRIORITY, UNKNOWN_PLATFORM, EVENT_TYPE_MESSAGE, HANDLER_SLOW_THRESHOLD_SECS
 from typing import Any
 from collections.abc import Callable
 import asyncio
 import inspect
+import time as _time
 from itertools import groupby
 from .wrapper import Event
 from ..lifecycle import lifecycle

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/src/ErisPulse/Core/Event/command.py

@@ -286,6 +286,7 @@ class CommandHandler:
             # 清理超时的等待
             if wait_key in self._waiting_replies:
                 del self._waiting_replies[wait_key]
+            logger.debug(f"wait_reply 超时: key={wait_key}, timeout={timeout}s")
             return None
         except Exception as e:
             # 清理异常情况

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/src/ErisPulse/Core/adapter.py

@@ -23,6 +23,7 @@ from .constants import (
     CONFIG_KEY_ADAPTER_STATUS,
     CONFIG_KEY_ADAPTER_STATUS_OF,
     DEFAULT_ADAPTER_ENABLED,
+    HANDLER_SLOW_THRESHOLD_SECS,
 )
 
 
@@ -134,24 +135,32 @@ class AdapterManager(ManagerBase):
         if existing_instance is not None:
             self._adapters[platform] = existing_instance
         else:
-            # 创建适配器实例
-            # 检查适配器类 __init__ 方法的参数
-            init_signature = inspect.signature(adapter_class.__init__)
-            params = [p for p in init_signature.parameters.values() if p.name != "self"]
-
-            sdk_to_use = self._sdk
-            if sdk_to_use is None:
-                from .. import sdk
-
-                sdk_to_use = sdk
-
-            # 根据参数情况创建实例
-            if params:
-                instance = adapter_class(sdk_to_use)
-            else:
-                instance = adapter_class()
-
-            self._adapters[platform] = instance
+            try:
+                # 创建适配器实例
+                # 检查适配器类 __init__ 方法的参数
+                init_signature = inspect.signature(adapter_class.__init__)
+                params = [p for p in init_signature.parameters.values() if p.name != "self"]
+
+                sdk_to_use = self._sdk
+                if sdk_to_use is None:
+                    from .. import sdk
+
+                    sdk_to_use = sdk
+            
+                # 根据参数情况创建实例
+                if params:
+                    instance = adapter_class(sdk_to_use)
+                else:
+                    instance = adapter_class()
+
+                self._adapters[platform] = instance
+            except SystemExit as e:
+                logger.error(f"适配器 {platform} 尝试退出进程 (SystemExit({e.code}))，已跳过。"
+                             f"请不要在适配器中使用 sys.exit() 或 raise SystemExit")
+                return False
+            except Exception as e:
+                logger.error(f"创建适配器实例 {platform} 失败: {e}")
+                return False
 
         return True
 
@@ -685,6 +694,9 @@ class AdapterManager(ManagerBase):
         """
         提交OneBot12协议事件到指定平台
 
+        每个事件处理器（handler）都在独立的 asyncio.Task 中执行，
+        单个处理器阻塞不会影响框架的事件分发和其他处理器运行。
+
         :param data: 符合OneBot12标准的事件数据
 
         :example:
@@ -766,7 +778,7 @@ class AdapterManager(ManagerBase):
                         },
                     )
 
-        # 先执行OneBot12中间件
+        # 先执行OneBot12中间件（中间件可以修改数据，必须顺序执行）
         processed_data = data
         for middleware in self._onebot_middlewares:
             result = await middleware(processed_data)
@@ -777,7 +789,7 @@ class AdapterManager(ManagerBase):
                     f"中间件 {middleware.__qualname__} 返回 None，已忽略并保留原数据"
                 )
 
-        # 分发到OneBot12事件处理器
+        # 分发到OneBot12事件处理器（每个 handler 在独立 Task 中执行，不阻塞框架）
         handlers_to_call = []
 
         # 处理特定事件类型的处理器
@@ -787,12 +799,14 @@ class AdapterManager(ManagerBase):
         # 处理通配符处理器
         handlers_to_call.extend(self._onebot_handlers.get("*", []))
 
-        # 调用符合条件的标准事件处理器
+        # 将符合条件的处理器分发到独立 Task
         for handler_wrapper in handlers_to_call:
             handler_platform = handler_wrapper.get("platform")
-            # 如果处理器没有指定平台，或者指定的平台与当前事件平台匹配
             if handler_platform is None or handler_platform == platform:
-                await handler_wrapper["func"](processed_data)
+                self._dispatch_handler_task(
+                    handler_wrapper["func"], processed_data,
+                    event_type=event_type, platform=platform,
+                )
 
         # 只有当存在原生事件数据时才分发原生事件
         if raw_event_type and (platform_raw := data.get(f"{platform}_raw")) is not None:
@@ -805,12 +819,14 @@ class AdapterManager(ManagerBase):
             # 处理原生事件的通配符处理器
             raw_handlers_to_call.extend(self._raw_handlers.get("*", []))
 
-            # 调用符合条件的原生事件处理器
+            # 将符合条件的原生事件处理器分发到独立 Task
             for handler_wrapper in raw_handlers_to_call:
                 handler_platform = handler_wrapper.get("platform")
-                # 如果处理器没有指定平台，或者指定的平台与当前事件平台匹配
                 if handler_platform is None or handler_platform == platform:
-                    await handler_wrapper["func"](platform_raw)
+                    self._dispatch_handler_task(
+                        handler_wrapper["func"], platform_raw,
+                        event_type=raw_event_type, platform=platform,
+                    )
 
         # 钩子: 事件分发完成
         await lifecycle.emit("adapter.event.dispatched", {
@@ -820,6 +836,56 @@ class AdapterManager(ManagerBase):
             "onebot_handlers_count": len(handlers_to_call),
         })
 
+    def _dispatch_handler_task(
+        self,
+        func: Callable,
+        data: Any,
+        *,
+        event_type: str = "unknown",
+        platform: str = "unknown",
+    ) -> asyncio.Task:
+        """
+        {!--< internal-use >!--}
+        将事件处理器包装为独立 asyncio.Task 并调度执行
+
+        处理器在独立 Task 中运行，不会阻塞 adapter.emit() 的后续流程。
+        自动捕获处理器异常并记录日志，同时监控处理器执行耗时。
+
+        :param func: 事件处理器函数
+        :param data: 事件数据
+        :param event_type: 事件类型（用于日志）
+        :param platform: 平台名称（用于日志）
+        :return: asyncio.Task
+        """
+        import time as _time
+
+        _func_name = getattr(func, "__qualname__", getattr(func, "__name__", str(func)))
+
+        async def _safe_run():
+            t0 = _time.monotonic()
+            try:
+                await func(data)
+            except asyncio.CancelledError:
+                pass
+            except Exception as e:
+                logger.error(
+                    f"事件处理器执行错误 [{_func_name}] "
+                    f"type={event_type} platform={platform}: {e}"
+                )
+            finally:
+                elapsed = _time.monotonic() - t0
+                if elapsed > HANDLER_SLOW_THRESHOLD_SECS:
+                    logger.warning(
+                        f"事件处理器执行缓慢 [{_func_name}] "
+                        f"耗时 {elapsed:.2f}s > {HANDLER_SLOW_THRESHOLD_SECS}s "
+                        f"type={event_type} platform={platform}"
+                    )
+
+        try:
+            return asyncio.create_task(_safe_run())
+        except RuntimeError:
+            return asyncio.ensure_future(_safe_run())
+
     # ==================== Bot状态管理 ====================
 
     def _auto_register_bot(self, platform: str, self_info: dict) -> bool:

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/src/ErisPulse/Core/adapter.pyi

@@ -23,7 +23,7 @@ from .Bases.adapter import BaseAdapter
 from .config import config
 from .lifecycle import lifecycle
 from .Bases.manager import ManagerBase
-from .constants import ADAPTER_RETRY_BACKOFF_INTERVALS, ADAPTER_RETRY_FIXED_DELAY_SECS, CONFIG_KEY_ADAPTER_STATUS, CONFIG_KEY_ADAPTER_STATUS_OF, DEFAULT_ADAPTER_ENABLED
+from .constants import ADAPTER_RETRY_BACKOFF_INTERVALS, ADAPTER_RETRY_FIXED_DELAY_SECS, CONFIG_KEY_ADAPTER_STATUS, CONFIG_KEY_ADAPTER_STATUS_OF, DEFAULT_ADAPTER_ENABLED, HANDLER_SLOW_THRESHOLD_SECS
 
 class AdapterManager(ManagerBase):
     """
@@ -218,6 +218,9 @@ class AdapterManager(ManagerBase):
         """
         提交OneBot12协议事件到指定平台
         
+        每个事件处理器（handler）都在独立的 asyncio.Task 中执行，
+        单个处理器阻塞不会影响框架的事件分发和其他处理器运行。
+        
         :param data: 符合OneBot12标准的事件数据
         
         :example:

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/src/ErisPulse/Core/constants.py

@@ -308,6 +308,11 @@ DEFAULT_WAIT_TIMEOUT_SECS = 60.0
 # 修改影响: 验证器拒绝回复后的重试次数。
 DEFAULT_MAX_RETRIES = 3
 
+# 事件处理器执行耗时警告阈值（秒）。
+# 使用位置: Core/adapter.py -> emit() 中的 handler 执行监控。
+# 修改影响: 当单个处理器执行超过此时间时记录 WARNING 日志。
+HANDLER_SLOW_THRESHOLD_SECS = 1.0
+
 # 平台标识的回退值。
 # 当事件数据缺少 platform 字段时使用。
 # 修改影响: 日志和事件处理中的平台标识显示。

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/src/ErisPulse/Core/lifecycle.py

@@ -13,7 +13,7 @@ ErisPulse 生命周期管理模块
 
 import asyncio
 import inspect
-from .constants import DEFAULT_EVENT_SOURCE
+from .constants import DEFAULT_EVENT_SOURCE, HANDLER_SLOW_THRESHOLD_SECS
 import time
 from typing import Any
 from collections.abc import Callable
@@ -307,12 +307,18 @@ class LifecycleManager:
         :param data: Any 事件数据
         :return: Any 处理后的数据
         """
-        for _, handler in self._hooks[hook_name]:
+        import time as _time
+        for priority, handler in self._hooks[hook_name]:
             try:
+                _t = _time.monotonic()
+                _hname = getattr(handler, "__qualname__", getattr(handler, "__name__", str(handler)))
                 if inspect.iscoroutinefunction(handler):
                     result = await handler(data)
                 else:
                     result = handler(data)
+                _elapsed = _time.monotonic() - _t
+                if _elapsed > HANDLER_SLOW_THRESHOLD_SECS:
+                    _get_logger().warning(f"[Lifecycle] Slow handler {_hname} for event '{event}' took {_elapsed:.4f}s")
                 if result is not None:
                     data = result
             except Exception as e:

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/src/ErisPulse/Core/lifecycle.pyi

@@ -19,7 +19,7 @@ ErisPulse 生命周期管理模块
 
 import asyncio
 import inspect
-from .constants import DEFAULT_EVENT_SOURCE
+from .constants import DEFAULT_EVENT_SOURCE, HANDLER_SLOW_THRESHOLD_SECS
 import time
 from typing import Any
 from collections.abc import Callable

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/src/ErisPulse/Core/module.py

@@ -203,6 +203,18 @@ class ModuleManager(ManagerBase):
             logger.info(f"模块 {module_name} 加载成功")
             return True
 
+        except SystemExit as e:
+            await lifecycle.submit_event(
+                "module.load",
+                data={
+                    "module_name": module_name,
+                    "success": False,
+                },
+                msg=f"模块 {module_name} 尝试退出进程 (SystemExit)",
+            )
+            logger.error(f"模块 {module_name} 尝试退出进程 (SystemExit({e.code}))，已跳过该模块。"
+                         f"请不要在模块中使用 sys.exit() 或 raise SystemExit，请改用 raise RuntimeError 或返回错误")
+            return False
         except Exception as e:
             await lifecycle.submit_event(
                 "module.load",

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/src/ErisPulse/loaders/adapter.py

@@ -91,8 +91,10 @@ class AdapterLoader(BaseLoader):
 
             logger.print_section_separator()
 
-        except Exception as e:
+        except BaseException as e:
             logger.error(f"加载 {group_name} entry-points 失败: {e}")
+            if isinstance(e, SystemExit):
+                logger.warning(f"拦截到 SystemExit，已阻止进程退出，跳过后续适配器加载")
 
         return objs, enabled_list, disabled_list
 
@@ -172,6 +174,9 @@ class AdapterLoader(BaseLoader):
             objs[meta_name] = adapter_obj
             enabled_list.append(meta_name)
 
+        except SystemExit as e:
+            logger.error(f"加载适配器 {meta_name} 时触发 SystemExit({e.code})，已跳过。"
+                         f"请不要在适配器中使用 sys.exit() 或 raise SystemExit")
         except Exception as e:
             logger.error(f"加载适配器 {meta_name} 失败，已跳过: {e}")
 
@@ -224,6 +229,15 @@ class AdapterLoader(BaseLoader):
                                 data={"platform": platform, "success": True},
                             )
                     return success
+                except SystemExit as e:
+                    logger.error(f"适配器 {name} 注册时尝试退出进程 (SystemExit({e.code}))，已跳过。"
+                                 f"请不要使用 sys.exit() 或 raise SystemExit")
+                    await lifecycle.submit_event(
+                        "adapter.load",
+                        msg=f"适配器 {name} 注册时触发 SystemExit",
+                        data={"platform": name, "success": False},
+                    )
+                    return False
                 except Exception as e:
                     logger.error(f"适配器 {name} 注册失败: {e}")
                     # 提交适配器加载失败事件
@@ -243,7 +257,7 @@ class AdapterLoader(BaseLoader):
         failed_adapters = []
         for i, result in enumerate(register_results):
             adapter_name = adapters[i]
-            if isinstance(result, Exception) or result is False:
+            if isinstance(result, BaseException) or result is False:
                 logger.warning(f"适配器 {adapter_name} 注册失败，已跳过")
                 failed_adapters.append(adapter_name)
 

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/src/ErisPulse/loaders/module.py

@@ -93,6 +93,9 @@ class ModuleLoader(BaseLoader):
 
             logger.print_section_separator()
 
+        except SystemExit as e:
+            logger.error(f"加载 {group_name} 时触发 SystemExit({e.code})，已阻止进程退出。"
+                         f"请不要使用 sys.exit() 或 raise SystemExit")
         except Exception as e:
             logger.error(f"加载 {group_name} entry-points 失败: {e}")
 
@@ -191,6 +194,9 @@ class ModuleLoader(BaseLoader):
             objs[meta_name] = module_obj
             enabled_list.append(meta_name)
 
+        except SystemExit as e:
+            logger.error(f"加载模块 {meta_name} 时尝试退出进程 (SystemExit({e.code}))，已跳过。"
+                         f"请不要使用 sys.exit() 或 raise SystemExit")
         except Exception as e:
             logger.error(f"从 entry-point 加载模块 {meta_name} 失败，已跳过: {e}")
 
@@ -355,6 +361,10 @@ class ModuleLoader(BaseLoader):
                         manager_instance.register(name, module_class, obj.moduleInfo)
                         return True
                     return False
+                except SystemExit as e:
+                    logger.error(f"注册模块 {name} 时尝试退出进程 (SystemExit({e.code}))，已跳过。"
+                                 f"请不要使用 sys.exit() 或 raise SystemExit")
+                    return False
                 except Exception as e:
                     logger.error(f"注册模块 {name} 失败: {e}")
                     return False
@@ -368,7 +378,7 @@ class ModuleLoader(BaseLoader):
         failed_modules = []
         for i, result in enumerate(register_results):
             module_name = modules[i]
-            if isinstance(result, Exception) or result is False:
+            if isinstance(result, BaseException) or result is False:
                 logger.warning(f"模块 {module_name} 注册失败，已跳过")
                 failed_modules.append(module_name)
 
@@ -527,6 +537,9 @@ class ModuleLoader(BaseLoader):
                         logger.debug(f"挂载立即加载模块到 sdk: {meta_name}")
                     else:
                         logger.warning(f"立即加载模块 {meta_name} 失败，已跳过")
+            except SystemExit as e:
+                logger.warning(f"初始化模块 {meta_name} 时尝试退出进程 (SystemExit({e.code}))，已跳过。"
+                               f"请不要使用 sys.exit() 或 raise SystemExit")
             except Exception as e:
                 logger.warning(f"初始化模块 {meta_name} 失败，已跳过: {e}")
 
@@ -655,6 +668,17 @@ class LazyModule:
                 f"懒加载模块 {object.__getattribute__(self, '_module_name')} 初始化完成"
             )
 
+        except SystemExit as e:
+            module_name = object.__getattribute__(self, "_module_name")
+            await lifecycle.submit_event(
+                "module.init",
+                msg=f"模块 {module_name} 尝试退出进程 (SystemExit)",
+                data={"module_name": module_name, "success": False},
+            )
+            logger.error(f"懒加载模块 {module_name} 尝试退出进程 (SystemExit({e.code}))，已跳过。"
+                         f"请不要使用 sys.exit() 或 raise SystemExit")
+            object.__setattr__(self, "_initialized", False)
+            object.__setattr__(self, "_init_failed", True)
         except Exception as e:
             await lifecycle.submit_event(
                 "module.init",
@@ -730,6 +754,9 @@ class LazyModule:
             new_loop = asyncio.new_event_loop()
             try:
                 new_loop.run_until_complete(self._initialize())
+            except SystemExit as e:
+                init_error[0] = e
+                object.__setattr__(self, "_init_failed", True)
             except Exception as e:
                 init_error[0] = e
                 object.__setattr__(self, "_init_failed", True)
@@ -784,6 +811,13 @@ class LazyModule:
                 f"懒加载模块 {object.__getattribute__(self, '_module_name')} 同步初始化完成"
             )
 
+        except SystemExit as e:
+            logger.error(
+                f"懒加载模块 {object.__getattribute__(self, '_module_name')} 尝试退出进程 "
+                f"(SystemExit({e.code}))，已跳过。请不要使用 sys.exit() 或 raise SystemExit"
+            )
+            object.__setattr__(self, "_initialized", False)
+            object.__setattr__(self, "_init_failed", True)
         except Exception as e:
             logger.error(
                 f"懒加载模块 {object.__getattribute__(self, '_module_name')} 同步初始化失败: {e}"

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/src/ErisPulse/sdk.py

@@ -15,6 +15,7 @@ from __future__ import annotations
 
 import asyncio
 import importlib
+import os
 import sys
 from typing import TYPE_CHECKING
 from .Core.constants import UNINIT_SETTLE_DELAY_SECS, LIFECYCLE_TIMER_CORE_INIT, LIFECYCLE_TIMER_CORE_UNINIT
@@ -971,6 +972,39 @@ class SDK:
 
         return True
 
+    RESTART_EXIT_CODE = 42
+
+    async def hard_restart(self) -> bool:
+        """
+        硬重启：反初始化后退出进程，由父进程（run.py）重新启动新实例
+
+        与 restart()（热重启）的区别：
+        - restart(): 在同一进程内反初始化再重新初始化
+        - hard_restart(): 反初始化后退出进程，由父进程重新启动全新进程
+
+        确保资源完全释放
+
+        需要通过 epsdk run 启动才生效，否则进程退出后不会自动重启。
+
+        :return: bool 硬重启任务是否成功调度
+
+        :example:
+        >>> await sdk.hard_restart()
+        """
+
+        async def _do_hard_restart():
+            await asyncio.sleep(0.5)
+            try:
+                self.logger.info("[HardRestart] 开始硬重启，执行反初始化...")
+                await self.uninit()
+                self.logger.info("[HardRestart] 反初始化完成，正在退出进程...")
+            except Exception as e:
+                self.logger.error(f"[HardRestart] 反初始化异常: {e}")
+            os._exit(self.RESTART_EXIT_CODE)
+
+        asyncio.ensure_future(_do_hard_restart())
+        return True
+
     async def uninit(self) -> bool:
         """
         SDK 反初始化

{erispulse-2.4.6.dev2 → erispulse-2.4.6.dev4}/src/ErisPulse/sdk.pyi

@@ -20,6 +20,7 @@ example:
 from __future__ import annotations
 import asyncio
 import importlib
+import os
 import sys
 from typing import TYPE_CHECKING
 from .Core.constants import UNINIT_SETTLE_DELAY_SECS, LIFECYCLE_TIMER_CORE_INIT, LIFECYCLE_TIMER_CORE_UNINIT
@@ -170,6 +171,24 @@ class SDK:
         >>> await sdk.restart()
         """
         ...
+    async def hard_restart(self: object) -> bool:
+        """
+        硬重启：反初始化后退出进程，由父进程（run.py）重新启动新实例
+        
+        与 restart()（热重启）的区别：
+        - restart(): 在同一进程内反初始化再重新初始化
+        - hard_restart(): 反初始化后退出进程，由父进程重新启动全新进程
+        
+        确保资源完全释放
+        
+        需要通过 epsdk run 启动才生效，否则进程退出后不会自动重启。
+        
+        :return: bool 硬重启任务是否成功调度
+        
+        :example:
+        >>> await sdk.hard_restart()
+        """
+        ...
     async def uninit(self: object) -> bool:
         """
         SDK 反初始化