ErisPulse 2.5.2.dev2__tar.gz → 2.5.2.dev3__tar.gz

{erispulse-2.5.2.dev2 → erispulse-2.5.2.dev3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.5.2.dev2
+Version: 2.5.2.dev3
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Project-URL: Homepage, https://github.com/ErisPulse/ErisPulse
 Project-URL: Documentation, https://www.erisdev.com#docs

{erispulse-2.5.2.dev2 → erispulse-2.5.2.dev3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.5.2-dev.2"
+version = "2.5.2-dev.3"
 description = "ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。"
 readme = "README.md"
 requires-python = ">=3.10"

{erispulse-2.5.2.dev2 → erispulse-2.5.2.dev3}/src/ErisPulse/Core/adapter.py

@@ -701,12 +701,12 @@ class AdapterManager(ManagerBase):
 
     # ==================== 适配器配置管理 ====================
 
-    def _config_register(self, platform: str, enabled: bool = False) -> bool:
+    def _config_register(self, platform: str, enabled: bool = True) -> bool:
         """
         注册新平台适配器（仅当平台不存在时注册）
 
         :param platform: 平台名称
-        :param enabled: [bool] 是否启用适配器
+        :param enabled: [bool] 是否启用适配器 (默认: True，新适配器默认启用)
         :return: [bool] 操作是否成功
         """
         existing = config.getConfig(CONFIG_KEY_ADAPTER_STATUS_OF.format(platform))
@@ -745,16 +745,17 @@ class AdapterManager(ManagerBase):
         1. 适配器在配置文件中（ErisPulse.adapters.status.{platform} 存在）
         2. 配置值为启用状态
 
-        如果适配器未在配置中，返回 False
+        如果适配器未在配置中，默认启用并自动写入配置
         {!--< /tips >!--}
         """
         from .config import parse_bool_config
 
         status = config.getConfig(CONFIG_KEY_ADAPTER_STATUS_OF.format(platform))
 
-        # 适配器未在配置中，返回 False
+        # 适配器未在配置中，默认启用并写入配置
         if status is None:
-            return False
+            config.setConfig(CONFIG_KEY_ADAPTER_STATUS_OF.format(platform), True)
+            return True
 
         return parse_bool_config(status)
 
@@ -825,9 +826,16 @@ class AdapterManager(ManagerBase):
         """
         列出所有平台适配器状态
 
+        合并配置项与已注册适配器，确保禁用适配器也可见。
+
         :return: {平台名: 是否启用} 字典
         """
-        return config.getConfig(CONFIG_KEY_ADAPTER_STATUS, {})
+        items = dict(config.getConfig(CONFIG_KEY_ADAPTER_STATUS, {}))
+        # 补充已在管理器中注册但配置中不存在的适配器
+        for platform in self._adapters:
+            if platform not in items:
+                items[platform] = self.is_enabled(platform)
+        return items
 
     # 兼容性方法 - 保持向后兼容
     def list_adapters(self) -> dict[str, bool]:
@@ -1387,6 +1395,7 @@ class AdapterManager(ManagerBase):
         获取适配器与Bot的完整状态摘要
 
         返回所有适配器的运行状态及各适配器下的Bot状态，便于WebUI展示。
+        包含已禁用适配器以便于管理。
 
         :return: 状态摘要字典
 
@@ -1403,10 +1412,17 @@ class AdapterManager(ManagerBase):
         >>> #                     "info": {"nickname": "MyBot"}
         >>> #                 }
         >>> #             }
+        >>> #         },
+        >>> #         "disabled_platform": {
+        >>> #             "status": "disabled",
+        >>> #             "enabled": False,
+        >>> #             "bots": {}
         >>> #         }
         >>> #     }
         >>> # }
         """
+        from .config import parse_bool_config
+
         adapters_summary = {}
         for platform_name in self._adapters:
             adapter_instance = self._adapters[platform_name]
@@ -1417,9 +1433,20 @@ class AdapterManager(ManagerBase):
 
             adapters_summary[platform_name] = {
                 "status": adapter_status,
+                "enabled": self.is_enabled(platform_name),
                 "bots": dict(self._bots.get(platform_name, {})),
             }
 
+        # 补充配置中存在但未注册的适配器（被禁用的适配器），方便管理界面显示并开启
+        config_status = config.getConfig(CONFIG_KEY_ADAPTER_STATUS, {})
+        for platform_name in config_status:
+            if platform_name not in adapters_summary:
+                adapters_summary[platform_name] = {
+                    "status": "disabled",
+                    "enabled": parse_bool_config(config_status[platform_name]),
+                    "bots": {},
+                }
+
         return {"adapters": adapters_summary}
 
     # ==================== 工具方法 ====================

{erispulse-2.5.2.dev2 → erispulse-2.5.2.dev3}/src/ErisPulse/Core/adapter.pyi

@@ -119,7 +119,7 @@ class AdapterManager(ManagerBase):
         注册新平台适配器（仅当平台不存在时注册）
         
         :param platform: 平台名称
-        :param enabled: [bool] 是否启用适配器
+        :param enabled: [bool] 是否启用适配器 (默认: True，新适配器默认启用)
         :return: [bool] 操作是否成功
         """
         ...
@@ -143,7 +143,7 @@ class AdapterManager(ManagerBase):
         1. 适配器在配置文件中（ErisPulse.adapters.status.{platform} 存在）
         2. 配置值为启用状态
         
-        如果适配器未在配置中，返回 False
+        如果适配器未在配置中，默认启用并自动写入配置
         {!--< /tips >!--}
         """
         ...
@@ -174,6 +174,8 @@ class AdapterManager(ManagerBase):
         """
         列出所有平台适配器状态
         
+        合并配置项与已注册适配器，确保禁用适配器也可见。
+        
         :return: {平台名: 是否启用} 字典
         """
         ...
@@ -298,6 +300,7 @@ class AdapterManager(ManagerBase):
         获取适配器与Bot的完整状态摘要
         
         返回所有适配器的运行状态及各适配器下的Bot状态，便于WebUI展示。
+        包含已禁用适配器以便于管理。
         
         :return: 状态摘要字典
         
@@ -314,6 +317,11 @@ class AdapterManager(ManagerBase):
         >>> #                     "info": {"nickname": "MyBot"}
         >>> #                 }
         >>> #             }
+        >>> #         },
+        >>> #         "disabled_platform": {
+        >>> #             "status": "disabled",
+        >>> #             "enabled": False,
+        >>> #             "bots": {}
         >>> #         }
         >>> #     }
         >>> # }

{erispulse-2.5.2.dev2 → erispulse-2.5.2.dev3}/src/ErisPulse/Core/module.py

@@ -451,7 +451,7 @@ class ModuleManager(ManagerBase):
 
     # ==================== 模块配置管理 ====================
 
-    def _config_register(self, module_name: str, enabled: bool = False) -> bool:
+    def _config_register(self, module_name: str, enabled: bool = True) -> bool:
         """
         注册新模块信息
 
@@ -459,7 +459,7 @@ class ModuleManager(ManagerBase):
         此方法仅供内部使用
 
         :param module_name: 模块名称
-        :param enabled: 是否启用模块 (默认: False)
+        :param enabled: 是否启用模块 (默认: True，新模块默认启用)
         :return: 操作是否成功
         """
         existing = config.getConfig(CONFIG_KEY_MODULE_STATUS_OF.format(module_name))
@@ -490,16 +490,17 @@ class ModuleManager(ManagerBase):
         1. 模块在配置文件中（ErisPulse.modules.status.{module_name} 存在）
         2. 配置值为启用状态
 
-        如果模块未在配置中，返回 False
+        如果模块未在配置中，默认启用并自动写入配置
         {!--< /tips >!--}
         """
         from .config import parse_bool_config
 
         status = config.getConfig(CONFIG_KEY_MODULE_STATUS_OF.format(module_name))
 
-        # 模块未在配置中，返回 False
+        # 模块未在配置中，默认启用并写入配置
         if status is None:
-            return False
+            config.setConfig(CONFIG_KEY_MODULE_STATUS_OF.format(module_name), True)
+            return True
 
         # 解析配置值
         return parse_bool_config(status)
@@ -641,9 +642,16 @@ class ModuleManager(ManagerBase):
         """
         列出所有模块状态
 
+        合并配置项与已注册模块，确保禁用模块也可见。
+
         :return: [dict[str, bool]] {模块名: 是否启用} 字典
         """
-        return config.getConfig(CONFIG_KEY_MODULES_STATUS, {})
+        items = dict(config.getConfig(CONFIG_KEY_MODULES_STATUS, {}))
+        # 补充已在管理器中注册但配置中不存在的模块
+        for name in self._module_classes:
+            if name not in items:
+                items[name] = self.is_enabled(name)
+        return items
 
     def get_info(self, module_name: str) -> dict | None:
         """
@@ -661,7 +669,8 @@ class ModuleManager(ManagerBase):
         """
         获取模块的完整状态摘要
 
-        便于WebUI展示所有模块的注册、加载和启用状态。
+        便于WebUI展示所有模块的注册、加载和启用状态，
+        包含已禁用模块以便于管理。
 
         :return: 状态摘要字典
 
@@ -673,10 +682,17 @@ class ModuleManager(ManagerBase):
         >>> #             "status": "loaded",
         >>> #             "enabled": True,
         >>> #             "is_base_module": True
+        >>> #         },
+        >>> #         "DisabledModule": {
+        >>> #             "status": "disabled",
+        >>> #             "enabled": False,
+        >>> #             "is_base_module": None
         >>> #         }
         >>> #     }
         >>> # }
         """
+        from .config import parse_bool_config
+
         modules_summary = {}
         for name in self._module_classes:
             module_class = self._module_classes[name]
@@ -685,6 +701,17 @@ class ModuleManager(ManagerBase):
                 "enabled": self.is_enabled(name),
                 "is_base_module": self._is_subclass(module_class, BaseModule),
             }
+
+        # 补充配置中存在但未加载的模块（被禁用的模块），方便管理界面显示并开启
+        config_status = config.getConfig(CONFIG_KEY_MODULES_STATUS, {})
+        for name in config_status:
+            if name not in modules_summary:
+                modules_summary[name] = {
+                    "status": "disabled",
+                    "enabled": parse_bool_config(config_status[name]),
+                    "is_base_module": None,
+                }
+
         return {"modules": modules_summary}
 
     # 兼容性方法 - 保持向后兼容

{erispulse-2.5.2.dev2 → erispulse-2.5.2.dev3}/src/ErisPulse/Core/module.pyi

@@ -174,7 +174,7 @@ class ModuleManager(ManagerBase):
         1. 模块在配置文件中（ErisPulse.modules.status.{module_name} 存在）
         2. 配置值为启用状态
         
-        如果模块未在配置中，返回 False
+        如果模块未在配置中，默认启用并自动写入配置
         {!--< /tips >!--}
         """
         ...
@@ -198,6 +198,8 @@ class ModuleManager(ManagerBase):
         """
         列出所有模块状态
         
+        合并配置项与已注册模块，确保禁用模块也可见。
+        
         :return: [dict[str, bool]] {模块名: 是否启用} 字典
         """
         ...
@@ -216,7 +218,8 @@ class ModuleManager(ManagerBase):
         """
         获取模块的完整状态摘要
         
-        便于WebUI展示所有模块的注册、加载和启用状态。
+        便于WebUI展示所有模块的注册、加载和启用状态，
+        包含已禁用模块以便于管理。
         
         :return: 状态摘要字典
         
@@ -228,6 +231,11 @@ class ModuleManager(ManagerBase):
         >>> #             "status": "loaded",
         >>> #             "enabled": True,
         >>> #             "is_base_module": True
+        >>> #         },
+        >>> #         "DisabledModule": {
+        >>> #             "status": "disabled",
+        >>> #             "enabled": False,
+        >>> #             "is_base_module": None
         >>> #         }
         >>> #     }
         >>> # }

{erispulse-2.5.2.dev2 → erispulse-2.5.2.dev3}/src/ErisPulse/Core/storage.py

@@ -517,6 +517,24 @@ class StorageManager(BaseStorage):
         ):
             conn.commit()
 
