Skip to content

get_essence_msg_list

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

以下查询修复属于v2.0.6;v2.0.5 的旧查询链路仍可能返回 12002

js
const messages = await api.get_essence_msg_list({
  self_id: 1060221,
  client_type: 'android',
  group_id: 123456789,
})
字段类型必填说明
self_idnumber执行请求的 QQ 账号
client_typestringandroidlinuxqq
group_idnumber群号

成功时返回数组,每项包含 msg_seqmsg_randomsender_idsender_nickoperator_idoperator_nickmessage_idoperator_timecontent

content 将原生文本、QQ 表情、图片、文件与分享内容转换为消息段。发送者和操作者 QQ 使用服务器返回值;message_id 是执行查询账号自己的公共消息引用,不可跨账号复用。

登录态失效、网络失败、超时、非法消息标识或分页异常会返回错误,不会伪装成空列表。正常的空列表返回 []。单次读取最多 100 页;超过上限会明确报错,不返回看似完整的部分数据。

该接口只读取精华消息,不会设置或删除精华。v2.0.6支持 Android 和 Linux QQ;Linux 使用该协议会话自己的原生域名凭据,不要求 Android 的 SKey,也不会借用另一个协议账号的登录态。

两个测试 QQ 的 Android/Linux 会话、两个运行节点及两条正向 WS 已完成设置、查询存在、取消、查询消失的交叉验证;事件投递另行逐条校验。这不代表已发布的 v2.0.5 已包含修复。

萌卡 NT · 连接想法,也连接你我。