ErisPulse 2.7.0.dev0__tar.gz → 2.7.0.dev3__tar.gz

{erispulse-2.7.0.dev0 → erispulse-2.7.0.dev3}/PKG-INFO

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

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

{erispulse-2.7.0.dev0 → erispulse-2.7.0.dev3}/src/ErisPulse/CLI/commands/create.py

@@ -339,6 +339,21 @@ class {name}(BaseAdapter):
                 "message": result.get("message", ""),
             }}
 
+    class Api(BaseAdapter.Api):
+        \"\"\"
+        标准 API 动作 DSL
+
+        提供跨平台的 OneBot12 标准动作（信息查询/群管理/消息管理/文件操作）。
+        默认实现委托给 call_api，适配器可覆盖单个方法映射到平台原生 API。
+        平台扩展动作通过 call("prefix.action", **params) 调用。
+        \"\"\"
+
+        # 标准方法（get_user_info / get_group_info / delete_message 等）已从基类继承，
+        # 默认委托给 call_api。如需平台特定逻辑，可覆盖单个方法：
+        # async def get_user_info(self, user_id: str) -> dict:
+        #     raw = await self._adapter._request("GET", f"/users/{{user_id}}")
+        #     return self._adapter.make_response(data={{...}}, raw=raw)
+
     async def start(self):
         \"\"\"启动适配器\"\"\"
         cfg = self.cfg

{erispulse-2.7.0.dev0 → erispulse-2.7.0.dev3}/src/ErisPulse/Core/Bases/__init__.py

