ErisPulse 2.7.1.dev1__tar.gz → 2.7.1.dev2__tar.gz

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.7.1.dev1
+Version: 2.7.1.dev2
 Summary: Event-driven modular async bot framework — write once, deploy to any platform | 事件驱动的模块化异步机器人框架，一次编写，多平台部署
 Project-URL: Homepage, https://github.com/ErisPulse/ErisPulse
 Project-URL: Documentation, https://www.erisdev.com#docs

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.7.1-dev.1"
+version = "2.7.1-dev.2"
 description = "Event-driven modular async bot framework — write once, deploy to any platform | 事件驱动的模块化异步机器人框架，一次编写，多平台部署"
 readme = "README.pypi.md"
 requires-python = ">=3.10"

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/src/ErisPulse/CLI/commands/run.py

@@ -183,6 +183,7 @@ class RunCommand(Command):
         ]
 
         crash_count = 0
+        process = None
         try:
             while True:
                 process = subprocess.Popen(cmd)
@@ -208,6 +209,17 @@ class RunCommand(Command):
                 # 继续循环，重新启动子进程
         except KeyboardInterrupt:
             pass
+        finally:
+            # 运行器退出（Ctrl+C 等）前必须终止子进程，否则孤儿进程会继续持有
+            # 端口等资源，导致下次启动时端口被占用（如监听 8000 的残留进程）。
+            if process is not None and process.poll() is None:
+                console.print(f"[info]{i18n.t('cli.run.terminating_child')}[/]")
+                process.terminate()
+                try:
+                    process.wait(timeout=5)
+                except subprocess.TimeoutExpired:
+                    process.kill()
+                    process.wait()
 
     def _run_script(self, script_path: str, reload_mode: bool):
         """

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/src/ErisPulse/CLI/i18n/locales/en.py

@@ -277,6 +277,7 @@ TRANSLATIONS = {
     "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...",
+    "cli.run.terminating_child": "Terminating the bot subprocess to release ports and resources...",
     # ==================== uninstall command ====================
     "cli.uninstall.description": "Uninstall module/adapter packages",
     "cli.uninstall.package_help": "Package name(s) to uninstall (multiple allowed)",

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/src/ErisPulse/CLI/i18n/locales/ja.py

@@ -277,6 +277,7 @@ TRANSLATIONS = {
     "cli.run.process_exited": "プロセスが正常に終了しました。ファイルの変更を待機して再起動",
     "cli.run.process_crashed": "プロセスが異常終了しました（終了コード {code}）。修正して保存すると自動再起動",
     "cli.run.subprocess_crashed_retry": "サブプロセスが異常終了しました。{seconds} 秒後に自動再試行します...",
+    "cli.run.terminating_child": "ポートなどのリソースを解放するため、ボットの子プロセスを終了しています...",
     # ==================== uninstall コマンド ====================
     "cli.uninstall.description": "モジュール/アダプターパッケージをアンインストール",
     "cli.uninstall.package_help": "アンインストールするパッケージ名（複数指定可）",

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/src/ErisPulse/CLI/i18n/locales/ru.py

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

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/src/ErisPulse/CLI/i18n/locales/zh_cn.py

@@ -277,6 +277,7 @@ TRANSLATIONS = {
     "cli.run.process_exited": "进程已正常退出，等待文件变更后重启",
     "cli.run.process_crashed": "进程异常退出（退出码 {code}），修复后保存文件将自动重启",
     "cli.run.subprocess_crashed_retry": "子进程异常终止，将在 {seconds} 秒后自动重试...",
+    "cli.run.terminating_child": "正在终止机器人子进程，释放端口等资源...",
     # ==================== uninstall 命令 ====================
     "cli.uninstall.description": "卸载模块/适配器包",
     "cli.uninstall.package_help": "要卸载的包名（可指定多个）",

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/src/ErisPulse/CLI/i18n/locales/zh_tw.py

@@ -277,6 +277,7 @@ TRANSLATIONS = {
     "cli.run.process_exited": "程式已正常退出，等待檔案變更後重啟",
     "cli.run.process_crashed": "程式異常退出（退出碼 {code}），修復後儲存檔案將自動重啟",
     "cli.run.subprocess_crashed_retry": "子程序異常終止，將在 {seconds} 秒後自動重試...",
+    "cli.run.terminating_child": "正在終止機器人子程序，釋放連接埠等資源...",
     # ==================== uninstall 命令 ====================
     "cli.uninstall.description": "解除安裝模組/適配器包",
     "cli.uninstall.package_help": "要解除安裝的包名（可指定多個）",

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/src/ErisPulse/Core/constants.py

@@ -53,12 +53,6 @@ DEFAULT_SERVER_AUTO_START: Final[bool] = True
 # 修改影响: Ctrl+C 后等待 uvicorn 关闭的耐心时间。超时后强制终止。
 SERVER_SHUTDOWN_TIMEOUT_SECS: Final[float] = 5.0
 
-# 路由服务器启动时端口被占用后的自动顺延尝试次数（含起始端口）。
-# 运行时行为。启动时若端口被占用，自动依次尝试后续端口，
-# 直至找到可用端口或达到该上限。实际监听端口通过 router.base_url 暴露。
-# 修改影响: 设大允许更多顺延，设小更快放弃；设为 1 表示不顺延，占用即报错。
-DEFAULT_SERVER_PORT_RETRY_LIMIT: Final[int] = 50
-
 # ==============================================================================
 # 配置键模板
 #
@@ -772,7 +766,6 @@ __all__ = [
     "DEFAULT_SERVER_AUTO_START",
     "DEFAULT_SERVER_HOST",
     "DEFAULT_SERVER_PORT",
-    "DEFAULT_SERVER_PORT_RETRY_LIMIT",
     "DEFAULT_STRICT_MODE",
     "DEFAULT_UNINIT_TIMEOUT_SECS",
     "DEFAULT_USE_GLOBAL_DB",

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/src/ErisPulse/Core/i18n/locales/en.py

@@ -257,8 +257,6 @@ TRANSLATIONS = {
     "core.router.start_failed_msg": "Router server startup failed",
     "core.router.start_failed": "Failed to start server: {error}",
     "core.router.port_in_use": "Port {host}:{port} is already in use; the router server could not start. Check whether another ErisPulse instance or another program is using this port (run `netstat -ano` to find the process holding it)",
-    "core.router.port_advance": "Port {host}:{requested} is already in use; automatically advanced to {host}:{port}",
-    "core.router.port_range_in_use": "Port {host}:{port} and the next {count} ports are all in use; the router server could not start. Check whether multiple ErisPulse instances or other programs are occupying these ports",
     "core.router.stopping": "Stopping router server...",
     "core.router.stopped_normal": "Router server stopped normally",
     "core.router.stopped_cancelled": "Router server was cancelled",

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/src/ErisPulse/Core/i18n/locales/ja.py

@@ -257,8 +257,6 @@ TRANSLATIONS = {
     "core.router.start_failed_msg": "ルーターサーバーの起動に失敗しました",
     "core.router.start_failed": "サーバーの起動に失敗しました: {error}",
     "core.router.port_in_use": "ポート {host}:{port} は既に使用されています。ルーターサーバーを起動できません。別の ErisPulse インスタンスや他のプログラムがこのポートを使用していないか確認してください（`netstat -ano` で使用中のプロセスを確認できます）",
-    "core.router.port_advance": "ポート {host}:{requested} は既に使用されています。{host}:{port} に自動で切り替えました",
-    "core.router.port_range_in_use": "ポート {host}:{port} とその後の {count} 個のポートがすべて使用中です。ルーターサーバーを起動できません。複数の ErisPulse インスタンスや他のプログラムがこれらのポートを占有していないか確認してください",
     "core.router.stopping": "ルーターサーバーを停止しています...",
     "core.router.stopped_normal": "ルーターサーバーは正常に停止しました",
     "core.router.stopped_cancelled": "ルーターサーバーはキャンセルされました",

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/src/ErisPulse/Core/i18n/locales/ru.py

@@ -257,8 +257,6 @@ TRANSLATIONS = {
     "core.router.start_failed_msg": "Ошибка запуска сервера маршрутизации",
     "core.router.start_failed": "Ошибка запуска сервера: {error}",
     "core.router.port_in_use": "Порт {host}:{port} уже занят, сервер маршрутизации не может запуститься. Проверьте, не использует ли этот порт другой экземпляр ErisPulse или другая программа (выполните `netstat -ano`, чтобы найти процесс, удерживающий порт)",
-    "core.router.port_advance": "Порт {host}:{requested} уже занят, автоматически переключено на {host}:{port}",
-    "core.router.port_range_in_use": "Порт {host}:{port} и последующие {count} портов заняты, сервер маршрутизации не может запуститься. Проверьте, не занимают ли эти порты несколько экземпляров ErisPulse или других программ",
     "core.router.stopping": "Остановка сервера маршрутизации...",
     "core.router.stopped_normal": "Сервер маршрутизации остановлен нормально",
     "core.router.stopped_cancelled": "Работа сервера маршрутизации была отменена",

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/src/ErisPulse/Core/i18n/locales/zh_cn.py

@@ -257,8 +257,6 @@ TRANSLATIONS = {
     "core.router.start_failed_msg": "路由服务器启动失败",
     "core.router.start_failed": "启动服务器失败: {error}",
     "core.router.port_in_use": "端口 {host}:{port} 已被占用，路由服务器无法启动。请检查是否有另一个 ErisPulse 实例或其他程序正在使用该端口（可执行 `netstat -ano` 查看占用进程）",
-    "core.router.port_advance": "端口 {host}:{requested} 已被占用，已自动顺延至 {host}:{port}",
-    "core.router.port_range_in_use": "端口 {host}:{port} 及其后 {count} 个端口均已被占用，无法启动路由服务器。请检查是否有多个 ErisPulse 实例或其他程序占用了这些端口",
     "core.router.stopping": "正在停止路由服务器...",
     "core.router.stopped_normal": "路由服务器已正常停止",
     "core.router.stopped_cancelled": "路由服务器已被取消",

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/src/ErisPulse/Core/i18n/locales/zh_tw.py

@@ -257,8 +257,6 @@ TRANSLATIONS = {
     "core.router.start_failed_msg": "路由伺服器啟動失敗",
     "core.router.start_failed": "啟動伺服器失敗: {error}",
     "core.router.port_in_use": "連接埠 {host}:{port} 已被占用，路由伺服器無法啟動。請檢查是否有另一個 ErisPulse 實例或其他程式正在使用該連接埠（可執行 `netstat -ano` 查看占用程序）",
-    "core.router.port_advance": "連接埠 {host}:{requested} 已被占用，已自動順延至 {host}:{port}",
-    "core.router.port_range_in_use": "連接埠 {host}:{port} 及其後 {count} 個連接埠均已被占用，無法啟動路由伺服器。請檢查是否有多個 ErisPulse 實例或其他程式占用了這些連接埠",
     "core.router.stopping": "正在停止路由伺服器...",
     "core.router.stopped_normal": "路由伺服器已正常停止",
     "core.router.stopped_cancelled": "路由伺服器已被取消",

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/src/ErisPulse/Core/router.py

@@ -53,7 +53,6 @@ from .constants import (
     DEFAULT_SECURITY_HEADERS,
     DEFAULT_SERVER_HOST,
     DEFAULT_SERVER_PORT,
-    DEFAULT_SERVER_PORT_RETRY_LIMIT,
     DEFAULT_WS_AUTO_ACCEPT,
     FALLBACK_IPV4,
     FALLBACK_IPV6_HOST,
@@ -2601,26 +2600,23 @@ class RouterManager:
             self._get_local_ips()
             self._apply_config()
 
-            # 端口自动顺延：若端口被占用则依次尝试后续端口（类似 VNC 的 5099→5100）。
-            # uvicorn 在端口被占用时会执行 sys.exit(3)，其 SystemExit 会被事件循环
-            # 重新抛出并取消所有任务，导致进程异常退出并刷屏大量 "Task was destroyed
-            # but it is pending"。此处先同步 bind 探测并顺延，实际监听端口通过
-            # bind_port 暴露，uvicorn 启动时不会再次遇到占用错误。
-            bind_port = self._find_available_port(
-                host, port, DEFAULT_SERVER_PORT_RETRY_LIMIT
-            )
+            # 同步探测端口是否可绑定。uvicorn 在端口被占用时会执行 sys.exit(3)，
+            # 其 SystemExit 会被事件循环重新抛出并取消所有任务，导致进程异常退出并
+            # 刷屏大量 "Task was destroyed but it is pending"。此处先同步 bind 探测，
+            # 端口被占用时在启动前抛出清晰、可操作的错误，由上层按致命错误处理。
+            self._check_port_available(host, port)
 
             config = uvicorn.Config(
                 self.app,
                 host=host,
-                port=bind_port,
+                port=port,
                 log_level="warning",
                 ssl_certfile=ssl_certfile,
                 ssl_keyfile=ssl_keyfile,
             )
             self._uvicorn_server = uvicorn.Server(config)
 
-            self.base_url = f"http{'s' if ssl_certfile else ''}://{host}:{bind_port}"
+            self.base_url = f"http{'s' if ssl_certfile else ''}://{host}:{port}"
             display_url = self._format_display_url(self.base_url)
             http_count = sum(len(paths) for paths in self._http_routes.values())
             ws_count = sum(len(paths) for paths in self._websocket_routes.values())
@@ -2662,7 +2658,7 @@ class RouterManager:
                 data={
                     "base_url": self.base_url,
                     "host": host,
-                    "port": bind_port,
+                    "port": port,
                 },
             )
         except Exception as e:
@@ -2684,18 +2680,21 @@ class RouterManager:
             logger.error(i18n.t("core.router.start_failed", error=e))
             raise e
 
-    def _is_port_bindable(self, host: str, port: int) -> bool:
+    def _check_port_available(self, host: str, port: int) -> None:
         """
