用途:通过 wxautox4 RESTful API 操作微信,支持消息收发、监听、好友与群聊管理、会话与窗口切换等。
主要能力:发送消息(含 @群成员、精确匹配、子窗口发送)、读取聊天记录与历史消息、轮询新消息、添加监听、获取会话/好友/群聊列表、获取我的信息、切换聊天与联系人页面、发送文件与 URL 卡片、引用消息等。
使用方式:先检测操作系统。非 Windows 设备无法本地运行服务,需向用户获取远程服务地址与 Bearer Token,调用 GET /v1/wechat/status 验证连通后执行操作。Windows 设备可本地部署:pip install wxautox4,用 wxautox4 -a your-activation-code 激活,进入 wxauto-restful-api 目录执行 python run.py 启动服务。脚本调用示例:python scripts/wxapi.py send "好友" "消息",查看帮助用 python scripts/wxapi.py --help。配置优先级为命令行参数、环境变量 WXAPI_BASE_URL/WXAPI_TOKEN、service_status.json、config.yaml、默认值 http://localhost:8000 与 token。
适用场景:微信消息自动发送、聊天记录读取、新消息监听、好友与群聊列表获取、接受好友申请、窗口切换等。
限制:wxautox4 仅支持 Windows,需 Python 3.9–3.12 64 位并激活;微信客户端须在运行服务的 Windows 设备上保持打开;不要用 PowerShell 直接调用 API(中文编码问题),请用 Python;建议修改 config.yaml 中 auth.token 增强安全性。macOS/Linux 用户跳过本地安装,仅需远程地址与 Token。