ErisPulse 2.8.6__tar.gz → 2.9.0.dev2__tar.gz

{erispulse-2.8.6 → erispulse-2.9.0.dev2}/.gitignore

@@ -5,7 +5,6 @@ plugins/
 venvs
 config.full.example
 config.toml
-uv.lock
 snapshots/
 logs/
 config.db*
@@ -123,7 +122,7 @@ ipython_config.py
 #   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
 #   This is especially recommended for binary packages to ensure reproducibility, and is more
 #   commonly ignored for libraries.
-#uv.lock
+uv.lock
 
 # poetry
 #   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
@@ -239,3 +238,9 @@ pyvenv.cfg
 
 # 但保留源中文文档
 !docs/zh-CN/
+
+.zcode/
+
+.github/assets/ErisPulseFilm1.mp4
+.github/assets/score1.wav
+.github/assets/score2.wav

{erispulse-2.8.6 → erispulse-2.9.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ErisPulse
-Version: 2.8.6
+Version: 2.9.0-dev.2
 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
@@ -24,6 +24,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
@@ -33,18 +34,19 @@ Requires-Dist: aiosqlite>=0.20.0
 Requires-Dist: fastapi>=0.116.1
 Requires-Dist: rich>=13.0.0
 Requires-Dist: tomlkit>=0.15.1
-Requires-Dist: uvicorn>=0.30.0
+Requires-Dist: uvicorn>=0.35.0
 Requires-Dist: websockets>=12.0
 Provides-Extra: mysql
 Requires-Dist: aiomysql>=0.2.0; extra == 'mysql'
+Requires-Dist: cryptography>=41.0.0; extra == 'mysql'
 Provides-Extra: postgres
 Requires-Dist: asyncpg>=0.29.0; extra == 'postgres'
 Provides-Extra: test
 Requires-Dist: httpx>=0.24.0; extra == 'test'
 Requires-Dist: pytest-asyncio>=0.21.0; extra == 'test'
-Requires-Dist: pytest-benchmark>=4.0.0; extra == 'test'
 Requires-Dist: pytest-cov>=4.0.0; extra == 'test'
 Requires-Dist: pytest-mock>=3.10.0; extra == 'test'
+Requires-Dist: pytest-timeout>=2.1.0; extra == 'test'
 Requires-Dist: pytest-xdist>=3.0.0; extra == 'test'
 Requires-Dist: pytest>=7.0.0; extra == 'test'
 Description-Content-Type: text/markdown

{erispulse-2.8.6 → erispulse-2.9.0.dev2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.8.6"
+version = "2.9.0-dev.2"
 description = "Event-driven modular async bot framework — write once, deploy to any platform | 事件驱动的模块化异步机器人框架，一次编写，多平台部署"
 readme = "README.pypi.md"
 requires-python = ">=3.10"
@@ -51,6 +51,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Programming Language :: Python :: 3 :: Only",
     "Operating System :: OS Independent",
     "Topic :: Software Development :: Libraries :: Python Modules",
@@ -66,7 +67,7 @@ dependencies = [
     "websockets>=12.0",
     "aiohttp>=3.9.0",
     "fastapi>=0.116.1",
-    "uvicorn>=0.30.0",
+    "uvicorn>=0.35.0",
     # storage 相关（默认 SQLite 后端异步驱动，开箱即用）
     "aiosqlite>=0.20.0",
 ]
@@ -83,6 +84,8 @@ Changelog = "https://github.com/ErisPulse/ErisPulse/blob/main/CHANGELOG.md"
 # 存储后端可选驱动：pip install ErisPulse[mysql] / ErisPulse[postgres]
 mysql = [
     "aiomysql>=0.2.0",
+    # MySQL 8 默认 caching_sha2_password 认证要求（缺失时连接池初始化失败）
+    "cryptography>=41.0.0",
 ]
 postgres = [
     "asyncpg>=0.29.0",
@@ -92,12 +95,14 @@ test = [
     "pytest-cov>=4.0.0",
     "pytest-asyncio>=0.21.0",
     "pytest-xdist>=3.0.0",
+    "pytest-timeout>=2.1.0",
     "pytest-mock>=3.10.0",
-    "pytest-benchmark>=4.0.0",
     "httpx>=0.24.0",
 ]
 
 [dependency-groups]
+# 测试依赖统一维护于 [project.optional-dependencies].test（公开 extras，
+# 生态可 pip install ErisPulse[test]）；此处的 test 组已删除以免双处漂移。
 dev = [
     "pyclean>=3.6.0",
     "ruff>=0.1.7",
@@ -105,6 +110,9 @@ dev = [
     "typing_extensions>=4.7.0; python_version < '3.11'",
 ]
 
+[tool.uv]
+default-groups = ["dev"]
+
 [project.scripts]
 ep-init = "ErisPulse.__init__:init_sync"
 epsdk = "ErisPulse.__main__:main"
@@ -130,7 +138,7 @@ include = [
 target-version = "py310"
 line-length = 120
 
-include = ["src/**/*.py", "tests/**/*.py"]
+include = ["src/**/*.py", "tests/**/*.py", "scripts/**/*.py", "examples/**/*.py"]
 
 extend-exclude = [
     "__pycache__",
@@ -168,6 +176,7 @@ ignore = [
     "RUF003",  # ambiguous-unicode-character-comment
 
     # 框架/异步代码风格性规则（强行修会破坏 API 或语义）
+    "B008",     # function-call-in-default-argument —— 依赖注入（Depends）声明的标准形态，DI 框架惯例豁免
     "PLC0415",  # import-outside-top-level —— 异步框架中 lazy import 是常用且必要的模式
     "PLR0911",  # too-many-return-statements
     "PLR0912",  # too-many-branches
@@ -208,6 +217,13 @@ ignore = [
 
 [tool.ruff.lint.per-file-ignores]
 "__init__.py" = ["F401", "PLC0415", "I001"]  # 导出式 __init__ 经常按需导入
+# 旧版生成/翻译脚本：存量风格债渐进收编（新脚本 check_i18n_locales/check_docs_links/
+# release_check/_common 已全净）。TODO: 逐步修复后移除本段。
+"scripts/tools/translate-docs.py" = ["PERF401", "PTH", "UP035", "B", "RET505", "FURB", "RUF013", "UP008", "A001", "SIM"]
+"scripts/tools/check-translation.py" = ["PERF401", "PTH", "UP035", "B", "RET505", "FURB", "RUF013", "SIM"]
+"scripts/tools/generate-api-docs.py" = ["PERF401", "PTH", "UP035", "B", "RET505", "FURB", "RUF013", "A001", "SIM", "W29", "E501"]
+"scripts/tools/generate-docs-index.py" = ["PERF401", "PTH", "UP035", "B", "RET505", "FURB", "RUF013", "RUF015", "SIM"]
+"scripts/tools/generate-type-stubs.py" = ["PERF401", "PTH", "UP035", "B", "RET505", "FURB", "RUF013", "ANN", "A001", "PLW0603", "SIM", "W29"]
 "tests/**/*.py" = [
     # 断言/夹具相关（测试代码天然模式）
     "S101", "PLR2004", "SLF001", "ARG", "ANN", "PTH",
@@ -282,6 +298,8 @@ python_classes = "Test*"
 python_functions = "test_*"
 minversion = "7.0"
 addopts = [
+        "--timeout=120",
+        "--timeout-method=thread",
     "-v",
     "--strict-markers",
     "--strict-config",

{erispulse-2.8.6 → erispulse-2.9.0.dev2}/src/ErisPulse/CLI/cli.py

@@ -305,6 +305,11 @@ class CLI:
         args, unknown = self.parser.parse_known_args()
         args._unknown_args = unknown
 
+        # --yes/-y：assume-yes 模式，由统一交互封装（utils/interactive）消费
+        from .utils.interactive import set_assume_yes
+
+        set_assume_yes(bool(getattr(args, "yes", False)))
+
         # --no-color：禁用 Rich 控制台着色（CI / 日志采集场景）
         if getattr(args, "no_color", False):
             console.no_color = True
@@ -375,6 +380,13 @@ class CLI:
             console.print(f"\n[warning]{i18n.t('cli.run.user_interrupted')}[/]")
             sys.exit(1)
         except Exception as e:
+            from .utils.interactive import NonInteractiveError
+
+            if isinstance(e, NonInteractiveError):
+                # 非交互环境遇到无法自动应答的提示：明确报错而非 EOF 崩溃
+                console.print(f"[error]{e}[/]")
+                console.print(f"[hint]{i18n.t('cli.interactive.non_tty_hint')}[/]")
+                sys.exit(1)
             console.print(f"[error]{i18n.t('cli.run.exec_error', error=e)}[/]")
             # 场景化友好提示：根据异常类型给出下一步建议
             from .hints import suggest_for_exception

{erispulse-2.8.6 → erispulse-2.9.0.dev2}/src/ErisPulse/CLI/commands/create.py

@@ -219,6 +219,8 @@ class Main(BaseModule):
         # 跨命令的用户黑白名单用覆写系统 ACL
         # （ErisPulse.event.overrides.acl 或 overrides.acl.set(name, allow/deny)，命令名支持 glob）；
         # 模块级可用性 / 事件准入 / 出站限制由作用域 scope 管理（用户可控）
+        # 命令支持声明式参数与选项（args= / options=）：框架自动解析并按名注入处理器参数，
+        # 用户输入错误自动回复本地化提示与用法（类型：str/int/float/bool/literal/duration/rest）
         @command(\"hello\", help=i18n.t(\"module.{name}.command.hello.help\"))
         async def hello_command(event: Event):
             await event.reply(i18n.t(\"module.{name}.command.hello.reply\"))

{erispulse-2.8.6 → erispulse-2.9.0.dev2}/src/ErisPulse/CLI/commands/doctor.py

@@ -95,7 +95,7 @@ class DoctorCommand(Command):
             pip_note = (
                 i18n.t("cli.doctor.venv_pip_ok")
                 if venv_pip.exists()
-                else "uv（pip 不可用，uv 后端替代）"
+                else i18n.t("cli.doctor.venv_pip_uv")
             )
             rows.append(
                 (
@@ -133,6 +133,52 @@ class DoctorCommand(Command):
             )
             failed = True
 
+        # 4.5 组件配置健康（配置文件存在 ≠ 必填项齐全：复用配置向导的
+        # schema 状态检测，"装好了跑不起来"多因适配器必填项缺失）
+        try:
+            from ..utils.config_wizard import (
+                STATUS_INCOMPLETE,
+                get_target_status,
+                load_config_targets,
+            )
+
+            incomplete: list[str] = []
+            for target in load_config_targets():
+                status, _errors = get_target_status(target)
+                # 仅"待完善"（开了但必填项缺失）判 FAIL；完全未配置属
+                # 用户尚未开始配置，不算故障
+                if status == STATUS_INCOMPLETE:
+                    incomplete.append(target.name)
+            if incomplete:
+                failed = True
+                rows.append(
+                    (
+                        self._status(False),
+                        i18n.t("cli.doctor.component_config"),
+                        i18n.t(
+                            "cli.doctor.component_config_incomplete",
+                            names=", ".join(incomplete),
+                        ),
+                    )
+                )
+            else:
+                rows.append(
+                    (
+                        self._status(True),
+                        i18n.t("cli.doctor.component_config"),
+                        i18n.t("cli.doctor.component_config_ok"),
+                    )
+                )
+        except Exception:
+            # 发现失败（如依赖缺失）不阻塞其余诊断项
+            rows.append(
+                (
+                    self._status(True),
+                    i18n.t("cli.doctor.component_config"),
+                    i18n.t("cli.doctor.component_config_skipped"),
+                )
+            )
+
         # 5. PyPI 连通性
         try:
             remote = asyncio.run(pm.get_remote_packages())

{erispulse-2.8.6 → erispulse-2.9.0.dev2}/src/ErisPulse/CLI/commands/init.py

@@ -11,7 +11,6 @@ import sys
 from argparse import ArgumentParser
 from pathlib import Path
 
-from rich.prompt import Confirm, IntPrompt
 from rich.text import Text
 
 from ..base import Command
@@ -19,6 +18,7 @@ from ..console import console
 from ..i18n import i18n
 from ..utils import PackageManager
 from ..utils.display import _input, prompt_validated, section_header
+from ..utils.interactive import confirm, select
 from ..utils.package_manager import (
     append_pyproject_dependencies,
     create_project_venv,
@@ -432,7 +432,11 @@ class InitCommand(Command):
                     f"    [bold]2.[/] {i18n.t('cli.init.location_option_new')}     [dim]— {i18n.t('cli.init.location_desc_new')}[/]"
                 )
                 console.print()
-                location_choice = IntPrompt.ask(i18n.t("cli.create.select_prompt"), default=2, choices=["1", "2"])
+                location_choice = int(
+                    select(
+                        i18n.t("cli.create.select_prompt"), choices=["1", "2"], default="2"
+                    )
+                )
                 console.print()
                 in_current_dir = location_choice == 1
 
@@ -458,7 +462,7 @@ class InitCommand(Command):
                 project_name = p.name
                 project_path = (Path(target_dir) if target_dir else Path()) / project_name
                 if project_path.exists() and not force:
-                    if not Confirm.ask(
+                    if not confirm(
                         f"  [cyan]{i18n.t('cli.init.dir_overwrite_prompt', name=project_name)}[/]",
                         default=False,
                     ):
@@ -467,10 +471,10 @@ class InitCommand(Command):
 
             # 虚拟环境与 git 仓库问询
             if not getattr(self, "no_venv", False):
-                create_venv = Confirm.ask(
+                create_venv = confirm(
                     f"  [cyan]{i18n.t('cli.init.venv_prompt')}[/]", default=True
                 )
-            git_init = Confirm.ask(
+            git_init = confirm(
                 f"  [cyan]{i18n.t('cli.init.git_prompt')}[/]", default=False
             )
 
@@ -521,7 +525,7 @@ class InitCommand(Command):
                     console.print(f"[warning]  {i18n.t('cli.init.invalid_port', port=new_port)}[/]")
                     new_port = _input(">")
 
-            if Confirm.ask(
+            if confirm(
                 f"\n  [cyan]{i18n.t('cli.init.configure_adapters_prompt')}[/]",
                 default=True,
             ):
@@ -587,7 +591,7 @@ class InitCommand(Command):
 
         console.print(f"[dim]  {i18n.t('cli.init.adapters_enabled', count=len(enabled))}[/]")
 
-        if enabled and Confirm.ask(f"  [cyan]{i18n.t('cli.init.install_selected_prompt')}[/]", default=True):
+        if enabled and confirm(f"  [cyan]{i18n.t('cli.init.install_selected_prompt')}[/]", default=True):
             self._install_adapters(enabled, adapters)
 
     def _install_adapters(self, adapter_names, adapters_info):

{erispulse-2.8.6 → erispulse-2.9.0.dev2}/src/ErisPulse/CLI/commands/install.py

@@ -8,7 +8,7 @@ import asyncio
 import sys
 from argparse import ArgumentParser
 
-from rich.prompt import Confirm, Prompt
+from rich.prompt import Prompt
 from rich.text import Text
 
 from ..base import Command
@@ -16,6 +16,7 @@ from ..console import console
 from ..i18n import i18n
 from ..utils import PackageManager, config_wizard
 from ..utils.display import interactive_select_table
+from ..utils.interactive import confirm
 from ..utils.package_manager import (
     resolve_target_python,
     warn_if_uv_isolated,
@@ -251,6 +252,7 @@ class InstallCommand(Command):
             if success:
                 # 非交互路径不进入向导，仅提示后续配置入口
                 console.print(f"[dim]  {i18n.t('cli.install.configure_hint')}[/]")
+                console.print(f"[hint]  {i18n.t('cli.install.done_hint')}[/]")
 
             if not success:
                 sys.exit(1)
@@ -294,7 +296,7 @@ class InstallCommand(Command):
             elif choice == "4":
                 self._install_custom(upgrade, pre)
 
-            if not Confirm.ask(f"\n  [cyan]{i18n.t('cli.install.continue_install')}[/]", default=False):
+            if not confirm(f"\n  [cyan]{i18n.t('cli.install.continue_install')}[/]", default=False):
                 break
 
     def _install_adapters(self, remote_packages: dict, upgrade: bool, pre: bool):
@@ -341,7 +343,7 @@ class InstallCommand(Command):
 
         selected_names = [name for name, _ in selected]
         console.print(f"\n  [dim]{i18n.t('cli.install.selected', selected=', '.join(selected_names))}[/]")
-        if Confirm.ask(
+        if confirm(
             f"  [cyan]{i18n.t('cli.install.confirm_adapters', count=len(selected_names))}[/]",
             default=True,
         ):
@@ -390,7 +392,7 @@ class InstallCommand(Command):
 
         selected_names = [name for name, _ in selected]
         console.print(f"\n  [dim]{i18n.t('cli.install.selected', selected=', '.join(selected_names))}[/]")
-        if Confirm.ask(
+        if confirm(
             f"  [cyan]{i18n.t('cli.install.confirm_modules', count=len(selected_names))}[/]",
             default=True,
         ):
@@ -495,7 +497,7 @@ class InstallCommand(Command):
             except ValueError:
                 continue
 
-        if selected and Confirm.ask(
+        if selected and confirm(
             f"  [cyan]{i18n.t('cli.install.confirm_search_install', count=len(selected))}[/]",
             default=True,
         ):
@@ -514,7 +516,7 @@ class InstallCommand(Command):
         if package_name.lower() == "q":
             return
         if package_name:
-            if Confirm.ask(
+            if confirm(
                 f"  [cyan]{i18n.t('cli.install.confirm_custom_install', package_name=package_name)}[/]",
                 default=True,
             ):
@@ -534,6 +536,7 @@ class InstallCommand(Command):
         """
         if not config_wizard.is_interactive():
             console.print(f"[dim]  {i18n.t('cli.install.configure_hint')}[/]")
+            console.print(f"[hint]  {i18n.t('cli.install.done_hint')}[/]")
             return
 
         resolved = []
@@ -545,3 +548,4 @@ class InstallCommand(Command):
             config_wizard.post_install_configure(resolved)
         except Exception as e:
             console.print(f"[warning]  {i18n.t('cli.config.post_install_failed', error=e)}[/]")
+        console.print(f"[hint]  {i18n.t('cli.install.done_hint')}[/]")

{erispulse-2.8.6 → erispulse-2.9.0.dev2}/src/ErisPulse/CLI/commands/list.py

@@ -56,6 +56,7 @@ class ListCommand(Command):
 
         # 仅在需要时一次性拉取远程索引，避免逐包重复 asyncio.run / 网络请求
         remote_packages = None
+        remote_unavailable = False
         if outdated_only:
             try:
                 remote_packages = asyncio.run(
@@ -63,15 +64,29 @@ class ListCommand(Command):
                 )
             except Exception:
                 remote_packages = None
+            # 索引拉取失败（异常或双源均空）：区分"全是最新"与"无法检查"
+            remote_unavailable = remote_packages is None or not (
+                remote_packages.get("modules") or remote_packages.get("adapters")
+            )
 
         if pkg_type == "all":
-            self._print_installed_packages("modules", outdated_only, remote_packages)
-            self._print_installed_packages("adapters", outdated_only, remote_packages)
+            self._print_installed_packages(
+                "modules", outdated_only, remote_packages, remote_unavailable
+            )
+            self._print_installed_packages(
+                "adapters", outdated_only, remote_packages, remote_unavailable
+            )
         else:
-            self._print_installed_packages(pkg_type, outdated_only, remote_packages)
+            self._print_installed_packages(
+                pkg_type, outdated_only, remote_packages, remote_unavailable
+            )
 
     def _print_installed_packages(
-        self, pkg_type: str, outdated_only: bool = False, remote_packages: dict | None = None
+        self,
+        pkg_type: str,
+        outdated_only: bool = False,
+        remote_packages: dict | None = None,
+        remote_unavailable: bool = False,
     ):
         """
         以表格形式打印已安装的模块或适配器
@@ -79,6 +94,7 @@ class ListCommand(Command):
         :param pkg_type: [str] 组件类型 (modules 或 adapters)
         :param outdated_only: [bool] 是否仅显示可升级的包 (默认: False)
         :param remote_packages: [Optional[dict]] 预取的远程索引，避免逐包重复拉取 (默认: None)
+        :param remote_unavailable: [bool] 远程索引是否不可达（空结果区分文案用，默认: False）
         """
         installed = self.package_manager.get_installed_packages()
 
@@ -121,6 +137,10 @@ class ListCommand(Command):
                 )
                 # 展示模块注册的脚本入口
                 self._print_package_scripts(installed["modules"])
+            elif outdated_only and remote_unavailable:
+                console.print(f"[dim]  {i18n.t('cli.list.outdated_unavailable')}[/]")
+            elif outdated_only:
+                console.print(f"[dim]  {i18n.t('cli.list.no_outdated')}[/]")
             else:
                 console.print(f"[dim]  {i18n.t('cli.list.no_modules')}[/]")
                 console.print(f"[dim]  {i18n.t('cli.list.empty_hint')}[/]")
@@ -134,6 +154,7 @@ class ListCommand(Command):
             )
             table.add_column(i18n.t("cli.list.header_package"), min_width=20)
             table.add_column(i18n.t("cli.list.header_version"), width=10)
+            table.add_column(i18n.t("cli.list.header_status"), width=8)
             table.add_column(i18n.t("cli.list.header_desc"))
 
             count = 0
@@ -142,10 +163,16 @@ class ListCommand(Command):
                     info["package"], info["version"], remote_packages
                 ):
                     continue
+                status = (
+                    f"[green]{i18n.t('cli.list.status_enabled')}[/]"
+                    if info.get("enabled", True)
+                    else f"[yellow]{i18n.t('cli.list.status_disabled')}[/]"
+                )
                 table.add_row(
                     name,
                     info["package"],
                     info["version"],
+                    status,
                     info["summary"],
                 )
                 count += 1
@@ -155,6 +182,10 @@ class ListCommand(Command):
                 console.print(
                     f"[dim]  {i18n.t('cli.list.count_adapters', count=count)}[/]"
                 )
+            elif outdated_only and remote_unavailable:
+                console.print(f"[dim]  {i18n.t('cli.list.outdated_unavailable')}[/]")
+            elif outdated_only:
+                console.print(f"[dim]  {i18n.t('cli.list.no_outdated')}[/]")
             else:
                 console.print(f"[dim]  {i18n.t('cli.list.no_adapters')}[/]")
                 console.print(f"[dim]  {i18n.t('cli.list.empty_hint')}[/]")
@@ -182,12 +213,15 @@ class ListCommand(Command):
         """
         if remote_packages is None:
             remote_packages = asyncio.run(self.package_manager.get_remote_packages())
+        # 仅"远端更新"才算可升级：本地 dev/git 安装版本比远端新时不再误报
+        from ...runtime.version import compare_versions
+
         for module_info in remote_packages["modules"].values():
             if module_info["package"] == package_name:
-                return module_info["version"] != current_version
+                return compare_versions(module_info["version"], current_version) > 0
         for adapter_info in remote_packages["adapters"].values():
             if adapter_info["package"] == package_name:
-                return adapter_info["version"] != current_version
+                return compare_versions(adapter_info["version"], current_version) > 0
         return False
 
     def _print_package_scripts(self, packages: dict) -> None:

{erispulse-2.8.6 → erispulse-2.9.0.dev2}/src/ErisPulse/CLI/commands/run.py

@@ -19,7 +19,14 @@ from rich.panel import Panel
 from ...runtime.file_watcher import FileSystemEventHandler, PollingObserver
 from ..base import Command
 from ..console import console
-from ..constants import ENV_SUPERVISED, HARD_RESTART_EXIT_CODE
+from ..constants import (
+    ENV_SUPERVISED,
+    HARD_RESTART_EXIT_CODE,
+    RUN_CRASH_BACKOFF_MAX_SECS,
+    RUN_CRASH_BACKOFF_PER_CRASH_SECS,
+    RUN_PERSISTENT_CRASH_HINT_THRESHOLD,
+    RUN_RESTART_PAUSE_SECS,
+)
 from ..i18n import i18n
 from ..utils.package_manager import (
     resolve_target_python,
@@ -152,7 +159,6 @@ class RunCommand(Command):
             self._run_internal(reload_mode)
 
     _RESTART_EXIT_CODE = HARD_RESTART_EXIT_CODE
-    _MAX_CRASH_BACKOFF = 60.0
 
     def _run_internal(self, reload_mode: bool):
         """
@@ -200,6 +206,11 @@ class RunCommand(Command):
         ]
 
         crash_count = 0
+        # 连续同退出码崩溃计数：达到阈值输出一次排查指引（确定性故障
+        # 退避重试无意义，与其反复失败不如引导留现场）
+        consecutive_same_code = 0
+        last_crash_code: int | None = None
+        crash_hint_shown = False
         process = None
         try:
             while True:
@@ -213,7 +224,7 @@ class RunCommand(Command):
                 if process.returncode == self._RESTART_EXIT_CODE:
                     console.print(f"[info]{i18n.t('cli.run.restart_request')}[/]")
                     crash_count = 0
-                    time.sleep(0.5)
+                    time.sleep(RUN_RESTART_PAUSE_SECS)
                     continue
 
                 if process.returncode == 0:
@@ -224,7 +235,21 @@ class RunCommand(Command):
                 # 非硬重启/非正常退出码：模块/适配器内部错误导致子进程异常终止
                 # 不退出主进程，等待后自动重试
                 crash_count += 1
-                backoff = min(self._MAX_CRASH_BACKOFF, 3.0 * crash_count)
+                if process.returncode == last_crash_code:
+                    consecutive_same_code += 1
+                else:
+                    consecutive_same_code = 1
+                    last_crash_code = process.returncode
+                if (
+                    not crash_hint_shown
+                    and RUN_PERSISTENT_CRASH_HINT_THRESHOLD > 0
+                    and consecutive_same_code >= RUN_PERSISTENT_CRASH_HINT_THRESHOLD
+                ):
+                    crash_hint_shown = True
+                    console.print(
+                        f"[hint]{i18n.t('cli.run.persistent_crash_hint', count=consecutive_same_code, code=process.returncode)}[/]"
+                    )
+                backoff = min(RUN_CRASH_BACKOFF_MAX_SECS, RUN_CRASH_BACKOFF_PER_CRASH_SECS * crash_count)
                 console.print(
                     f"[warning]{i18n.t('cli.run.process_crashed', code=process.returncode)}[/]"
                 )

{erispulse-2.8.6 → erispulse-2.9.0.dev2}/src/ErisPulse/CLI/commands/self_update.py

@@ -9,7 +9,7 @@ import sys
 from argparse import ArgumentParser
 
 from rich.box import SIMPLE
-from rich.prompt import Confirm, Prompt
+from rich.prompt import Prompt
 from rich.table import Table
 from rich.text import Text
 
@@ -18,6 +18,7 @@ from ..console import console
 from ..i18n import i18n
 from ..utils import PackageManager
 from ..utils.display import _input, section_header
+from ..utils.interactive import confirm
 
 
 class SelfUpdateCommand(Command):
@@ -82,7 +83,7 @@ class SelfUpdateCommand(Command):
             )
             sys.exit(0)
         elif not args.force:
-            if not Confirm.ask(
+            if not confirm(
                 i18n.t(
                     "cli.self_update.confirm_update",
                     current=current_version,
@@ -114,7 +115,7 @@ class SelfUpdateCommand(Command):
                 console.print(
                     f"[warning]{i18n.t('cli.self_update.version_not_found', version=specified_version)}[/]"
                 )
-                if not Confirm.ask(
+                if not confirm(
                     i18n.t("cli.self_update.confirm_continue"), default=False
                 ):
                     return None
@@ -197,7 +198,7 @@ class SelfUpdateCommand(Command):
                 console.print(
                     f"[warning]{i18n.t('cli.self_update.version_not_found', version=target_version)}[/]"
                 )
-                if not Confirm.ask(
+                if not confirm(
                     i18n.t("cli.self_update.confirm_continue"), default=False
                 ):
                     return None

{erispulse-2.8.6 → erispulse-2.9.0.dev2}/src/ErisPulse/CLI/commands/upgrade.py

@@ -7,11 +7,11 @@ Upgrade 命令实现
 import sys
 from argparse import ArgumentParser
 
-from rich.prompt import Confirm
-
 from ..base import Command
+from ..console import console
 from ..i18n import i18n
 from ..utils import PackageManager
+from ..utils.interactive import confirm
 from ..utils.package_manager import resolve_target_python, warn_if_uv_isolated
 
 
@@ -50,15 +50,21 @@ class UpgradeCommand(Command):
     def execute(self, args):
         warn_if_uv_isolated()
         self.package_manager.no_uv = getattr(args, "no_uv", False)
+        upgraded = False
         if args.package:
             # 升级指定包
             success = self.package_manager.upgrade_package(args.package, pre=args.pre)
             if not success:
                 sys.exit(1)
+            upgraded = True
         # 升级所有包
-        elif args.force or Confirm.ask(
+        elif args.force or confirm(
             i18n.t("cli.upgrade.confirm_all"), default=False
         ):
             success = self.package_manager.upgrade_all()
             if not success:
                 sys.exit(1)
+            upgraded = True
+        if upgraded:
+            # 生效方式提示：升级只更新磁盘代码，运行中的进程需重启或热重载
+            console.print(f"[hint]{i18n.t('cli.upgrade.done_hint')}[/]")