mirror of
https://github.com/snowy-yang/qqbotsdk.git
synced 2026-10-21 11:29:07 +00:00
snowy-yang
71cbfdaf5d
破坏性变更：intents.toml 订阅粒度收敛到 Intents 大类（分组）—— 配置从「[分组] 表内逐事件开关」改为「分组名 = true/false」。网关只接受 分组位掩码，组内事件本就无法单独订阅，此前的逐事件开关仅是「组内任一 为 true 即订阅整组」的装饰。旧格式不再兼容，与拼错的分组名、非布尔值 一样在启动时直接抛 ValueError，而非静默少订阅。 新增： - GROUP_MESSAGE_CREATE 事件接收（群消息全量模式，与 GROUP_AT_MESSAGE_CREATE 共用 GroupAtMessage）；GroupAtMessage 补齐 message_type/message_scene/ attachments/mentions/ark_data/msg_elements 字段 优化： - 形参注入缓存化：合并缓存 handler 签名与类型标注解析（此前每条事件都重跑 inspect.signature/get_type_hints），services 命中改为每条事件实时判定， 保证「先注册 handler、后登记组件」的既有装配顺序不受影响 - EventQueue.put_event/put_reply 去掉多余的 return await - model.NoneType 联合成员顺序调整（None 置于末尾） 文档同步 GUIDE/API/README/CHANGELOG 与示例；测试 76 全绿，ruff/pyright 干净。
19 lines
1.2 KiB
TOML
19 lines
1.2 KiB
TOML
# =============================================
|
||
# 事件订阅配置（TOML）
|
||
# 订阅粒度就是下面的大类（Intents 分组）：true 订阅该分组，false 不订阅。
|
||
# QQ 网关只认分组位掩码，组内单个事件无法单独开关，
|
||
# 各分组包含哪些事件见 docs/API.md 的「事件名 → dataclass 对照」。
|
||
# =============================================
|
||
|
||
GUILDS = false # (1 << 0) 频道/子频道增删改
|
||
GUILD_MEMBERS = false # (1 << 1) 频道成员增删改
|
||
GUILD_MESSAGES = false # (1 << 9) 频道全量消息，仅 *私域* 机器人
|
||
GUILD_MESSAGE_REACTIONS = false # (1 << 10) 频道表情表态
|
||
DIRECT_MESSAGE = false # (1 << 12) 频道私信
|
||
GROUP_AND_C2C_EVENT = true # (1 << 25) 群/单聊消息、关注与主动消息开关事件
|
||
INTERACTION = true # (1 << 26) 互动事件（卡片按钮回调）
|
||
MESSAGE_AUDIT = false # (1 << 27) 消息审核结果
|
||
FORUMS_EVENT = false # (1 << 28) 论坛事件，仅 *私域* 机器人
|
||
AUDIO_ACTION = false # (1 << 29) 音频播放/上麦下麦
|
||
PUBLIC_GUILD_MESSAGES = false # (1 << 30) 频道公域消息（@机器人）
|