ErisPulse 2.5.2.dev0__py3-none-any.whl → 2.5.2.dev2__py3-none-any.whl

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/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/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)",
@@ -315,18 +316,18 @@ TRANSLATIONS = {
     "cli.package.compat_warning_upgrade": "SDK Version Compatibility Warning\nPackage {package} requires minimum SDK version {version}\n{message}\n\nContinuing the upgrade may cause issues.",
     "cli.package.compat_warning_title": "Compatibility Warning",
     "cli.package.installing": "Installing {package}",
-    "cli.package.install_success": "✔ Package {package} installed successfully",
-    "cli.package.install_failed": "✘ Package {package} installation failed",
-    "cli.package.operation_success": "✔ {description} succeeded",
-    "cli.package.operation_failed": "✘ {description} failed",
+    "cli.package.install_success": "[OK] Package {package} installed successfully",
+    "cli.package.install_failed": "[FAIL] Package {package} installation failed",
+    "cli.package.operation_success": "[OK] {description} succeeded",
+    "cli.package.operation_failed": "[FAIL] {description} failed",
     "cli.package.alias_mapping": "  Alias mapping: {alias} → {package}",
     "cli.package.installed_package_found": "  Found installed package: {package}",
     "cli.package.uninstall_alias_not_found": "  No alias found, attempting direct uninstall: {package}",
     "cli.package.confirm_uninstall": "Confirm uninstall the following packages?\n{packages}",
     "cli.package.operation_cancelled": "  Operation cancelled",
     "cli.package.uninstalling": "Uninstalling {package}",
-    "cli.package.uninstall_success": "✔ Package {package} uninstalled successfully",
-    "cli.package.uninstall_failed": "✘ Package {package} uninstall failed",
+    "cli.package.uninstall_success": "[OK] Package {package} uninstalled successfully",
+    "cli.package.uninstall_failed": "[FAIL] Package {package} uninstall failed",
     "cli.package.all_up_to_date": "All ErisPulse packages are up to date",
     "cli.package.updates_found": "Found {count} package(s) to upgrade:",
     "cli.package.upgrade_list_title": "Upgrade List",
@@ -343,8 +344,8 @@ TRANSLATIONS = {
     "cli.package.confirm_upgrade": "Continue with upgrade?",
     "cli.package.upgrade_cancelled": "Upgrade cancelled",
     "cli.package.upgrading": "Upgrading {package}",
-    "cli.package.upgrade_success": "✔ Package {package} upgraded successfully",
-    "cli.package.upgrade_failed": "✘ Package {package} upgrade failed",
+    "cli.package.upgrade_success": "[OK] Package {package} upgraded successfully",
+    "cli.package.upgrade_failed": "[FAIL] Package {package} upgrade failed",
     "cli.package.pypi_versions_failed": "Failed to fetch PyPI version info",
     "cli.package.already_target_version": "Already at target version {version}",
     "cli.package.invalid_version": "Invalid version number: {version}",
@@ -353,7 +354,7 @@ TRANSLATIONS = {
     "cli.package.update_desc_with_version": "Updating ErisPulse SDK to {version}",
     "cli.package.update_desc_latest": "Updating ErisPulse SDK to the latest version",
     "cli.package.latest_version": "latest version",
-    "cli.package.sdk_update_success": "✔ ErisPulse SDK updated successfully: {old} → {new}",
+    "cli.package.sdk_update_success": "[OK] ErisPulse SDK updated successfully: {old} → {new}",
     "cli.package.restart_cli": "Please restart the CLI to use the new version",
-    "cli.package.sdk_update_failed": "✘ ErisPulse SDK update failed",
+    "cli.package.sdk_update_failed": "[FAIL] ErisPulse SDK update failed",
 }

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": "アンインストールするパッケージ名（複数指定可）",
@@ -315,18 +316,18 @@ TRANSLATIONS = {
     "cli.package.compat_warning_upgrade": "SDK バージョン互換性警告\nパッケージ {package} は最小 SDK バージョン {version} が必要です\n{message}\n\nアップグレードを続行すると問題が発生する可能性があります。",
     "cli.package.compat_warning_title": "互換性警告",
     "cli.package.installing": "インストール中 {package}",
-    "cli.package.install_success": "✔ パッケージ {package} のインストールに成功しました",
-    "cli.package.install_failed": "✘ パッケージ {package} のインストールに失敗しました",
-    "cli.package.operation_success": "✔ {description} 成功",
-    "cli.package.operation_failed": "✘ {description} 失敗",
+    "cli.package.install_success": "[OK] パッケージ {package} のインストールに成功しました",
+    "cli.package.install_failed": "[FAIL] パッケージ {package} のインストールに失敗しました",
+    "cli.package.operation_success": "[OK] {description} 成功",
+    "cli.package.operation_failed": "[FAIL] {description} 失敗",
     "cli.package.alias_mapping": "  エイリアスマッピング: {alias} → {package}",
     "cli.package.installed_package_found": "  インストール済みパッケージが見つかりました: {package}",
     "cli.package.uninstall_alias_not_found": "  エイリアスが見つかりません。直接アンインストールを試みます: {package}",
     "cli.package.confirm_uninstall": "以下のパッケージをアンインストールしますか？\n{packages}",
     "cli.package.operation_cancelled": "  操作がキャンセルされました",
     "cli.package.uninstalling": "アンインストール中 {package}",
-    "cli.package.uninstall_success": "✔ パッケージ {package} のアンインストールに成功しました",
-    "cli.package.uninstall_failed": "✘ パッケージ {package} のアンインストールに失敗しました",
+    "cli.package.uninstall_success": "[OK] パッケージ {package} のアンインストールに成功しました",
+    "cli.package.uninstall_failed": "[FAIL] パッケージ {package} のアンインストールに失敗しました",
     "cli.package.all_up_to_date": "すべての ErisPulse パッケージは最新です",
     "cli.package.updates_found": "{count} 個のアップグレード可能なパッケージが見つかりました:",
     "cli.package.upgrade_list_title": "アップグレードリスト",
@@ -343,8 +344,8 @@ TRANSLATIONS = {
     "cli.package.confirm_upgrade": "アップグレードを続行しますか？",
     "cli.package.upgrade_cancelled": "アップグレードがキャンセルされました",
     "cli.package.upgrading": "アップグレード中 {package}",
-    "cli.package.upgrade_success": "✔ パッケージ {package} のアップグレードに成功しました",
-    "cli.package.upgrade_failed": "✘ パッケージ {package} のアップグレードに失敗しました",
+    "cli.package.upgrade_success": "[OK] パッケージ {package} のアップグレードに成功しました",
+    "cli.package.upgrade_failed": "[FAIL] パッケージ {package} のアップグレードに失敗しました",
     "cli.package.pypi_versions_failed": "PyPI バージョン情報の取得に失敗しました",
     "cli.package.already_target_version": "すでにターゲットバージョン {version} です",
     "cli.package.invalid_version": "無効なバージョン番号: {version}",
@@ -353,7 +354,7 @@ TRANSLATIONS = {
     "cli.package.update_desc_with_version": "ErisPulse SDK を {version} に更新中",
     "cli.package.update_desc_latest": "ErisPulse SDK を最新バージョンに更新中",
     "cli.package.latest_version": "最新バージョン",
-    "cli.package.sdk_update_success": "✔ ErisPulse SDK の更新に成功しました: {old} → {new}",
+    "cli.package.sdk_update_success": "[OK] ErisPulse SDK の更新に成功しました: {old} → {new}",
     "cli.package.restart_cli": "新しいバージョンを使用するには CLI を再起動してください",
-    "cli.package.sdk_update_failed": "✘ ErisPulse SDK の更新に失敗しました",
+    "cli.package.sdk_update_failed": "[FAIL] ErisPulse SDK の更新に失敗しました",
 }

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": "Имя(ена) пакета(ов) для удаления (можно указать несколько)",
@@ -315,18 +316,18 @@ TRANSLATIONS = {
     "cli.package.compat_warning_upgrade": "Предупреждение о совместимости версии SDK\nПакет {package} требует минимальную версию SDK {version}\n{message}\n\nПродолжение обновления может вызвать проблемы.",
     "cli.package.compat_warning_title": "Предупреждение о совместимости",
     "cli.package.installing": "Установка {package}",
-    "cli.package.install_success": "✔ Пакет {package} успешно установлен",
-    "cli.package.install_failed": "✘ Ошибка установки пакета {package}",
-    "cli.package.operation_success": "✔ {description} выполнено",
-    "cli.package.operation_failed": "✘ {description} не удалось",
+    "cli.package.install_success": "[OK] Пакет {package} успешно установлен",
+    "cli.package.install_failed": "[FAIL] Ошибка установки пакета {package}",
+    "cli.package.operation_success": "[OK] {description} выполнено",
+    "cli.package.operation_failed": "[FAIL] {description} не удалось",
     "cli.package.alias_mapping": "  Сопоставление псевдонима: {alias} → {package}",
     "cli.package.installed_package_found": "  Найден установленный пакет: {package}",
     "cli.package.uninstall_alias_not_found": "  Псевдоним не найден, попытка прямого удаления: {package}",
     "cli.package.confirm_uninstall": "Подтвердить удаление следующих пакетов?\n{packages}",
     "cli.package.operation_cancelled": "  Операция отменена",
     "cli.package.uninstalling": "Удаление {package}",
-    "cli.package.uninstall_success": "✔ Пакет {package} успешно удалён",
-    "cli.package.uninstall_failed": "✘ Ошибка удаления пакета {package}",
+    "cli.package.uninstall_success": "[OK] Пакет {package} успешно удалён",
+    "cli.package.uninstall_failed": "[FAIL] Ошибка удаления пакета {package}",
     "cli.package.all_up_to_date": "Все пакеты ErisPulse обновлены до последней версии",
     "cli.package.updates_found": "Найдено пакетов для обновления: {count}",
     "cli.package.upgrade_list_title": "Список обновлений",
@@ -343,8 +344,8 @@ TRANSLATIONS = {
     "cli.package.confirm_upgrade": "Продолжить обновление?",
     "cli.package.upgrade_cancelled": "Обновление отменено",
     "cli.package.upgrading": "Обновление {package}",
-    "cli.package.upgrade_success": "✔ Пакет {package} успешно обновлён",
-    "cli.package.upgrade_failed": "✘ Ошибка обновления пакета {package}",
+    "cli.package.upgrade_success": "[OK] Пакет {package} успешно обновлён",
+    "cli.package.upgrade_failed": "[FAIL] Ошибка обновления пакета {package}",
     "cli.package.pypi_versions_failed": "Не удалось получить информацию о версиях PyPI",
     "cli.package.already_target_version": "Уже установлена целевая версия {version}",
     "cli.package.invalid_version": "Недопустимый номер версии: {version}",
@@ -353,7 +354,7 @@ TRANSLATIONS = {
     "cli.package.update_desc_with_version": "Обновление ErisPulse SDK до {version}",
     "cli.package.update_desc_latest": "Обновление ErisPulse SDK до последней версии",
     "cli.package.latest_version": "последняя версия",
-    "cli.package.sdk_update_success": "✔ ErisPulse SDK успешно обновлён: {old} → {new}",
+    "cli.package.sdk_update_success": "[OK] ErisPulse SDK успешно обновлён: {old} → {new}",
     "cli.package.restart_cli": "Пожалуйста, перезапустите CLI, чтобы использовать новую версию",
-    "cli.package.sdk_update_failed": "✘ Ошибка обновления ErisPulse SDK",
+    "cli.package.sdk_update_failed": "[FAIL] Ошибка обновления ErisPulse SDK",
 }

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": "要卸载的包名（可指定多个）",
@@ -315,18 +316,18 @@ TRANSLATIONS = {
     "cli.package.compat_warning_upgrade": "SDK版本兼容性警告\n包 {package} 需要最低SDK版本 {version}\n{message}\n\n继续升级可能会导致问题。",
     "cli.package.compat_warning_title": "兼容性警告",
     "cli.package.installing": "安装 {package}",
-    "cli.package.install_success": "✔ 包 {package} 安装成功",
-    "cli.package.install_failed": "✘ 包 {package} 安装失败",
-    "cli.package.operation_success": "✔ {description} 成功",
-    "cli.package.operation_failed": "✘ {description} 失败",
+    "cli.package.install_success": "[OK] 包 {package} 安装成功",
+    "cli.package.install_failed": "[FAIL] 包 {package} 安装失败",
+    "cli.package.operation_success": "[OK] {description} 成功",
+    "cli.package.operation_failed": "[FAIL] {description} 失败",
     "cli.package.alias_mapping": "  别名映射: {alias} → {package}",
     "cli.package.installed_package_found": "  找到已安装包: {package}",
     "cli.package.uninstall_alias_not_found": "  未找到别名，将尝试直接卸载: {package}",
     "cli.package.confirm_uninstall": "确认卸载以下包吗？\n{packages}",
     "cli.package.operation_cancelled": "  操作已取消",
     "cli.package.uninstalling": "卸载 {package}",
-    "cli.package.uninstall_success": "✔ 包 {package} 卸载成功",
-    "cli.package.uninstall_failed": "✘ 包 {package} 卸载失败",
+    "cli.package.uninstall_success": "[OK] 包 {package} 卸载成功",
+    "cli.package.uninstall_failed": "[FAIL] 包 {package} 卸载失败",
     "cli.package.all_up_to_date": "所有ErisPulse包已是最新版本",
     "cli.package.updates_found": "找到 {count} 个可升级的包:",
     "cli.package.upgrade_list_title": "升级列表",
@@ -343,8 +344,8 @@ TRANSLATIONS = {
     "cli.package.confirm_upgrade": "是否继续升级？",
     "cli.package.upgrade_cancelled": "已取消升级",
     "cli.package.upgrading": "升级 {package}",
-    "cli.package.upgrade_success": "✔ 包 {package} 升级成功",
-    "cli.package.upgrade_failed": "✘ 包 {package} 升级失败",
+    "cli.package.upgrade_success": "[OK] 包 {package} 升级成功",
+    "cli.package.upgrade_failed": "[FAIL] 包 {package} 升级失败",
     "cli.package.pypi_versions_failed": "获取PyPI版本信息失败",
     "cli.package.already_target_version": "当前已是目标版本 {version}",
     "cli.package.invalid_version": "无效的版本号: {version}",
@@ -353,7 +354,7 @@ TRANSLATIONS = {
     "cli.package.update_desc_with_version": "更新 ErisPulse SDK 到 {version}",
     "cli.package.update_desc_latest": "更新 ErisPulse SDK 到最新版本",
     "cli.package.latest_version": "最新版本",
-    "cli.package.sdk_update_success": "✔ ErisPulse SDK 更新成功: {old} → {new}",
+    "cli.package.sdk_update_success": "[OK] ErisPulse SDK 更新成功: {old} → {new}",
     "cli.package.restart_cli": "请重新启动CLI以使用新版本",
-    "cli.package.sdk_update_failed": "✘ ErisPulse SDK 更新失败",
+    "cli.package.sdk_update_failed": "[FAIL] ErisPulse SDK 更新失败",
 }

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": "要解除安裝的包名（可指定多個）",
@@ -315,18 +316,18 @@ TRANSLATIONS = {
     "cli.package.compat_warning_upgrade": "SDK版本相容性警告\n包 {package} 需要最低SDK版本 {version}\n{message}\n\n繼續升級可能會導致問題。",
     "cli.package.compat_warning_title": "相容性警告",
     "cli.package.installing": "安裝 {package}",
-    "cli.package.install_success": "✔ 包 {package} 安裝成功",
-    "cli.package.install_failed": "✘ 包 {package} 安裝失敗",
-    "cli.package.operation_success": "✔ {description} 成功",
-    "cli.package.operation_failed": "✘ {description} 失敗",
+    "cli.package.install_success": "[OK] 包 {package} 安裝成功",
+    "cli.package.install_failed": "[FAIL] 包 {package} 安裝失敗",
+    "cli.package.operation_success": "[OK] {description} 成功",
+    "cli.package.operation_failed": "[FAIL] {description} 失敗",
     "cli.package.alias_mapping": "  別名對映: {alias} → {package}",
     "cli.package.installed_package_found": "  找到已安裝包: {package}",
     "cli.package.uninstall_alias_not_found": "  未找到別名，將嘗試直接解除安裝: {package}",
     "cli.package.confirm_uninstall": "確認解除安裝以下包嗎？\n{packages}",
     "cli.package.operation_cancelled": "  操作已取消",
     "cli.package.uninstalling": "解除安裝 {package}",
-    "cli.package.uninstall_success": "✔ 包 {package} 解除安裝成功",
-    "cli.package.uninstall_failed": "✘ 包 {package} 解除安裝失敗",
+    "cli.package.uninstall_success": "[OK] 包 {package} 解除安裝成功",
+    "cli.package.uninstall_failed": "[FAIL] 包 {package} 解除安裝失敗",
     "cli.package.all_up_to_date": "所有ErisPulse包已是最新版本",
     "cli.package.updates_found": "找到 {count} 個可升級的包:",
     "cli.package.upgrade_list_title": "升級列表",
@@ -343,8 +344,8 @@ TRANSLATIONS = {
     "cli.package.confirm_upgrade": "是否繼續升級？",
     "cli.package.upgrade_cancelled": "已取消升級",
     "cli.package.upgrading": "升級 {package}",
-    "cli.package.upgrade_success": "✔ 包 {package} 升級成功",
-    "cli.package.upgrade_failed": "✘ 包 {package} 升級失敗",
+    "cli.package.upgrade_success": "[OK] 包 {package} 升級成功",
+    "cli.package.upgrade_failed": "[FAIL] 包 {package} 升級失敗",
     "cli.package.pypi_versions_failed": "取得PyPI版本資訊失敗",
     "cli.package.already_target_version": "當前已是目標版本 {version}",
     "cli.package.invalid_version": "無效的版本號: {version}",
@@ -353,7 +354,7 @@ TRANSLATIONS = {
     "cli.package.update_desc_with_version": "更新 ErisPulse SDK 到 {version}",
     "cli.package.update_desc_latest": "更新 ErisPulse SDK 到最新版本",
     "cli.package.latest_version": "最新版本",
-    "cli.package.sdk_update_success": "✔ ErisPulse SDK 更新成功: {old} → {new}",
+    "cli.package.sdk_update_success": "[OK] ErisPulse SDK 更新成功: {old} → {new}",
     "cli.package.restart_cli": "請重新啟動CLI以使用新版本",
-    "cli.package.sdk_update_failed": "✘ ErisPulse SDK 更新失敗",
+    "cli.package.sdk_update_failed": "[FAIL] ErisPulse SDK 更新失敗",
 }

ErisPulse/CLI/utils/package_manager.py

@@ -381,6 +381,8 @@ class PackageManager:
         :param name: [str] 原始名称
         :return: [str] 标准化后的名称
         """
+        if not name:
+            return ""
         return name.lower().strip()
 
     async def _find_package_by_alias(self, alias: str) -> Optional[str]:
@@ -494,7 +496,7 @@ class PackageManager:
         :param force_refresh: [bool] 是否强制刷新缓存 (默认: False)
         :return: [Optional[str]] 最新版本号，失败时返回 None
         """
-        cache_key = package_name.lower()
+        cache_key = (package_name or "").lower()
         if not force_refresh and cache_key in self._pypi_cache:
             if time.time() - self._pypi_cache_time[cache_key] < self.CACHE_EXPIRY:
                 return self._pypi_cache[cache_key]
@@ -621,7 +623,7 @@ class PackageManager:
             proxy_hint = f" [dim](proxy: {safe_proxy})[/]"
 
         console.print(
-            f"\n[bold blue]⚙ {description}[/] [dim]({backend})[/]{proxy_hint}"
+            f"\n[bold blue][*] {description}[/] [dim]({backend})[/]{proxy_hint}"
         )
         console.print("[dim]─────────────────────────────────────────────────[/]")
 
@@ -673,59 +675,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/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/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/Core/Event/__init__.pyi

@@ -18,9 +18,9 @@ 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, 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
+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