mirror of https://github.com/LifeArchiveProject/WeChatDataAnalysis.git synced 2026-02-02 05:50:50 +08:00

Files

2977094657 98de7f5998 docs: 重写README并更新截图

- 移除所有emoji符号

- 界面预览移至功能特性上方

- 更新截图为PNG格式并移至前端公共目录

- 添加聊天记录页面说明（注明为基础功能）

- 添加oh-my-wechat到参考项目

2025-12-14 21:13:23 +08:00

6.1 KiB

Raw Blame History

微信数据库解密工具

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

界面预览

检测页面

自动检测微信安装路径和数据库文件位置，支持多账户识别。

解密页面

输入解密密钥，选择数据库文件进行批量解密操作。

解密成功页面

解密完成后显示统计信息，可直接跳转查看聊天记录。

聊天记录页面

注意: 聊天记录页面目前仅完成了基础展示功能，包括消息列表、文本/图片/语音等基本消息类型的显示。更多功能（如搜索、导出、高级筛选等）尚在开发中，当前界面不代表最终成品。

功能特性

已实现功能

数据库解密: 支持微信4.x版本数据库文件的解密
多账户检测: 自动检测并处理多个微信账户的数据库文件
API接口: 提供RESTful API接口进行数据库解密操作
Web界面: 提供现代化的Web操作界面
聊天记录查看: 支持查看解密后的聊天记录（基础功能）

开发计划

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

项目进展: 查看 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. 访问应用

使用指南

获取解密密钥

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

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）

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