仅用于触发搜索,返回搜索结果,不会进行下一步的动作,可自行处理搜索结果
示例:
参数:
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| keywords | str | False | 搜索关键词 |
| force | bool | False | 是否强制等待,避免未搜索到就返回结果 |
| force_wait | Union[float, int] | 0.5 | 强制等待时间,秒 |
返回值:
List[SearchResultElement]
回到会话列表顶部
参数:无
返回值:无
向上滚动会话列表
参数:
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| n | int | 5 | 滚动次数,自行调节滚动幅度 |
返回值:无
向下滚动会话列表
参数:
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| n | int | 5 | 滚动次数,自行调节滚动幅度 |
返回值:无

| 属性 | 类型 | 描述(以上图为例) |
|---|---|---|
| name | str | 会话名(wxauto三群) |
| time | str | 时间(2025-05-14 14:41) |
| content | str | 消息内容([10条]天道酬勤:这..) |
| ismute | bool | 是否消息免打扰(True) |
| isnew | bool | 是否有新消息(True) |
| new_count | int | 新消息数量(10) |
| info | Dict[str, Any] | 会话信息(包含了上述所有属性的dict) |
点击会话,即切换到这个聊天窗口
参数:无
返回值:无
示例:
双击会话,即将这个聊天窗口独立出去
参数:无
返回值:无
示例:
删除会话
{{< callout type="warning" >}} 请谨慎调用该方法,该方法会删除该会话的所有聊天记录,无法恢复!! 请谨慎调用该方法,该方法会删除该会话的所有聊天记录,无法恢复!! 请谨慎调用该方法,该方法会删除该会话的所有聊天记录,无法恢复!! {{< /callout >}}
参数:无
返回值:WxResponse
示例:
隐藏会话
参数:无
返回值:WxResponse
示例:
选择会话选项,即右键点击会话,然后选择某个选项
参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| option | str | 选项名称,例如“置顶”、“标为未读”等 |
返回值:WxResponse
会话搜索结果对象
| 属性 | 类型 | 描述 |
|---|---|---|
| type | str | 搜索结果对象的UI类型,一般pane是分割线或者标签,不可交互;listitem是搜索结果,可交互 |
| text | str | 搜索结果,有时候卡可能为空,建议使用get_all_text方法进行完整判断 |
获取该结果对象的所有UI文字内容,用于判断是不是你要的搜索结果
参数:无
返回值:List[str]
点击该搜索对象
参数:无
返回值:无
关闭搜索窗口,关闭后本次搜索的所有对象均不可再交互
参数:无
返回值:无