+    def _open_connection(self) -> sqlite3.Connection:
+        """
+        {!--< internal-use >!--}
+        打开一个新的 SQLite 连接并应用标准 PRAGMA
+
+        - journal_mode=WAL：持久化在数据库文件头，重复设置无副作用
+        - synchronous=NORMAL：per-connection 设置，必须在每个新连接上重新应用。
+          此前仅在 _init_db 的临时连接上设置过一次，而该 PRAGMA 不跨连接持久化，
+          导致事务外的 get/set 等高频操作实际回落到默认的 synchronous=FULL
+          （每次 commit 都触发 fsync），与文档宣称的 WAL+NORMAL 提速不符。
+
+        :return: 已应用标准 PRAGMA 的 sqlite3.Connection
+        """
+        conn = sqlite3.connect(self.db_path)
+        conn.execute(SQLITE_JOURNAL_MODE)
+        conn.execute(SQLITE_SYNCHRONOUS_MODE)
+        return conn
+
     @contextmanager
     def _get_connection(self) -> sqlite3.Connection:  # type: ignore
         """
@@ -524,7 +542,7 @@ class StorageManager(BaseStorage):
         获取数据库连接（支持事务）
 
         如果在事务中，返回事务的连接
-        否则创建新连接
+        否则新建一个应用了标准 PRAGMA 的短生命周期连接
 
         :return: sqlite3.Connection 数据库连接
         """
