get_essence_msg_list

获取指定群聊的精华消息列表。框架使用当前账号的登录态读取 QQ 群精华服务，自动读取分页。插件不需要提供 Cookie、SKey 或 PsKey，框架也不会把这些凭据返回给插件。

此接口在已认证的服务连接中调用，账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。

适用协议

Android（手机 / 平板）/ Linux QQ；需要有效的群网页登录凭据。

调用方式

向已认证的 WebSocket 连接发送：

{
  "type": "action",
  "id": "example-1",
  "action": "get_essence_msg_list",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "group_id": 987654321
  }
}

响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。

参数

参数	类型	必填	说明
self_id	integer	是	当前框架内的账号 QQ 号
protocol_id	integer	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
group_id	integer	是	目标群号

返回值

以下为成功响应的 data，错误通过 ok: false 与 error 返回。

字段	类型	说明
messages	object[]	转发节点数组，详见下方结构
messages[].group_id	integer	目标群号
messages[].message_id	integer	消息事件或发送结果中的框架消息编号
messages[].msg_seq	integer	上游消息序列号
messages[].msg_random	integer	上游消息随机数
messages[].sender_id	integer	发送者 QQ 号
messages[].sender_avatar	string	发送者头像
messages[].sender_nick	string	发送者昵称
messages[].sender_time	integer	消息发送时间
messages[].operator_id	integer	操作人 QQ 号
messages[].add_digest_avatar	string	设置精华者的头像
messages[].add_digest_nick	string	设置精华者的昵称
messages[].add_digest_time	integer	设置精华的时间
messages[].jump_url	string	跳转地址
messages[].content	object[]	正文内容
messages[].content[].msg_type	integer	内容类型
messages[].content[].text	string	文本内容
messages[].content[].face_index	integer	表情索引
messages[].content[].face_text	string	表情文字
messages[].content[].image_url	string	图片地址
messages[].content[].image_thumbnail_url	string	图片缩略图地址
messages[].content[].share_title	string	分享标题
messages[].content[].share_summary	string	分享说明
messages[].content[].share_brief	string	分享摘要
messages[].content[].share_url	string	分享地址
messages[].content[].share_action	string	分享动作标识
messages[].content[].share_source	string	分享来源
messages[].content[].share_image_url	string	分享封面地址
messages[].content[].file_name	string	文件名
messages[].content[].file_thumbnail_url	string	文件缩略图地址
messages[].content[].file_size	integer	文件大小（字节）
total_count	integer	结果条数
jump_url	string	跳转地址