使用指南 · WeChatDataAnalysis

环境要求

使用前确认你的环境

⚠️ 目前仅支持 Windows 平台，需要微信 4.x 客户端正在运行

Windows 系统

仅支持 Windows（依赖 pywin32/pymem 等 Windows 原生 API）

微信 4.x 已登录

工具运行时需要微信客户端正在运行，密钥从进程内存提取

密钥提取权限

工具需要读取微信进程内存，部分杀软可能误报

网络连接

首次使用需要网络下载依赖，日常使用可离线运行

快速开始

两种启动方式

方式一适合普通用户，方式二适合开发者

方式一 · EXE 安装包（推荐）

Windows 用户，开箱即用

1

打开 GitHub Releases 下载最新版本
https://github.com/.../releases/latest

2

下载 WeChatDataAnalysis.Setup.{version}.exe

3

运行安装程序，按提示完成安装（Windows 可能提示"未知发布者"，确认来自本仓库即可）

4

启动 WeChatDataAnalysis，确保微信已登录

方式二 · 源码运行（开发者）

需要 Python 3.11+ 和 Node.js

1

克隆项目

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

2

安装后端依赖（推荐 uv）

uv sync

3

安装前端依赖

cd frontend && npm install && cd ..

4

启动后端 + 前端

uv run main.py       # 后端 API，端口 10392
cd frontend && npm run dev  # 前端，端口 3000

常见问题

FAQ

提示"未知发布者"或"更多信息"警告

这是 Windows 的正常安全提示。确认下载来源为本仓库（github.com/LifeArchiveProject/WeChatDataAnalysis）后，选择"仍要运行"即可。安装包来自 GitHub 官方签名。

杀软提示有风险/恶意软件

由于工具需要读取微信进程内存（OpenProcess/VirtualQueryEx），部分安全软件可能将其误判为可疑行为。这是内存扫描技术的正常特性，并非真正的恶意软件。可临时关闭杀软或添加白名单。

密钥提取失败怎么办

确保：1) 微信已完全启动并登录；2) 微信版本为 4.x；3) 以管理员权限运行工具；4) 微信未开启多开/分身。若仍失败，查看日志获取详细错误信息。

Mac 或 Linux 用户能使用吗

目前不支持。工具依赖 pywin32/pymem/yara-python 等 Windows 原生 API，无法在 Mac/Linux 运行。建议使用 Windows 虚拟机。

能否离线解密旧备份的微信数据

不能。密钥必须从运行中的微信进程内存实时提取，无法对离线的数据库备份文件进行解密。

年度总结只显示今年的数据吗

是的，年度总结功能仅支持生成当年（自然年）的社交报告，不支持选择历史年份。

合规使用声明

本工具仅限解密你自己的微信数据。请遵守相关法律法规，不得将本工具用于非法取证、侵犯他人隐私或任何其他违法用途。使用本工具即表示你同意自行承担所有风险，工具作者不对任何滥用行为负责。

竞品对比

与同类开源项目对比

数据来源：GitHub 检索 + README 分析

项目	Stars	功能完整度	年度总结	MCP支持	特色
WeChatDataAnalysis	1.5k ⭐	★★★★★	✅ GSAP动画	✅	解密→浏览→导出→年度总结→MCP全链路
echotrace	-	★★★☆☆	❌	❌	密钥技术参考
WeFlow	-	★★★☆☆	❌	❌	功能实现参考
wechat-dump-rs	-	★★☆☆☆	❌	❌	Rust实现，偏极客
oh-my-wechat	-	★★☆☆☆	❌	❌	老牌工具，更新慢