@@ -536,7 +554,7 @@ class StorageManager(BaseStorage):
             conn = self._local.transaction_conn
             should_close = False
         else:
-            conn = sqlite3.connect(self.db_path)
+            conn = self._open_connection()
             should_close = True
 
         try:
@@ -574,11 +592,8 @@ class StorageManager(BaseStorage):
             pass  # 如果无法创建目录，则继续尝试连接数据库
 
         try:
-            conn = sqlite3.connect(self.db_path)
-
-            # 启用WAL模式提高并发性能
-            conn.execute(SQLITE_JOURNAL_MODE)
-            conn.execute(SQLITE_SYNCHRONOUS_MODE)
+            # 连接创建统一走 _open_connection，确保 WAL/synchronous PRAGMA 一致应用
+            conn = self._open_connection()
 
             cursor = conn.cursor()
             cursor.execute("""
@@ -1195,7 +1210,7 @@ class StorageManager(BaseStorage):
 
             :return: 事务对象
             """
-            self.conn = sqlite3.connect(self.storage_manager.db_path)
+            self.conn = self.storage_manager._open_connection()
             self.cursor = self.conn.cursor()
             self.cursor.execute("BEGIN TRANSACTION")
             # 将连接存储到线程本地存储，供其他方法复用

{erispulse-2.5.2.dev2 → erispulse-2.5.2.dev3}/src/ErisPulse/loaders/bases/loader.py

@@ -181,13 +181,15 @@ class BaseLoader(ABC):
 
         {!--< internal-use >!--}
         内部方法，用于获取配置状态
+        默认情况下（无配置），返回 True（启用）并写入配置
         {!--< /internal-use >!--}
         """
         config_key = f"{self._config_prefix}.status.{name}"
         status = config.getConfig(config_key)
 
         if status is None:
-            return False
+            config.setConfig(config_key, True)
+            return True
 
         if isinstance(status, str):
             return status.lower() not in ("false", "0", "no", "off")