#Plus版更新日志

#v40.1.15

#修复BUG

• 修复AddNewFriend在4.1.9版本无法正常执行完成的问题
• 修复GetFriendDetails方法在4.1.9版本获取不到备注的问题
• 修复 GetNewFriends 在 4.1.9.x 版本客户端报错的问题
• 修复msg.forward方法无法正常转发给企业用户的问题
• 修复发表朋友圈当图片过多无法正常选择可见范围的问题

#优化

• WeChat实例增加缓存机制，优化初始化速度

#v40.1.14

#新增内容

• GetHistoryMessage 方法增加 goback 参数，可自行指定获取结束后是否返回最新消息位置
• GetFriendDetails 方法增加 callback 参数，可传入回调函数从指定联系人开始获取

#修复BUG

• 修复 GetFriendDetails 在 4.1.9.x 版本客户端报错的问题
• 修复 SendUrlCard 在 4.1.9.x 版本客户端报错的问题
• 修复 msg.forward 在 4.1.9.x 版本客户端报错的问题
• 修复国际版微信报错的问题

#v40.1.13

#新增内容

• WeChat 核心对象新增 version 参数，wx = WeChat(version='WeChat')即可支持国际号码注册的账号客户端
• 新增 GetDialog 方法，用于自行获取某些情况下触发的确认对话框并进行相应处理
• 新增 EditFriendInfo 方法，可修改好友备注、添加标签、移除标签
• ImageMessage 对象新增 ocr 方法，可提取图片中的文字
• [Beta]新增 SendAudio 方法，用于发送语音条消息（需最新4.1.9+版本客户端，以及需要额外配置，可能暂不稳定）

#修复BUG

• 修复 FriendMessage 的 edit_info 方法无法正常修改标签的问题

#优化

• 新增支持 Python3.13
• 兼容 4.1.9 版本客户端
• 优化图片下载，兼容某些默认以内嵌方式打开图片的客户端
• 优化消息转发方法，当消息被撤回时可处理对话框
• 优化发表朋友圈方法，增加图片、视频上传等待时间，可通过wait_upload参数设置

#v40.1.12

#新增内容

• 新增CreateGroup方法，创建群聊
• 新增SetGroupName方法，修改群聊名称
• 新增SetGroupRemark方法，修改群聊备注
• 新增SetGroupAnnouncement方法，修改群公告
• 新增SetGroupMyNickname方法，修改我在群里的昵称
• GetNewFriends方法获取到的新好友对象新增name、msg属性
• FriendMessage 对象新增 edit_info 方法，可修改备注、添加标签、移除标签
• HumanMessage 对象新增 download_head_image 方法，可下载头像图片
• FriendMessage 对象新增 add_friend 方法，可通过消息对象快捷添加好友
• FriendMessage 对象新增 delete_friend 方法，可通过消息对象快捷删除好友

#修复BUG

• 修复 GetNextNewMessage 方法在过滤免打扰时在某些电脑不能正常获取消息的问题

#优化

• 优化 SendMsg 和 SendFiles 方法，更严格的切换机制，避免发错对象

#v40.1.11

• 同时适配4.1.8和4.1.7客户端

#v40.1.10

• 适配4.1.8新版客户端

#v40.1.9

#新增内容

• GetNewFriends方法增加roll_times参数，用于向下滚动好友请求列表
• 新增消息对象TimeMessage，可通过msg.time获取消息时间，yyyy-mm-dd HH:MM:SS格式

#修复BUG

• 修复@多人时无法正常执行的问题
• 修复朋友圈点赞无法正常执行的问题
• 修复发朋友圈卡在选择文件的问题
• 修复在微信支付等官方页面时，GetNextNewMessage方法报错的问题
• 修复在未选中任何聊天页面时，GetNextNewMessage方法报错的问题
• 修复视频过期时，VideoMessage的download方法卡死的问题
• 修复好友引用消息 download_quote_image 方法报错的问题

#优化

• 优化接受好友请求方法，当好友数超过5000时可处理朋友圈权限
• 优化GetHistoryMessage 方法

#v40.1.8

#新增内容

• ImageMessage 和 VideoMessage 的 download 方法增加 dir_path 参数，可指定下载目录
• EmotionMessage 增加 capture 方法，用于截图表情包
• QuoteMessage 增加 download_quote_image 方法，用于下载引用图片
• GetHistoryMessage 方法回调函数支持设置停止条件，当回调函数返回值为 WxParam.CALLBACK_STOP_SIGN 时停止

from wxautox4 import WxParam
from wxautox4.msgs import TimeMessage   # v40.1.9及以上版本支持TimeMessage对象

# 示例：如果找到带有“通知”字眼的消息则停止获取
def history_callback(msg):
    # 当消息内容里包含特定字词时停止
    if '通知' in msg.content:
        print('获取到包含“通知”的消息，停止获取历史消息')
        return WxParam.CALLBACK_STOP_SIGN

    # 当消息时间超过特定时间时停止     # v40.1.9及以上版本支持TimeMessage对象
    if isinstance(msg, TimeMessage) and msg.time < '2026-02-01':
        print('获取到早于2026年2月1日的消息，停止获取历史消息')
        return WxParam.CALLBACK_STOP_SIGN

wx.GetHistoryMessage(n=100, callback=history_callback)

#修复BUG

• 修复当SendMsg输入内容包含[微笑]等默认聊天表情时，无法发送成功的问题
• 修复 VoiceMessage 对象的 sender 属性错误问题
• 修复AddGroupMembers创建群聊无法完成的问题

#优化

• 优化 GetNextNewMessage 方法，获取完后不再关闭当前窗口
• 优化获取实例时间
• 优化获取下一页朋友圈
• 优化适配 4.1.6.46 版本客户端会话内容解析

#v40.1.7

#新增内容

• HumanMessage 新增 delete 方法，删除消息
• 新增 GetDialog 方法，用于获取弹窗，并进行处理

#(Beta)朋友圈相关

• MomentsWnd 对象新增 GetMoments 方法，获取朋友圈信息
• Moment 对象新增 Like 方法，点赞/取消点赞
• Moment 对象新增 Comment 方法，发表评论

#修复BUG

• 修复PublishMoment方法，4.1版本改为先选择照片再编辑文字

#优化

• 优化发送朋友圈，可单独发表文字

#v40.1.6

#新增内容

• 新增GetFriendDetails方法，获取所有联系人信息
• 新增AddGroupMembers方法，邀请好友入群

#修复BUG

• 修复Chat对象缺失chat_type属性的问题
• 修复子窗口SendMsg方法@群成员消息内容过短无法@成功的问题
• 修复AddListenChat方法不打开独立窗口的问题

#v40.1.5

#新增内容

• LinkMessage新增get_url方法，获取卡片消息链接
• WeChat新增resize参数，设置为False时不自动调整窗口尺寸
• ImageMessage和VideoMessage新增original参数，设置为True时下载原图/原视频

#修复BUG

• 修复消息对象的sender属性错误问题
• 修复添加好友报错msgedit属性缺失的问题
• 修复子窗口SendMsg方法无法@群成员的问题
• 修复最小化时获取WeChat实例报错的问题

#优化

• 优化切换聊天窗口的方式，当前会话列表存在目标则不进行搜索
• 优化GetNextNewMessage方法，过滤免打扰时不再频繁跳转会话列表