Skip to content

安装

pip 安装

bash
pip install pywxauto

依赖项

pywxauto 依赖以下 Python 包(安装时自动处理):

包名用途
uiautomationWindows UI Automation 操作
psutil进程管理
pywin32Windows API 调用
Pillow图片处理
requests网络请求(下载URL文件)
pyee事件发射器(消息监听)
rapidocrOCR 文字识别(备选引擎)
onnxruntimeRapidOCR 推理后端
pymem进程内存读取(数据库监听模式)
sqlcipher3加密 SQLite 数据库(数据库监听模式)
zstandardZstd 解压缩(数据库监听模式)
xmltodictXML 解析(数据库监听模式)

微信版本要求

  • 支持微信 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', ...)