qqbotsdk-base-py 2.0.0__tar.gz → 2.2.0__tar.gz

{qqbotsdk_base_py-2.0.0 → qqbotsdk_base_py-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: qqbotsdk-base-py
-Version: 2.0.0
+Version: 2.2.0
 Summary: QQ 官方机器人 SDK 基座包：模型基类、共享消息模型与 HTTP 会话
 Author: snowy-yang
 Author-email: snowy-yang <102860110+snowy-yang@users.noreply.github.com>

{qqbotsdk_base_py-2.0.0 → qqbotsdk_base_py-2.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "qqbotsdk-base-py"
-version = "2.0.0"
+version = "2.2.0"
 description = "QQ 官方机器人 SDK 基座包：模型基类、共享消息模型与 HTTP 会话"
 readme = "README.md"
 requires-python = ">=3.12"

{qqbotsdk_base_py-2.0.0 → qqbotsdk_base_py-2.2.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "qqbotsdk-base-py"
-version = "2.0.0"
+version = "2.2.0"
 description = "QQ 官方机器人 SDK 基座包：模型基类、共享消息模型与 HTTP 会话"
 readme = "README.md"
 authors = [

{qqbotsdk_base_py-2.0.0 → qqbotsdk_base_py-2.2.0}/src/qqbotsdk/api/core.py

@@ -22,6 +22,7 @@ import asyncio
 import os
 import random
 from collections.abc import Awaitable, Callable, Generator, Mapping
+from contextlib import contextmanager
 from types import TracebackType
 from typing import Any, Final, cast
 from urllib.parse import urlparse
@@ -414,8 +415,24 @@ class QQBotSession:
         return self._ensure()
 
     async def request(self, method: str, url: str, **kwargs: Any) -> ClientResponse:
-        """返回已读取完成的响应, 便于需要自行处理状态码的场景."""
-        return await self._ensure().request(method, url, **kwargs)
+        """通用 verb 请求: 与 ``get`` / ``post`` 等完全同构, 同样走 429 重试.
+
+        ``method`` 可以是任意 HTTP verb, 便于按配置分发。行为与
+        ``get`` / ``post`` / ``put`` / ``patch`` / ``delete`` 一致:
+
+        - 命中 HTTP 429 时按 ``Retry-After`` / 指数退避自动重试, 最多
+          ``MAX_RETRIES`` 次;
+        - 非 2xx 抛 :class:`qqbotsdk.errors.QQBotAPIError`(OpenAPI 域名下);
+        - 返回的响应**未**读取 body, 调用方自己 ``await resp.json()`` 或
+          ``await resp.read()``, 用完由本方法的上下文管理器释放连接::
+
+            async with session.request("GET", "/users/@me") as resp:
+                data = await resp.json()
+
+        注意: 直接 ``await session.request(...)`` 拿到的响应不会自动释放,
+        与 aiohttp 原生语义一致, 建议一律用 ``async with``.
+        """
+        return await self._request_context(method, url, **kwargs)
 
     @property
     def closed(self) -> bool:
@@ -434,7 +451,100 @@ class QQBotSession:
         await self.close()
 
 
-session = QQBotSession()
+# 默认会话: 未注入时所有请求都走它
+_DEFAULT_SESSION: Final = QQBotSession()
+
+# 当前注入的会话; None 表示用默认会话
+_injected_session: QQBotSession | None = None
+
+
+class _SessionRouter:
+    """``session`` 的转发实现: 每次调用都重新解析当前生效的会话.
+
+    模块级 ``session`` 必须是**稳定的转发层**而不是会话本身: 业务模块的
+    ``from ... import session`` 在 import 期就把名字绑死了, 如果 ``session`` 是会话
+    实例, 注入就要去改各模块的模块属性(打补丁), 测起来很脆. 这里让名字稳定不变,
+    真正的会话由 :func:`set_session` 换, 所有 import 过它的模块自动看到新会话.
+    """
+
+    __slots__ = ()
+
+    def __getattr__(self, name: str) -> Any:
+        """未显式定义的属性一律转发到当前生效的会话.
+
+        注意这是「转发引用」: ``session.some_attr = x`` 只会写到本代理上, 不会写到
+        真正的会话. 需要改内部状态请用 :func:`get_session` 拿真实会话.
+        """
+        return getattr(resolve_session(), name)
+
+    def _ensure(self) -> ClientSession:
+        """确保当前会话的连接池已创建, 返回底层 ``ClientSession``."""
+        session = resolve_session()
+        return session._ensure()  # pyright: ignore[reportPrivateUsage]
+
+    async def __aenter__(self) -> ClientSession:
+        return self._ensure()
+
+    async def __aexit__(self, *_exc: object) -> None:
+        return None
+
+
+def resolve_session() -> QQBotSession:
+    """返回当前生效的会话对象: 注入了就用注入的, 否则用模块级默认单例."""
+    return _DEFAULT_SESSION if _injected_session is None else _injected_session
+
+
+def get_session() -> QQBotSession:
+    """返回当前生效的会话对象, 供需要改内部状态(例如测试)的场景使用."""
+    return resolve_session()
+
+
+@contextmanager
+def use_session(session: QQBotSession) -> Generator[QQBotSession]:
+    """在 ``with`` 块内让所有 ``qqbotsdk`` 请求改走指定会话, 退出后还原.
+
+    用于单测: 构造一个指向本地假服务端的会话传进来, 业务模块与 ``ctx.api`` 都会
+    自动用它, 不会误连真实域名.
+
+    Args:
+        session: 要临时启用的会话对象.
+
+    Yields:
+        传入的会话对象本身.
+    """
+    set_session(session)
+    try:
+        yield session
+    finally:
+        reset_session()
+
+
+def set_session(session: QQBotSession | None) -> None:
+    """替换全局会话(传 None 表示恢复默认单例).
+
+    Args:
+        session: 新的会话对象, 或 None.
+
+    Notes:
+        被替换掉的会话不会被自动关闭, 调用方自己决定何时 ``await it.close()``.
+    """
+    global _injected_session
+    _injected_session = session
+
+
+def reset_session() -> None:
+    """恢复默认单例, 供测试夹具收尾使用(不关闭任何会话)."""
+    global _injected_session
+    _injected_session = None
+
+
+session = _SessionRouter()
+"""当前生效会话的转发入口, 用法与 ``aiohttp.ClientSession`` 一致.
+
+``from qqbotsdk.api.core import session`` 拿到的就是这个对象; 它本身不持有连接,
+真正的会话由 :func:`get_session` / :func:`set_session` 决定, 因此测试里可以整体
+换成假服务端上的会话.
+"""
 
 __all__ = [
     "BASE_URL",
@@ -445,5 +555,9 @@ __all__ = [
     "RETRY_TOTAL_WAIT_SECONDS",
     "QQBotResponse",
     "QQBotSession",
+    "get_session",
+    "reset_session",
     "session",
+    "set_session",
+    "use_session",
 ]

qqbotsdk_base_py-2.0.0/src/qqbotsdk/errors.py → qqbotsdk_base_py-2.2.0/src/qqbotsdk/errors/__init__.py

@@ -8,13 +8,23 @@
     +-- QQBotGatewayError       WebSocket 网关层错误
 
 调用方 ``except QQBotError`` 可以兜住全部错误, 也可以按层分别处理.
+
+业务错误码常量见子模块 :mod:`qqbotsdk.errors.codes`::
+
+    from qqbotsdk.errors import QQBotAPIError, codes
+
+    if exc.err_code == codes.MSG_DEDUPLICATED:
+        ...
 """
 
+from qqbotsdk.errors import codes
+
 __all__ = [
     "QQBotAPIError",
     "QQBotAuthError",
     "QQBotError",
     "QQBotGatewayError",
+    "codes",
 ]
 
 

qqbotsdk_base_py-2.2.0/src/qqbotsdk/errors/codes.py

@@ -0,0 +1,129 @@
+"""OpenAPI 业务错误码常量.
+
+``QQBotAPIError.err_code`` 是**业务错误码**, 与 HTTP 状态码分开: HTTP 200 时
+也可能带非零 ``err_code``. 用这里的常量替代魔法数字::
+
+    from qqbotsdk.errors import QQBotAPIError, codes
+
+    try:
+        await ctx.reply("...")
+    except QQBotAPIError as exc:
+        if exc.err_code == codes.MSG_MSG_ID_EXPIRED:
+            ...
+
+命名规范: 前缀是错误码所属的域(``MSG_`` 消息、``APP_`` 应用权限、
+``FILE_`` 文件), 名字取官方错误表里英文标识的大写形式; 官方只给了中文描述的,
+按描述意译.
+
+来源: 官方 [API 调用指南 · 公共错误码] 与各接口页的「错误码」表. 标注为
+「实践观察」的几条未收录在官方公共错误表中, 来自真实 bot 的调用日志, 平台可能
+调整, 不要把它们当成稳定契约.
+"""
+
+from typing import Final
+
+# ---------------------------------------------------------------- 消息收发
+
+MSG_DEDUPLICATED: Final = 40054005
+"""相同 msg_id + msg_seq 重复发送被去重. 递增 msg_seq 即可."""
+
+MSG_ID_EXPIRED: Final = 40034005
+"""回复消息的 msg_id 已过期, 请在收到消息后尽快回复."""
+
+EVENT_ID_INVALID: Final = 40034025
+"""请求参数 event_id 无效或越权."""
+
+EVENT_ID_EXPIRED: Final = 40034026
+"""请求参数 event_id 已过期, 请在收到事件后尽快回复."""
+
+EVENT_NOT_REPLYABLE: Final = 40034027
+"""该事件不支持回复消息. 例如 GROUP_MEMBER_ADD 只能发主动消息."""
+
+MSG_TYPE_MISMATCH: Final = 22006
+"""消息类型与内容不匹配(例如 msg_type=2 却只传了 content)."""
+
+MSG_TYPE_INVALID: Final = 340069
+"""消息类型无效, 检查 msg_type 取值."""
+
+MSG_CONTENT_INVALID: Final = 304061
+"""消息内容无效, 检查消息格式."""
+
+MSG_LENGTH_EXCEEDED: Final = 40054007
+"""消息长度超限."""
+
+MSG_URL_NOT_ALLOWED: Final = 40054010
+"""不允许发送 URL."""
+
+MSG_PASSIVE_LIMIT: Final = 40034128
+"""被动回复时间或次数超限(群聊 5 次 / 单聊 4 次)."""
+
+MSG_ACTIVE_RATE_LIMITED: Final = 40034100
+"""主动消息发送超过频控限制."""
+
+BOT_NOT_IN_GROUP: Final = 40054003
+"""机器人不是群成员."""
+
+BOT_MUTED: Final = 40054002
+"""机器人被禁言, 等解禁后再发送."""
+
+BOT_OFFLINE: Final = 40054016
+"""机器人已下线, 检查网关连接状态."""
+
+MEDIA_TRANSFER_FAILED: Final = 40034004
+"""富媒体信息转存失败, 可重试."""
+
+FILE_INFO_INVALID: Final = 304080
+"""文件信息无效, 检查 file_info 格式."""
+
+MSG_ID_EXPIRED_ALT: Final = 304103
+"""消息 ID 已过期, 不能回复."""
+
+# ---------------------------------------------------------------- 应用与权限
+
+APP_PRIVILEGE_NOT_PASS: Final = 11253
+"""应用权限不通过: 该机器人未获得调用该接口的权限, 需要向平台申请."""
+
+APP_PRIVILEGE_CHECK_FAILED: Final = 11252
+"""检查应用权限失败(系统错误), 通常重试一次即可."""
+
+APP_INTERFACE_FORBIDDEN: Final = 11254
+"""应用接口被封禁: 有该接口权限但被封禁."""
+
+BOT_BANNED: Final = 11265
+"""机器人已经被封禁."""
+
+# ---------------------------------------------------------------- 实践观察
+# 以下未收录在官方公共错误码表中, 来自真实 bot 的调用日志, 平台可能调整.
+
+GROUP_FILE_NO_PERMISSION: Final = 40093005
+"""群文件无权限(实践观察). 常见于机器人缺少群文件读写权限时."""
+
+QQ_STREAM_FETCH_FAILED: Final = 40093007
+"""QQ 抓流失败(实践观察). 常见于语音 / 视频链接平台侧拉取失败."""
+
+__all__ = [
+    "APP_INTERFACE_FORBIDDEN",
+    "APP_PRIVILEGE_CHECK_FAILED",
+    "APP_PRIVILEGE_NOT_PASS",
+    "BOT_BANNED",
+    "BOT_MUTED",
+    "BOT_NOT_IN_GROUP",
+    "BOT_OFFLINE",
+    "EVENT_ID_EXPIRED",
+    "EVENT_ID_INVALID",
+    "EVENT_NOT_REPLYABLE",
+    "FILE_INFO_INVALID",
+    "GROUP_FILE_NO_PERMISSION",
+    "MEDIA_TRANSFER_FAILED",
+    "MSG_ACTIVE_RATE_LIMITED",
+    "MSG_CONTENT_INVALID",
+    "MSG_DEDUPLICATED",
+    "MSG_ID_EXPIRED",
+    "MSG_ID_EXPIRED_ALT",
+    "MSG_LENGTH_EXCEEDED",
+    "MSG_PASSIVE_LIMIT",
+    "MSG_TYPE_INVALID",
+    "MSG_TYPE_MISMATCH",
+    "MSG_URL_NOT_ALLOWED",
+    "QQ_STREAM_FETCH_FAILED",
+]

{qqbotsdk_base_py-2.0.0 → qqbotsdk_base_py-2.2.0}/src/qqbotsdk/model/sub/messages.py

@@ -1,8 +1,8 @@
-from typing import Literal
+from typing import Any, ClassVar, Literal, cast
 
-from pydantic import Field
+from pydantic import Field, model_validator
 
-from qqbotsdk.model.core import QQBotBaseModel
+from qqbotsdk.model.core import QQBotBaseModel, QQBotRequestModel
 
 
 class Permission(QQBotBaseModel):
@@ -76,8 +76,10 @@ class Action(QQBotBaseModel):
 class RenderData(QQBotBaseModel):
     label: str | None = Field(
         default=None,
-        max_length=10,
-        description="按钮文字，最多 10 字符",
+        description=(
+            "按钮文字。平台限制为最多 10 字符，超出部分由平台自行裁剪；"
+            "SDK 不在此处校验长度，避免用热词/标题等业务数据时被 ValidationError 卡住"
+        ),
     )
     visited_label: str | None = Field(
         default=None,
@@ -207,3 +209,65 @@ class MessageCard(QQBotBaseModel):
         default=None,
         description="卡片元素；type=tuwen 时必须包含 title/description/url/pic_url",
     )
+
+
+class MessageSendRequestBase(QQBotRequestModel):
+    """发送消息请求的公共校验: 按内容字段推导 ``msg_type``, 并校验内容互斥.
+
+    平台的 ``msg_type`` 与内容字段是一一对应的(``content``→0、``markdown``→2、
+    ``input_notify``→6、``media``→7、``card``→8), 但两个字段都是可选的: 只填
+    ``markdown`` 而不填 ``msg_type`` 时, 请求体会缺 ``msg_type`` 而只剩内容字段,
+    语义全靠平台默认推断. 这里在**校验前**按填入的字段补齐 ``msg_type``, 让
+    ``SendXxxMessagesRequest(markdown=...)`` 直接就是一个合法的请求.
+
+    同时把原来只写在 docstring 里的互斥关系变成真校验:
+
+    - ``markdown`` / ``media`` / ``card`` / ``input_notify`` 四者至多填一个;
+    - ``content`` 与 ``markdown`` 互斥(官方: 传了 markdown 后 content 必须为空);
+    - ``content`` 可以与 ``media`` 共存, 作为富媒体的附带文本.
+
+    显式传了 ``msg_type`` 但与内容字段对不上时直接报错, 而不是把矛盾发给服务端.
+    """
+
+    # 内容字段 -> 该字段对应的 msg_type
+    _MSG_TYPE_BY_FIELD: ClassVar[dict[str, int]] = {
+        "markdown": 2,
+        "media": 7,
+        "card": 8,
+        "input_notify": 6,
+    }
+
+    @model_validator(mode="before")
+    @classmethod
+    def _infer_msg_type(cls, data: Any) -> Any:
+        """补齐 ``msg_type`` 并校验内容字段互斥."""
+        if not isinstance(data, dict):
+            return data
+        raw = cast("dict[str, Any]", data)
+        filled = [name for name in cls._MSG_TYPE_BY_FIELD if raw.get(name) is not None]
+        if len(filled) > 1:
+            raise ValueError(f"消息内容字段互斥，不能同时传 {filled}")
+        has_content = raw.get("content") is not None
+        if has_content and "markdown" in filled:
+            raise ValueError(
+                "content 与 markdown 互斥：传了 markdown 时 content 必须为空"
+            )
+
+        if filled:
+            inferred = cls._MSG_TYPE_BY_FIELD[filled[0]]
+        elif has_content:
+            inferred = 0
+        else:
+            # 没有任何内容字段(例如只带键盘), 保持原样交给平台判断
+            return raw
+
+        declared = raw.get("msg_type")
+        if declared is None:
+            return {**raw, "msg_type": inferred}
+        if declared != inferred:
+            source = filled[0] if filled else "content"
+            raise ValueError(
+                f"msg_type={declared!r} 与内容字段 {source!r} 不匹配，"
+                f"按 {source!r} 应为 {inferred}"
+            )
+        return raw

{qqbotsdk_base_py-2.0.0 → qqbotsdk_base_py-2.2.0}/src/qqbotsdk/ws/__init__.py

@@ -1,16 +1,18 @@
 """网关 WebSocket 客户端.
 
 对外只需要几个名字: ``Intents``(事件订阅位), ``DEFAULT_INTENTS``(默认订阅),
-``GatewayPayload``(事件数据包), ``ReadyContent``(READY 事件体),
-``QQBotWebSocket``(连接客户端), ``WILDCARD_EVENT``(通配事件名) 与 ``Handler``(回调类型).
+``GROUP_BOT_INTENTS``(只做群聊 / 单聊的订阅位), ``GatewayPayload``(事件数据包),
+``ReadyContent``(READY 事件体), ``QQBotWebSocket``(连接客户端),
+``WILDCARD_EVENT``(通配事件名) 与 ``Handler``(回调类型).
 """
 
 from qqbotsdk.ws.client import WILDCARD_EVENT, Handler, QQBotWebSocket
-from qqbotsdk.ws.intents import DEFAULT_INTENTS, Intents
+from qqbotsdk.ws.intents import DEFAULT_INTENTS, GROUP_BOT_INTENTS, Intents
 from qqbotsdk.ws.payload import GatewayPayload, OpCode, ReadyContent, ReadyUser
 
 __all__ = [
     "DEFAULT_INTENTS",
+    "GROUP_BOT_INTENTS",
     "WILDCARD_EVENT",
     "GatewayPayload",
     "Handler",

{qqbotsdk_base_py-2.0.0 → qqbotsdk_base_py-2.2.0}/src/qqbotsdk/ws/client.py

@@ -71,6 +71,26 @@ _FATAL_CLOSE_CODES: Final = frozenset(
     {4001, 4002, 4010, 4011, 4012, 4013, 4014, 4914, 4915}
 )
 
+# 不可重连关闭码的可读原因, 让报错直接指向怎么修
+_FATAL_CLOSE_REASONS: Final = {
+    4001: "无效的 opcode",
+    4002: "无效的 payload",
+    4010: "无效的 shard",
+    4011: "连接数超过限制",
+    4012: "无效的 API 版本",
+    4013: (
+        "无效的 intents：其中有当前应用不可订阅的事件位；"
+        "到开放平台确认该 intents 已在「事件订阅」中开通"
+    ),
+    4014: (
+        "无权限的 intents：该 intents 未在开放平台开通；"
+        "到「开发设置 → 事件订阅」申请对应事件，或改用 "
+        "GROUP_BOT_INTENTS 收窄订阅范围"
+    ),
+    4914: "机器人已下架, 请到开放平台检查应用状态",
+    4915: "机器人已被封禁",
+}
+
 # 其余关闭码(含 4006, 4007, 4900~4913)一律清空会话后重新 Identify
 
 
@@ -509,7 +529,11 @@ class QQBotWebSocket:
             # 主动关闭, 无需重连
             return
         if code in _FATAL_CLOSE_CODES:
-            error = QQBotGatewayError("网关拒绝连接，不可重连", code=code)
+            reason = _FATAL_CLOSE_REASONS.get(code)
+            message = "网关拒绝连接，不可重连"
+            if reason is not None:
+                message = f"{message}：{reason}"
+            error = QQBotGatewayError(message, code=code)
             self._last_error = error
             raise _StopGateway(str(error))
         if code in _RESUMABLE_CLOSE_CODES:

qqbotsdk_base_py-2.2.0/src/qqbotsdk/ws/intents.py

@@ -0,0 +1,62 @@
+"""网关事件订阅位(Intents).
+
+Intents 是一个位掩码, 在 Identify 时上报给网关, 声明机器人希望订阅哪些事件;
+未订阅的事件不会下发. 用按位或组合多个位::
+
+    from qqbotsdk.ws import Intents
+
+    intents = Intents.GROUP_AND_C2C_EVENT | Intents.PUBLIC_GUILD_MESSAGES
+
+``GROUP_MEMBER_EVENT`` (1<<24) 没有出现在官方「事件订阅与通知」的总表里, 但
+``GROUP_MEMBER_ADD`` 与 ``GROUP_JOIN_REQUEST`` 两篇事件文档标注的 intent 都是它;
+官方 Python SDK (botpy) 至今也没有这一位. 需要群成员进出 / 入群申请事件时显式
+订阅它.
+"""
+
+from enum import IntFlag
+from typing import Final
+
+
+class Intents(IntFlag):
+    """事件订阅位, 每一位对应一类事件."""
+
+    GUILDS = 1 << 0
+    GUILD_MEMBERS = 1 << 1
+    GUILD_MESSAGES = 1 << 9
+    GUILD_MESSAGE_REACTIONS = 1 << 10
+    DIRECT_MESSAGE = 1 << 12
+    GROUP_MEMBER_EVENT = 1 << 24
+    GROUP_AND_C2C_EVENT = 1 << 25
+    INTERACTION = 1 << 26
+    MESSAGE_AUDIT = 1 << 27
+    FORUMS_EVENT = 1 << 28
+    AUDIO_ACTION = 1 << 29
+    PUBLIC_GUILD_MESSAGES = 1 << 30
+
+
+# 默认订阅: 群与单聊消息, 公域频道消息, 频道成员变更, 交互事件
+DEFAULT_INTENTS: Final = (
+    Intents.GROUP_AND_C2C_EVENT
+    | Intents.PUBLIC_GUILD_MESSAGES
+    | Intents.GUILD_MEMBERS
+    | Intents.INTERACTION
+)
+
+# 只做群聊 / 单聊的机器人用这一组: 不含任何频道域订阅位
+GROUP_BOT_INTENTS: Final = Intents.GROUP_AND_C2C_EVENT | Intents.INTERACTION
+"""群聊 / 单聊机器人的订阅位.
+
+``DEFAULT_INTENTS`` 带两个频道位(``GUILD_MEMBERS`` / ``PUBLIC_GUILD_MESSAGES``,
+按官方文档它们属于基础事件、默认有权限, 不会导致连接被拒), 只做群聊的机器人用
+这组更贴合实际订阅范围, 也少一位需要考虑权限的位.
+
+注意 ``INTERACTION`` 属于需要申请的特殊事件: 如果机器人不用消息按钮 / 快捷菜单,
+可以进一步收窄成 ``Intents.GROUP_AND_C2C_EVENT``. 订阅了没开通的 intent, 网关会用
+关闭码 4013 / 4014 直接断开.
+"""
+
+__all__ = [
+    "DEFAULT_INTENTS",
+    "GROUP_BOT_INTENTS",
+    "Intents",
+]

qqbotsdk_base_py-2.0.0/src/qqbotsdk/ws/intents.py

@@ -1,42 +0,0 @@
-"""网关事件订阅位(Intents).
-
-Intents 是一个位掩码, 在 Identify 时上报给网关, 声明机器人希望订阅哪些事件;
-未订阅的事件不会下发. 用按位或组合多个位::
-
-    from qqbotsdk.ws import Intents
-
-    intents = Intents.GROUP_AND_C2C_EVENT | Intents.PUBLIC_GUILD_MESSAGES
-"""
-
-from enum import IntFlag
-from typing import Final
-
-
-class Intents(IntFlag):
-    """事件订阅位, 每一位对应一类事件."""
-
-    GUILDS = 1 << 0
-    GUILD_MEMBERS = 1 << 1
-    GUILD_MESSAGES = 1 << 9
-    GUILD_MESSAGE_REACTIONS = 1 << 10
-    DIRECT_MESSAGE = 1 << 12
-    GROUP_AND_C2C_EVENT = 1 << 25
-    INTERACTION = 1 << 26
-    MESSAGE_AUDIT = 1 << 27
-    FORUMS_EVENT = 1 << 28
-    AUDIO_ACTION = 1 << 29
-    PUBLIC_GUILD_MESSAGES = 1 << 30
-
-
-# 默认订阅: 群与单聊消息, 公域频道消息, 频道成员变更, 交互事件
-DEFAULT_INTENTS: Final = (
-    Intents.GROUP_AND_C2C_EVENT
-    | Intents.PUBLIC_GUILD_MESSAGES
-    | Intents.GUILD_MEMBERS
-    | Intents.INTERACTION
-)
-
-__all__ = [
-    "DEFAULT_INTENTS",
-    "Intents",
-]