-        同步探测端口当前是否可绑定
+        同步探测端口是否可绑定，避免 uvicorn 异步启动失败后引发级联错误
 
         uvicorn 在端口被占用时会执行 ``sys.exit(STARTUP_FAILURE)``，其 SystemExit
         会被事件循环重新抛出并取消所有任务，导致进程异常退出并刷屏大量
-        "Task was destroyed but it is pending"。此处先同步 bind 探测端口是否空闲，
-        供启动前自动顺延使用。
+        "Task was destroyed but it is pending"。此处先同步 bind 探测端口，若被占用
+        则在启动前抛出清晰的 i18n 提示，由上层按致命错误处理（不自动顺延端口，
+        避免生产环境暴露的端口变化导致外部访问失败）。
 
         :param host: str 监听地址
         :param port: int 监听端口
-        :return: bool 端口当前可绑定返回 True，否则返回 False
+
+        :raises RuntimeError: 当端口被占用时抛出，携带友好的错误提示
+        :raises OSError: 其他绑定错误（如无权限绑定特权端口）
         """
         try:
             family = socket.AF_INET6 if ":" in host else socket.AF_INET
@@ -2704,46 +2703,12 @@ class RouterManager:
                 probe.bind((host, port))
             finally:
                 probe.close()
-            return True
-        except OSError:
-            return False
-
-    def _find_available_port(
-        self, host: str, port: int, retry_limit: int
-    ) -> int:
-        """
-        在 [port, port + retry_limit) 范围内寻找第一个可绑定的端口
-
-        端口被占用时自动顺延，实际监听端口通过
-        router.base_url 暴露给下游。若范围内全部被占用，抛出清晰的错误提示。
-
-        :param host: str 监听地址
-        :param port: int 期望端口（顺延起点）
-        :param retry_limit: int 尝试的端口个数（含起点），最小为 1
-        :return: int 实际可绑定的端口
-
-        :raises RuntimeError: 当范围内端口全部被占用时抛出
-        """
-        for candidate in range(port, port + max(1, retry_limit)):
-            if self._is_port_bindable(host, candidate):
-                if candidate != port:
-                    logger.warning(
-                        i18n.t(
-                            "core.router.port_advance",
-                            host=host,
-                            requested=port,
-                            port=candidate,
-                        )
-                    )
-                return candidate
-        raise RuntimeError(
-            i18n.t(
-                "core.router.port_range_in_use",
-                host=host,
-                port=port,
-                count=retry_limit,
-            )
-        )
+        except OSError as e:
+            if e.errno == errno.EADDRINUSE:
+                raise RuntimeError(
+                    i18n.t("core.router.port_in_use", host=host, port=port)
+                ) from e
+            raise
 
     def _start_rate_limit_cleanup(self) -> None:
         """

