ErisPulse 2.7.1.dev0__tar.gz → 2.7.1.dev1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.7.1.dev0
+Version: 2.7.1.dev1
 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.dev0 → erispulse-2.7.1.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.7.1-dev.0"
+version = "2.7.1-dev.1"
 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.dev0 → erispulse-2.7.1.dev1}/src/ErisPulse/CLI/commands/doctor.py

@@ -43,13 +43,14 @@ class DoctorCommand(Command):
 
     def execute(self, args):
         pm = self.package_manager
-        rows: list[tuple[str, str]] = []
+        rows: list[tuple[str, str, str]] = []
         failed = False
 
         # 1. Python 解释器
         py_ok = sys.version_info >= (3, 10)
         rows.append(
             (
+                self._status(py_ok),
                 i18n.t("cli.doctor.python"),
                 f"{platform.python_version()} ({sys.executable})",
             )
@@ -60,27 +61,43 @@ class DoctorCommand(Command):
         # 2. 安装后端（uv / pip）
         uv_cmd = pm._get_uv_command()
         if uv_cmd:
-            rows.append((i18n.t("cli.doctor.backend"), f"uv ({uv_cmd[0]})"))
+            rows.append(
+                (self._status(True), i18n.t("cli.doctor.backend"), f"uv ({uv_cmd[0]})")
+            )
         else:
-            rows.append((i18n.t("cli.doctor.backend"), i18n.t("cli.doctor.backend_pip")))
+            rows.append(
+                (
+                    self._status(True),
+                    i18n.t("cli.doctor.backend"),
+                    i18n.t("cli.doctor.backend_pip"),
+                )
+            )
 
         # 3. 目标解释器（安装目标环境）
         target_python = pm._get_target_python()
-        rows.append((i18n.t("cli.doctor.target_python"), target_python))
+        rows.append(
+            (self._status(True), i18n.t("cli.doctor.target_python"), target_python)
+        )
 
         # 4. 配置文件
         config_path = Path("config") / "config.toml"
         if config_path.exists():
             rows.append(
-                (i18n.t("cli.doctor.config"), str(config_path.resolve()))
+                (
+                    self._status(True),
+                    i18n.t("cli.doctor.config"),
+                    str(config_path.resolve()),
+                )
             )
         else:
             rows.append(
                 (
+                    self._status(False),
                     i18n.t("cli.doctor.config"),
                     f"{i18n.t('cli.doctor.config_missing')} ({config_path})",
                 )
             )
+            failed = True
 
         # 5. PyPI 连通性
         try:
@@ -90,21 +107,40 @@ class DoctorCommand(Command):
             )
             rows.append(
                 (
+                    self._status(True),
                     i18n.t("cli.doctor.pypi"),
                     i18n.t("cli.doctor.pypi_ok", count=pkg_count),
                 )
             )
         except Exception:
             failed = True
-            rows.append((i18n.t("cli.doctor.pypi"), i18n.t("cli.doctor.pypi_fail")))
+            rows.append(
+                (
+                    self._status(False),
+                    i18n.t("cli.doctor.pypi"),
+                    i18n.t("cli.doctor.pypi_fail"),
+                )
+            )
 
         # 6. 代理
         proxy = pm._get_system_proxy()
         if proxy:
             https_proxy = proxy.get("https") or proxy.get("http", "")
-            rows.append((i18n.t("cli.doctor.proxy"), https_proxy))
+            rows.append(
+                (
+                    self._status(True),
+                    i18n.t("cli.doctor.proxy"),
+                    https_proxy,
+                )
+            )
         else:
-            rows.append((i18n.t("cli.doctor.proxy"), i18n.t("cli.doctor.proxy_none")))
+            rows.append(
+                (
+                    self._status(True),
+                    i18n.t("cli.doctor.proxy"),
+                    i18n.t("cli.doctor.proxy_none"),
+                )
+            )
 
         # 输出诊断报告
         table = Table(
@@ -113,15 +149,36 @@ class DoctorCommand(Command):
             pad_edge=False,
             expand=True,
         )
