feat!: intents 只按大类订阅、群消息全量模式与事件流优化

破坏性变更: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 干净。
This commit is contained in:
snowy-yang committed 2026-09-20 21:39:25 +08:00
1 parent 3237558128
commit 71cbfdaf5d
16 files changed
+204 -116

No files matched your search

+47
View File
@@ -28,6 +28,53 @@ def test_parse_group_at_message():
assert msg.author is not None and msg.author.member_openid == "M1"
def test_parse_group_full_message():
msg = parse_event(
"GROUP_MESSAGE_CREATE",
{
"author": {"member_openid": "M2"},
"content": "大家好",
"group_openid": "G1",
"id": "msgid-2",
"timestamp": "2026-01-01",
"message_type": 0,
"message_scene": {"unknown": False},
"attachments": [{"content_type": 1, "url": "https://x/img.png"}],
"mentions": [{"id": "U1"}],
"msg_elements": [{"type": 1, "text_element": {"content": "大家好"}}],
},
)
assert isinstance(msg, GroupAtMessage)
assert msg.group_openid == "G1"
assert msg.user_openid == "M2"
assert msg.message_type == 0
assert msg.message_scene == {"unknown": False}
assert msg.attachments == [{"content_type": 1, "url": "https://x/img.png"}]
assert msg.mentions == [{"id": "U1"}]
assert msg.msg_elements == [{"type": 1, "text_element": {"content": "大家好"}}]
async def test_group_full_message_reaches_typed_handler():
queue = EventQueue()
emitter = EventEmitter(queue)
received: list[GroupAtMessage] = []
@emitter.on("GROUP_MESSAGE_CREATE")
async def handler(msg: GroupAtMessage):
received.append(msg)
await emitter.emit(
{
"op": Opcode.DISPATCH,
"t": "GROUP_MESSAGE_CREATE",
"d": {"content": "hi", "group_openid": "G1"},
}
)
assert len(received) == 1
assert received[0].content == "hi"
assert received[0].group_openid == "G1"
def test_parse_c2c_message():
msg = parse_event(
"C2C_MESSAGE_CREATE",