mirror of
https://github.com/LifeArchiveProject/WeChatDataAnalysis.git
synced 2026-02-18 05:40:50 +08:00
130 lines
3.5 KiB
Markdown
130 lines
3.5 KiB
Markdown
<div align="center">
|
|
<img src="frontend/public/logo.png" alt="微信数据库解密工具" width="200">
|
|
</div>
|
|
|
|
# 微信数据库解密工具
|
|
|
|
一个专门用于微信4.x版本数据库解密的工具
|
|
|
|
## 🚀 功能特性
|
|
|
|
### 已实现功能
|
|
- ✅ **数据库解密**: 支持微信4.x版本数据库文件的解密
|
|
- ✅ **多账户检测**: 自动检测并处理多个微信账户的数据库文件
|
|
- ✅ **API接口**: 提供RESTful API接口进行数据库解密操作
|
|
- ✅ **Web界面**: 提供现代化的Web操作界面
|
|
|
|
### 开发计划
|
|
- 🔄 **数据分析**: 对解密后的数据进行深度分析
|
|
- 🔄 **数据可视化**: 提供图表、统计报告等可视化展示
|
|
- 🔄 **聊天记录分析**: 消息频率、活跃时间、关键词分析等
|
|
|
|
> 📋 **项目进展**: 查看 [GitHub项目面板](https://github.com/orgs/LifeArchiveProject/projects/1/views/1) 了解当前开发状态和后续功能规划
|
|
|
|
## 快速开始
|
|
|
|
### 1. 克隆项目
|
|
|
|
```bash
|
|
git clone https://github.com/2977094657/WeChatDataAnalysis
|
|
```
|
|
|
|
### 2. 安装后端依赖
|
|
|
|
```bash
|
|
# 使用uv (推荐)
|
|
uv sync
|
|
```
|
|
|
|
### 3. 安装前端依赖
|
|
|
|
```bash
|
|
cd frontend
|
|
npm install
|
|
```
|
|
|
|
### 4. 启动服务
|
|
|
|
#### 启动后端API服务
|
|
```bash
|
|
# 在项目根目录
|
|
uv run main.py
|
|
```
|
|
|
|
#### 启动前端开发服务器
|
|
```bash
|
|
# 在frontend目录
|
|
cd frontend
|
|
npm run dev
|
|
```
|
|
|
|
### 5. 访问应用
|
|
|
|
- 前端界面: http://localhost:3000
|
|
- API服务: http://localhost:8000
|
|
- API文档: http://localhost:8000/docs
|
|
|
|
## 界面预览
|
|
|
|
### 检测页面
|
|
<div align="center">
|
|
<img src="检测.jpg" alt="微信检测页面" width="800">
|
|
</div>
|
|
|
|
自动检测微信安装路径和数据库文件位置，支持多账户识别。
|
|
|
|
### 解密页面
|
|
<div align="center">
|
|
<img src="解密.jpg" alt="数据库解密页面" width="800">
|
|
</div>
|
|
|
|
输入解密密钥，选择数据库文件进行批量解密操作。
|
|
|
|
## 使用指南
|
|
|
|
### 获取解密密钥
|
|
|
|
在使用本工具之前，您需要先获取微信数据库的解密密钥。推荐使用以下工具：
|
|
|
|
**DbkeyHook** (推荐)
|
|
- 项目地址: https://github.com/gzygood/DbkeyHook
|
|
- 专门用于获取微信数据库密钥的工具
|
|
|
|
## 安全说明
|
|
|
|
⚠️ **重要提醒**:
|
|
|
|
1. **仅限个人使用**: 此工具仅用于解密您自己的微信数据
|
|
2. **密钥安全**: 请妥善保管您的解密密钥，不要泄露给他人
|
|
3. **数据隐私**: 解密后的数据包含个人隐私信息，请谨慎处理
|
|
4. **合法使用**: 请遵守相关法律法规，不得用于非法目的
|
|
|
|
## 致谢
|
|
|
|
本项目的开发过程中参考了以下优秀的开源项目和资源：
|
|
|
|
### 主要参考项目
|
|
|
|
1. **[DbkeyHook](https://github.com/gzygood/DbkeyHook)** - 微信数据库密钥获取工具
|
|
- 提供了获取微信数据库解密密钥的解决方案
|
|
- 本项目推荐使用此工具获取密钥
|
|
|
|
2. **[wechat-dump-rs](https://github.com/0xlane/wechat-dump-rs)** - Rust实现的微信数据库解密工具
|
|
- 提供了SQLCipher 4.0解密的正确实现参考
|
|
- 本项目的HMAC验证和页面处理逻辑基于此项目的实现
|
|
|
|
## Star History
|
|
|
|
[](https://www.star-history.com/#LifeArchiveProject/WeChatDataAnalysis&Date)
|
|
|
|
## 贡献
|
|
|
|
欢迎提交Issue和Pull Request来改进这个项目。
|
|
|
|
## 许可证
|
|
|
|
本项目仅供学习和个人使用。请遵守相关法律法规。
|
|
|
|
---
|
|
|
|
**免责声明**: 本工具仅供学习研究使用，使用者需自行承担使用风险。开发者不对因使用本工具造成的任何损失负责。 |