🍬微信聊天记录备份与管理工具
wx-dump 是一款基于 Python 开发的微信数据分析工具。后端采用 FastAPI 实现解密、数据查询与导出能力，前端基于 Ant Design Pro 提供可视化管理界面。它准确显示好友数、群聊数和当日消息总量，提供过去15天每日消息统计，了解社交活跃度。识别展示最近一个月内互动频繁的前10位联系人。支持导出聊天记录、联系人、群聊信息，及查看超过三天限制的朋友圈历史记录和找回微信好友。
- 🔑 数据库解密：自动从微信进程内存中提取密钥，解密微信 SQLite 数据库，支持微信多开、多账号切换。
- 👤 获取用户信息：获取当前登录微信的详细信息，包括昵称、账号、手机号、邮箱、秘钥、微信Id。
- 💬 支持多种消息类型：管理微信聊天对话中的文本、引用、图片、表情、卡片链接、系统消息等。
- 🖼️ 图片解码：自动解码微信
.dat加密图片，聊天图片可直接预览。 - 📊 综合管理：提供微信会话、联系人、群聊与朋友圈的全面管理功能。
- 📥 记录导出：支持导出微信聊天记录、联系人、已删除好友和群聊信息，便于备份和管理。
- 📅 查看历史朋友圈：突破三日限制，查看更久以前的朋友圈历史记录，方便回顾和管理。
- 📈 微信统计功能：展示微信好友数、群聊数及今日收发消息总量，了解社交活跃度。
- 📊 消息统计：统计过去15天内每日微信消息数量，掌握长期消息交流情况。
- 🔝 互动联系人：展示最近一个月互动最频繁的前10位联系人，了解重要社交联系。
- 🧩 消息类别占比：展示微信消息类别占比图表，分析不同类型消息的占比情况。
- ☁️ 关键字词云：展示微信最近使用的关键字词云图，分析聊天内容重点。
- 🔄 找回已删除好友：支持找回已删除的微信好友，恢复重要联系人。
- 🧰 解密小工具：内置独立的解密工具页面，可手动选择数据库目录进行解密。
双击根目录的 start.bat，脚本会自动：
- 检测 Python 环境并安装
backend/requirements.txt中的依赖； - 设置数据目录
WX_DUMP_DATA=./data与静态资源目录WXDUMP_STATIC_DIR=./html； - 启动后端服务，访问 http://127.0.0.1:8000 即可使用。
后端已开启 uvicorn 热重载（
reload=True），修改backend/下代码会自动生效，无需重启。
- 下载源码：
$ git clone <本项目地址>
- 安装后端依赖并启动：
$ cd backend $ pip install -r requirements.txt $ python run.py - 安装前端依赖并启动开发服务：
$ cd frontend $ npm install $ npm run start - 前端开发服务启动后，浏览器访问 dev server 地址（接口请求通过
config/proxy.ts代理到 8000 端口后端）。 - 构建前端（产物直接输出到根目录
html/，由后端静态托管）：也可以直接运行根目录$ cd frontend $ npm run buildbuild.bat，一键完成前端构建 + 后端拉起。
WeChat
├── backend/ # Python 后端
│ ├── run.py # 启动入口：uvicorn 启动 FastAPI（0.0.0.0:8000，热重载）
│ ├── requirements.txt # 后端依赖
│ ├── wechatauto_src/ # 微信 4.x 用户信息读取依赖（通过 sys.path 引入）
│ └── wxdump/ # 核心业务代码
│ ├── api.py # FastAPI 路由层，对接前端 /api/* 契约
│ ├── config.py # 数据目录、图片目录等配置（WX_DUMP_DATA 环境变量）
│ ├── wechat_key.py # 微信进程内存密钥提取、用户信息读取
│ ├── decrypt.py # 微信 SQLite 数据库解密
│ ├── database.py # SQLite 连接与数据库管理
│ ├── queries.py # 会话/联系人/群聊/朋友圈/统计等查询
│ ├── msg_content.py # 消息内容解析
│ ├── export_utils.py # 聊天记录/联系人/群聊导出
│ └── image_utils.py # 微信 .dat 图片解码
├── frontend/ # 前端（Ant Design Pro / UmiJS）
│ ├── src/pages/ # Dashboard、Session、Contact、ChatRoom、Feeds、Chat、DecryptTool 等页面
│ └── config/ # UmiJS 路由、代理、主题配置（构建产物输出到 ../html）
├── html/ # 前端构建产物（后端静态托管目录）
├── data/ # 运行数据：解密后的 db、用户信息、导出文件
├── start.bat # 一键启动（自动装依赖 + 启动后端）
└── build.bat # 一键构建（前端构建 + 后端拉起）
| 技术 | 描述 |
|---|---|
| Python | 后端开发语言 |
| FastAPI | Web 框架与 API 契约 |
| Uvicorn | ASGI 服务器（热重载） |
| SQLite | 微信聊天记录存储 |
| Cryptography | 数据库解密（AES/HMAC） |
| Protobuf | 消息数据解析 |
| openpyxl | Excel 导出 |
| React 18 | 前端框架 |
| Ant Design Pro | 前端 UI 与布局 |
| UmiJS (max) | 前端构建与路由 |
| @ant-design/charts | 图表与词云 |
本软件仅适用于Windows操作系统。我们目前不支持macOS、Linux或其他操作系统。如果你在尝试在非Windows系统上运行本软件时可能遇到兼容性问题，这些问题可能导致软件无法正常运行或产生其他意外后果。
| 操作系统 | 支持情况 |
|---|---|
| Windows | 支持 |
| macOS | 不支持 |
| Linux | 不支持 |
本软件仅供技术研究和教育目的使用，旨在解密用户个人微信聊天记录。严禁将本软件用于任何非法目的，包括但不限于侵犯隐私权或非授权数据访问。作为软件开发者，我不对因使用或滥用本软件产生的任何形式的损失或损害承担责任。
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |