安装
pip 安装
bash
pip install pywxauto依赖项
pywxauto 依赖以下 Python 包(安装时自动处理):
| 包名 | 用途 |
|---|---|
uiautomation | Windows UI Automation 操作 |
psutil | 进程管理 |
pywin32 | Windows API 调用 |
Pillow | 图片处理 |
requests | 网络请求(下载URL文件) |
pyee | 事件发射器(消息监听) |
rapidocr | OCR 文字识别(备选引擎) |
onnxruntime | RapidOCR 推理后端 |
pymem | 进程内存读取(数据库监听模式) |
sqlcipher3 | 加密 SQLite 数据库(数据库监听模式) |
zstandard | Zstd 解压缩(数据库监听模式) |
xmltodict | XML 解析(数据库监听模式) |
微信版本要求
- 支持微信 Windows 客户端 4.x 版本
- 确保微信已正常安装并可登录
OCR 引擎
pywxauto 支持两种 OCR 引擎,用于消息发送者识别和朋友圈操作:
wcocr(默认)
使用微信自带的 OCR 组件,速度快、准确率高:
python
wx = Weixin(ocr="wcocr")需要微信 OCR 插件已安装(微信 4.x 通常自带)。
RapidOCR
开源 OCR 引擎,无需微信 OCR 插件:
python
wx = Weixin(ocr="rapidocr")系统要求
- 操作系统: Windows 10 / 11
- Python: >= 3.8
- 权限: 普通用户权限即可运行;
lock_input功能需要管理员权限 - 显示: DPI 缩放会自动适配(通过 SetProcessDpiAwareness)
验证安装
python
from pywxauto import Weixin
# 确保微信已登录
wx = Weixin()
print(wx) # Weixin(pid=12345, version='4.1.8.67', ...)