{erispulse-2.7.1.dev1 → erispulse-2.7.1.dev2}/src/ErisPulse/sdk.py

@@ -430,17 +430,15 @@ class SDK:
                     # 跳过 HTTP 服务器启动（适用于纯 WebSocket/轮询适配器）
                     self.logger.info(i18n.t("core.sdk.init.router_start_skipped"))
                 else:
-                    try:
-                        await self.router.start(
-                            host=_server_config["host"],
-                            port=_server_config["port"],
-                            ssl_certfile=_server_config.get("ssl_certfile"),
-                            ssl_keyfile=_server_config.get("ssl_keyfile"),
-                        )
-                    except Exception as e:
-                        self.logger.warning(
-                            i18n.t("core.sdk.init.router_start_failed", error=e)
-                        )
+                    # 路由服务器是适配器/模块对外服务的核心基础设施，绑定失败
+                    # （如端口被占用）属于致命初始化错误：不自动顺延端口（生产环境
+                    # 暴露的端口变化会导致外部访问失败），直接抛出使 init() 失败退出。
+                    await self.router.start(
+                        host=_server_config["host"],
+                        port=_server_config["port"],
+                        ssl_certfile=_server_config.get("ssl_certfile"),
+                        ssl_keyfile=_server_config.get("ssl_keyfile"),
+                    )
 
                 # 获取加载耗时
                 load_duration = self.lifecycle.stop_timer(LIFECYCLE_TIMER_CORE_INIT)