mirror of
https://github.com/snowy-yang/qqbotsdk.git
synced 2026-10-21 15:14:48 +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 干净。
34 lines
1.0 KiB
Python
34 lines
1.0 KiB
Python
"""Webhook 接入最小示例：HTTP 回调收群 @消息并回复。
|
||
|
||
运行前提：
|
||
1. 项目根目录 .env 配好 APPID/APPSECRET，并设 CONNECTER=webhook；
|
||
2. intents.toml 订阅 GROUP_AND_C2C_EVENT 分组（仓库默认已开启）；
|
||
3. 部署在公网 HTTPS 环境（平台仅支持 80/443/8080/8443 端口，
|
||
本地调试可内网穿透），回调地址填
|
||
https://<你的域名>:<端口><WEBHOOK_PATH>；
|
||
4. 开放平台保存回调配置时会先发 op=13 验证请求，SDK 自动完成签名应答。
|
||
|
||
运行：uv run python examples/webhook_bot/main.py
|
||
"""
|
||
|
||
from qqbotsdk import EventEmitter, main
|
||
from qqbotsdk.api import BotApi
|
||
from qqbotsdk.payloads import GroupAtMessage
|
||
|
||
ee = EventEmitter()
|
||
|
||
|
||
@ee.on("GROUP_AT_MESSAGE_CREATE")
|
||
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,
|
||
)
|
||
|
||
|
||
if __name__ == "__main__":
|
||
main(ee)
|