WeChatDataAnalysis/README.md

微信数据库解密工具

一个专门用于微信4.x版本数据库解密的工具，基于SQLCipher 4.0加密机制，支持批量解密微信数据库文件。

系统要求

• Python 3.11+
• Windows 11 (主要测试平台)

快速开始

1. 克隆项目

git clone <repository-url>

2. 安装Python依赖

# 使用uv (推荐)
uv sync

3. 启动API服务

uv run main.py

注意: 服务将在8000端口启动，支持热重载

4. 访问应用

• API服务: http://localhost:8000
• API文档: http://localhost:8000/docs

使用指南

获取解密密钥

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

DbkeyHook (推荐)

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

安全说明

⚠️ 重要提醒:

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

致谢

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

主要参考项目

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

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

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

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

贡献

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

许可证

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

---

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