wxauto如何实现Windows微信自动化从UI自动化原理到机器人实战【免费下载链接】wxautoWindows版本微信客户端非网页版自动化可实现简单的发送、接收微信消息简单微信机器人项目地址: https://gitcode.com/gh_mirrors/wx/wxauto如果你需要在 Windows 桌面上用 Python 控制微信客户端非网页版自动收发消息、下载文件、甚至是搭建一个简单的微信机器人那么 wxauto 是一个值得研究的选择。这个项目基于微软的 UIAutomation 技术栈绕开了网页版协议的种种限制直接操作微信 PC 端界面完成自动化。下面我们从为什么难做开始逐步拆解它的设计思路与实现细节。桌面自动化难在哪里先看问题再谈方案给微信写自动化脚本第一反应通常是找协议接口。但个人开发者拿不到官方开放能力网页版微信又早已停止新用户注册于是大家把目光转向了桌面客户端本身。这时候真正的难点浮出水面界面结构不稳定微信窗口里的控件层级复杂会话列表、聊天区域的内容随时在增删变化版本差异大从 3.9 到 4.x不同版本的窗口类名、控件属性都可能有变化脚本很容易换版本即失效操作要够像人如果动作过于机械、频率过高容易触发安全风控甚至被限制登录。wxauto 的解题思路是既然客户端界面长在 Windows 上那就用 Windows 官方的 UI 自动化接口去看和操作它不碰网络协议也不碰内存注入。四条技术路线为什么最终选了 UIAutomation市面上常见的微信自动化手段可以归成四类各有各的代价基于协议WebSocket/HTTP需要官方或第三方服务器支持网页版微信这条路已经基本走不通图像识别用截图 模板匹配定位按钮通用性强但 CPU 开销大分辨率一变就要重新校准内存注入/HOOK效率高、能做高级功能但风险大可能被判为外挂也与项目的开源定位相悖UIAutomationWindows 系统自带的无障碍自动化框架稳定、合规、跨版本适应性较好缺点是需要跑在 Windows 上。wxauto 选择最后一条路用系统的原生能力换取稳定性和开发效率这是它所有设计的地基。换句话说它扮演的是一个模拟人手操作微信窗口的角色而不是伪造网络请求。三步跑通最小脚本从安装到发第一条消息先看效果再谈原理。假设环境是 Windows Python 3.8 及以上微信 PC 版 3.9.x 已登录from wxauto import WeChat # 1. 建立实例自动定位微信主窗口 wx WeChat() # 2. 发送一条消息 wx.SendMsg(你好这是自动化测试, who文件传输助手) # 3. 读取当前聊天窗口的历史消息 for msg in wx.GetAllMessage(): print(f{msg.sender}: {msg.content})这里有几件事值得注意初始化时WeChat()会去查找类名为WeChatMainWndForPC的主窗口找不到会报错SendMsg内部会先切换到目标会话再向输入框键入内容并点击发送按钮拿到的每条消息都是一个Message对象.sender和.content分别表示发送者和内容。想自己动手跑的话从https://gitcode.com/gh_mirrors/wx/wxauto克隆仓库或者直接pip install随后按上面代码执行即可。源码解剖微信窗口是如何被切成三块的WeChat类初始化的核心动作是把微信主窗口拆成三个功能区域这是整个框架的骨架MainControl1 [i for i in self.UiaAPI.GetChildren() if not i.ClassName][0] MainControl2 MainControl1.GetFirstChildControl() # 三栏布局导航栏 / 会话列表 / 聊天框 self.NavigationBox, self.SessionBox, self.ChatBox MainControl2.GetChildren()对应的界面映射很直观NavigationBox导航栏最左侧的图标区头像、聊天、通讯录、朋友圈、设置等入口都归它管成员以A_前缀命名SessionBox会话列表中间的搜索框和聊天对象列表B_前缀ChatBox聊天框右侧消息区域和输入区C_前缀其中C_MsgList就是消息列表控件。完成这三块区域的切分后再对导航栏、搜索框等关键控件做一次定点注册比如A_MyIcon、B_Search、C_MsgList后续所有操作都从这些句柄出发。整个初始化的尾声还会把当前窗口已有的消息 ID 缓存下来作为判断哪些是新消息的基准线——这个细节后面监听部分还会用到。消息识别的魔法靠高度和位置给消息分类微信聊天框里每条消息在 UI 自动化眼里都是一个 ListItem。wxauto 不靠文本内容猜类型而是先看控件的像素高度——这是WeChatBase._split的核心逻辑控件高度px判定类型说明33SYS系统提示如你已添加了对方34Time时间分隔行45Recall撤回消息需文本含撤回其他Friend / Self正常聊天消息这些阈值被定义在WxParam类里SYS_TEXT_HEIGHT、TIME_TEXT_HEIGHT、RECALL_TEXT_HEIGHT等来源是对微信 3.9 版实测得到的经验值。对于正常聊天消息还要进一步区分对方发的和自己发的做法很巧妙取消息条目的中间竖线作为基准如果发送者头像控件位于中线左侧就再看消息上方是否有昵称文本从而得到(昵称, 内容)的二元组如果头像在中线右侧直接标记为Self。消息解析完成后会交给ParseMessage分发最终产出一个带info / control / obj三元组的消息对象后续无论是转发、引用还是下载附件都基于这个对象展开。发送与接收两个方向的实现思路对比发送方向走的是模拟键鼠路线。以SendMsg为例大致流程是需要时先ChatWith(who)切换会话点击输入框用SendKeys键入文本如果要 某人先输入等待弹出联系人选择面板再回车确认查找发送按钮并点击若设置clearTrue用CtrlADelete清空输入框方便连续发送。接收方向则是读取界面 增量对比。框架会记录当前聊天窗口所有消息的 RuntimeId 作为基线轮询时重新拉取消息列表与usedmsgid对比差值就是新消息。GetAllNewMessage(max_round10)会在多个监听会话之间轮询多轮把各会话的新消息聚合后返回。值得注意的是发送超时控制向输入框键入后代码会等待消息真正出现在列表里超过 10 秒仍未出现就抛出TimeoutError避免静默失败。做一个简单机器人监听回调的完整链路wxauto的机器人玩法核心是AddListenChat 回调函数。由于监听跑在守护线程里主线程可能先退出所以官方示例里会调用KeepRunning()挂住进程from wxauto import WeChat from wxauto.msgs import FriendMessage wx WeChat() def on_message(msg, chat): # 把收到的消息写入本地文件 with open(msgs.txt, a, encodingutf-8) as f: f.write(msg.content \n) # 对方发来的消息自动引用回复 if isinstance(msg, FriendMessage): msg.quote(收到) wx.AddListenChat(nickname张三, callbackon_message) wx.KeepRunning()回调函数接收(msg, chat)两个参数msg是消息对象可访问content、type或调用quote()引用回复、download()下载附件chat是对应会话的封装可以调用chat.SendMsg(...)回消息。不需要监听时RemoveListenChat(nickname张三)即可解除。文件、图片、语音的下载链路是怎么走的文本消息直接读控件文本即可但附件必须动手。三条链路各具特色图片找到消息条目里的图片按钮 → 点击放大预览 → 用独立的图片预览窗口对象执行保存 → 返回本地路径文件右键文件 → 弹出CMenuWnd菜单 → 找复制选项 → 从剪贴板读取真实文件路径 → 复制到本地wxauto文件目录。若文件未接收还会先点接收文件再重试语音优先读取控件里已有的转文字结果若没有则右键菜单找语音转文字选项触发转换后轮询等待结果文本出现。这些能力在使用GetAllMessage(savepicTrue, savefileTrue, savevoiceTrue)或监听时设置对应开关即可启用下载完成后消息的content会被替换成本地路径。多语言与兼容性一张语言表撑起三端体验微信在简体中文、繁体中文、英文下的控件文本完全不同直接写死搜索发送这样的字符串换个语言环境就全废。wxauto 的做法是在languages.py里维护一张主语言表和一个警告信息表def _lang(self, text, langtypeMAIN): if langtype MAIN: return MAIN_LANGUAGE[text][self.language] elif langtype WARNING: return WARNING[text][self.language]实例化时传入languagecn / cn_t / en所有控件查找、按钮点击都走_lang()转换。同样的思路还覆盖了图片查看器的上一张/放大/旋转等按钮文案。官方文档同时提示语言关键字收集还不完整欢迎通过 PR 补充——这也是个不错的贡献入口。版本兼容性方面_checkversion()会读取微信安装路径并解析版本号与当前适配版本比对不一致时打印警告。遇到窗口状态异常_refresh()通过CtrlAltW快捷键强制刷新并重新置顶窗口。进阶玩法盘点好友申请、多开登录、合并转发、群管理除了收发消息文档还覆盖了不少实用场景这里挑几个有代表性的自动处理好友申请GetNewFriends(acceptableTrue)拉取新申请friend.accept(remark..., tags...)批量通过并打备注和标签多个微信实例get_wx_clients()获取所有已登录客户端get_wx_logins()获取登录窗口并可批量关闭自动登录与二维码LoginWnd(wxpath)指定微信可执行文件路径login()完成登录get_qrcode()返回登录二维码图片路径方便远程扫码合并转发在会话中打开C_MsgList对最近的HumanMessage调用multi_select()多选再wx.MergeForward(targets)转发给目标联系人创建群聊wx.AddGroupMembers(group张三, members[李四])拉人成群wx.ManageGroup(name新群名)修改群名打字机式发送SendTypingText支持{张三}占位符和换行模拟真人逐字输入好友信息导出GetFriendDetails()遍历通讯录读取昵称、微信号、地区、备注、电话、标签等信息平均约 0.5~1 秒一位注意文档明确警告企业微信的离职好友可能导致微信卡死官方 BUG。踩坑避雷这些坑建议提前知道把源码和文档翻完几个高频坑值得提前标记版本敏感当前仓库适配微信 3.9 系列换 4.x 大概率要等适配或自行改控件属性监听是轮询不是事件新消息靠定时扫描列表对比 ID实时性取决于轮询频率别期待毫秒级推送别在高频场景裸奔自动化脚本没有内置全局限速批量发送时建议自行加间隔规避风控下载目录附件默认存到运行目录下的wxauto文件文件夹路径可自行指定语音转文字依赖菜单项部分语言版本或界面缩放下可能找不到对应菜单代码里做了降级处理但仍有失败概率后台运行的窗口_show()会强制把微信窗口置顶显示纯后台跑服务时需要考虑这一行为。常见问题速览问一定要装微信 PC 版吗是的框架直接操作桌面客户端网页版不支持。问可以多个机器人同时跑吗可以多开微信后用get_wx_clients()区分实例即可。问为什么KeepRunning()是必须的监听跑在守护线程主线程退出会导致整个进程结束。问适配其他版本微信怎么办优先看_checkversion()的版本比对逻辑和languages.py的语言表改动点相对集中。写在最后这套设计的得与失回看整个框架wxauto最聪明的地方在于把操作系统提供的无障碍接口用到了极致用像素高度分类消息、用控件运行时 ID 做增量、用剪贴板中转文件每一个设计都朴素但有效也让整个代码库保持在一个小团队可以维护的规模。代价同样清晰依赖 Windows、绑定具体微信版本、界面一改就要重新适配。这决定了它更适合个人工具与中小规模自动化而不是面向生产环境的强依赖组件。往长远看如果微信推出官方开放接口、或者自动化需求走向云原生部署这类模拟操作方案的边界会被进一步压缩但就眼下而言对于想在合规范围内把收发消息、备份聊天、做机器人这类需求快速落地的开发者它依然是性价比很高的选择。如果你正准备动手建议从发一条消息 → 读一次消息 → 挂一个回调这条最小链路开始跑通之后再逐步叠加文件下载、好友管理这些进阶能力会比直接啃完整文档高效得多。【免费下载链接】wxautoWindows版本微信客户端非网页版自动化可实现简单的发送、接收微信消息简单微信机器人项目地址: https://gitcode.com/gh_mirrors/wx/wxauto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考