[咨询] QQ 官方群机器人适配器:是否推送群成员入群/退群事件?跨平台发送与@的推荐写法?

[BB0813]

背景

我在为下游 AstrBot 插件做「QQ 官方机器人(开放平台群机器人)」兼容时,遇到若干平台层能力问题,插件侧无法自行确认,特来向框架作者咨询。
相关下游需求:mjy1113451/welcome_group#50、mjy1113451/astrbot_plugin_say_picture#61。

问题

1. qqofficial(QQ 官方群机器人)适配器是否会向插件推送「群成员入群/退群」类 notice 事件?若推送,事件结构/字段是什么(是否有类似 OneBot 的 post_type=notice、notice_type=group_increase/group_decrease,或官方自有字段)?插件应如何稳定检测?
2. 在 qqofficial 平台,插件向群内发送消息、以及 @ 某成员的推荐跨平台写法是什么?OneBot 的 bot.send_group_msg + At(qq=) 在官方不适用(官方为 openid),是否有统一抽象?
3. 官方群机器人的主动消息是否有配额/频率限制(例如每月条数),是否会影响「入群欢迎」这类主动发送场景?

期望

确认上述能力边界,以便决定插件侧适配范围(完整支持 vs 非 OneBot 平台优雅降级)。谢谢!

[LIghtJUNction]

按当前 master 的 QQ 官方 WebSocket/Webhook 两条实现核对后，三个问题的能力边界如下。

1. 群成员入群/退群 notice

当前 AstrBot 不会向插件推送此类事件。

• astrbot/core/platform/sources/qqofficial/qqofficial_platform_adapter.py::_ensure_group_message_create_parser 注册的是 message/at/direct/group/c2c 等消息 parser。
• 同文件 botClient 只实现了 on_group_at_message_create、on_group_message_create、频道消息、私聊和 C2C 等消息回调；初始化的 botpy.Intents 也只有 public_messages、public_guild_messages、direct_message。
• Webhook 适配器复用同一个 parser/adapter，因此也没有额外生成 group_increase/group_decrease。

所以插件侧目前没有稳定字段可检测，不能把 OneBot 的 post_type=notice 判断直接套过来。即使 QQ 开放平台存在相关管理事件，也还需要 core 明确订阅、解析并转换成 AstrBot 事件后插件才收得到。

2. 跨平台发送与 @

普通发送应走框架抽象：当前事件内用 yield event.*_result(...) / event.send(...)；延迟主动发送则保存 event.unified_msg_origin，之后调用 self.context.send_message(umo, chain)。仓库文档 docs/zh/dev/star/guides/send-message.md 也是这条路径，不应从插件直接调用 OneBot 的 send_group_msg。

QQ 官方群入站解析在 QQOfficialPlatformAdapter._parse_from_qqofficial 中把成员保存为 member_openid、群保存为 group_openid；_send_by_session_common 最终用 session id 调 post_group_message(group_openid=...)，因此普通跨平台群消息可发。

但 At(qq=...) 当前不能在 QQ 官方适配器中工作：astrbot/core/platform/sources/qqofficial/qqofficial_message_event.py::_parse_to_qqofficial 只序列化 Plain/Image/Record/Video/File，其他组件进入“qq_official 忽略 ...”分支，At 会被静默丢弃。插件现在应按平台能力优雅降级为纯文本提示；若 core 增加支持，应使用 member_openid 的 QQ 官方消息格式，并让不支持/缺少 openid 的情况返回明确结果，不能静默假成功。

3. 主动消息限制

QQOfficialPlatformAdapter.meta() 的 support_proactive_message=True 只是声明适配器具有发送路径；core 中没有看到月度配额计算或频控管理。实际权限和频率由 QQ 开放平台按账号/场景判定。官方群消息接口 当前列出了“主动消息发送超过频控限制”(40034100) 和“无权限”(40034105)，但没有可由 AstrBot 源码保证的固定月条数。因此欢迎消息必须把发送当作可失败操作，按 err_code 记录/返回，做事件去重并避免无界重试。

改进与测试建议

• 在 PlatformMetadata 增加可查询的 member_notice、mention、主动消息语义等细粒度能力，而不是让插件按平台名猜测。
• 若实现成员事件，WebSocket/Webhook 应共享事件转换，保留 group_openid/member_openid/event_id，并覆盖权限未开通、重复投递和乱序。
• 为 At 增加出站序列化测试：合法 member_openid、缺失 openid、混合 Plain+At、Webhook/WS 一致；不支持时至少发出可观察警告/错误。
• 主动发送测试覆盖 40034100/40034105、429、幂等/重复事件以及失败不误报成功。

在这些 core 能力补齐前，“入群欢迎 + 精确 @ 新成员”在 qqofficial 上应标记为不支持，而普通群消息可以使用 UMO 路径支持。