Skip to content

LifeArchiveProject/WeChatDataAnalysis

BranchesTags

Repository files navigation

微信数据库解密工具

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

微信4.x数据解密并生成年度总结，高仿微信，支持实时更新，导出聊天记录，朋友圈等大量便捷功能

特别致谢：H3CoF6（密钥与朋友圈等核心内容的技术支持）、echotrace、WeFlow（本项目大量功能参考其实现）

如需定制功能，请联系 QQ：2977094657。

Version Stars Downloads Forks QQ Group Python Vue.js SQLite

如果你需要 QQ 侧的数据解密、分析或年度总结类工具，欢迎体验 H3CoF6/WeQ；WeQ 作者也是本项目开发成员之一

年度总结

年度总结 Modern
AnnualSummary 1 AnnualSummary 2
AnnualSummary 3 AnnualSummary 4
AnnualSummary 5 AnnualSummary 6
AnnualSummary 7 AnnualSummary 8

界面预览

聊天记录页面（支持多种消息类型展示，样式尽可能与微信保持一致）
聊天记录页面
修改消息（本地修改，支持恢复）
修改消息
实时消息同步（点击侧边栏闪电图标后，消息会自动刷新）
实时消息同步
设置面板（桌面行为、启动偏好、更新、朋友圈缓存策略）
设置面板
朋友圈（支持查看用户之前朋友圈的背景图及时间；本地查看过的朋友圈即使后续不可见也可以查看）
朋友圈
聊天记录搜索
聊天记录搜索
聊天记录导出
聊天记录导出
联系人导出
联系人导出

可导出的内容

内容 支持格式 导出范围 / 说明
聊天记录 HTML / JSON / TXT / Excel（ZIP） 当前会话、自定义会话、全部会话、群聊或单聊；支持按消息类型和时间筛选
朋友圈 HTML / JSON / TXT / Excel（ZIP） 指定联系人或全部联系人
联系人 HTML / JSON / TXT / Excel 支持按联系人分类和关键词筛选，可选择是否包含头像链接
收藏 HTML / JSON / TXT / Excel（ZIP） 支持按收藏类型和关键词筛选
好友验证 HTML / JSON / TXT / Excel 支持按发起方向和关键词筛选
小程序 HTML / JSON / TXT / Excel 支持按关键词筛选
视频号直播 HTML / JSON / TXT / Excel 支持按直播类型和关键词筛选
转账与红包 HTML / JSON / TXT / Excel 支持按记录类型和关键词筛选
服务号记录 HTML / JSON / TXT / Excel 支持按服务号和记录类型导出
账号数据归档 ZIP 可选择导出数据库、资源文件或两者

Excel 格式生成 .xlsx 文件；聊天记录、朋友圈和收藏会将对应格式文件与必要资源一起打包为 ZIP。

Windows / macOS 兼容性

功能 Windows macOS
数据库密钥自动获取 支持 不提供；请用支持 Mac 的同类本地工具获取后手动填写 64 位密钥
数据库解密与离线分析 支持 支持
图片密钥内存扫描 支持 支持；首次使用可能需要授予辅助功能或管理员权限
WCDB 实时消息、联系人和朋友圈 支持 Apple Silicon 支持；Intel Mac 暂不支持实时 WCDB
聊天、朋友圈、联系人、收藏等导出 支持 支持
账号全量归档 ZIP 导入与导出 支持 支持，并可与 Windows 双向迁移
微信进程大图 Hook 支持 不提供，这是 Windows 专属能力

macOS 版本不会从微信进程提取数据库密钥。应用检测到 Mac 后只会显示获取方式提示；取得您本人账号的密钥并手动填写后，Apple Silicon Mac 上的数据库解密、实时消息、联系人、朋友圈、媒体、导出和迁移流程与 Windows 保持一致。

从 Windows 迁移到 Mac

  1. 在 Windows 端打开全局导出，选择“账号数据归档”，同时包含数据库和资源文件。
  2. 将生成的 wechat_archive_*.zip 传到 Mac，不要手动解压或修改归档内容。
  3. 在 Mac 端进入“导入数据”，选择“账号归档 ZIP”，预览账号后确认导入。
  4. 导入器会校验每个文件的 SHA-256；若本地已有同名账号，会在完整导入成功后保留旧目录备份。

已经由本项目解密并归档的数据，迁移后可直接离线查看；只有连接 Mac 上微信原始 WCDB 做实时读取时才需要手动填写数据库密钥。

加入群聊

也欢迎加入下方 QQ 群一起讨论。

WeChatDataAnalysis 加群二维码

快速开始

1. 下载桌面安装包（推荐）

  1. 打开 Release 页面（最新版）：https://github.com/LifeArchiveProject/WeChatDataAnalysis/releases/latest
  2. Windows 下载 Setup.exe；Apple Silicon Mac 下载 .dmg 或 mac.zip
  3. 安装完成后启动 WeChatDataAnalysis

如果 Windows 弹出“未知发布者/更多信息”等提示，请确认下载来源为本仓库 Release 后再选择“仍要运行”。

macOS 首次打开若提示来源限制，请在“系统设置 → 隐私与安全性”中确认来自本仓库的应用。图片密钥扫描还可能需要授予终端或应用辅助功能权限。

2. 从源码运行（开发者/高级用户）

2.1 克隆项目

git clone https://github.com/LifeArchiveProject/WeChatDataAnalysis.git
cd WeChatDataAnalysis

2.2 安装后端依赖

# 使用uv (推荐)
uv sync

2.3 安装前端依赖

cd frontend
npm install

2.4 启动服务

启动后端API服务

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

启动前端开发服务器

# 在frontend目录
cd frontend
npm run dev

2.5 访问应用

MCP 服务

设置页中的“AI 接入提示词”会包含 endpoint 和 Bearer token，可直接复制给客户端作为接入指令。

打包为 EXE（Windows 桌面端）

本项目提供基于 Electron 的桌面端安装包（NSIS Setup.exe）。

# 1) 安装桌面端依赖
cd desktop
npm install

# 2) 打包（会自动：nuxt generate -> 拷贝静态资源 -> PyInstaller 打包后端 -> electron-builder 生成安装包）
npm run dist

输出位置：desktop/dist/WeChatDataAnalysis Setup <version>.exe

打包 macOS 桌面端（Apple Silicon）

需要 Xcode Command Line Tools、Rust、Python 3.11、Node.js 20+ 和 uv。

cd desktop
npm install
npm run dist:mac

该命令会生成静态前端、编译 macOS wce_integrity 模块、使用 PyInstaller 打包 ARM64 后端，并生成 DMG 与 ZIP。输出位于 desktop/dist/。

内置 Mac 原生资源的来源、哈希、修改内容和许可见 THIRD_PARTY_NOTICES.md。运行和打包均不依赖仓库外或根目录下的 WeFlow 副本。

安全说明

重要提醒:

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

致谢

  1. echotrace
  2. WeFlow
  3. wx_key
  4. wechat-dump-rs
  5. oh-my-wechat
  6. vue3-wechat-tool
  7. wx-dat
  8. Ritsu
  9. recarto404

Star History

Star History Chart

贡献

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

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

About

微信4.x数据解密并生成年度总结，高仿微信，实时更新，导出聊天记录，朋友圈，收藏等大量便捷功能

Resources

Readme
Activity
Custom properties

Stars

1.8k stars

Watchers

10 watching

Forks

532 forks
Report repository

Releases

Packages

Contributors

Languages