ErisPulse 2.8.0.dev1__tar.gz → 2.8.1__tar.gz

{erispulse-2.8.0.dev1 → erispulse-2.8.1}/.gitignore

@@ -3,6 +3,7 @@ devs/videos
 main.py
 plugins/
 venvs
+config.full.example
 config.toml
 uv.lock
 snapshots/
@@ -16,6 +17,7 @@ config/config.db
 config/config.db-journal
 config/config.db-wal
 config/config.db-shm
+.erispulse_config.lock
 
 # site-packages
 config/.packages

{erispulse-2.8.0.dev1 → erispulse-2.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ErisPulse
-Version: 2.8.0.dev1
+Version: 2.8.1
 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
@@ -29,11 +29,16 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: aiosqlite>=0.20.0
 Requires-Dist: fastapi>=0.116.1
 Requires-Dist: rich>=13.0.0
-Requires-Dist: toml>=0.10.2
+Requires-Dist: tomlkit>=0.15.1
 Requires-Dist: uvicorn>=0.30.0
 Requires-Dist: websockets>=12.0
+Provides-Extra: mysql
+Requires-Dist: aiomysql>=0.2.0; extra == 'mysql'
+Provides-Extra: postgres
+Requires-Dist: asyncpg>=0.29.0; extra == 'postgres'
 Provides-Extra: test
 Requires-Dist: httpx>=0.24.0; extra == 'test'
 Requires-Dist: pytest-asyncio>=0.21.0; extra == 'test'
@@ -44,8 +49,6 @@ Requires-Dist: pytest-xdist>=3.0.0; extra == 'test'
 Requires-Dist: pytest>=7.0.0; extra == 'test'
 Description-Content-Type: text/markdown
 
-![ErisPulse](https://raw.githubusercontent.com/ErisPulse/ErisPulse/main/.github/assets/mascot-hero.png)
-
 # ErisPulse
 
 **Write once, deploy on multiple platforms.**
@@ -54,6 +57,8 @@ An event-driven, multi-platform chatbot development framework based on the OneBo
 
 [![PyPI](https://img.shields.io/pypi/v/ErisPulse?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/ErisPulse/)
 [![Python](https://img.shields.io/badge/Python-3.10+-FFD43B?style=for-the-badge&logo=python&logoColor=blue)](https://pypi.org/project/ErisPulse/)
+[![OneBot 11](https://img.shields.io/badge/OneBot-11-black?style=for-the-badge)](https://github.com/botuniverse/onebot-11)
+[![OneBot 12](https://img.shields.io/badge/OneBot-12-black?style=for-the-badge)](https://12.onebot.dev/)
 [![License](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)](https://github.com/ErisPulse/ErisPulse/blob/main/LICENSE)
 [![Docs](https://img.shields.io/badge/docs-erisdev.com-FF6B9D?style=for-the-badge&logo=bookstack&logoColor=white)](https://www.erisdev.com)
 [![Stars](https://img.shields.io/github/stars/ErisPulse/ErisPulse?style=for-the-badge&logo=github&color=brightgreen)](https://github.com/ErisPulse/ErisPulse)

{erispulse-2.8.0.dev1 → erispulse-2.8.1}/README.pypi.md

@@ -1,5 +1,3 @@
-![ErisPulse](https://raw.githubusercontent.com/ErisPulse/ErisPulse/main/.github/assets/mascot-hero.png)
-
 # ErisPulse
 
 **Write once, deploy on multiple platforms.**
@@ -8,6 +6,8 @@ An event-driven, multi-platform chatbot development framework based on the OneBo
 
 [![PyPI](https://img.shields.io/pypi/v/ErisPulse?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/ErisPulse/)
 [![Python](https://img.shields.io/badge/Python-3.10+-FFD43B?style=for-the-badge&logo=python&logoColor=blue)](https://pypi.org/project/ErisPulse/)
+[![OneBot 11](https://img.shields.io/badge/OneBot-11-black?style=for-the-badge)](https://github.com/botuniverse/onebot-11)
+[![OneBot 12](https://img.shields.io/badge/OneBot-12-black?style=for-the-badge)](https://12.onebot.dev/)
 [![License](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)](https://github.com/ErisPulse/ErisPulse/blob/main/LICENSE)
 [![Docs](https://img.shields.io/badge/docs-erisdev.com-FF6B9D?style=for-the-badge&logo=bookstack&logoColor=white)](https://www.erisdev.com)
 [![Stars](https://img.shields.io/github/stars/ErisPulse/ErisPulse?style=for-the-badge&logo=github&color=brightgreen)](https://github.com/ErisPulse/ErisPulse)

{erispulse-2.8.0.dev1 → erispulse-2.8.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.8.0-dev.1"
+version = "2.8.1"
 description = "Event-driven modular async bot framework — write once, deploy to any platform | 事件驱动的模块化异步机器人框架，一次编写，多平台部署"
 readme = "README.pypi.md"
 requires-python = ">=3.10"
@@ -61,13 +61,14 @@ classifiers = [
 
 dependencies = [
     "rich>=13.0.0",
-    "toml>=0.10.2",
-
+    "tomlkit>=0.15.1",
     # network 相关
     "websockets>=12.0",
     "aiohttp>=3.9.0",
     "fastapi>=0.116.1",
     "uvicorn>=0.30.0",
+    # storage 相关（默认 SQLite 后端异步驱动，开箱即用）
+    "aiosqlite>=0.20.0",
 ]
 
 [project.urls]
@@ -79,6 +80,13 @@ Issues = "https://github.com/ErisPulse/ErisPulse/issues"
 Changelog = "https://github.com/ErisPulse/ErisPulse/blob/main/CHANGELOG.md"
 
 [project.optional-dependencies]
+# 存储后端可选驱动：pip install ErisPulse[mysql] / ErisPulse[postgres]
+mysql = [
+    "aiomysql>=0.2.0",
+]
+postgres = [
+    "asyncpg>=0.29.0",
+]
 test = [
     "pytest>=7.0.0",
     "pytest-cov>=4.0.0",

{erispulse-2.8.0.dev1 → erispulse-2.8.1}/src/ErisPulse/CLI/commands/create.py

@@ -86,7 +86,11 @@ class Main(BaseModule):
     # {text[module.config_hint]}
     @dataclass
     class ConfigClass(BaseConfig):
-        \"\"\"{text[module.config_doc]}\"\"\"
+        \"\"\"
+        {text[module.config_doc]}
+
+        :ivar advanced_threshold: 高级阈值（docstring :ivar: 声明即为字段描述，无需 metadata）
+        \"\"\"
 
         enabled: bool = field(
             default=True,
@@ -94,6 +98,11 @@ class Main(BaseModule):
                 \"description\": {{\"i18n\": \"module.{name}.enabled\", \"default\": \"Enable module\"}},
             }},
         )
+        # example 字段：默认不写入 config.toml（仅记录在 config.full.example，用户按需启用）
+        advanced_threshold: int = field(
+            default=100,
+            metadata={{\"example\": True, \"min\": 0}},
+        )
 
     # {text[module.i18n_hint]}
     class I18nClass(BaseI18n):
@@ -157,8 +166,13 @@ class Main(BaseModule):
             description={{\"i18n\": \"module.{name}.meta.description\", \"default\": \"{name} module\"}},
             version=\"0.1.0\",
             author=\"ErisDev\",
+            # 最低 SDK 版本（可选）：不满足时框架在加载期明确报错并跳过本模块
+            min_sdk_version=\"2.8.0\",
             group=\"default\",
             tags=[\"{name}\"],
+            # 对外服务白名单（可选）：声明后其他模块可经 sdk.module.call() 调用这些方法；
+            # 缺省时公开方法全开放（限制由用户通过 scope.actions 配置）
+            # services=[\"get_welcome_message\"],
         )
 
     @staticmethod
@@ -285,10 +299,17 @@ class {name}(BaseAdapter):
     depends: ClassVar[dict] = {{}}
     optional_modules: ClassVar[list] = []
 
+    # 声明所需最低 SDK 版本：不满足时框架在加载期明确报错并跳过本适配器（可选）
+    min_sdk_version = "2.8.0"
+
     # {text[adapter.config_hint]}
     @dataclass
     class ConfigClass(BaseConfig):
-        \"\"\"{text[adapter.config_doc]}\"\"\"
+        \"\"\"
+        {text[adapter.config_doc]}
+
+        :ivar request_timeout: 请求超时秒数（docstring :ivar: 声明即为字段描述，无需 metadata）
+        \"\"\"
 
         endpoint: str = field(
             default="https://api.example.com",
@@ -307,6 +328,11 @@ class {name}(BaseAdapter):
                 "ui": {{"widget": "password", "group": "basic", "order": 2}},
             }},
         )
+        # example 字段：默认不写入 config.toml（仅记录在 config.full.example，用户按需启用）
+        request_timeout: int = field(
+            default=30,
+            metadata={{"example": True, "min": 1, "max": 300}},
+        )
 
     # {text[adapter.i18n_hint]}
     class I18nClass(BaseI18n):

{erispulse-2.8.0.dev1 → erispulse-2.8.1}/src/ErisPulse/CLI/commands/init.py

@@ -175,128 +175,16 @@ class InitCommand(Command):
         """
         生成完整的配置示例文本
 
-        配置注释跟随 CLI 语言（缺失语言回退英文），
-        文案键集中于 ``scaffold_text`` 的 ``cfg.*`` 键族维护。
+        生成逻辑收归 ``ErisPulse.runtime.example_config``（框架运行与 CLI 共用：
+        含自维护首行标记、静态框架段与已安装组件声明式段）。此处仅保留调用入口。
 
         :param adapter_list: [list] 适配器名称列表 (默认: None)
         :return: [str] 完整配置示例字符串
         """
-        from ..utils.scaffold_text import ScaffoldText
-
-        st = ScaffoldText()
-        lines = [
-            st.t("cfg.header.title"),
-            st.t("cfg.header.desc"),
-            st.t("cfg.header.usage"),
-            "",
-            st.t("cfg.section.server"),
-            "",
-            "[ErisPulse.server]",
-            f'host = "0.0.0.0"              # {st.t("cfg.server.host")}',
-            f"port = 8000                   # {st.t('cfg.server.port')}",
-            f"auto_start = true             # {st.t('cfg.server.auto_start')}",
-            f'ssl_certfile = "config/ssl/cert.pem"   # {st.t("cfg.server.ssl_certfile")}',
-            f'ssl_keyfile = "config/ssl/key.pem"    # {st.t("cfg.server.ssl_keyfile")}',
-            st.t("cfg.server.ssl_inline_hint"),
-            '# ssl_cert = """-----BEGIN CERTIFICATE-----',
-            "# ...",
-            '# -----END CERTIFICATE-----"""',
-            '# ssl_key = """-----BEGIN PRIVATE KEY-----',
-            "# ...",
-            '# -----END PRIVATE KEY-----"""',
-            "",
-            st.t("cfg.section.logger"),
-            "",
-            "[ErisPulse.logger]",
-            f'level = "INFO"                # {st.t("cfg.logger.level")}',
-            f"log_files = []                # {st.t('cfg.logger.log_files')}",
-            f'log_dir = ""                  # {st.t("cfg.logger.log_dir")}',
-            f'log_rotation = "size"         # {st.t("cfg.logger.log_rotation")}',
-            f"log_max_size_mb = 10          # {st.t('cfg.logger.log_max_size_mb')}",
-            f"log_backup_count = 5          # {st.t('cfg.logger.log_backup_count')}",
-            f'log_rotation_when = "midnight"  # {st.t("cfg.logger.log_rotation_when")}',
-            f"memory_limit = 1000           # {st.t('cfg.logger.memory_limit')}",
-            "",
-            st.t("cfg.section.storage"),
-            "",
-            "[ErisPulse.storage]",
-            f"use_global_db = false         # {st.t('cfg.storage.use_global_db')}",
-            "",
-            st.t("cfg.section.event"),
-            "",
-            "[ErisPulse.event.message]",
-            f"ignore_self = true            # {st.t('cfg.event.ignore_self')}",
-            "",
-            "[ErisPulse.event.command]",
-            f'prefix = "/"                  # {st.t("cfg.command.prefix")}',
-            f"case_sensitive = true         # {st.t('cfg.command.case_sensitive')}",
-            f"allow_space_prefix = false    # {st.t('cfg.command.allow_space_prefix')}",
-            f"must_at_bot = false           # {st.t('cfg.command.must_at_bot')}",
-            "",
-            st.t("cfg.section.framework"),
-            "",
-            "[ErisPulse.framework]",
-            f"enable_lazy_loading = true     # {st.t('cfg.framework.enable_lazy_loading')}",
-            f'plugins_dir = "plugins"        # {st.t("cfg.framework.plugins_dir")}',
-            f"uninit_timeout = 30            # {st.t('cfg.framework.uninit_timeout')}",
-            f"                                {st.t('cfg.framework.uninit_timeout_line1')}",
-            f"                                {st.t('cfg.framework.uninit_timeout_line2')}",
-            f"strict_mode = false            # {st.t('cfg.framework.strict_mode')}",
-            f"strict_mode_exceptions = {{ modules = [], adapters = [] }}  # {st.t('cfg.framework.strict_mode_exceptions')}",
-            f"handler_max_concurrency = 64   # {st.t('cfg.framework.handler_max_concurrency')}",
-            f"proactive_gc_interval = 300    # {st.t('cfg.framework.proactive_gc_interval')}",
-            f"proactive_gc_generation = 2    # {st.t('cfg.framework.proactive_gc_generation')}",
-            f"proactive_gc_full_every = 10   # {st.t('cfg.framework.proactive_gc_full_every')}",
-            f"proactive_gc_memory_growth_mb = 100  # {st.t('cfg.framework.proactive_gc_memory_growth_mb')}",
-            f"proactive_gc_idle_only = true  # {st.t('cfg.framework.proactive_gc_idle_only')}",
-            f"proactive_gc_gen0_min = 100    # {st.t('cfg.framework.proactive_gc_gen0_min')}",
-            f"offline_bot_expiry = 3600      # {st.t('cfg.framework.offline_bot_expiry')}",
-            "",
-            st.t("cfg.section.router"),
-            "",
-            "[ErisPulse.router.cors]",
-            "enabled = false",
-            'allow_origins = ["*"]',
-            'allow_methods = ["*"]',
-            'allow_headers = ["*"]',
-            "allow_credentials = false",
-            "max_age = 600",
-            "",
-            "[ErisPulse.router.security]",
-            "enabled = false",
-            "",
-            "[ErisPulse.router.security.headers]",
-            'X-Content-Type-Options = "nosniff"',
-            'X-Frame-Options = "DENY"',
-            "",
-            st.t("cfg.section.adapter_status"),
-            "",
-            "[ErisPulse.adapters.status]",
-        ]
-
-        if adapter_list:
-            lines.extend(f"# {adapter} = false" for adapter in adapter_list)
-        else:
-            lines.extend(
-                [
-                    "# yunhu = false",
-                    "# telegram = false",
-                    "# onebot11 = false",
-                ]
-            )
+        from ErisPulse.runtime.example_config import render_full_example
 
-        lines.extend(
-            [
-                "",
-                st.t("cfg.section.module_status"),
-                "",
-                "[ErisPulse.modules.status]",
-                "# MyModule = true",
-                "",
-            ]
-        )
+        return render_full_example(adapter_list=adapter_list)
 
-        return "\n".join(lines)
 
     async def _fetch_available_adapters(self):
         """

{erispulse-2.8.0.dev1 → erispulse-2.8.1}/src/ErisPulse/CLI/commands/run.py

@@ -16,11 +16,11 @@ from pathlib import Path
 
 from rich.panel import Panel
 
+from ...runtime.file_watcher import FileSystemEventHandler, PollingObserver
 from ..base import Command
 from ..console import console
 from ..constants import ENV_SUPERVISED, HARD_RESTART_EXIT_CODE
 from ..i18n import i18n
-from ..utils.file_watcher import FileSystemEventHandler, PollingObserver
 
 
 class ReloadHandler(FileSystemEventHandler):

{erispulse-2.8.0.dev1 → erispulse-2.8.1}/src/ErisPulse/CLI/utils/config_wizard.py

@@ -524,6 +524,9 @@ def fill_config_fields(config_class, current_values: dict) -> dict:
     """
     渲染整个配置类的表单并收集用户输入
 
+    ``example`` 字段不进入向导（默认值不落盘，仅记录在 config.full.example）；
+    嵌套 dataclass 字段（schema 含 ``fields`` 子树）递归渲染为子表单。
+
     :param config_class: dataclass 配置类
     :param current_values: 当前存储的配置字典（作为各字段初值）
     :return: 收集后的配置字典
@@ -531,12 +534,31 @@ def fill_config_fields(config_class, current_values: dict) -> dict:
     from ErisPulse.Core.Bases.config_schema import resolve_config_schema
 
     schema = resolve_config_schema(config_class)
-    current_store = dict(current_values or {})
-    values = dict(current_store)
-    for name, field_schema in _sort_fields(schema.get("fields", {})):
+    values = dict(current_values or {})
+    _fill_from_schema_fields(schema.get("fields", {}), values)
+    return values
+
+
+def _fill_from_schema_fields(fields_dict: dict, values: dict) -> None:
+    """
+    {!--< internal-use >!--}
+    按 schema 字段树渲染表单并就地收集到 values（嵌套子树递归）
+    """
+    current_store = dict(values)
+    for name, field_schema in _sort_fields(fields_dict):
+        if field_schema.get("example") and name not in current_store:
+            # example 字段仅当用户已显式设置时保留原值，不主动询问
+            continue
+        nested_fields = field_schema.get("fields")
+        if isinstance(nested_fields, dict):
+            sub_values = current_store.get(name)
+            if not isinstance(sub_values, dict):
+                sub_values = {}
+            _fill_from_schema_fields(nested_fields, sub_values)
+            values[name] = sub_values
+            continue
         has_value = name in current_store
         values[name] = _prompt_field(name, field_schema, values.get(name), has_value)
-    return values
 
 
 def _validate_dataclass(config_class, data: dict) -> list[str]:

{erispulse-2.8.0.dev1 → erispulse-2.8.1}/src/ErisPulse/CLI/utils/package_manager.py

@@ -26,54 +26,8 @@ from ..console import console
 from ..constants import PYPI_PACKAGE_JSON_URL_TEMPLATE
 from ..i18n import i18n
 
-# 版本号解析正则（PEP 440 子集，纯标准库，不依赖 packaging）：
-# 支持 epoch (1!)、release 段、预发布后缀 (dev/a/alpha/b/beta/rc/c/pre)、
-# post 版本 (1.0.postN) 与本地版本 (1.0+local)。
-# 例如 2.5.0-dev.1 / 2.5.0a1 / 1.0rc1 / 1.0.post1 / 1.0+local / 1!1.0 均可解析。
-# 不支持的格式（如 1.0.post1.dev1 这类 post 后跟 dev）由 _parse_version 返回 None 退化处理。
-_VERSION_RE = re.compile(
-    r"^\s*v?(?P<epoch>\d+!)?(?P<release>\d+(?:\.\d+)*)"
-    r"(?:[-._]?(?P<pre>dev|alpha|beta|rc|a|b|c|pre)[-._]?(?P<num>\d*))?"
-    r"(?:[-._]?post[-._]?(?P<post>\d+))?"
-    r"(?:\+(?P<local>[a-zA-Z0-9]+(?:[.-][a-zA-Z0-9]+)*))?",
-    re.IGNORECASE,
-)
-# 预发布类型排序权重：正式版 > rc > beta > alpha > dev
-_PRE_RELEASE_RANK = {
-    "dev": 0,
-    "alpha": 1,
-    "a": 1,
-    "beta": 2,
-    "b": 2,
-    "rc": 3,
-    "c": 3,
-    "pre": 3,
-}
-
-
-def _parse_version(version: str) -> dict | None:
-    """
-    将版本号解析为结构化组件（PEP 440 子集，纯标准库）。
-
-    与 :meth:`PackageManager._version_key` / :meth:`PackageManager._is_pre_release`
-    共用同一解析口径，避免不同正则导致判定分歧（如 ``1.0c2`` 此前在
-    ``_is_pre_release`` 与 ``_version_key`` 间判定口径不一致）。
-
-    :param version: [str] 版本号字符串
-    :return: [Optional[dict]] 含 epoch/release/pre_type/pre_num/post/local 的字典，
-             无法解析时返回 None
-    """
-    match = _VERSION_RE.match(str(version).strip().lstrip("vV"))
-    if not match:
-        return None
-    return {
-        "epoch": int((match.group("epoch") or "0").rstrip("!") or 0),
-        "release": match.group("release"),
-        "pre_type": match.group("pre"),
-        "pre_num": match.group("num"),
-        "post": match.group("post"),
-        "local": match.group("local"),
-    }
+# 版本号解析与比较的唯一实现在 runtime/version.py（PEP 440 子集，纯标准库）；
+# 本模块经下方方法级委托复用同一解析口径，避免双正则导致判定分歧
 
 
 class PackageManager:
@@ -853,63 +807,28 @@ class PackageManager:
         """
         将版本号解析为可比较的元组键
 
-        遵循项目命名规则排序：正式版 > post > rc > beta > alpha > dev；
-        epoch 优先于一切 release 段；本地版本 (+local) 不影响主排序，
-        但同一版本号带 local 段者 > 不带 local 段者。
-        例如 2.4.5-dev.1 先于 2.4.5 正式版，1.0 < 1.0.post1 < 1.1。
+        委托 :func:`ErisPulse.runtime.version.version_key`（框架内唯一实现）。
 
         :param version: [str] 版本号字符串
-        :return: [tuple] 可直接用于排序/比较的元组键
+        :return: [tuple] 逐段可比较的比较键元组
         """
-        parsed = _parse_version(version)
-        if parsed is None:
-            # 无法解析时退化为基础键，保证不抛异常
-            return (0, (0, 0, 0, 0), (1,), (0,), ((1, str(version).lower()),))
-
-        release = tuple(int(x) for x in parsed["release"].split("."))
-        # release 段对齐到固定长度，确保 (2.5) 与 (2.5.0) 可正确比较
-        padded = release + (0,) * max(0, 4 - len(release))
-
-        pre_type = parsed["pre_type"]
-        if pre_type is None:
-            # 正式版：预发布键高于任何预发布版本
-            pre_key = (1,)
-        else:
-            rank = _PRE_RELEASE_RANK.get(pre_type.lower(), 1)
-            pre_num = int(parsed["pre_num"] or 0)
-            pre_key = (0, rank, pre_num)
-
-        # post 段：无 post 视为 post0，保证 1.0 == 1.0.post0 < 1.0.post1
-        post_num = int(parsed["post"] or 0)
-        post_key = (post_num,)
-
-        local = parsed["local"]
-        if local:
-            # 本地段按 "数值段 < 字母段" 拆分，避免 int/str 直接比较抛异常
-            local_key = tuple(
-                (0, int(part)) if part.isdigit() else (1, part.lower())
-                for part in local.split(".")
-            )
-        else:
-            local_key = ()
+        from ...runtime.version import version_key
 
-        return (parsed["epoch"], padded, pre_key, post_key, local_key)
+        return version_key(version)
 
     def _compare_versions(self, version1: str, version2: str) -> int:
         """
         比较两个版本号的大小
 
+        委托 :func:`ErisPulse.runtime.version.compare_versions`（框架内唯一实现）。
+
         :param version1: [str] 第一个版本号
         :param version2: [str] 第二个版本号
         :return: [int] version1 大于/等于/小于 version2 时分别返回 1/0/-1
         """
-        k1 = self._version_key(version1)
-        k2 = self._version_key(version2)
-        if k1 > k2:
-            return 1
-        if k1 < k2:
-            return -1
-        return 0
+        from ...runtime.version import compare_versions
+
+        return compare_versions(version1, version2)
 
     def _check_sdk_compatibility(self, min_sdk_version: str) -> tuple[bool, str]:
         """
@@ -1435,14 +1354,16 @@ class PackageManager:
         """
         判断版本号是否为预发布版本
 
-        与 :meth:`_version_key` 复用同一解析口径（:func:`_parse_version`）：
-        仅当版本含预发布段 (dev/alpha/beta/rc/c/pre) 时返回 True；
-        post 版本 (1.0.post1) 与本地版本 (1.0+local) 不计为预发布。
+        与 :meth:`_version_key` 共用同一解析口径（:func:`ErisPulse.runtime.version.parse_version`）。
+        当版本号含预发布段 (dev/alpha/beta/rc/c/pre) 时返回 True。
+        post 版本 (1.0.post1) 与本地版本 (1.0+local) 不视为预发布版本
 
         :param version: [str] 版本号字符串
-        :return: [bool] 是预发布版本返回 True
+        :return: [bool] 是预发布版本时返回 True
         """
-        parsed = _parse_version(version)
+        from ...runtime.version import parse_version
+
+        parsed = parse_version(version)
         return parsed is not None and parsed["pre_type"] is not None
 
     def update_self(self, target_version: str | None = None, force: bool = False) -> bool:

{erispulse-2.8.0.dev1 → erispulse-2.8.1}/src/ErisPulse/CLI/utils/scaffold_text.py

@@ -96,6 +96,8 @@ _EN_FALLBACK: dict[str, str] = {
     "cfg.section.router": "# ==================== Router ====================",
     "cfg.section.adapter_status": "# ==================== Adapter Status ====================",
     "cfg.section.module_status": "# ==================== Module Status ====================",
+    "cfg.section.components": "# ==================== Installed Components (declarative, auto-generated) ====================",
+    "cfg.section.components_hint": "# Rendered from each installed adapter/module ConfigClass; example: fields only live here (not auto-persisted to config.toml)",
     "cfg.server.host": "Listen address",
     "cfg.server.port": "Listen port",
     "cfg.server.auto_start": "Auto start HTTP server (set false for pure WS/polling adapters)",
@@ -112,6 +114,9 @@ _EN_FALLBACK: dict[str, str] = {
     "cfg.logger.log_rotation_when": "date mode: rotation period S/M/H/D/midnight",
     "cfg.logger.memory_limit": "In-memory log entries limit",
     "cfg.storage.use_global_db": "Use global database",
+    "cfg.storage.backend": "Storage backend: \"sqlite\" / \"mysql\" / \"postgres\"",
+    "cfg.storage.mysql": "MySQL connection params (effective when backend = \"mysql\"), requires: pip install ErisPulse[mysql]",
+    "cfg.storage.postgres": "PostgreSQL connection params (effective when backend = \"postgres\"), requires: pip install ErisPulse[postgres]",
     "cfg.event.ignore_self": "Ignore self messages",
     "cfg.command.prefix": "Command prefix",
     "cfg.command.case_sensitive": "Case sensitive",
@@ -196,6 +201,8 @@ _TRANSLATIONS: dict[str, dict[str, str]] = {
     "cfg.section.router": "# ==================== 路由增强 ====================",
     "cfg.section.adapter_status": "# ==================== 适配器状态 ====================",
     "cfg.section.module_status": "# ==================== 模块状态 ====================",
+    "cfg.section.components": "# ==================== 已安装组件（声明式自动生成） ====================",
+    "cfg.section.components_hint": "# 由各已安装适配器/模块的 ConfigClass 渲染；example: 字段仅记录于此（不会自动写入 config.toml）",
     "cfg.server.host": "监听地址",
     "cfg.server.port": "监听端口",
     "cfg.server.auto_start": "是否自动启动 HTTP 服务器 (纯 WS/轮询适配器可设 false)",
@@ -211,6 +218,9 @@ _TRANSLATIONS: dict[str, dict[str, str]] = {
     "cfg.logger.log_rotation_when": "date 模式轮转周期: S/M/H/D/midnight",
     "cfg.logger.memory_limit": "内存日志条数上限",
     "cfg.storage.use_global_db": "是否使用全局数据库",
+    "cfg.storage.backend": "存储后端: \"sqlite\" / \"mysql\" / \"postgres\"",
+    "cfg.storage.mysql": "MySQL 连接参数（backend = \"mysql\" 时生效），需安装: pip install ErisPulse[mysql]",
+    "cfg.storage.postgres": "PostgreSQL 连接参数（backend = \"postgres\" 时生效），需安装: pip install ErisPulse[postgres]",
     "cfg.event.ignore_self": "忽略自身消息",
     "cfg.command.prefix": "命令前缀",
     "cfg.command.case_sensitive": "区分大小写",

{erispulse-2.8.0.dev1 → erispulse-2.8.1}/src/ErisPulse/Core/Bases/__init__.py

@@ -9,7 +9,8 @@ from .converter import BaseConverter
 from .send_rules import SendContext
 from .send_builder import SendBuilder, BatchContext
 from .module import BaseModule, ModuleMeta
-from .storage import BaseStorage, BaseQueryBuilder
+from .storage import AsyncBridge, BaseStorage, BaseQueryBuilder
+from .sql_base import AlterTableBuilder, SQLDialect, SQLQueryBuilder, SQLStorageBase
 from .kv_builder import KVQueryBuilder
 from .errors import (
     ErisPulseError,
@@ -17,6 +18,17 @@ from .errors import (
     ClientConnectionError,
     ClientTimeoutError,
     HTTPStatusError,
+    InteractionCancelled,
+    InteractionError,
+    ModuleCallError,
+    ModuleCallTimeoutError,
+    ModuleError,
+    ModuleNotAvailableError,
+    ServiceNotProvidedError,
+    SessionOccupiedError,
+    StorageError,
+    StorageUnreachableError,
+    StrictModeError,
     WebSocketError,
     WebSocketDisconnect,
 )
@@ -66,16 +78,33 @@ __all__ = [
     "I18nConfig",
     # i18n 单键声明
     "I18nKey",
+    "AsyncBridge",
+    "InteractionCancelled",
+    "InteractionError",
     "KVQueryBuilder",
+    "ModuleCallError",
+    "ModuleCallTimeoutError",
+    "ModuleError",
     "ModuleMeta",
+    "ModuleNotAvailableError",
     "RequestDSL",
     "SendBuilder",
     "SendContext",
     "SendDSL",
+    "ServiceNotProvidedError",
+    "SessionOccupiedError",
     "SseEmitter",
+    "StorageError",
+    "StorageUnreachableError",
+    "StrictModeError",
     "WSMessage",
     "WebSocketConnection",
     "WebSocketConnectionBase",
     "WebSocketDisconnect",
     "WebSocketError",
+    # SQL 存储基类（自定义 SQL 后端扩展用）
+    "AlterTableBuilder",
+    "SQLDialect",
+    "SQLQueryBuilder",
+    "SQLStorageBase",
 ]