功能简介

读取当前聊天窗口中的历史消息，并缓存为最近消息列表。

使用场景

• 需要回溯聊天记录时。

参数说明

输入参数

参数名	类型	必填	说明
获取数量	整数	是	要读取的历史消息最大数量。

输出参数

参数名	类型	必填	说明
消息列表	列表	是	历史消息列表。

注意事项

• 调用前须将微信界面切换到目标聊天窗口。
• 获取历史消息时，将以当前聊天窗口中当前停留的消息位置作为起点继续向上读取，而不是默认从聊天记录最底部开始。
• 获取完成后，聊天窗口会自动滚动到消息底部。
• 若后续需要将本指令返回的消息序号传给下载、点击、引用回复等依赖界面定位的操作指令，通常仅对获取完成后当前聊天窗口底部可见的一屏历史消息范围内的消息更稳定；超出该可见范围的消息即使已出现在输出列表中，也可能无法直接操作。
• 若获取到的消息条数超过请求数量，输出时将优先保留时间较新的消息，并按「获取数量」截断。