-        for label, detail in rows:
-            table.add_row(f"[info]{label}[/]", detail)
+        for status, label, detail in rows:
+            table.add_row(status, f"[info]{label}[/]", detail)
 
         console.print(table)
 
         if failed:
             console.print(f"[error]{i18n.t('cli.doctor.failed')}[/]")
+            for status, label, _ in rows:
+                if status != self._status(True):
+                    console.print(
+                        f"  [error]-[/] [info]{label}[/]"
+                    )
         else:
             console.print(f"[success]{i18n.t('cli.doctor.all_ok')}[/]")
 
+    @staticmethod
+    def _status(ok: bool) -> str:
+        """
+        生成诊断项的状态标记文本（OK / FAIL，不使用 emoji）
+
+        :param ok: bool 诊断项是否正常
+        :return: str 带样式的状态标记文本
+        """
+        from ..i18n import i18n
+
+        return (
+            f"[success]{i18n.t('cli.doctor.status_ok')}[/]"
+            if ok
+            else f"[error]{i18n.t('cli.doctor.status_fail')}[/]"
+        )
+
 
 __all__ = ["DoctorCommand"]

{erispulse-2.7.1.dev0 → erispulse-2.7.1.dev1}/src/ErisPulse/CLI/commands/list.py

@@ -121,6 +121,7 @@ class ListCommand(Command):
                 self._print_package_scripts(installed["modules"])
             else:
                 console.print(f"[dim]  {i18n.t('cli.list.no_modules')}[/]")
+                console.print(f"[dim]  {i18n.t('cli.list.empty_hint')}[/]")
 
         elif pkg_type == "adapters" and installed["adapters"]:
             table = Table(
@@ -154,11 +155,13 @@ class ListCommand(Command):
                 )
             else:
                 console.print(f"[dim]  {i18n.t('cli.list.no_adapters')}[/]")
+                console.print(f"[dim]  {i18n.t('cli.list.empty_hint')}[/]")
 
         elif not installed.get(pkg_type, {}):
             console.print(
                 f"[dim]  {i18n.t('cli.list.no_packages', pkg_type=pkg_type)}[/]"
             )