@@ -4,7 +4,7 @@ ErisPulse 基础模块
 提供平台适配器、模块、存储后端、路由和客户端的基类与抽象接口
 """
 
-from .adapter import SendDSL, RequestDSL, BaseAdapter
+from .adapter import ApiDSL, SendDSL, RequestDSL, BaseAdapter
 from .send_rules import SendContext
 from .send_builder import SendBuilder, BatchContext
 from .module import BaseModule
@@ -38,6 +38,7 @@ from .i18n_schema import (
 __all__ = [
     # 配置 Schema 别名（= BaseConfig）
     "AdapterConfig",
+    "ApiDSL",
     "BaseAdapter",
     "BaseClientWebSocket",
     "BaseConfig",

{erispulse-2.7.0.dev0 → erispulse-2.7.0.dev3}/src/ErisPulse/Core/Bases/adapter.py

@@ -949,6 +949,326 @@ class RequestDSL:
         }
 
 
+class ApiDSL:
+    """
+    标准 API 动作 DSL 基类
+
+    提供 OneBot12 标准动作（get_user_info / get_group_info 等）的强类型方法，
+    模块开发者只需面向标准接口编程，由适配器负责映射到平台原生 API。
+
+    与 SendDSL（消息发送）、RequestDSL（请求操作）并行，覆盖 OneBot12
+    标准动作中的「信息查询 / 状态变更 / 消息管理 / 文件操作」四类操作。
+
+    {!--< tips >!--}
+    1. 标准方法默认委托给 ``adapter.call_api(action_name, ...)``，适配器可按需覆盖
+    2. 使用 ``adapter.Api.Using("bot1").get_user_info("123")`` 指定 Bot 账号
+    3. 平台扩展动作通过 ``call("prefix.action", **params)`` 调用
+    4. 所有方法返回标准 API 响应格式（status / retcode / data / message_id / message）
+    5. 适配器可覆盖单个标准方法以映射到平台 API，无需全部实现
+    {!--< /tips >!--}
+    """
+
+    def __init__(
+        self,
+        adapter: "BaseAdapter",
+        account_id: str | None = None,
+    ):
+        """
+        初始化标准 API 动作 DSL
+
+        :param adapter: 所属适配器实例
+        :param account_id: 执行操作的 Bot 账号（可选）
+        """
+        self._adapter = adapter
+        self._account_id = account_id
+
+    def Using(self, account_id: str | int) -> "Self":
+        """
+        指定执行操作的 Bot 账号
+
+        :param account_id: 账号标识
+        :return: 新的 ApiDSL 实例
+
+        :example:
+        >>> info = await adapter.myplatform.Api.Using("bot1").get_user_info("123")
+        """
+        return self.__class__(self._adapter, str(account_id))
+
+    @property
+    def api_context(self) -> dict:
+        """
+        获取当前 API 操作上下文
+
+        :return: 包含 account_id 的字典
+        """
+        return {
+            "account_id": self._account_id,
+        }
+
+    def _merge_context(self, params: dict) -> dict:
+        """
+        将 api_context 合并到参数字典
+
+        :param params: 业务参数
+        :return: 合并后的参数字典
+        """
+        merged = dict(params)
+        merged.update(self.api_context)
+        return merged
+
+    # ==================== 用户相关动作 ====================
+
+    async def get_self_info(self) -> dict[str, Any]:
+        """
+        获取机器人自身信息
+
+        :return: 标准响应，data 包含 user_id / user_name / user_displayname
+
+        :example:
+        >>> result = await adapter.myplatform.Api.get_self_info()
+        >>> my_name = result["data"]["user_name"]
+        """
+        return await self._adapter.call_api(
+            "get_self_info", **self._merge_context({})
+        )
+
+    async def get_user_info(self, user_id: str) -> dict[str, Any]:
+        """
+        获取用户信息
+
+        :param user_id: 用户 ID（可以是好友，也可以是陌生人）
+        :return: 标准响应，data 包含 user_id / user_name / user_displayname / user_remark
+
+        :example:
+        >>> result = await adapter.myplatform.Api.get_user_info("123456")
+        >>> user_name = result["data"]["user_name"]
+        """
+        return await self._adapter.call_api(
+            "get_user_info", **self._merge_context({"user_id": str(user_id)})
+        )
+
+    async def get_friend_list(self) -> dict[str, Any]:
+        """
+        获取好友列表
+
+        :return: 标准响应，data 为好友信息列表
+
+        :example:
+        >>> result = await adapter.myplatform.Api.get_friend_list()
+        >>> friends = result["data"]
+        """
+        return await self._adapter.call_api(
+            "get_friend_list", **self._merge_context({})
+        )
+
+    # ==================== 群组相关动作 ====================
+
+    async def get_group_info(self, group_id: str) -> dict[str, Any]:
+        """
+        获取群信息
+
+        :param group_id: 群 ID
+        :return: 标准响应，data 包含 group_id / group_name
+
+        :example:
+        >>> result = await adapter.myplatform.Api.get_group_info("123456")
+        >>> group_name = result["data"]["group_name"]
+        """
+        return await self._adapter.call_api(
+            "get_group_info", **self._merge_context({"group_id": str(group_id)})
+        )
+
+    async def get_group_list(self) -> dict[str, Any]:
+        """
+        获取群列表
+
+        :return: 标准响应，data 为群信息列表
+
+        :example:
+        >>> result = await adapter.myplatform.Api.get_group_list()
+        >>> groups = result["data"]
+        """
+        return await self._adapter.call_api(
+            "get_group_list", **self._merge_context({})
+        )
+
+    async def get_group_member_info(
+        self, group_id: str, user_id: str
+    ) -> dict[str, Any]:
+        """
+        获取群成员信息
+
+        :param group_id: 群 ID
+        :param user_id: 用户 ID
+        :return: 标准响应，data 包含 user_id / user_name / user_displayname
+
+        :example:
+        >>> result = await adapter.myplatform.Api.get_group_member_info("123", "456")
+        >>> member = result["data"]
+        """
+        return await self._adapter.call_api(
+            "get_group_member_info",
+            **self._merge_context({"group_id": str(group_id), "user_id": str(user_id)})
+        )
+
+    async def get_group_member_list(self, group_id: str) -> dict[str, Any]:
+        """
+        获取群成员列表
+
+        :param group_id: 群 ID
+        :return: 标准响应，data 为群成员信息列表
+
+        :example:
+        >>> result = await adapter.myplatform.Api.get_group_member_list("123456")
+        >>> members = result["data"]
+        """
+        return await self._adapter.call_api(
+            "get_group_member_list",
+            **self._merge_context({"group_id": str(group_id)})
+        )
+
+    async def set_group_name(self, group_id: str, group_name: str) -> dict[str, Any]:
+        """
+        设置群名称
+
+        :param group_id: 群 ID
+        :param group_name: 新群名称
+        :return: 标准响应
+
+        :example:
+        >>> await adapter.myplatform.Api.set_group_name("123456", "新群名")
+        """
+        return await self._adapter.call_api(
+            "set_group_name",
+            **self._merge_context({"group_id": str(group_id), "group_name": group_name})
+        )
+
+    async def leave_group(self, group_id: str) -> dict[str, Any]:
+        """
+        退出群
+
+        :param group_id: 群 ID
+        :return: 标准响应
+
+        :example:
+        >>> await adapter.myplatform.Api.leave_group("123456")
+        """
+        return await self._adapter.call_api(
+            "leave_group", **self._merge_context({"group_id": str(group_id)})
+        )
+
+    # ==================== 消息管理动作 ====================
+
+    async def delete_message(self, message_id: str) -> dict[str, Any]:
+        """
+        撤回 / 删除消息
+
+        :param message_id: 消息 ID
+        :return: 标准响应
+
+        :example:
+        >>> await adapter.myplatform.Api.delete_message("msg_123456")
+        """
+        return await self._adapter.call_api(
+            "delete_message",
+            **self._merge_context({"message_id": str(message_id)})
+        )
+
+    # ==================== 文件相关动作 ====================
+
+    async def upload_file(
+        self,
+        *,
+        type: str,
+        name: str,
+        url: str | None = None,
+        path: str | None = None,
+        data: bytes | None = None,
+        headers: dict[str, str] | None = None,
+        sha256: str | None = None,
+    ) -> dict[str, Any]:
+        """
+        上传文件
+
+        :param type: 上传方式（``url`` / ``path`` / ``data``）
+        :param name: 文件名（如 ``foo.jpg``）
+        :param url: 文件 URL（``type="url"`` 时必须传入）
+        :param path: 文件路径（``type="path"`` 时必须传入）
+        :param data: 文件数据（``type="data"`` 时必须传入）
+        :param headers: 下载 URL 时附加的 HTTP 请求头（可选）
+        :param sha256: 文件数据的 SHA256 校验和（可选）
+        :return: 标准响应，data 包含 file_id
+
+        :example:
+        >>> result = await adapter.Api.upload_file(
+        ...     type="url", name="logo.jpg", url="https://example.com/logo.jpg"
+        ... )
+        >>> file_id = result["data"]["file_id"]
+        """
+        params: dict[str, Any] = {"type": type, "name": name}
+        if url is not None:
+            params["url"] = url
+        if path is not None:
+            params["path"] = path
+        if data is not None:
+            params["data"] = data
+        if headers is not None:
+            params["headers"] = headers
+        if sha256 is not None:
+            params["sha256"] = sha256
+        return await self._adapter.call_api(
+            "upload_file", **self._merge_context(params)
+        )
+
+    async def get_file(
+        self, file_id: str, type: str = "url"
+    ) -> dict[str, Any]:
+        """
+        获取文件
+
+        :param file_id: 文件 ID
+        :param type: 获取方式（``url`` / ``path`` / ``data``），默认 ``url``
+        :return: 标准响应，data 包含 name / url 或 path 或 data
+
+        :example:
+        >>> result = await adapter.myplatform.Api.get_file("file_abc", "url")
+        >>> download_url = result["data"]["url"]
+        """
+        return await self._adapter.call_api(
+            "get_file",
+            **self._merge_context({"file_id": str(file_id), "type": type})
+        )
+
+    # ==================== 通用扩展动作 ====================
+
+    async def call(self, action: str, **params: Any) -> dict[str, Any]:
+        """
+        调用平台扩展动作（逃生舱）
+
+        用于调用 OneBot12 标准之外的平台扩展动作。
+        建议使用 ``{prefix}.{action}`` 命名（如 ``telegram.send_sticker``），
+        遵循 OneBot12 扩展规则。
+
+        :param action: 动作名称（标准动作名或 ``{prefix}.{action}`` 扩展动作名）
+        :param params: 动作参数
+        :return: 标准响应格式
+
+        :example:
+        >>> # 调用平台扩展动作
+        >>> result = await adapter.myplatform.Api.call(
+        ...     "telegram.send_sticker", sticker_id="CAACAgIAAxkBAA..."
+        ... )
+        >>>
+        >>> # 也可用于调用标准动作（等价于直接调用对应方法）
+        >>> result = await adapter.myplatform.Api.call(
+        ...     "get_user_info", user_id="123"
+        ... )
+        """
+        return await self._adapter.call_api(
+            action, **self._merge_context(params)
+        )
+
+
 class BaseAdapter(ABC):
     """
     适配器基类
