# WeChat

**Repository Path**: FR89757/we-chat

## Basic Information

- **Project Name**: WeChat
- **Description**: 微信自动化运营
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-15
- **Last Updated**: 2026-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 微信 RPA 监控系统

## 需求场景

- 一台专用 Windows 电脑，只登录一个微信号，长期霸屏运行
- 自动统计"别人加我"的新好友（微信号、添加来源）
- 自动采集每天新增的聊天内容及聊天对象
- 不破坏微信客户端，零封号风险

## 技术方案

基于 Python + `uiautomation`，通过 Windows UIAutomation API 模拟人工操作。
微信看来就是正常的用户点击行为，不注入进程、不逆向协议。

## 部署前准备清单

### 硬件
- [x] 专用 Windows 电脑（或云主机 / Mini PC），不做他用
- [x] 保持屏幕常亮，不锁屏、不休眠

### 系统设置
- [x] Windows 10/11
- [x] 分辨率：1920×1080，缩放：100%
- [x] 电源计划 → 从不睡眠、从不关闭显示器
- [x] 关闭自动锁屏：`设置 → 账户 → 登录选项 → 需要登录 → 从不`
- [x] 如需远程管理：用 VNC（不要用 RDP，断开会锁屏）

### 软件
- [x] Python 3.10+（安装时勾选 Add to PATH）
- [x] 微信 PC 客户端 3.9.12（关闭自动更新）
- [x] 微信保持登录，窗口可见、不最小化

### 安装依赖
```bash
pip install uiautomation flask apscheduler
# 可选：OCR 兜底（当 UI 树拿不到微信号/来源字段时）
pip install paddleocr pillow
```

## 启动
```bash
python main.py
# 浏览器打开 http://127.0.0.1:5000 查看仪表盘
```

## 目录结构

```
├── config.py              # 配置
├── ui_engine.py           # UIAutomation 底层封装
├── friend_scanner.py      # 新增好友扫描（"新的朋友"页面）
├── chat_listener.py       # 聊天记录监听
├── guard.py               # 容错守护（弹窗关闭、掉线检测）
├── store.py               # SQLite 数据存储
├── web_app.py             # Web 仪表盘
├── main.py                # 主入口
├── start.bat              # Windows 一键启动
└── data/                  # 运行时数据
    └── monitor.db
```

## 运行策略

| 任务 | 频率 | 说明 |
|------|------|------|
| 新好友扫描 | 每 10 分钟 | 进入"新的朋友"页面，逐条读取 |
| 消息轮询 | 每 12 秒 | 检测会话列表变化，进入有新消息的会话读取 |
| 掉线检测 | 每 2 分钟 | 检查微信窗口是否存活 |
| 弹窗清理 | 每次操作前 | 自动关闭更新提示等弹窗 |

## 已知限制

1. 微信每 3-7 天可能要求重新扫码登录 → 掉线后 Webhook 通知你
2. 微信大版本更新可能改变 UI 控件结构 → 锁定版本、关闭自动更新
3. 聊天区域是虚拟化列表，只能读当前屏幕可见的消息 → 12 秒轮询基本够用
4. 语音 / 图片消息只能采集到 [语音] [图片] 标记，无法自动转文字

## 免责声明

仅供学习和个人合法使用，请遵守相关法律法规。