+            console.print(f"[dim]  {i18n.t('cli.list.empty_hint')}[/]")
 
     def _is_package_outdated(
         self,

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

@@ -205,6 +205,7 @@ TRANSLATIONS = {
     "cli.list.count_adapters": "{count} adapter(s)",
     "cli.list.no_adapters": "No matching adapters",
     "cli.list.no_packages": "No {pkg_type}",
+    "cli.list.empty_hint": "Run 'epsdk install' to browse and install components, or 'epsdk init' to create a project",
     # ==================== list-remote command ====================
     "cli.list_remote.description": "List remote available components",
     "cli.list_remote.type_help": "List type (default: all)",
@@ -416,6 +417,8 @@ TRANSLATIONS = {
     "cli.doctor.proxy_none": "none detected",
     "cli.doctor.failed": "[done] Issues found, see output above",
     "cli.doctor.all_ok": "[done] Environment is healthy",
+    "cli.doctor.status_ok": "OK",
+    "cli.doctor.status_fail": "FAIL",
     # ==================== types command ====================
     "cli.types.description": "Generate type stub file to enable IDE completion",
     "cli.types.output_help": "Output file path (default: ./_ep_types.py)",

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

@@ -205,6 +205,7 @@ TRANSLATIONS = {
     "cli.list.count_adapters": "{count} 個のアダプター",
     "cli.list.no_adapters": "該当するアダプターはありません",
     "cli.list.no_packages": "{pkg_type} はありません",
+    "cli.list.empty_hint": "'epsdk install' でコンポーネントを閲覧・インストールするか、'epsdk init' でプロジェクトを作成できます",
     # ==================== list-remote コマンド ====================
     "cli.list_remote.description": "リモートで利用可能なコンポーネントを一覧表示",
     "cli.list_remote.type_help": "一覧タイプ (デフォルト: all)",
@@ -416,6 +417,8 @@ TRANSLATIONS = {
     "cli.doctor.proxy_none": "検出されません",
     "cli.doctor.failed": "[完了] 対応が必要な問題があります。上記を確認してください",
     "cli.doctor.all_ok": "[完了] 環境は正常です",
+    "cli.doctor.status_ok": "OK",
+    "cli.doctor.status_fail": "NG",
     # ==================== types コマンド ====================
     "cli.types.description": "型スタブファイルを生成して IDE 補完を有効化",
     "cli.types.output_help": "出力ファイルパス（デフォルト: ./_ep_types.py）",

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

@@ -205,6 +205,7 @@ TRANSLATIONS = {
     "cli.list.count_adapters": "{count} адаптера(ов)",
     "cli.list.no_adapters": "Нет подходящих адаптеров",
     "cli.list.no_packages": "Нет {pkg_type}",
+    "cli.list.empty_hint": "Выполните 'epsdk install' для просмотра и установки компонентов, или 'epsdk init' для создания проекта",
     # ==================== команда list-remote ====================
     "cli.list_remote.description": "Список удаленно доступных компонентов",
     "cli.list_remote.type_help": "Тип списка (по умолчанию: all)",
@@ -416,6 +417,8 @@ TRANSLATIONS = {
     "cli.doctor.proxy_none": "не обнаружен",
     "cli.doctor.failed": "[готово] Есть проблемы, см. вывод выше",
     "cli.doctor.all_ok": "[готово] Окружение в порядке",
+    "cli.doctor.status_ok": "OK",
+    "cli.doctor.status_fail": "FAIL",
     # ==================== команда types ====================
     "cli.types.description": "Сгенерировать файл заглушек типов для автодополнения IDE",
     "cli.types.output_help": "Путь вывода (по умолчанию: ./_ep_types.py)",

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

@@ -205,6 +205,7 @@ TRANSLATIONS = {
     "cli.list.count_adapters": "{count} 个适配器",
     "cli.list.no_adapters": "没有符合条件的适配器",
     "cli.list.no_packages": "没有{pkg_type}",
+    "cli.list.empty_hint": "可运行 'epsdk install' 浏览并安装组件，或运行 'epsdk init' 创建项目",
     # ==================== list-remote 命令 ====================
     "cli.list_remote.description": "列出远程可用的组件",
     "cli.list_remote.type_help": "列出类型 (默认: all)",
@@ -416,6 +417,8 @@ TRANSLATIONS = {
     "cli.doctor.proxy_none": "未检测到",
     "cli.doctor.failed": "[诊断完成] 存在需要处理的问题，请参考上方输出",
     "cli.doctor.all_ok": "[诊断完成] 环境正常",
+    "cli.doctor.status_ok": "正常",
+    "cli.doctor.status_fail": "异常",
     # ==================== types 命令 ====================
     "cli.types.description": "生成类型存根文件，启用 IDE 补全",
     "cli.types.output_help": "输出文件路径（默认: ./_ep_types.py）",

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

@@ -205,6 +205,7 @@ TRANSLATIONS = {
     "cli.list.count_adapters": "{count} 個適配器",
     "cli.list.no_adapters": "沒有符合條件的適配器",
     "cli.list.no_packages": "沒有{pkg_type}",
+    "cli.list.empty_hint": "可執行 'epsdk install' 瀏覽並安裝元件，或執行 'epsdk init' 建立專案",
     # ==================== list-remote 命令 ====================
     "cli.list_remote.description": "列出遠端可用的元件",
     "cli.list_remote.type_help": "列出型別 (預設: all)",
@@ -416,6 +417,8 @@ TRANSLATIONS = {
     "cli.doctor.proxy_none": "未偵測到",
     "cli.doctor.failed": "[診斷完成] 存在需要處理的問題，請參考上方輸出",
     "cli.doctor.all_ok": "[診斷完成] 環境正常",
+    "cli.doctor.status_ok": "正常",
+    "cli.doctor.status_fail": "異常",
     # ==================== types 命令 ====================
     "cli.types.description": "生成類型存根檔案，啟用 IDE 補全",
     "cli.types.output_help": "輸出檔案路徑（預設: ./_ep_types.py）",

{erispulse-2.7.1.dev0 → erispulse-2.7.1.dev1}/src/ErisPulse/CLI/utils/display.py

@@ -9,6 +9,7 @@ from collections.abc import Callable
 from typing import Any
 
 from rich.box import SIMPLE
+from rich.markup import escape
 from rich.prompt import Prompt
 from rich.table import Table
 from rich.text import Text
@@ -45,7 +46,9 @@ def _input(prompt_label: str = ">") -> str:
     :param prompt_label: [str] 提示标签 (默认: ">")
     :return: [str] 用户输入内容（已去除首尾空白）
     """
-    console.print(f"  [dim]{prompt_label}[/] ", end="")
+    # 转义富文本标记
+    escaped = escape(prompt_label)
+    console.print(f"  [dim]{escaped}[/] ", end="")
     try:
         return input().strip()
     except (EOFError, KeyboardInterrupt):

{erispulse-2.7.1.dev0 → erispulse-2.7.1.dev1}/src/ErisPulse/Core/Event/base.py

@@ -59,7 +59,15 @@ async def _invoke_handler(handler_info: dict, event: Event) -> None:
         else:
             handler(event)
     except Exception as e:
-        logger.error(i18n.t("core.event.handler_error", error=e))
+        logger.error(
+            i18n.t(
+                "core.event.handler_error",
+                handler=_hname,
+                type=event.get("type", "") if isinstance(event, dict) else "",
+                owner=_owner or "<unknown>",
+                error=e,
+            )
+        )
         return
     finally:
         _elapsed = _time.monotonic() - _t

{erispulse-2.7.1.dev0 → erispulse-2.7.1.dev1}/src/ErisPulse/Core/adapter.py

@@ -1052,7 +1052,9 @@ class AdapterManager(ManagerBase):
             logger.error(i18n.t("core.adapter.platform_not_exist", platform=platform))
             return False
 
-        config.setConfig(CONFIG_KEY_ADAPTER_STATUS_OF.format(platform), True)
+        config.setConfig(
+            CONFIG_KEY_ADAPTER_STATUS_OF.format(platform), True, immediate=True
+        )
         logger.info(i18n.t("core.adapter.platform_enabled", platform=platform))
         return True
 
@@ -1075,7 +1077,9 @@ class AdapterManager(ManagerBase):
             logger.error(i18n.t("core.adapter.platform_not_exist", platform=platform))
             return False
 
-        config.setConfig(CONFIG_KEY_ADAPTER_STATUS_OF.format(platform), False)
+        config.setConfig(
+            CONFIG_KEY_ADAPTER_STATUS_OF.format(platform), False, immediate=True
+        )
         logger.info(i18n.t("core.adapter.platform_disabled", platform=platform))
         return True
 
@@ -1514,18 +1518,28 @@ class AdapterManager(ManagerBase):
                     # 调用过 wait_reply：纯等待属于交互白名单
                     if _pure > HANDLER_SLOW_THRESHOLD_SECS:
                         logger.warning(
-                            f"事件处理器执行缓慢 [{_func_name}] "
-                            f"耗时 {elapsed:.2f}s "
-                            f"(wait_reply={_wait_total:.2f}s, pure={_pure:.2f}s)"
-                            f" > {HANDLER_SLOW_THRESHOLD_SECS}s "
-                            f"type={event_type} platform={platform}{_owner_tag}"
+                            i18n.t(
+                                "core.adapter.handler_slow",
+                                handler=_func_name,
+                                elapsed=f"{elapsed:.2f}",
+                                threshold=HANDLER_SLOW_THRESHOLD_SECS,
+                                type=event_type,
+                                platform=platform,
+                                tag=_owner_tag,
+                            )
                         )
                     else:
                         logger.trace(
-                            f"事件处理器 [{_func_name}] 耗时 {elapsed:.2f}s "
-                            f"(wait_reply={_wait_total:.2f}s, pure={_pure:.2f}s) "
-                            f"interactive-wait, suppressed slow-warning "
-                            f"type={event_type} platform={platform}{_owner_tag}"
+                            i18n.t(
+                                "core.adapter.handler_slow_trace",
+                                handler=_func_name,
+                                elapsed=f"{elapsed:.2f}",
+                                wait=f"{_wait_total:.2f}",
+                                pure=f"{_pure:.2f}",
+                                type=event_type,
+                                platform=platform,
+                                tag=_owner_tag,
+                            )
                         )
                 elif elapsed > HANDLER_SLOW_THRESHOLD_SECS:
                     logger.warning(

{erispulse-2.7.1.dev0 → erispulse-2.7.1.dev1}/src/ErisPulse/Core/config.py

@@ -248,6 +248,9 @@ class ConfigManager:
             else:
                 self._cache = config
                 self._cache_timestamp = time.time()
+                # 外部修改重载后，丢弃与新文件一致的待写键，
+                # 避免陈旧的整棵/叶子脏键在下次 flush 时覆盖用户热更新
+                self._drop_redundant_dirty_keys()
                 if not self._cache:
                     self._log_config_error(
                         i18n.t("core.config.loaded_empty", path=self.CONFIG_FILE),
@@ -255,6 +258,32 @@ class ConfigManager:
                     )
                 return True
 
+    def _drop_redundant_dirty_keys(self) -> None:
+        """
+        丢弃与新配置文件内容一致的待写键
+
+        配置重载（外部修改）后，部分待写键的值可能已与文件一致，
+        继续保留会在下次 flush 时用陈旧快照覆盖用户热更新。
+        仅当待写值已反映在缓存（即文件）中时才丢弃；真正未落盘的写入仍保留。
+
+        {!--< internal-use >!--}
+        {!--< /internal-use >!--}
+        """
+        if not self._dirty_keys:
+            return
+        for key in list(self._dirty_keys):
+            value = self._dirty_keys[key]
+            current = self._cache
+            found = True
+            for k in key.split("."):
+                if isinstance(current, dict) and k in current:
+                    current = current[k]
+                else:
+                    found = False
+                    break
+            if found and current == value:
+                del self._dirty_keys[key]
+
     @staticmethod
     def _log_config_error(message: str, level: str = "error") -> None:
         """

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

@@ -53,6 +53,12 @@ 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
+
 # ==============================================================================
 # 配置键模板
 #
@@ -766,6 +772,7 @@ __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.dev0 → erispulse-2.7.1.dev1}/src/ErisPulse/Core/i18n/locales/en.py

@@ -33,6 +33,8 @@ TRANSLATIONS = {
     "core.sdk.init.disabled_modules": "Disabled modules: {names}",
     "core.sdk.init.strict_rejected": "Rejected by strict mode ({count}):",
     "core.sdk.init.strict_rejected_reason": "({reason})",
+    "core.sdk.init.strict_tolerated": "Lenient mode: {count} component(s) have compliance issues but were loaded:",
+    "core.sdk.init.strict_action_hint": "To load skipped components, set ErisPulse.framework.strict_mode = 0, or add exemptions under ErisPulse.framework.strict_mode_exceptions.",
     "core.sdk.init.success": "SDK initialized successfully (duration: {duration})",
     "core.sdk.init.module_init_complete": "Module initialization complete",
     "core.sdk.init.module_init_partial_failed": "Module initialization partially failed",
@@ -164,6 +166,7 @@ TRANSLATIONS = {
     "core.adapter.bot_online": "Bot {platform}/{bot_id} online",
     "core.adapter.handler_error": "Event handler execution error [{handler}] type={type} platform={platform}: {error}",
     "core.adapter.handler_slow": "Event handler execution slow [{handler}] elapsed {elapsed}s > {threshold}s type={type} platform={platform}{tag}",
+    "core.adapter.handler_slow_trace": "Event handler [{handler}] took {elapsed}s (wait_reply={wait}s, pure={pure}s) interactive-wait, suppressed slow-warning type={type} platform={platform}{tag}",
     "core.adapter.handler_drain_timeout": "{count} pending event handler(s) did not exit within {timeout}s, force cancelled",
     "core.adapter.lifecycle_hooks_cleaned": "Adapter {platform} cleaned {count} lifecycle hook(s)",
     "core.adapter.auto_discover_bot": "Auto-discovered Bot: {platform}/{bot_id}",
@@ -253,6 +256,9 @@ TRANSLATIONS = {
     "core.router.started": "Router server started",
     "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",
@@ -303,7 +309,7 @@ TRANSLATIONS = {
     "core.config.toml_malformed": "Configuration file {path} has a syntax error (line {line}, column {col}): {reason}",
     "core.config.flush_malformed": "Configuration file {path} is corrupted (syntax error, line {line}, column {col}: {reason}); cannot merge-write. Please fix the config file and restart. Pending changes have been preserved.",
     "core.config.permission_denied": "Permission denied when reading configuration file {path} (file may lack read access)",
-    "core.config.using_defaults_warning": "Fell back to default configuration — your custom settings were NOT applied. Please fix the issue and restart.",
+    "core.config.using_defaults_warning": "Failed to load the configuration file. Continuing with the last valid configuration; your recent edits were NOT applied. Fix the issue, then reload or restart.",
     "core.config.loaded_empty": "Configuration file {path} was loaded but is empty",
     "core.config.watcher_error": "Config watcher task error: {error}",
     "core.config.restart_required": "Configuration '{key}' changed; a process restart is required to take effect",
@@ -327,6 +333,7 @@ TRANSLATIONS = {
     # ==================== Loader ====================
     "loader.adapter.discovered": "Discovered {count} adapters",
     "loader.adapter.none": "No adapters found",
+    "loader.adapter.discovery_failed": "Adapter discovery failed, environment/dependency issue may be the cause: {error}",
     "loader.adapter.load_failed": "Failed to load {group} entry-points: {error}",
     "loader.adapter.systemexit": "SystemExit({code}) triggered while loading {group}, process exit blocked. Do not use sys.exit() or raise SystemExit",
     "loader.adapter.load_single_failed": "Failed to load adapter {name}, skipped: {error}",
@@ -340,6 +347,7 @@ TRANSLATIONS = {
     "loader.adapter.register_skipped": "Adapter {name} registration failed, skipped",
     "loader.module.discovered": "Discovered {count} modules",
     "loader.module.none": "No modules found",
+    "loader.module.discovery_failed": "Module discovery failed, environment/dependency issue may be the cause: {error}",
     "loader.module.load_failed": "Failed to load {group} entry-points: {error}",
     "loader.module.load_single_failed": "Failed to load module {name} from entry-point, skipped: {error}",
     "loader.module.diag_hint": "  → Hint: raise the log level to DEBUG for the full traceback; check the implementation of module {name}",
@@ -359,8 +367,30 @@ TRANSLATIONS = {
     "loader.module.mount_lazy": "Mounting lazy-load module to sdk: {name}",
     "loader.module.mount_eager": "Mounting eager-load module to sdk: {name}",
     "loader.module.init_lazy_start": "Initializing lazy-load module {name}...",
+    "loader.module.systemexit_group": "SystemExit({code}) triggered while loading {group}, process exit blocked. Do not use sys.exit() or raise SystemExit",
+    "loader.module.systemexit_single": "Module {name} attempted to exit process (SystemExit({code})), skipped. Do not use sys.exit() or raise SystemExit",
+    "loader.module.strategy_failed": "Failed to call {method}() on module {name}: {error}",
+    "loader.module.lazy_init_failed": "Lazy-load module {name} initialization failed: {error}",
+    "loader.module.sync_init_failed": "Lazy-load module {name} synchronous initialization failed: {error}",
+    "loader.module.background_init_failed": "Lazy-load module {name} background initialization failed: {error}",
+    "loader.module.async_init_hint": "Module {name} requires async initialization, please call it in an async context",
+    "loader.module.lazy_init_done": "Lazy-load module {name} initialization complete",
+    "loader.module.sync_init_start": "Synchronously initializing lazy-load module {name}...",
+    "loader.module.sync_init_done": "Lazy-load module {name} synchronous initialization complete",
+    "loader.module.needs_async_load": "Module {name} requires async initialization, use 'await sdk.load_module(\"{name}\")' to initialize it",
+    "loader.module.init_failed_attr_get": "Module {name} initialization failed, cannot access attribute '{attr}'",
+    "loader.module.init_failed_attr_set": "Module {name} initialization failed, cannot set attribute '{attr}'",
+    # ==================== Base Loader ====================
+    "loader.base.load_start": "Loading {group} entry-points...",
+    "loader.base.load_done": "{group} loaded",
+    "loader.base.load_failed": "Failed to load {group} entry-points: {error}",
+    "loader.base.import_failed": "Failed to import {group}: {error}",
+    "loader.base.registered": "{prefix} {name} registered and {status}",
+    "loader.base.status_enabled": "enabled",
+    "loader.base.status_disabled": "disabled",
     # ==================== Strict Mode ====================
     "loader.strict.config_failed": "Failed to read strict_mode config, using default: {error}",
+    "loader.strict.invalid_level": "Invalid value '{value}' for ErisPulse.framework.strict_mode. Valid values are 0 (lenient), 1 (skip), 2 (fatal). Using default level ({level}).",
     "loader.strict.exempted": "{type} '{name}' is exempted from strict mode ({reason}), continuing to load",
     "loader.strict.tolerated": "Lenient mode: {type} '{name}' {reason}, attempting to load",
     "loader.strict.rejected": "Strict mode: skipped {type} '{name}' ({reason}). To load it anyway, add exemption in ErisPulse.framework.strict_mode_exceptions.{list_key}, or set ErisPulse.framework.strict_mode = 0",
@@ -368,6 +398,13 @@ TRANSLATIONS = {
     "loader.strict.fatal_report_header": "Strict mode (fatal) detected {count} violation(s), aborting startup:",
     "loader.strict.fatal_report_item": "  [{index}] {type} '{name}': {reason} {detail}",
     "loader.strict.fatal_abort": "Strict mode (fatal): {count} violation(s) collected, startup aborted",
+    # ==================== Finder ====================
+    "finder.remote_load_unavailable": "_RemoteEntryPoint.load() is unavailable: cross-environment queries cannot load target-environment entry-point objects in the current process. Resolve via .value or call within the target environment.",
+    "finder.query_started": "Looking up {group} entry-points...",
+    "finder.found_count": "Found {count} {group} entry-points",
+    "finder.entry_points_query_failed": "Failed to find {group} entry-points: {error}",
+    "finder.remote_query_failed": "Failed to query {group} entry-points in target environment {python}: {stderr}",
+    "finder.remote_query_exception": "Failed to query entry-points in target environment {python}: {error}",
     # ==================== Storage Router Display ====================
     "core.router.lan_ipv4": "LAN IPv4",
     "core.router.lan_ipv6": "LAN IPv6",
@@ -377,13 +414,14 @@ TRANSLATIONS = {
     "core.logger.saved": "Logs have been saved to: {path}.",
     "core.logger.save_failed": "Failed to save logs to {path}: {error}.",
     "core.logger.invalid_level": "Invalid log level: {level}",
+    "core.logger.invalid_format": "Invalid log format: {fmt}. Valid values are rich, plain, json.",
     "core.logger.module_level_set": "Module {module} log level set to {level}",
     "core.logger.set_output_failed": "Failed to set log file {path}: {error}",
     "core.logger.no_output_set": "Failed to set any log file.",
     "core.logger.memory_limit_invalid": "Log memory limit must be greater than 0.",
     "core.logger.attr.did_you_mean": "Logger module name '{input}' is very similar to registered '{suggestion}', possibly a typo",
     # ==================== Event System ====================
-    "core.event.handler_error": "Event handler execution error: {error}",
+    "core.event.handler_error": "Event handler execution error [{handler}] type={type} owner={owner}: {error}",
     "core.event.slow_handler_wait": "[EventHandler] Slow handler {handler} took {elapsed}s (wait_reply={wait}s, pure={pure}s, waits=[{waits}]){owner}",
     "core.event.trace_handler_wait": "[EventHandler] {handler} took {elapsed}s (wait_reply={wait}s, pure={pure}s) interactive-wait, suppressed slow-warning{owner}",
     "core.event.slow_handler": "[EventHandler] Slow handler {handler} took {elapsed}s{owner}",