@@ -994,6 +1314,22 @@ class BaseAdapter(ABC):
 
         ...
 
+    class Api(ApiDSL):
+        """
+        标准 API 动作 DSL 实现
+
+        提供跨平台的 OneBot12 标准动作接口（信息查询、群管理、消息撤回、文件操作等）。
+
+        {!--< tips >!--}
+        1. 默认实现委托给 ``adapter.call_api(action_name, ...)``，零配置可用
+        2. 适配器可覆盖单个标准方法以映射到平台原生 API
+        3. 平台扩展动作通过 ``call("prefix.action", **params)`` 调用
+        4. 使用 ``adapter.Api.Using("bot1")`` 指定 Bot 账号
+        {!--< /tips >!--}
+        """
+
+        ...
+
     class Send(SendDSL):
         """
         消息发送DSL实现
@@ -1101,9 +1437,11 @@ class BaseAdapter(ABC):
             self.sdk = sdk
             self.logger = sdk.logger.get_child(self.__class__.__name__, relative=False)
 
-        # Send/Request 在类上是 type[SendDSL]，实例化后替换为实例。pyright 无法识别这种“实例属性覆盖嵌套类属性”的模式，故显式 cast。
+        # Send/Request/Api 在类上是嵌套类，实例化后替换为实例。
+        # pyright 无法识别这种"实例属性覆盖嵌套类属性"的模式，故显式 cast。
         self.Send = cast("SendDSL", self.__class__.Send(self))  # pyright: ignore[reportAttributeAccessIssue]
         self.Request = cast("RequestDSL", self.__class__.Request(self))  # pyright: ignore[reportAttributeAccessIssue]
+        self.Api = cast("ApiDSL", self.__class__.Api(self))  # pyright: ignore[reportAttributeAccessIssue]
 
         self._config_instance = None
         self._accounts_data = None
@@ -1625,6 +1963,7 @@ class BaseAdapter(ABC):
 
 
 __all__ = [
+    "ApiDSL",
     "BaseAdapter",
     "RequestDSL",
     "SendDSL",

{erispulse-2.7.0.dev0 → erispulse-2.7.0.dev3}/src/ErisPulse/Core/Event/session_type.py

@@ -270,23 +270,45 @@ def infer_receive_type(event: dict, platform: str | None = None) -> str:
     根据事件数据自动推断接收类型
 
     检查顺序：
-    1. 如果存在 detail_type，直接使用
-    2. 检查各种 ID 字段，按优先级返回
+    1. 如果 ``detail_type`` 是已知的会话类型（标准或自定义），直接使用
+    2. notice/request 事件的 ``detail_type`` 是语义子类型（如 ``group_member_increase``），
+       不是会话类型，此时根据 ID 字段推断
+    3. 最后根据存在的 ID 字段，按优先级返回
 
     :param event: 事件数据字典
     :param platform: 平台名称（可选）
     :return: 推断的接收类型
 
     :example:
-    >>> event = {"group_id": "123"}
+    >>> # 消息事件：detail_type 就是会话类型
+    >>> event = {"type": "message", "detail_type": "group", "group_id": "123"}
     >>> infer_receive_type(event)  # 返回 "group"
+    >>>
+    >>> # 通知事件：detail_type 是语义子类型，从 ID 字段推断
+    >>> event = {"type": "notice", "detail_type": "group_member_increase", "group_id": "123"}
+    >>> infer_receive_type(event)  # 返回 "group"（而非 "group_member_increase"）
+    >>>
+    >>> event = {"type": "notice", "detail_type": "friend_increase", "user_id": "456"}
+    >>> infer_receive_type(event)  # 返回 "private"
     """
