什么是wxauto
wxauto 是一个面向微信桌面端操作的自动化工具，核心思路不是改造微信本身，而是在本地启动 HTTP 服务，把常见的微信动作封装成可调用的接口。围绕 wxautox4 和 RESTful API，它能把“给好友或群聊发消息”“读取聊天记录”“监听新消息”“切换会话窗口”“获取好友与群聊列表”等操作变成程序可控制的流程。对需要把微信接入脚本、服务或内部工具的开发者来说，这类能力的价值在于减少手工点击，把原本零散的桌面交互转成统一的接口调用。
从证据包看，wxauto 的覆盖范围比较完整，既包括主窗口层面的微信实例初始化、在线状态检查、我的信息读取、会话列表获取，也包括具体聊天窗口层面的发消息、拉取全部消息、新消息监听、关闭子窗口等操作。它还支持历史消息获取、群内 @ 成员发送、接受好友申请等微信常见管理任务，因此并不只是一个“代发消息”脚本，而更像是把微信桌面端的一部分日常操作能力开放给本地程序使用。
这个项目的使用边界也很明确。它依赖 Windows 环境，需要 64 位的 Python 3.9 到 3.12，并且要先安装并激活 wxautox4，微信客户端本身也必须保持打开状态。服务端提供 Bearer Token 认证，运行信息会写入本地状态文件，脚本还可以优先读取这些状态并做健康检查，必要时尝试自动启动服务。换句话说，它更适合有一定本地部署能力、希望把微信操作接入既有流程的人，而不是单纯面向普通终端用户的轻量小工具。
核心功能特点
- 通过本地 HTTP 服务操作微信，把发送消息、读取记录、切换窗口等桌面动作统一成可调用接口
- 同时覆盖主窗口与聊天子窗口场景，既能处理全局状态，也能对指定会话做收发消息和新消息获取
- 支持获取好友列表、群聊列表、会话列表及我的信息，便于做联系人管理和会话检索
- 可读取当前消息、历史消息和后续新消息，适合需要轮询或持续监听聊天变化的流程
- 提供 Bearer Token 认证、服务状态文件和自动检测机制，便于脚本连接现有服务或按配置自动启动
- 支持群聊 @ 成员、发送文件、发送链接卡片、引用消息等较细化的聊天操作
适用场景
wxauto 最直接的适用场景，是把微信作为一个可编排的本地通信接口来使用。比如内部通知系统需要把消息同步发到指定好友或工作群，值班脚本需要读取某个会话的新消息并做后续处理，或办公自动化流程希望在完成某项任务后自动切换到目标聊天窗口并发送结果。由于它把这些动作暴露成统一接口，开发者可以不必围绕桌面点击逻辑反复写临时脚本，而是以接口调用的方式组织更稳定的自动化流程。
如果工作中需要基于聊天内容做信息汇总，它也有现实用途。项目支持获取当前窗口消息、历史消息以及新到消息，意味着可以把聊天记录提取到本地系统中，做归档、检索、提醒或轻量分析。再结合好友列表、群聊列表、会话列表等接口，可以比较方便地先定位对象，再按会话维度抓取内容。对于需要周期性查看某些群消息、追踪特定联系人沟通情况的场景，这种能力会比人工逐个打开微信窗口更适合程序接入。
另一个较典型的方向，是做面向个人或小团队的微信桌面助手。证据包里既有初始化、在线检测、页面切换，也有聊天窗口管理、子窗口消息读取和关闭等能力，说明它不只适合单次调用，也能支撑一个持续运行的本地辅助程序。开发者可以据此实现简单的消息中转、会话巡检、群聊提醒、联系人拉取等功能。不过它的前提条件同样不能忽略：必须运行在 Windows，依赖已激活的 wxautox4，且微信客户端要保持开启，因此更适合固定办公环境下的自动化，而不是跨平台或纯云端部署场景。