send_group_forward_msg

上传文本合并转发消息并返回可发送的合并转发消息段。

调用方式

const result = await api.send_group_forward_msg(
  self_id,
  group_id,
  messages,
)

参数

参数	类型	必填	说明
self_id	number	是	在线 Bot QQ 号
group_id	number	是	目标群聊 ID
messages	object[]	是	合并转发节点数组
节点使用以下扁平结构：

{
  user_id: 123456789,
  nickname: '示例用户',
  time: 1710000000,
  message: [{ type: 'text', data: { text: '内容' } }],
}

time 使用 Unix 秒。非 text 消息段会被忽略。

此接口不接受 { type: 'node', data: ... } 或 data.id 引用节点；这两种输入由 send_forward_msg 接口处理。

返回值

{
  success: true,
  res_id: 'RESOURCE_ID',
  message: [{ type: 'ark', data: {} }],
  uploaded_messages: 1,
  discarded_messages: 0,
  discarded_segments: 0,
}

示例

const forward = await api.send_group_forward_msg(self_id, group_id, messages)
await api.send_group_msg(self_id, group_id, forward.message)

当前实现的该 action 只负责上传合并转发内容并生成消息段，不会直接发送；参数中不存在 upload_only。需要发送时，把返回的 message 交给 send_group_msg。