Embed消息
Embed 是 QQ 开放平台中的结构化消息类型。 在当前组件中，它同样分成 API 层模型与组件层消息元素两层。
API模块
API 层使用的是 love.forte.simbot.qguild.model.Message.Embed。
最常见的入口是：
MessageSendApi.Body.embedDmsSendApi复用同样的发送体EmbedBuilder用于构建Message.Embed
组件库模块
组件层提供 love.forte.simbot.component.qguild.message.QGEmbed， 它是一个 QGMessageElement ，专门用于在 simbot 消息链中携带 Embed。
常用入口包括：
QGEmbed.byEmbed(embed)buildQGEmbed { ... }
发送限制
使用时需要注意：
QGEmbed发送时会独立占用一个MessageSendApi.Body.embedEmbed目前不支持 QQ 群 /C2C的GroupAndC2C发送链路
此外，还需要注意：
什么时候用哪一层
直接写开放平台请求：使用
Message.Embed使用 simbot 消息链：使用
QGEmbed
26 June 2026