外观
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_id | number | 是 | 执行请求的 QQ 账号 |
client_type | string | 是 | android 或 linuxqq |
group_id | number | 是 | 群号 |
成功时返回数组，每项包含 msg_seq、msg_random、sender_id、sender_nick、operator_id、operator_nick、message_id、operator_time 和 content。
content 将原生文本、QQ 表情、图片、文件与分享内容转换为消息段。发送者和操作者 QQ 使用服务器返回值；message_id 是执行查询账号自己的公共消息引用，不可跨账号复用。
登录态失效、网络失败、超时、非法消息标识或分页异常会返回错误，不会伪装成空列表。正常的空列表返回 []。单次读取最多 100 页；超过上限会明确报错，不返回看似完整的部分数据。
该接口只读取精华消息，不会设置或删除精华。v2.0.6支持 Android 和 Linux QQ；Linux 使用该协议会话自己的原生域名凭据，不要求 Android 的 SKey，也不会借用另一个协议账号的登录态。
两个测试 QQ 的 Android/Linux 会话、两个运行节点及两条正向 WS 已完成设置、查询存在、取消、查询消失的交叉验证；事件投递另行逐条校验。这不代表已发布的 v2.0.5 已包含修复。