微信桌面自动化工具

基于桌面端UI自动化的微信操作工具，支持Windows/macOS双平台，可实现微信窗口管理、联系人操作、消息收发、聊天记录提取及自动化智能回复。

⚠️ 重要声明：本工具仅用于个人合法合规的微信操作自动化，请勿用于批量群发、骚扰他人等违规场景。使用前请确保遵守微信用户协议及相关法律法规。

支持平台

✅ Windows (支持微信Windows版所有主流版本)
✅ macOS (支持微信macOS版)
❌ Linux (暂不支持)

前提条件

1. 环境依赖安装

# 基础核心依赖
pip install pyautogui pillow opencv-python numpy pyperclip requests psutil

# Windows 额外依赖
pip install pywin32

# macOS 额外依赖
pip install pyobjc-framework-Quartz pyobjc-core pyobjc

2. 权限配置

Windows：无需额外权限，确保微信已安装并登录
macOS：授予终端/IDE"辅助功能"和"屏幕录制"权限：系统设置 → 隐私与安全 → 辅助功能 → 添加终端/IDE 系统设置 → 隐私与安全 → 屏幕录制 → 添加终端/IDE

3. 微信准备

确保微信已安装并完成登录
建议将微信窗口最大化运行（提升定位准确性）
关闭微信的"消息免打扰"等可能影响界面显示的设置

4. 自动回复的Authentication

All requests require the CHAT_API_KEY in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Environment Variable: Set your API key as CHAT_API_KEY:

export CHAT_API_KEY="YOUR_API_KEY"

使用方法

启动微信

py wechat.py start

激活微信窗口

py wechat.py activate

搜索联系人并发送消息

py wechat.py search_and_send --contact 张三 --message "你好，这是自动发送的消息"

获取聊天记录

py wechat.py get_history --contact 李四 --limit 10

自动处理联系人消息（智能回复）

# 基础用法
py wechat.py auto_process --api_key "你的AI接口密钥"

# 自定义轮询次数和API地址
py wechat.py auto_process --polling_times 20 --api_url "http://127.0.0.1:8000/api/chat/message" --api_key "密钥"

查看帮助

py wechat.py help

命令参考

命令	功能	示例
`start`	启动微信客户端	`py wechat.py start`
`activate`	激活并最大化微信窗口	`py wechat.py activate --title 微信`
`search_and_send`	搜索联系人并发送消息	`py wechat.py search_and_send --contact 张三 --message 您好`
`get_history`	获取指定联系人聊天记录	`py wechat.py get_history --contact 李四 --limit 15`
`auto_process`	自动轮询联系人并智能回复	`py wechat.py auto_process --polling_times 10 --api_key xxx`
`help`	查看帮助信息	`py wechat.py help`

核心功能说明

1. 微信进程与窗口管理

功能	说明
进程检测	自动检测微信是否正在运行
自动启动	查找微信安装路径并启动，支持多路径适配
窗口激活	定位微信窗口并激活，支持最大化、前置显示
区域定位	自动识别微信界面各功能区域（输入框、发送按钮等）

2. 联系人操作

功能	说明
精准搜索	通过搜索框定位联系人，支持剪贴板输入避免输入失败
列表点击	按索引点击联系人列表，支持边界检查
状态记忆	记录当前打开的联系人，避免重复操作

3. 消息处理

功能	说明
安全输入	支持剪贴板粘贴和逐字符输入，避免输入异常
消息发送	精准点击发送按钮，支持自然鼠标移动轨迹
记录提取	通过OCR和右键复制提取聊天记录，区分收发方向
新消息检测	自动识别最新收到的消息，过滤自己发送的内容

4. 自动化回复

功能	说明
轮询检测	循环检查多个联系人的新消息
AI接口集成	调用自定义AI接口获取回复内容
批量发送	支持多条回复依次发送，可自定义发送间隔
异常处理	失败自动重试，错误日志完整记录

配置说明

界面区域配置

首次运行activate命令会自动生成config/wechat_regions.json
包含微信界面各区域的坐标和尺寸参数
不同平台配置自动区分，避免混用

wechat-rpa

Install via CLI (Recommended)