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 干净。

examples/README.md

@@ -10,7 +10,7 @@
 ## 运行前提
 
 1. 根目录 `.env` 配好 `APPID`/`APPSECRET`（`webhook_bot` 需另设 `CONNECTER=webhook`）；
-2. `intents.toml` 开启对应事件分组（`group_bot` 需 `GROUP_AND_C2C_EVENT` 与 `INTERACTION`，`webhook_bot` 需 `GROUP_AND_C2C_EVENT`）；
+2. `intents.toml` 订阅对应分组（`group_bot` 需 `GROUP_AND_C2C_EVENT` 与 `INTERACTION`，`webhook_bot` 需 `GROUP_AND_C2C_EVENT`；仓库默认配置已满足两者）；
 3. `group_bot` 要求机器人已开通群聊能力并拉入测试群；`webhook_bot` 要求公网 HTTPS 部署（平台仅支持 80/443/8080/8443 端口，本地调试可用内网穿透）。
 
 ## 运行

examples/group_bot/main.py

@@ -2,7 +2,7 @@
 
 运行前提：
 1. 项目根目录 .env 配好 APPID/APPSECRET（CONNECTER 用默认 websocket）；
-2. intents.toml 开启 GROUP_AND_C2C_EVENT 与 INTERACTION 分组的事件；
+2. intents.toml 订阅 GROUP_AND_C2C_EVENT 与 INTERACTION 两个分组（仓库默认已开启）；
 3. 机器人已在开放平台开通群聊能力，并被拉入测试群。
 
 运行：uv run python examples/group_bot/main.py
@@ -30,7 +30,10 @@ async def on_group_message(msg: GroupAtMessage, api: BotApi) -> None:
             return
         upload = await api.upload_group_file(msg.group_openid, file_type=1, url=url)
         await api.post_group_message(
-            msg.group_openid, content="图来了", msg_id=msg.id, media=upload,
+            msg.group_openid,
+            content="图来了",
+            msg_id=msg.id,
+            media=upload,
         )
         return
 
@@ -49,7 +52,9 @@ async def on_group_message(msg: GroupAtMessage, api: BotApi) -> None:
 
     # 普通文本：带 msg_id 被动回复（5 分钟内有效，同一条消息多次回复递增 msg_seq）
     await api.post_group_message(
-        msg.group_openid, content=f"你说：{msg.content}", msg_id=msg.id,
+        msg.group_openid,
+        content=f"你说：{msg.content}",
+        msg_id=msg.id,
     )
 
 
@@ -62,7 +67,8 @@ async def on_button_click(inter: Interaction, event: Event, api: BotApi) -> None
     # 被动回复的 event_id 是网关帧最外层的 id（形如 INTERACTION_CREATE:uuid），
     # 不是事件体里的裸 UUID——官方文档点名的常见坑
     await api.post_group_message(
-        inter.group_openid, content=f"你点了：{inter.button_data}",
+        inter.group_openid,
+        content=f"你点了：{inter.button_data}",
         event_id=event.event_id,
     )
 
@@ -76,7 +82,9 @@ async def on_robot_added(event: Event, api: BotApi) -> None:
         logger.info(f"机器人加入群聊 {group_openid}（无事件 ID，跳过欢迎语）")
         return
     await api.post_group_message(
-        group_openid, content="大家好，我是本群机器人，@我即可体验～", event_id=event_id,
+        group_openid,
+        content="大家好，我是本群机器人，@我即可体验～",
+        event_id=event_id,
     )
 
 
@@ -86,7 +94,9 @@ async def on_c2c_message(msg: C2CMessage, api: BotApi) -> None:
     if not (user_openid and msg.id):
         return
     # 单聊被动回复 60 分钟内有效，同一 msg_id 最多回复 4 次
-    await api.post_c2c_message(user_openid, content=f"你说：{msg.content}", msg_id=msg.id)
+    await api.post_c2c_message(
+        user_openid, content=f"你说：{msg.content}", msg_id=msg.id
+    )
 
 
 @ee.on("FRIEND_ADD")

examples/webhook_bot/main.py

@@ -2,7 +2,7 @@
 
 运行前提：
 1. 项目根目录 .env 配好 APPID/APPSECRET，并设 CONNECTER=webhook；
-2. intents.toml 开启 GROUP_AT_MESSAGE_CREATE；
+2. intents.toml 订阅 GROUP_AND_C2C_EVENT 分组（仓库默认已开启）；
 3. 部署在公网 HTTPS 环境（平台仅支持 80/443/8080/8443 端口，
    本地调试可内网穿透），回调地址填
    https://<你的域名>:<端口><WEBHOOK_PATH>；
@@ -23,7 +23,9 @@ async def on_group_message(msg: GroupAtMessage, api: BotApi) -> None:
     if not (msg.group_openid and msg.id):
         return
     await api.post_group_message(
-        msg.group_openid, content=f"收到：{msg.content}", msg_id=msg.id,
+        msg.group_openid,
+        content=f"收到：{msg.content}",
+        msg_id=msg.id,
     )