ErisPulse 2.6.2__tar.gz → 2.6.3.dev0__tar.gz

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/PKG-INFO

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

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

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/Bases/__init__.py

@@ -20,7 +20,7 @@ from .errors import (
     WebSocketDisconnect,
 )
 from .websocket import WebSocketConnectionBase, WSMessage
-from .router import HttpRequest, WebSocketConnection
+from .router import HttpRequest, WebSocketConnection, SseEmitter
 from .client import BaseHttpClient, BaseHttpResponse, BaseClientWebSocket
 
 __all__ = [
@@ -43,6 +43,7 @@ __all__ = [
     "SendBuilder",
     "SendContext",
     "SendDSL",
+    "SseEmitter",
     "WSMessage",
     "WebSocketConnection",
     "WebSocketConnectionBase",

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/Bases/__init__.pyi

@@ -15,5 +15,5 @@ from .storage import BaseStorage, BaseQueryBuilder
 from .kv_builder import KVQueryBuilder
 from .errors import ErisPulseError, ClientError, ClientConnectionError, ClientTimeoutError, HTTPStatusError, WebSocketError, WebSocketDisconnect
 from .websocket import WebSocketConnectionBase, WSMessage
-from .router import HttpRequest, WebSocketConnection
+from .router import HttpRequest, WebSocketConnection, SseEmitter
 from .client import BaseHttpClient, BaseHttpResponse, BaseClientWebSocket

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/Bases/client.py

@@ -330,3 +330,10 @@ class BaseHttpClient:
         重置统计数据
         """
         raise NotImplementedError
+
+
+__all__ = [
+    "BaseClientWebSocket",
+    "BaseHttpClient",
+    "BaseHttpResponse",
+]

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/Bases/errors.py

@@ -129,3 +129,14 @@ class WebSocketDisconnect(WebSocketError):
         self.code = code
         self.reason = reason or ""
         super().__init__(f"code={self.code}, reason={self.reason}")
+
+
+__all__ = [
+    "ClientConnectionError",
+    "ClientError",
+    "ClientTimeoutError",
+    "ErisPulseError",
+    "HTTPStatusError",
+    "WebSocketDisconnect",
+    "WebSocketError",
+]

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/Bases/kv_builder.py

@@ -373,3 +373,8 @@ class KVQueryBuilder(BaseQueryBuilder):
 
     async def aExists(self) -> bool:
         return await self.aCount() > 0
+
+
+__all__ = [
+    "KVQueryBuilder",
+]

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/Bases/router.py

@@ -628,3 +628,10 @@ class SseEmitter:
         self._closed = True
         if self._on_close is not None:
             await self._on_close()
+
+
+__all__ = [
+    "HttpRequest",
+    "SseEmitter",
+    "WebSocketConnection",
+]

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/Bases/send_builder.py

@@ -465,3 +465,9 @@ class SendBuilder:
         except Exception:
             # 生命周期事件失败不应影响批量发送
             pass
+
+
+__all__ = [
+    "BatchContext",
+    "SendBuilder",
+]

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/Bases/send_rules.py

@@ -333,3 +333,9 @@ class _PriorityQueue:
     def reset(cls) -> None:
         """重置状态（主要用于测试）"""
         cls._inflight = 0
+
+
+__all__ = [
+    "SendContext",
+    "apply_send_rules",
+]

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/Bases/websocket.py

@@ -263,3 +263,9 @@ class WebSocketConnectionBase:
             return func
 
         return decorator
+
+
+__all__ = [
+    "WSMessage",
+    "WebSocketConnectionBase",
+]

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/adapter.py

@@ -138,6 +138,9 @@ class AdapterManager(ManagerBase):
         # 标记是否正在关闭，避免重复提交离线事件
         self._is_being_shutdown = False
 
+        # 注册配置变更路由：将 config.set / config.updated 事件转发到各适配器的 on_config_update
+        self._register_config_change_routing()
+
     def set_sdk_ref(self, sdk) -> bool:
         """
         设置 SDK 引用
@@ -152,6 +155,97 @@ class AdapterManager(ManagerBase):
             logger.error(i18n.t("core.adapter.set_sdk_failed", error=e))
             return False
 
+    # ==================== 配置变更路由 ====================
+
+    def _register_config_change_routing(self) -> None:
+        """
+        {!--< internal-use >!--}
+        注册 config.set / config.updated 事件订阅，将配置变更路由到各适配器的 on_config_update
+        """
+        lifecycle.register("config.set", self._on_config_set)
+        lifecycle.register("config.updated", self._on_config_updated)
+
+    def _on_config_set(self, data: dict) -> None:
+        """
+        {!--< internal-use >!--}
+        处理 config.set 事件：找出受影响的适配器并触发 on_config_update
+        """
+        key = data.get("key", "")
+        if not key:
+            return
+        for instance in list(self._started_instances):
+            if not hasattr(instance, "on_config_update"):
+                continue
+            config_key = self._resolve_config_key(instance)
+            if key == config_key or key.startswith(config_key + "."):
+                new_dict = config.getConfig(config_key) or {}
+                self._notify_config_update(instance, None, None, new_dict)
+
+    def _on_config_updated(self, data: dict) -> None:
+        """
+        {!--< internal-use >!--}
+        处理 config.updated 事件：对比新旧配置树，找出配置变化的适配器并触发 on_config_update
+        """
+        old_config = data.get("old_config", {}) or {}
+        new_config = data.get("new_config", {}) or {}
+        for instance in list(self._started_instances):
+            if not hasattr(instance, "on_config_update"):
+                continue
+            config_key = self._resolve_config_key(instance)
+            old_dict = old_config.get(config_key)
+            new_dict = new_config.get(config_key)
+            if old_dict != new_dict:
+                self._notify_config_update(instance, None, old_dict, new_dict)
+
+    @staticmethod
+    def _resolve_config_key(instance: Any) -> str:
+        """
+        {!--< internal-use >!--}
+        解析适配器的配置键名（优先用 _get_config_key，回退类名）
+        """
+        get_key = getattr(instance, "_get_config_key", None)
+        if callable(get_key):
+            try:
+                return get_key()
+            except Exception:
+                pass
+        return instance.__class__.__name__
+
+    def _notify_config_update(
+        self,
+        instance: Any,
+        platform: str | None,
+        old_dict: dict | None,
+        new_dict: dict | None,
+    ) -> None:
+        """
+        {!--< internal-use >!--}
+        调用适配器的 on_config_update 回调，传入类型安全的配置对象
+        """
+        config_class = getattr(instance, "ConfigClass", None)
+        try:
+            if config_class is not None:
+                from ..runtime.config_schema import dict_to_dataclass
+
+                old_config = (
+                    dict_to_dataclass(config_class, old_dict) if old_dict else None
+                )
+                new_config = (
+                    dict_to_dataclass(config_class, new_dict) if new_dict else None
+                )
+            else:
+                old_config = old_dict
+                new_config = new_dict
+            instance.on_config_update(old_config, new_config)
+        except Exception as e:
+            logger.error(
+                i18n.t(
+                    "core.adapter.config_update_failed",
+                    platform=platform or instance.__class__.__name__,
+                    error=e,
+                )
+            )
+
     # ==================== 适配器注册与管理 ====================
 
     def register(

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/client.py

@@ -946,3 +946,10 @@ class HttpClient(BaseHttpClient):
 
     async def __aexit__(self, *args):
         await self.close()
+
+
+__all__ = [
+    "ClientWebSocket",
+    "HttpClient",
+    "HttpResponse",
+]

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/config.py

@@ -272,6 +272,13 @@ class ConfigManager:
                     self._cache_timestamp = time.time()
                     self._dirty_keys.clear()
 
+                    # 同步记录的 mtime，避免文件监听任务把框架自身的写入误判为外部修改，
+                    # 从而重复触发 config.updated（与 config.set 路由重复调用 on_config_update）
+                    try:
+                        self._config_mtime = Path(self.CONFIG_FILE).stat().st_mtime
+                    except OSError:
+                        pass
+
                 except Exception as e:
                     try:
                         from .logger import logger

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/constants.py

@@ -620,3 +620,106 @@ DEFAULT_PROACTIVE_GC_INTERVAL_SECS: Final[int] = 300
 # 运行时行为。适配器关闭时取消所有 pending handler tasks 后等待它们退出的耐心时间。
 # 修改影响: 设大确保处理器完整结束，设小加速关闭流程。
 DEFAULT_HANDLER_DRAIN_TIMEOUT_SECS: Final[float] = 5.0
+
+__all__ = [
+    "ADAPTER_RETRY_BACKOFF_INTERVALS",
+    "ADAPTER_RETRY_FIXED_DELAY_SECS",
+    "CONFIG_CACHE_TIMEOUT_SECS",
+    "CONFIG_KEY_ADAPTER_STATUS",
+    "CONFIG_KEY_ADAPTER_STATUS_OF",
+    "CONFIG_KEY_MODULES_STATUS",
+    "CONFIG_KEY_MODULE_STATUS_OF",
+    "CONFIG_KEY_ROUTER_CORS",
+    "CONFIG_KEY_ROUTER_SECURITY",
+    "CONFIG_ROOT_KEY",
+    "CONFIG_WRITE_DELAY_SECS",
+    "CONFIRM_HINT_WORDS",
+    "CONFIRM_NO_WORDS",
+    "CONFIRM_YES_WORDS",
+    "CONVERSATION_KEY_PREFIX",
+    "DEFAULT_ADAPTER_ENABLED",
+    "DEFAULT_COMMAND_ALLOW_SPACE_PREFIX",
+    "DEFAULT_COMMAND_CASE_SENSITIVE",
+    "DEFAULT_COMMAND_DISPATCHER_PRIORITY",
+    "DEFAULT_COMMAND_MUST_AT_BOT",
+    "DEFAULT_COMMAND_PREFIX",
+    "DEFAULT_CONFIG_FILE_PATH",
+    "DEFAULT_CORS_HEADERS",
+    "DEFAULT_CORS_MAX_AGE_SECS",
+    "DEFAULT_CORS_METHODS",
+    "DEFAULT_CORS_ORIGINS",
+    "DEFAULT_EVENT_SOURCE",
+    "DEFAULT_HANDLER_DRAIN_TIMEOUT_SECS",
+    "DEFAULT_HANDLER_MAX_CONCURRENCY",
+    "DEFAULT_HANDLER_PRIORITY",
+    "DEFAULT_HTTP_CLIENT_CONNECT_TIMEOUT_SECS",
+    "DEFAULT_HTTP_CLIENT_MAX_RETRIES",
+    "DEFAULT_HTTP_CLIENT_RETRY_DELAY_SECS",
+    "DEFAULT_HTTP_CLIENT_TIMEOUT_SECS",
+    "DEFAULT_HTTP_CLIENT_USER_AGENT",
+    "DEFAULT_HTTP_METHODS",
+    "DEFAULT_I18N_LANGUAGE",
+    "DEFAULT_KV_TABLE_NAME",
+    "DEFAULT_LAZY_LOADING_ENABLED",
+    "DEFAULT_LOG_LEVEL",
+    "DEFAULT_LOG_MEMORY_LIMIT",
+    "DEFAULT_MAX_RETRIES",
+    "DEFAULT_MESSAGE_IGNORE_SELF",
+    "DEFAULT_MODULE_ENABLED",
+    "DEFAULT_MODULE_PRIORITY",
+    "DEFAULT_OFFLINE_BOT_EXPIRY_SECS",
+    "DEFAULT_PROACTIVE_GC_INTERVAL_SECS",
+    "DEFAULT_RATE_LIMIT_CLEANUP_INTERVAL_SECS",
+    "DEFAULT_RATE_LIMIT_MAX_REQUESTS",
+    "DEFAULT_RATE_LIMIT_WINDOW_SECS",
+    "DEFAULT_SECURITY_HEADERS",
+    "DEFAULT_SEND_METHOD",
+    "DEFAULT_SEND_TARGET_TYPE",
+    "DEFAULT_SERVER_HOST",
+    "DEFAULT_SERVER_PORT",
+    "DEFAULT_STRICT_MODE",
+    "DEFAULT_UNINIT_TIMEOUT_SECS",
+    "DEFAULT_USE_GLOBAL_DB",
+    "DEFAULT_WAIT_TIMEOUT_SECS",
+    "DEFAULT_WS_AUTO_ACCEPT",
+    "DEFAULT_WS_CLIENT_CONNECT_TIMEOUT_SECS",
+    "DEFAULT_WS_CLIENT_HEARTBEAT_SECS",
+    "DETAIL_TYPE_CONNECT",
+    "DETAIL_TYPE_DISCONNECT",
+    "DETAIL_TYPE_FRIEND",
+    "DETAIL_TYPE_FRIEND_DECREASE",
+    "DETAIL_TYPE_FRIEND_INCREASE",
+    "DETAIL_TYPE_GROUP",
+    "DETAIL_TYPE_GROUP_MEMBER_DECREASE",
+    "DETAIL_TYPE_GROUP_MEMBER_INCREASE",
+    "DETAIL_TYPE_HEARTBEAT",
+    "DETAIL_TYPE_PRIVATE",
+    "DETAIL_TYPE_USER",
+    "EVENT_TYPE_MESSAGE",
+    "EVENT_TYPE_META",
+    "EVENT_TYPE_NOTICE",
+    "EVENT_TYPE_REQUEST",
+    "FALLBACK_IPV4",
+    "FALLBACK_IPV6_HOST",
+    "HANDLER_SLOW_THRESHOLD_SECS",
+    "LIFECYCLE_TIMER_CORE_INIT",
+    "LIFECYCLE_TIMER_CORE_UNINIT",
+    "LOGGER_NAME",
+    "LOG_RICH_THEME",
+    "LOG_TIME_FORMAT",
+    "RETCODE_NOT_IMPLEMENTED",
+    "RETCODE_OK",
+    "SERVER_SHUTDOWN_TIMEOUT_SECS",
+    "SQLITE_JOURNAL_MODE",
+    "SQLITE_SYNCHRONOUS_MODE",
+    "STATUS_FAILED",
+    "STATUS_OK",
+    "STORAGE_MAX_LIST_INDEX",
+    "TEXT_METHOD_INDICATORS",
+    "UNINIT_SETTLE_DELAY_SECS",
+    "UNKNOWN_PLATFORM",
+    "WILDCARD_IPV4",
+    "WILDCARD_IPV6",
+    "WS_CLOSE_INTERNAL_ERROR",
+    "WS_CLOSE_POLICY_VIOLATION",
+]

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/i18n/locales/en.py

@@ -168,6 +168,7 @@ TRANSLATIONS = {
     "core.adapter.list_adapters_deprecated": "list_adapters() is deprecated, please use list_items() instead",
     "core.adapter.task_cancelled_debug": "Cancelled background startup task for platform {platform}",
     "core.adapter.platform_unregistered_short": "Platform {platform} not registered",
+    "core.adapter.config_update_failed": "Adapter {platform} config hot-reload callback failed: {error}",
     # ==================== Module Management ====================
     "core.module.set_sdk_failed": "Failed to set SDK reference: {error}",
     "core.module.param_must_be_class": "Parameter for module {name} must be a class, not {type}",
@@ -200,6 +201,7 @@ TRANSLATIONS = {
     "core.module.cleared": "Module manager has been fully cleared",
     "core.module.module_not_enabled": "Module {name} does not exist or is not enabled",
     "core.module.list_modules_deprecated": "list_modules() is deprecated, please use list_items() instead",
+    "core.module.config_update_failed": "Module {name} config hot-reload callback failed: {error}",
     # ==================== Router Management ====================
     "core.router.sse_path_exists": "SSE path {path} is already registered in module {module}",
     "core.router.register_sse": "[{module}] Registering SSE route: {path}",

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/i18n/locales/ja.py

@@ -168,6 +168,7 @@ TRANSLATIONS = {
     "core.adapter.list_adapters_deprecated": "list_adapters() は非推奨です、list_items() を使用してください",
     "core.adapter.task_cancelled_debug": "プラットフォーム {platform} のバックグラウンド起動タスクをキャンセルしました",
     "core.adapter.platform_unregistered_short": "プラットフォーム {platform} は登録されていません",
+    "core.adapter.config_update_failed": "アダプター {platform} の設定ホットリロードコールバックの実行に失敗しました: {error}",
     # ==================== モジュール管理 ====================
     "core.module.set_sdk_failed": "SDK 参照の設定に失敗しました: {error}",
     "core.module.param_must_be_class": "モジュール {name} のパラメーターはクラスでなければなりません、{type} ではありません",
@@ -200,6 +201,7 @@ TRANSLATIONS = {
     "core.module.cleared": "モジュールマネージャーは完全にクリアされました",
     "core.module.module_not_enabled": "モジュール {name} は存在しないか有効化されていません",
     "core.module.list_modules_deprecated": "list_modules() は非推奨です、list_items() を使用してください",
+    "core.module.config_update_failed": "モジュール {name} の設定ホットリロードコールバックの実行に失敗しました: {error}",
     # ==================== ルーター管理 ====================
     "core.router.sse_path_exists": "SSE パス {path} は既にモジュール {module} に登録されています",
     "core.router.register_sse": "[{module}] SSE ルートを登録しています: {path}",

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/i18n/locales/ru.py

@@ -168,6 +168,7 @@ TRANSLATIONS = {
     "core.adapter.list_adapters_deprecated": "list_adapters() устарел, используйте list_items()",
     "core.adapter.task_cancelled_debug": "Отменена фоновая задача запуска для платформы {platform}",
     "core.adapter.platform_unregistered_short": "Платформа {platform} не зарегистрирована",
+    "core.adapter.config_update_failed": "Сбой обратного вызова горячей перезагрузки конфигурации адаптера {platform}: {error}",
     # ==================== Управление модулями ====================
     "core.module.set_sdk_failed": "Ошибка установки ссылки на SDK: {error}",
     "core.module.param_must_be_class": "Параметр для модуля {name} должен быть классом, а не {type}",
@@ -200,6 +201,7 @@ TRANSLATIONS = {
     "core.module.cleared": "Менеджер модулей полностью очищен",
     "core.module.module_not_enabled": "Модуль {name} не существует или не включён",
     "core.module.list_modules_deprecated": "list_modules() устарел, используйте list_items()",
+    "core.module.config_update_failed": "Сбой обратного вызова горячей перезагрузки конфигурации модуля {name}: {error}",
     # ==================== Управление маршрутизацией ====================
     "core.router.sse_path_exists": "SSE путь {path} уже зарегистрирован в модуле {module}",
     "core.router.register_sse": "[{module}] Регистрация SSE маршрута: {path}",

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/i18n/locales/zh_cn.py

@@ -168,6 +168,7 @@ TRANSLATIONS = {
     "core.adapter.list_adapters_deprecated": "list_adapters() 已弃用，请使用 list_items() 代替",
     "core.adapter.task_cancelled_debug": "已取消平台 {platform} 的后台启动任务",
     "core.adapter.platform_unregistered_short": "平台 {platform} 未注册",
+    "core.adapter.config_update_failed": "适配器 {platform} 配置热更新回调执行失败: {error}",
     # ==================== 模块管理 ====================
     "core.module.set_sdk_failed": "设置SDK引用失败: {error}",
     "core.module.param_must_be_class": "模块 {name} 的参数必须是类，而不是 {type}",
@@ -200,6 +201,7 @@ TRANSLATIONS = {
     "core.module.cleared": "模块管理器已完全清理",
     "core.module.module_not_enabled": "模块 {name} 不存在或未启用",
     "core.module.list_modules_deprecated": "list_modules() 已弃用，请使用 list_items() 代替",
+    "core.module.config_update_failed": "模块 {name} 配置热更新回调执行失败: {error}",
     # ==================== 路由管理 ====================
     "core.router.sse_path_exists": "SSE路径 {path} 已在模块 {module} 中注册",
     "core.router.register_sse": "[{module}] 注册SSE路由: {path}",

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/i18n/locales/zh_tw.py

@@ -168,6 +168,7 @@ TRANSLATIONS = {
     "core.adapter.list_adapters_deprecated": "list_adapters() 已棄用，請使用 list_items() 代替",
     "core.adapter.task_cancelled_debug": "已取消平台 {platform} 的後台啟動任務",
     "core.adapter.platform_unregistered_short": "平台 {platform} 未註冊",
+    "core.adapter.config_update_failed": "適配器 {platform} 配置熱更新回呼執行失敗: {error}",
     # ==================== 模組管理 ====================
     "core.module.set_sdk_failed": "設定SDK參考失敗: {error}",
     "core.module.param_must_be_class": "模組 {name} 的參數必須是類別，而不是 {type}",
@@ -200,6 +201,7 @@ TRANSLATIONS = {
     "core.module.cleared": "模組管理器已完全清理",
     "core.module.module_not_enabled": "模組 {name} 不存在或未啟用",
     "core.module.list_modules_deprecated": "list_modules() 已棄用，請使用 list_items() 代替",
+    "core.module.config_update_failed": "模組 {name} 配置熱更新回呼執行失敗: {error}",
     # ==================== 路由管理 ====================
     "core.router.sse_path_exists": "SSE路徑 {path} 已在模組 {module} 中註冊",
     "core.router.register_sse": "[{module}] 註冊SSE路由: {path}",

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/master.py

@@ -249,3 +249,8 @@ class MasterManager:
 
 # 模块级单例
 master = MasterManager()
+
+__all__ = [
+    "MasterManager",
+    "master",
+]

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/Core/module.py

@@ -93,6 +93,8 @@ class ModuleManager(ManagerBase):
             str, Any
         ] = {}  # 懒加载代理（未触发初始化时 get() 返回它）
         self._sdk = None
+        # 注册配置变更路由：将 config.set / config.updated 事件转发到各模块的 on_config_update
+        self._register_config_change_routing()
 
     def set_sdk_ref(self, sdk) -> bool:
         """
@@ -110,6 +112,100 @@ class ModuleManager(ManagerBase):
             logger.error(i18n.t("core.module.set_sdk_failed", error=e))
             return False
 
+    # ==================== 配置变更路由 ====================
+
+    def _register_config_change_routing(self) -> None:
+        """
+        {!--< internal-use >!--}
+        注册 config.set / config.updated 事件订阅，将配置变更路由到各模块的 on_config_update
+
+        - ``config.set``：代码或 Dashboard 调用 setConfig 时即时触发（单 key 变更）
+        - ``config.updated``：用户手动编辑配置文件后由文件监听任务触发（整树变更）
+        """
+        lifecycle.register("config.set", self._on_config_set)
+        lifecycle.register("config.updated", self._on_config_updated)
+
+    def _on_config_set(self, data: dict) -> None:
+        """
+        {!--< internal-use >!--}
+        处理 config.set 事件：找出受影响的模块并触发 on_config_update
+        """
+        key = data.get("key", "")
+        if not key:
+            return
+        for module_name in list(self._loaded_modules):
+            instance = self._modules.get(module_name)
+            if not instance or not hasattr(instance, "on_config_update"):
+                continue
+            config_key = self._resolve_config_key(instance)
+            # key 形如 "MyModule" 或 "MyModule.field"
+            if key == config_key or key.startswith(config_key + "."):
+                new_dict = config.getConfig(config_key) or {}
+                self._notify_config_update(instance, module_name, None, new_dict)
+
+    def _on_config_updated(self, data: dict) -> None:
+        """
+        {!--< internal-use >!--}
+        处理 config.updated 事件：对比新旧配置树，找出配置变化的模块并触发 on_config_update
+        """
+        old_config = data.get("old_config", {}) or {}
+        new_config = data.get("new_config", {}) or {}
+        for module_name in list(self._loaded_modules):
+            instance = self._modules.get(module_name)
+            if not instance or not hasattr(instance, "on_config_update"):
+                continue
+            config_key = self._resolve_config_key(instance)
+            old_dict = old_config.get(config_key)
+            new_dict = new_config.get(config_key)
+            if old_dict != new_dict:
+                self._notify_config_update(instance, module_name, old_dict, new_dict)
+
+    @staticmethod
+    def _resolve_config_key(instance: Any) -> str:
+        """
+        {!--< internal-use >!--}
+        解析模块的配置键名（优先用注入的注册名，回退类名）
+        """
+        return getattr(instance, "_module_name", None) or instance.__class__.__name__
+
+    def _notify_config_update(
+        self,
+        instance: Any,
+        module_name: str,
+        old_dict: dict | None,
+        new_dict: dict | None,
+    ) -> None:
+        """
+        {!--< internal-use >!--}
+        调用模块的 on_config_update 回调，传入类型安全的配置对象
+
+        :param instance: 模块实例
+        :param module_name: 模块名（用于日志）
+        :param old_dict: 变更前的配置字典（可能为 None）
+        :param new_dict: 变更后的配置字典（可能为 None）
+        """
+        config_class = getattr(instance, "ConfigClass", None)
+        try:
+            if config_class is not None:
+                from ..runtime.config_schema import dict_to_dataclass
+
+                old_config = (
+                    dict_to_dataclass(config_class, old_dict) if old_dict else None
+                )
+                new_config = (
+                    dict_to_dataclass(config_class, new_dict) if new_dict else None
+                )
+            else:
+                old_config = old_dict
+                new_config = new_dict
+            instance.on_config_update(old_config, new_config)
+        except Exception as e:
+            logger.error(
+                i18n.t(
+                    "core.module.config_update_failed", name=module_name, error=e
+                )
+            )
+
     # ==================== 模块注册与管理 ====================
 
     def register(

{erispulse-2.6.2 → erispulse-2.6.3.dev0}/src/ErisPulse/__init__.py

@@ -59,15 +59,30 @@ uninit = sdk.uninit
 
 # 导出列表
 __all__ = [
+    "BaseAdapter",
+    "BatchContext",
+    "Event",
     "LazyModule",
+    "SendBuilder",
+    "SendContext",
+    "SendDSL",
     "__author__",
     "__version__",
+    "adapter",
+    "config",
+    "env",
+    "i18n",
     "init",
     "init_sync",
     "init_task",
+    "lifecycle",
     "load_module",
+    "logger",
+    "module",
     "restart",
+    "router",
     "run",
     "sdk",
+    "storage",
     "uninit",
 ]