ErisPulse 2.4.3.dev0__tar.gz → 2.4.3.dev1__tar.gz

{erispulse-2.4.3.dev0 → erispulse-2.4.3.dev1}/.gitignore

@@ -5,6 +5,7 @@ venvs
 config.toml
 uv.lock
 snapshots/
+logs/
 config.db*
 .website
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.4.3.dev0
+Version: 2.4.3.dev1
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: ErisDev <erisdev@88.com>
 Maintainer-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>
@@ -48,7 +48,7 @@ Requires-Dist: packaging>=25.0
 Requires-Dist: pip>=23.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: toml>=0.10.2
-Requires-Dist: uvicorn>=0.30.0
+Requires-Dist: uvicorn[standard]>=0.30.0
 Requires-Dist: watchdog>=4.0.0
 Provides-Extra: dev
 Requires-Dist: httpx>=0.24.0; extra == 'dev'
@@ -88,11 +88,10 @@ Description-Content-Type: text/markdown
 **事件驱动的多平台机器人开发框架**
 
 [![PyPI](https://img.shields.io/pypi/v/ErisPulse?style=flat-square)](https://pypi.org/project/ErisPulse/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/ErisPulse?style=flat-square)](https://pypi.org/project/ErisPulse/)
-[![Docker Pulls](https://img.shields.io/docker/pulls/erispulse/erispulse?style=flat-square&logo=docker&label=pulls)](https://hub.docker.com/r/erispulse/erispulse)
-[![Docker Pulls](https://img.shields.io/docker/pulls/wsu2059/erispulse?style=flat-square&logo=docker&label=pulls)](https://hub.docker.com/r/erispulse/erispulse)
-[![Docker Version](https://img.shields.io/docker/v/erispulse/erispulse?style=flat-square&logo=docker&label=docker)](https://hub.docker.com/r/erispulse/erispulse)
+[![Docker](https://img.shields.io/badge/Docker-2496ED?style=flat-square&logo=docker&logoColor=white)](https://hub.docker.com/r/erispulse/erispulse)
+[![Python](https://img.shields.io/badge/Python-3.10+-3776AB?style=flat-square&logo=python&logoColor=white)](https://pypi.org/project/ErisPulse/)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Socket Badge](https://socket.dev/api/badge/pypi/package/ErisPulse/latest)](https://socket.dev/pypi/package/ErisPulse)
 
 </td>
 </tr>
@@ -118,16 +117,16 @@ ErisPulse 是一个基于 Python 的事件驱动型多平台机器人开发框
 
 | 适配器 | 说明 |
 |--------|------|
-| <img src=".github/assets/adapter_logo/kook.svg" width="20" /> [Kook](https://github.com/shanfishapp/ErisPulse-KookAdapter) | Kook（开黑啦）即时通讯平台 |
-| <img src=".github/assets/adapter_logo/matrix.svg" width="20" /> [Matrix](https://github.com/ErisPulse/ErisPulse-MatrixAdapter) | Matrix 去中心化通讯协议 |
-| <img src=".github/assets/adapter_logo/onebot.png" width="20" /> [OneBot11](https://github.com/ErisPulse/ErisPulse-OneBot11Adapter) | OneBot v11 通用机器人协议 |
-| <img src=".github/assets/adapter_logo/onebot.png" width="20" /> [OneBot12](https://github.com/ErisPulse/ErisPulse-OneBot12Adapter) | OneBot v12 标准协议 |
-| <img src=".github/assets/adapter_logo/qqbot.svg" width="20" /> [QQ](https://github.com/ErisPulse/ErisPulse-QQBotAdapter) | QQ 官方机器人平台 |
-| <img src=".github/assets/adapter_logo/sandbox.png" width="20" /> [沙箱](https://github.com/ErisPulse/ErisPulse-SandboxAdapter) | 网页端调试，无需接入真实平台 |
-| <img src=".github/assets/adapter_logo/telegram.svg" width="20" /> [Telegram](https://github.com/ErisPulse/ErisPulse-TelegramAdapter) | 全球性即时通讯平台 |
-| <img src=".github/assets/adapter_logo/email.svg" width="20" /> [邮件](https://github.com/ErisPulse/ErisPulse-EmailAdapter) | 邮件协议收发适配器 |
-| <img src=".github/assets/adapter_logo/yunhu.png" width="20" /> [云湖](https://github.com/ErisPulse/ErisPulse-YunhuAdapter) | 企业级即时通讯平台（机器人接入） |
-| <img src=".github/assets/adapter_logo/yunhu.png" width="20" /> [云湖用户](https://github.com/wsu2059q/ErisPulse-YunhuUserAdapter) | 基于云湖用户协议的接入适配器 |
+| [Kook](https://github.com/shanfishapp/ErisPulse-KookAdapter) | Kook（开黑啦）即时通讯平台 |
+| [Matrix](https://github.com/ErisPulse/ErisPulse-MatrixAdapter) | Matrix 去中心化通讯协议 |
+| [OneBot11](https://github.com/ErisPulse/ErisPulse-OneBot11Adapter) | OneBot v11 通用机器人协议 |
+| [OneBot12](https://github.com/ErisPulse/ErisPulse-OneBot12Adapter) | OneBot v12 标准协议 |
+| [QQ](https://github.com/ErisPulse/ErisPulse-QQBotAdapter) | QQ 官方机器人平台 |
+| [沙箱](https://github.com/ErisPulse/ErisPulse-SandboxAdapter) | 网页端调试，无需接入真实平台 |
+| [Telegram](https://github.com/ErisPulse/ErisPulse-TelegramAdapter) | 全球性即时通讯平台 |
+| [邮件](https://github.com/ErisPulse/ErisPulse-EmailAdapter) | 邮件协议收发适配器 |
+| [云湖](https://github.com/ErisPulse/ErisPulse-YunhuAdapter) | 企业级即时通讯平台（机器人接入） |
+| [云湖用户](https://github.com/wsu2059q/ErisPulse-YunhuUserAdapter) | 基于云湖用户协议的接入适配器 |
 
 查看 [适配器详情介绍](docs/zh-CN/platform-guide/README.md)
 
@@ -139,6 +138,22 @@ ErisPulse 是一个基于 Python 的事件驱动型多平台机器人开发框
 docker pull erispulse/erispulse:latest
 ```
 
+<details>
+<summary>Docker Hub不可用？</summary>
+
+如果 Docker Hub 无法访问，可以使用 GitHub Container Registry：
+
+```bash
+docker pull ghcr.io/erispulse/erispulse:latest
+```
+
+使用 ghcr.io 镜像时，需要修改 `docker-compose.yml` 中的 image：
+```yaml
+image: ghcr.io/erispulse/erispulse:latest
+```
+
+</details>
+
 <details>
 <summary>快速启动</summary>
 
@@ -152,9 +167,9 @@ ERISPULSE_DASHBOARD_TOKEN=your-token docker compose up -d
 
 > 镜像内置 ErisPulse 框架和 Dashboard 管理面板，支持 `linux/amd64` 和 `linux/arm64` 架构。
 
-</details>
+启动后访问 `http://<host>:<port>/Dashboard`，使用设置的令牌作为密码登录 Dashboard 管理面板。
 
-启动后访问 `http://localhost:8000/Dashboard`，使用设置的令牌作为密码登录 Dashboard 管理面板。
+</details>
 
 ### 使用 pip 安装
 

{erispulse-2.4.3.dev0 → erispulse-2.4.3.dev1}/README.md

@@ -16,11 +16,10 @@
 **事件驱动的多平台机器人开发框架**
 
 [![PyPI](https://img.shields.io/pypi/v/ErisPulse?style=flat-square)](https://pypi.org/project/ErisPulse/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/ErisPulse?style=flat-square)](https://pypi.org/project/ErisPulse/)
-[![Docker Pulls](https://img.shields.io/docker/pulls/erispulse/erispulse?style=flat-square&logo=docker&label=pulls)](https://hub.docker.com/r/erispulse/erispulse)
-[![Docker Pulls](https://img.shields.io/docker/pulls/wsu2059/erispulse?style=flat-square&logo=docker&label=pulls)](https://hub.docker.com/r/erispulse/erispulse)
-[![Docker Version](https://img.shields.io/docker/v/erispulse/erispulse?style=flat-square&logo=docker&label=docker)](https://hub.docker.com/r/erispulse/erispulse)
+[![Docker](https://img.shields.io/badge/Docker-2496ED?style=flat-square&logo=docker&logoColor=white)](https://hub.docker.com/r/erispulse/erispulse)
+[![Python](https://img.shields.io/badge/Python-3.10+-3776AB?style=flat-square&logo=python&logoColor=white)](https://pypi.org/project/ErisPulse/)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Socket Badge](https://socket.dev/api/badge/pypi/package/ErisPulse/latest)](https://socket.dev/pypi/package/ErisPulse)
 
 </td>
 </tr>
@@ -46,16 +45,16 @@ ErisPulse 是一个基于 Python 的事件驱动型多平台机器人开发框
 
 | 适配器 | 说明 |
 |--------|------|
-| <img src=".github/assets/adapter_logo/kook.svg" width="20" /> [Kook](https://github.com/shanfishapp/ErisPulse-KookAdapter) | Kook（开黑啦）即时通讯平台 |
-| <img src=".github/assets/adapter_logo/matrix.svg" width="20" /> [Matrix](https://github.com/ErisPulse/ErisPulse-MatrixAdapter) | Matrix 去中心化通讯协议 |
-| <img src=".github/assets/adapter_logo/onebot.png" width="20" /> [OneBot11](https://github.com/ErisPulse/ErisPulse-OneBot11Adapter) | OneBot v11 通用机器人协议 |
-| <img src=".github/assets/adapter_logo/onebot.png" width="20" /> [OneBot12](https://github.com/ErisPulse/ErisPulse-OneBot12Adapter) | OneBot v12 标准协议 |
-| <img src=".github/assets/adapter_logo/qqbot.svg" width="20" /> [QQ](https://github.com/ErisPulse/ErisPulse-QQBotAdapter) | QQ 官方机器人平台 |
-| <img src=".github/assets/adapter_logo/sandbox.png" width="20" /> [沙箱](https://github.com/ErisPulse/ErisPulse-SandboxAdapter) | 网页端调试，无需接入真实平台 |
-| <img src=".github/assets/adapter_logo/telegram.svg" width="20" /> [Telegram](https://github.com/ErisPulse/ErisPulse-TelegramAdapter) | 全球性即时通讯平台 |
-| <img src=".github/assets/adapter_logo/email.svg" width="20" /> [邮件](https://github.com/ErisPulse/ErisPulse-EmailAdapter) | 邮件协议收发适配器 |
-| <img src=".github/assets/adapter_logo/yunhu.png" width="20" /> [云湖](https://github.com/ErisPulse/ErisPulse-YunhuAdapter) | 企业级即时通讯平台（机器人接入） |
-| <img src=".github/assets/adapter_logo/yunhu.png" width="20" /> [云湖用户](https://github.com/wsu2059q/ErisPulse-YunhuUserAdapter) | 基于云湖用户协议的接入适配器 |
+| [Kook](https://github.com/shanfishapp/ErisPulse-KookAdapter) | Kook（开黑啦）即时通讯平台 |
+| [Matrix](https://github.com/ErisPulse/ErisPulse-MatrixAdapter) | Matrix 去中心化通讯协议 |
+| [OneBot11](https://github.com/ErisPulse/ErisPulse-OneBot11Adapter) | OneBot v11 通用机器人协议 |
+| [OneBot12](https://github.com/ErisPulse/ErisPulse-OneBot12Adapter) | OneBot v12 标准协议 |
+| [QQ](https://github.com/ErisPulse/ErisPulse-QQBotAdapter) | QQ 官方机器人平台 |
+| [沙箱](https://github.com/ErisPulse/ErisPulse-SandboxAdapter) | 网页端调试，无需接入真实平台 |
+| [Telegram](https://github.com/ErisPulse/ErisPulse-TelegramAdapter) | 全球性即时通讯平台 |
+| [邮件](https://github.com/ErisPulse/ErisPulse-EmailAdapter) | 邮件协议收发适配器 |
+| [云湖](https://github.com/ErisPulse/ErisPulse-YunhuAdapter) | 企业级即时通讯平台（机器人接入） |
+| [云湖用户](https://github.com/wsu2059q/ErisPulse-YunhuUserAdapter) | 基于云湖用户协议的接入适配器 |
 
 查看 [适配器详情介绍](docs/zh-CN/platform-guide/README.md)
 
@@ -67,6 +66,22 @@ ErisPulse 是一个基于 Python 的事件驱动型多平台机器人开发框
 docker pull erispulse/erispulse:latest
 ```
 
+<details>
+<summary>Docker Hub不可用？</summary>
+
+如果 Docker Hub 无法访问，可以使用 GitHub Container Registry：
+
+```bash
+docker pull ghcr.io/erispulse/erispulse:latest
+```
+
+使用 ghcr.io 镜像时，需要修改 `docker-compose.yml` 中的 image：
+```yaml
+image: ghcr.io/erispulse/erispulse:latest
+```
+
+</details>
+
 <details>
 <summary>快速启动</summary>
 
@@ -80,9 +95,9 @@ ERISPULSE_DASHBOARD_TOKEN=your-token docker compose up -d
 
 > 镜像内置 ErisPulse 框架和 Dashboard 管理面板，支持 `linux/amd64` 和 `linux/arm64` 架构。
 
-</details>
+启动后访问 `http://<host>:<port>/Dashboard`，使用设置的令牌作为密码登录 Dashboard 管理面板。
 
-启动后访问 `http://localhost:8000/Dashboard`，使用设置的令牌作为密码登录 Dashboard 管理面板。
+</details>
 
 ### 使用 pip 安装
 

{erispulse-2.4.3.dev0 → erispulse-2.4.3.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.4.3-dev.0"
+version = "2.4.3-dev.1"
 description = "ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -55,7 +55,7 @@ dependencies = [
     "watchdog>=4.0.0",
     "toml>=0.10.2",
     "fastapi>=0.116.1",
-    "uvicorn>=0.30.0",
+    "uvicorn[standard]>=0.30.0",
     "packaging>=25.0",
 ]
 

erispulse-2.4.3.dev1/src/ErisPulse/Core/Bases/__init__.py

@@ -0,0 +1,17 @@
+"""
+ErisPulse 基础模块
+ 
+提供平台适配器、模块和存储后端的基类
+"""
+ 
+from .adapter import SendDSL, BaseAdapter
+from .module import BaseModule
+from .storage import BaseStorage, BaseQueryBuilder
+ 
+__all__ = [
+    "BaseAdapter",
+    "SendDSL",
+    "BaseModule",
+    "BaseStorage",
+    "BaseQueryBuilder",
+]

{erispulse-2.4.3.dev0 → erispulse-2.4.3.dev1}/src/ErisPulse/Core/Bases/__init__.pyi

@@ -6,9 +6,10 @@
 
 """
 ErisPulse 基础模块
-
-提供平台适配器以及模块的基类
+ 
+提供平台适配器、模块和存储后端的基类
 """
 
 from .adapter import SendDSL, BaseAdapter
 from .module import BaseModule
+from .storage import BaseStorage, BaseQueryBuilder

erispulse-2.4.3.dev1/src/ErisPulse/Core/Bases/storage.py

@@ -0,0 +1,438 @@
+"""
+ErisPulse 存储基类
+
+提供存储后端和查询构建器的抽象接口，支持不同存储介质的统一访问
+
+{!--< tips >!--}
+1. BaseStorage 定义了键值存储和表管理的标准接口
+2. BaseQueryBuilder 定义了链式查询构建的标准接口
+3. 具体存储后端（如 SQLite、Redis、MySQL）需继承并实现这些接口
+{!--< /tips >!--}
+"""
+
+from abc import ABC, abstractmethod
+from typing import Any
+
+
+class BaseQueryBuilder(ABC):
+    """
+    查询构建器抽象基类
+
+    定义链式调用风格的查询构建接口，所有链式方法返回 self，
+    终止方法（Execute、ExecuteOne、Count、Exists）返回实际结果。
+
+    {!--< tips >!--}
+    使用方式：
+    1. storage.Table("users").Insert({"name": "Alice"}).Execute()
+    2. storage.Table("users").Select("name").Where("age > ?", 18).Limit(10).Execute()
+    {!--< /tips >!--}
+    """
+
+    def __init__(self, storage: "BaseStorage", table: str):
+        self._storage = storage
+        self._table = table
+        self._operation: str | None = None
+        self._columns: list[str] = []
+        self._data: dict[str, Any] | list[dict[str, Any]] | None = None
+        self._where_clauses: list[str] = []
+        self._where_params: list[Any] = []
+        self._order_by: list[tuple[str, bool]] = []
+        self._limit: int | None = None
+        self._offset: int | None = None
+
+    def Select(self, *columns: str) -> "BaseQueryBuilder":
+        """
+        指定查询列
+
+        :param columns: 列名列表，为空时表示 SELECT *
+        :return: self
+
+        :example:
+        >>> storage.Table("users").Select("name", "age").Execute()
+        """
+        self._operation = "select"
+        self._columns = list(columns)
+        return self
+
+    def Insert(self, data: dict[str, Any]) -> "BaseQueryBuilder":
+        """
+        插入一行数据
+
+        :param data: 列名到值的映射
+        :return: self
+
+        :example:
+        >>> storage.Table("users").Insert({"name": "Alice", "age": 30}).Execute()
+        """
+        self._operation = "insert"
+        self._data = data
+        return self
+
+    def InsertMulti(self, data: list[dict[str, Any]]) -> "BaseQueryBuilder":
+        """
+        批量插入多行数据
+
+        :param data: 列名到值的映射列表
+        :return: self
+
+        :example:
+        >>> storage.Table("users").InsertMulti([
+        ...     {"name": "Alice", "age": 30},
+        ...     {"name": "Bob", "age": 25}
+        ... ]).Execute()
+        """
+        self._operation = "insert_multi"
+        self._data = data
+        return self
+
+    def Update(self, data: dict[str, Any]) -> "BaseQueryBuilder":
+        """
+        更新数据
+
+        :param data: 列名到新值的映射
+        :return: self
+
+        :example:
+        >>> storage.Table("users").Update({"age": 31}).Where("name = ?", "Alice").Execute()
+        """
+        self._operation = "update"
+        self._data = data
+        return self
+
+    def Delete(self) -> "BaseQueryBuilder":
+        """
+        删除行
+
+        :return: self
+
+        :example:
+        >>> storage.Table("users").Delete().Where("name = ?", "Bob").Execute()
+        """
+        self._operation = "delete"
+        return self
+
+    def Where(self, condition: str, *params: Any) -> "BaseQueryBuilder":
+        """
+        添加 WHERE 条件
+
+        多次调用时条件之间以 AND 连接
+
+        :param condition: 条件表达式（使用占位符，如 "age > ?"）
+        :param params: 占位符对应的参数值
+        :return: self
+
+        :example:
+        >>> storage.Table("users").Where("age > ?", 18).Where("name LIKE ?", "A%").Execute()
+        """
+        self._where_clauses.append(condition)
+        self._where_params.extend(params)
+        return self
+
+    def OrderBy(self, column: str, desc: bool = False) -> "BaseQueryBuilder":
+        """
+        添加排序规则
+
+        多次调用时按添加顺序组合 ORDER BY
+
+        :param column: 排序列名
+        :param desc: 是否降序（默认升序）
+        :return: self
+
+        :example:
+        >>> storage.Table("users").OrderBy("age", desc=True).OrderBy("name").Execute()
+        """
+        self._order_by.append((column, desc))
+        return self
+
+    def Limit(self, count: int) -> "BaseQueryBuilder":
+        """
+        限制返回条数
+
+        :param count: 最大返回条数
+        :return: self
+
+        :example:
+        >>> storage.Table("users").Limit(10).Execute()
+        """
+        self._limit = count
+        return self
+
+    def Offset(self, count: int) -> "BaseQueryBuilder":
+        """
+        设置偏移量
+
+        :param count: 跳过的条数
+        :return: self
+
+        :example:
+        >>> storage.Table("users").Limit(10).Offset(20).Execute()
+        """
+        self._offset = count
+        return self
+
+    def copy(self) -> "BaseQueryBuilder":
+        """
+        深拷贝当前构建器状态
+
+        :return: 新的构建器实例
+        """
+        new = self.__class__(self._storage, self._table)
+        new._operation = self._operation
+        new._columns = list(self._columns)
+        new._data = (
+            dict(self._data) if isinstance(self._data, dict)
+            else [dict(d) for d in self._data] if isinstance(self._data, list)
+            else None
+        )
+        new._where_clauses = list(self._where_clauses)
+        new._where_params = list(self._where_params)
+        new._order_by = list(self._order_by)
+        new._limit = self._limit
+        new._offset = self._offset
+        return new
+
+    def clear(self) -> "BaseQueryBuilder":
+        """
+        重置构建器状态
+
+        :return: self
+        """
+        self._operation = None
+        self._columns = []
+        self._data = None
+        self._where_clauses = []
+        self._where_params = []
+        self._order_by = []
+        self._limit = None
+        self._offset = None
+        return self
+
+    @abstractmethod
+    def Execute(self) -> list[tuple] | int:
+        """
+        执行构建的查询
+
+        - SELECT 返回 list[tuple]
+        - INSERT/UPDATE/DELETE 返回受影响行数 int
+
+        :return: 查询结果或受影响行数
+        """
+        ...
+
+    @abstractmethod
+    def ExecuteOne(self) -> tuple | None:
+        """
+        执行查询并返回单条结果
+
+        :return: 单行元组或 None
+        """
+        ...
+
+    @abstractmethod
+    def Count(self) -> int:
+        """
+        执行 COUNT 查询
+
+        :return: 匹配的行数
+        """
+        ...
+
+    @abstractmethod
+    def Exists(self) -> bool:
+        """
+        检查是否存在匹配的记录
+
+        :return: 是否存在
+        """
+        ...
+
+    def __repr__(self) -> str:
+        return (
+            f"{self.__class__.__name__}"
+            f"(table={self._table!r}, op={self._operation!r})"
+        )
+
+
+class BaseStorage(ABC):
+    """
+    存储后端抽象基类
+
+    定义键值存储和表管理的统一接口，所有存储后端必须继承并实现此基类。
+
+    {!--< tips >!--}
+    1. 键值操作（get/set/delete）用于简单数据存取
+    2. Table/CreateTable/DropTable 用于结构化数据操作
+    3. transaction 提供事务支持
+    {!--< /tips >!--}
+    """
+
+    @abstractmethod
+    def get(self, key: str, default: Any = None) -> Any:
+        """
+        获取存储项的值
+
+        :param key: 存储项键名
+        :param default: 默认值
+        :return: 存储项的值
+        """
+        ...
+
+    @abstractmethod
+    def set(self, key: str, value: Any) -> bool:
+        """
+        设置存储项的值
+
+        :param key: 存储项键名
+        :param value: 存储项的值
+        :return: 操作是否成功
+        """
+        ...
+
+    @abstractmethod
+    def delete(self, key: str) -> bool:
+        """
+        删除存储项
+
+        :param key: 存储项键名
+        :return: 操作是否成功
+        """
+        ...
+
+    @abstractmethod
+    def get_all_keys(self) -> list[str]:
+        """
+        获取所有存储项的键名
+
+        :return: 键名列表
+        """
+        ...
+
+    @abstractmethod
+    def clear(self) -> bool:
+        """
+        清空所有存储项
+
+        :return: 操作是否成功
+        """
+        ...
+
+    @abstractmethod
+    def transaction(self) -> Any:
+        """
+        创建事务上下文
+
+        :return: 事务上下文管理器
+        """
+        ...
+
+    @abstractmethod
+    def Table(self, table_name: str) -> BaseQueryBuilder:
+        """
+        获取指定表的查询构建器
+
+        :param table_name: 表名
+        :return: 查询构建器实例
+        """
+        ...
+
+    @abstractmethod
+    def CreateTable(self, table_name: str, columns: dict[str, str]) -> bool:
+        """
+        创建表
+
+        :param table_name: 表名
+        :param columns: 列名到类型的映射（如 {"id": "INTEGER PRIMARY KEY", "name": "TEXT"}）
+        :return: 操作是否成功
+        """
+        ...
+
+    @abstractmethod
+    def DropTable(self, table_name: str) -> bool:
+        """
+        删除表
+
+        :param table_name: 表名
+        :return: 操作是否成功
+        """
+        ...
+
+    @abstractmethod
+    def HasTable(self, table_name: str) -> bool:
+        """
+        检查表是否存在
+
+        :param table_name: 表名
+        :return: 是否存在
+        """
+        ...
+
+    def get_multi(self, keys: list[str]) -> dict[str, Any]:
+        """
+        批量获取多个存储项的值
+
+        :param keys: 键名列表
+        :return: 键值对字典
+        """
+        results = {}
+        for key in keys:
+            value = self.get(key)
+            if value is not None:
+                results[key] = value
+        return results
+
+    def set_multi(self, items: dict[str, Any]) -> bool:
+        """
+        批量设置多个存储项
+
+        :param items: 键值对字典
+        :return: 操作是否成功
+        """
+        for key, value in items.items():
+            if not self.set(key, value):
+                return False
+        return True
+
+    def delete_multi(self, keys: list[str]) -> bool:
+        """
+        批量删除多个存储项
+
+        :param keys: 键名列表
+        :return: 操作是否成功
+        """
+        for key in keys:
+            if not self.delete(key):
+                return False
+        return True
+
+    def keys(self) -> list[str]:
+        """
+        获取所有存储项的键名（代理到 get_all_keys）
+
+        :return: 键名列表
+        """
+        return self.get_all_keys()
+
+    def __getattr__(self, key: str) -> Any:
+        if key.startswith("_"):
+            raise AttributeError(
+                f"'{self.__class__.__name__}' object has no attribute '{key}'"
+            )
+        value = self.get(key)
+        if value is None:
+            raise AttributeError(f"存储项 {key} 不存在")
+        return value
+
+    def __setattr__(self, key: str, value: Any) -> None:
+        if key.startswith("_"):
+            super().__setattr__(key, value)
+            return
+        try:
+            self.set(key, value)
+        except Exception:
+            super().__setattr__(key, value)
+
+
+__all__ = [
+    "BaseStorage",
+    "BaseQueryBuilder",
+]