-    # 如果已有 detail_type，直接返回
     detail_type = event.get("detail_type")
+
     if detail_type:
-        return detail_type
+        # 只有当 detail_type 是已知会话类型（标准或自定义）时才直接返回。
+        # notice/request 事件的 detail_type（如 group_member_increase / friend）
+        # 是语义子类型，不是会话类型，需从 ID 字段推断正确的会话类型。
+        if detail_type in RECEIVE_TYPES:
+            return detail_type
+
+        # 检查自定义会话类型
+        if platform:
+            custom_key = f"{platform}_{detail_type}"
+            if custom_key in _custom_type_to_id_field:
+                return detail_type
+        if detail_type in _custom_type_to_id_field:
+            return detail_type
 
-    # 根据存在的 ID 字段推断
+    # 从 ID 字段推断会话类型
     # 优先级：group > channel > guild > thread > user
     if event.get("group_id"):
         return "group"

{erispulse-2.7.0.dev0 → erispulse-2.7.0.dev3}/src/ErisPulse/Core/Event/wrapper.py

@@ -526,6 +526,31 @@ async def _builtin_collect(
     return result
 
 
+def _normalize_modifier(mod) -> tuple[str, tuple, dict]:
+    """
+    {!--< internal-use >!--}
+    归一化修饰方法定义为 (name, args, kwargs)
+
+    支持以下形式：
+    - ``"Name"``                            → ``("Name", (), {})``
+    - ``("Name",)``                         → ``("Name", (), {})``
+    - ``("Name", arg1, arg2, ...)``         → ``("Name", (arg1, arg2, ...), {})``
+    - ``("Name", (arg1, arg2), kwargs_dict)`` → 显式位置参数 + 关键字参数
+
+    :param mod: str|tuple - 修饰方法定义（字符串或元组）
+    :return: tuple - ``(方法名, 位置参数元组, 关键字参数字典)``
+    """
+    if isinstance(mod, str):
+        return mod, (), {}
+    name = mod[0]
+    if len(mod) == 1:
+        return name, (), {}
+    if len(mod) == 3 and isinstance(mod[2], dict):
+        args = mod[1] if isinstance(mod[1], (list, tuple)) else (mod[1],)
+        return name, tuple(args), mod[2]
+    return name, tuple(mod[1:]), {}
+
+
 class Event(dict):
     """
     事件包装类
@@ -1093,12 +1118,13 @@ class Event(dict):
     async def reply(
         self,
         content: str,
-        method: str = DEFAULT_SEND_METHOD,
+        method: str | None = None,
         at_sender: bool = False,
         quote: bool = False,
         at_users: list[str] | None = None,
         reply_to: str | None = None,
         at_all: bool = False,
+        via: list | None = None,
         **kwargs,
     ) -> Any:
         """
@@ -1107,15 +1133,27 @@ class Event(dict):
         基于适配器的Text方法，但可以通过method参数指定其他发送方法
 
         :param content: 发送内容（文本、URL等，取决于method参数）
-        :param method: 适配器发送方法，默认为"Text"
-                       可选值: "Text", "Image", "Voice", "Video", "File" 等
+        :param method: str - 适配器发送方法（默认: "Text"）
+                       可选值: "Text", "Image", "Voice", "Video", "File" 等；
+                       使用 via 时必须显式指定
         :param at_sender: 是否@发送者（自动从事件中提取 user_id）
         :param quote: 是否引用回复当前消息（自动从事件中提取 message_id）
         :param at_users: @用户列表（可选），如 ["user1", "user2"]
         :param reply_to: 回复消息ID（可选，手动指定）
         :param at_all: 是否@全体成员（可选），默认为 False
+        :param via: list - 经由的平台修饰方法链（可选，默认: None），按顺序在发送方法前应用。
+                    每个元素可为：
+                    - ``"Name"``（无参）
+                    - ``("Name", arg1, arg2, ...)``（位置参数）
+                    - ``("Name", (arg1, ...), {kw: val})``（位置+关键字参数）
+                    例如 ``[("Expire", 3600), ("ForMember", "uid")]`` 等价于
+                    ``.Expire(3600).ForMember("uid")``。
+                    当需要连续多个修饰方法、或 method 强依赖修饰方法时使用；
+                    更复杂的场景建议用 :meth:`send_chain`
         :param kwargs: 额外参数，例如Mention方法的user_id
-        :return: 适配器发送方法的返回值
+        :return: Any - 适配器发送方法的返回值
+
+        :raises ValueError: 当适配器不支持指定的发送方法/修饰方法时
 
         :example:
         >>> # 简单回复
@@ -1135,7 +1173,23 @@ class Event(dict):
         >>>
         >>> # @全体成员
         >>> await event.reply("公告", at_all=True)
+        >>>
+        >>> # 平台专有修饰方法链 + 看板发送
+        >>> await event.reply("看板内容", method="Board",
+        ...                   via=[("Expire", 3600), ("ForMember", "uid")])
         """
+        if via and method is None:
+            from ..i18n import i18n
+
+            logger.warning(
+                i18n.t(
+                    "core.event.reply_via_without_method",
+                    default_method=DEFAULT_SEND_METHOD,
+                )
+            )
+        if method is None:
+            method = DEFAULT_SEND_METHOD
+
         adapter_instance, detail_type, target_id, bot_id = (
             self._get_adapter_and_target()
         )
@@ -1180,6 +1234,17 @@ class Event(dict):
             send_chain = send_chain.At(user_id)
             method = DEFAULT_SEND_METHOD
 
+        # 应用用户自定义修饰方法（平台专有，如 Expire / ForMember）
+        if via:
+            for mod in via:
+                name, m_args, m_kwargs = _normalize_modifier(mod)
+                mod_attr = getattr(send_chain, name, None)
+                if not mod_attr or not callable(mod_attr):
+                    raise ValueError(f"适配器不支持修饰方法: {name}")
+                send_chain = mod_attr(*m_args, **m_kwargs)
+                if send_chain is None:
+                    raise ValueError(f"修饰方法 '{name}' 必须返回发送链实例")
+
         # 调用指定方法
         send_method = getattr(send_chain, method, None)
         if not send_method or not callable(send_method):
@@ -1234,6 +1299,48 @@ class Event(dict):
             send_chain = send_chain.Using(bot_id)
         return await send_chain.Raw_ob12(message)
 
+    # ==================== 发送链获取 ====================
+
+    def send_chain(self):
+        """
+        获取已配置好目标和发送账号的发送链
+
+        返回已设置 ``To``（目标）和 ``Using``（发送账号）的 SendDSL 实例，
+        可自由追加修饰方法（At/Reply/平台专有修饰）和发送方法。
+
+        适用于 :meth:`reply` 无法覆盖的场景：
+        - 平台专有修饰方法（如云虎的 Expire/ExpireAt/ForMember）
+        - 需要连续多个修饰方法
+        - 无内容参数的动作型发送方法（如 DismissBoard）
+
+        :return: SendDSL - 已设置目标和发送账号的发送链实例
+
+        :raises ValueError: 当事件缺少 platform 字段或找不到对应适配器时
+
+        :example:
+        >>> # 平台专有修饰方法 + 看板发送
+        >>> await event.send_chain().Expire(3600).Board("一小时后过期")
+        >>>
+        >>> # 连续多个修饰方法
+        >>> await (event.send_chain()
+        ...        .Expire(3600)
+        ...        .ForMember("114514")
+        ...        .Board("看板内容", content_type="markdown"))
+        >>>
+        >>> # 内置修饰方法同样可用
+        >>> await event.send_chain().At("123").Reply("msg_id").Text("hi")
+        >>>
+        >>> # 无内容参数的动作型方法
+        >>> await event.send_chain().DismissBoard()
+        """
+        adapter_instance, detail_type, target_id, bot_id = (
+            self._get_adapter_and_target()
+        )
+        send_chain = adapter_instance.Send.To(detail_type, target_id)
+        if bot_id:
+            send_chain = send_chain.Using(bot_id)
+        return send_chain
+
     # ==================== 平台能力查询 ====================
 
     def supports(self, method: str) -> bool:

{erispulse-2.7.0.dev0 → erispulse-2.7.0.dev3}/src/ErisPulse/Core/__init__.py

@@ -9,6 +9,7 @@ from .adapter import adapter, AdapterManager
 from .Bases import (
     BaseAdapter,
     BaseModule,
+    ApiDSL,
     SendDSL,
     SendContext,
     SendBuilder,
@@ -47,6 +48,7 @@ client = HttpClient()
 
 __all__ = [
     "AdapterManager",  # 适配器管理器类
+    "ApiDSL",  # 标准 API 动作 DSL 类
     "BaseAdapter",  # 适配器基类
     "BaseClientWebSocket",  # WebSocket 客户端基类
     "BaseHttpClient",  # HTTP 客户端基类