WeChatDataAnalysis - 微信数据库解密与分析工具

一个专门用于微信4.x版本数据库解密的工具

界面预览

首页	检测页面
解密页面	图片密钥页面
图片解密页面	解密成功页面
聊天记录页面
聊天记录导出

Note

: 聊天记录页面已支持基础展示与离线导出，更多功能（搜索、高级筛选等）尚在开发中。

功能特性

已实现功能

• 数据库解密: 支持微信4.x版本数据库文件的解密
• 多账户检测: 自动检测并处理多个微信账户的数据库文件
• API接口: 提供RESTful API接口进行数据库解密操作
• Web界面: 提供现代化的Web操作界面
• 聊天记录查看: 支持查看解密后的聊天记录（基础功能）
• 图片资源解密: 支持批量解密微信图片(.dat文件)，按MD5哈希存储便于快速访问
• 聊天图片展示: 支持部分版本图片消息无MD5时通过 file_id 兜底定位本地资源

开发计划

• 数据分析: 对解密后的数据进行深度分析
• 数据可视化: 提供图表、统计报告等可视化展示
• 聊天记录分析: 消息频率、活跃时间、关键词分析等
• 聊天记录优化: 搜索、导出、高级筛选等功能

项目进展: 查看 GitHub项目面板 了解当前开发状态和后续功能规划

快速开始

1. 克隆项目

git clone https://github.com/2977094657/WeChatDataAnalysis

2. 安装后端依赖

# 使用uv (推荐)
uv sync

3. 安装前端依赖

cd frontend
npm install

4. 启动服务

启动后端API服务

# 在项目根目录
uv run main.py

启动前端开发服务器

# 在frontend目录
cd frontend
npm run dev

5. 访问应用

• 前端界面: http://localhost:3000
• API服务: http://localhost:8000
• API文档: http://localhost:8000/docs

使用指南

获取解密密钥

在使用本工具之前，您需要先获取微信数据库的解密密钥。推荐使用以下工具：

DbkeyHook (推荐)

• 项目地址: https://github.com/gzygood/DbkeyHook
• 专门用于获取微信数据库密钥的工具

生成字段配置模板（JSON）

在完成数据库解密后（默认输出到 output/databases/{账号名}/），可基于实际解密出的数据库结构生成一份可填写的字段说明模板。

前置条件：

• output/databases/{账号名}/*.db 下已有解密后的数据库文件（通过后端 API 或命令行完成解密）。

运行命令：

uv run generate_config_template.py

输出结果：

• 在项目根目录生成 wechat_db_config_template.json

接下来：

• 打开并填写模板中的字段含义（meaning）、表/数据库功能描述（description），以及可选的 message_types、friend_types 映射示例。
• 填写完成后，将其另存为根目录下的 wechat_db_config.json（分析脚本默认读取此文件名）。

提示：若未提供 wechat_db_config.json，分析脚本会使用内置的最小默认映射，生成的文档字段含义将较为粗略。

生成数据库表结构文档（Markdown）

该脚本会扫描解密后的数据库，输出每个数据库与表的结构说明、示例数据以及跨库字段关联分析。

前置条件：

• output/databases/{账号名}/*.db 下已有解密后的数据库文件 -（可选）根目录存在 wechat_db_config.json，用于提供更准确的字段含义映射

运行命令：

uv run analyze_wechat_databases.py

输出结果：

• 文档目录：output/docs/database/
• 主要文件：
  • README.md：总览文档
  • field_relationships.md：跨数据库字段关联分析
  • {数据库名}/README.md：该数据库概览
  • {数据库名}/{表名}.md：各表详细结构、索引、外键、示例数据与建表语句

图片资源解密

微信的图片文件(.dat)是加密存储的，需要解密后才能正常显示。本工具提供了API接口进行批量解密。

1. 获取图片解密密钥

# GET请求获取密钥（需要微信正在运行；部分版本需以管理员身份运行后端才能提取AES密钥）
curl http://localhost:8000/api/media/keys

# 强制重新提取密钥
curl "http://localhost:8000/api/media/keys?force_extract=true"

提示：部分版本的 AES 密钥可能需要微信触发过图片加载/解密后才会出现在进程内存中。可尝试：完全退出微信 → 重新启动并登录 → 打开朋友圈图片并点开大图 2-3 次 → 立刻回到工具获取密钥。

返回示例：

{
  "status": "success",
  "xor_key": "0xA5",
  "aes_key": "xxxxxxxxxxxxxxxx",
  "message": "XOR密钥提取成功。已从微信进程提取AES密钥"
}

2. 批量解密所有图片

# POST请求批量解密所有图片到 output/databases/{账号}/resource 目录
curl -X POST http://localhost:8000/api/media/decrypt_all \
  -H "Content-Type: application/json" \
  -d '{}'

解密后的图片按MD5哈希命名，存储在 resource/{md5前2位}/{md5}.{ext} 路径下，便于快速查找。

3. 获取已解密的图片

# 直接通过MD5获取已解密的图片（更快）
curl http://localhost:8000/api/media/resource/{md5}

安全说明

重要提醒:

1. 仅限个人使用: 此工具仅用于解密您自己的微信数据
2. 密钥安全: 请妥善保管您的解密密钥，不要泄露给他人
3. 数据隐私: 解密后的数据包含个人隐私信息，请谨慎处理
4. 合法使用: 请遵守相关法律法规，不得用于非法目的

致谢

本项目的开发过程中参考了以下优秀的开源项目和资源：

主要参考项目

1. DbkeyHook - 微信数据库密钥获取工具

   • 提供了获取微信数据库解密密钥的解决方案
   • 本项目推荐使用此工具获取密钥

2. wechat-dump-rs - Rust实现的微信数据库解密工具

   • 提供了SQLCipher 4.0解密的正确实现参考
   • 本项目的HMAC验证和页面处理逻辑基于此项目的实现

3. oh-my-wechat - 微信聊天记录查看工具

   • 提供了优秀的聊天记录界面设计参考
   • 本项目的聊天界面风格参考了此项目的实现

4. vue3-wechat-tool - 微信聊天记录工具（Vue3）

   • 提供了聊天记录展示与交互的实现参考

Star History

贡献

欢迎提交Issue和Pull Request来改进这个项目。

许可证

本项目仅供学习和个人使用。请遵守相关法律法规。

---

免责声明: 本工具仅供学习研究使用，使用者需自行承担使用风险。开发者不对因使用本工具造成的任何损失负责。