微信4.x数据解密并生成年度总结，高仿微信，支持实时更新，导出聊天记录，朋友圈等大量便捷功能
特别致谢：H3CoF6（密钥与朋友圈等核心内容的技术支持）、echotrace、WeFlow（本项目大量功能参考其实现）
如需定制功能，请联系 QQ：2977094657。
如果你需要 QQ 侧的数据解密、分析或年度总结类工具，欢迎体验 H3CoF6/WeQ；WeQ 作者也是本项目开发成员之一
 |
|
 |
 |
 |
 |
 |
 |
 |
 |
| 聊天记录页面（支持多种消息类型展示，样式尽可能与微信保持一致） | |
 |
|
| 修改消息（本地修改，支持恢复） | |
 |
|
| 实时消息同步（点击侧边栏闪电图标后，消息会自动刷新） | |
 |
|
| 设置面板（桌面行为、启动偏好、更新、朋友圈缓存策略） | |
 |
|
| 朋友圈（支持查看用户之前朋友圈的背景图及时间；本地查看过的朋友圈即使后续不可见也可以查看） | |
 |
|
| 聊天记录搜索 | |
 |
|
| 聊天记录导出 | |
 |
|
| 联系人导出 | |
 |
| 内容 | 支持格式 | 导出范围 / 说明 |
|---|---|---|
| 聊天记录 | 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 |
|---|---|---|
| 数据库密钥自动获取 | 支持 | 不提供；请用支持 Mac 的同类本地工具获取后手动填写 64 位密钥 |
| 数据库解密与离线分析 | 支持 | 支持 |
| 图片密钥内存扫描 | 支持 | 支持；首次使用可能需要授予辅助功能或管理员权限 |
| WCDB 实时消息、联系人和朋友圈 | 支持 | Apple Silicon 支持；Intel Mac 暂不支持实时 WCDB |
| 聊天、朋友圈、联系人、收藏等导出 | 支持 | 支持 |
| 账号全量归档 ZIP 导入与导出 | 支持 | 支持，并可与 Windows 双向迁移 |
| 微信进程大图 Hook | 支持 | 不提供，这是 Windows 专属能力 |
macOS 版本不会从微信进程提取数据库密钥。应用检测到 Mac 后只会显示获取方式提示；取得您本人账号的密钥并手动填写后，Apple Silicon Mac 上的数据库解密、实时消息、联系人、朋友圈、媒体、导出和迁移流程与 Windows 保持一致。
- 在 Windows 端打开全局导出，选择“账号数据归档”，同时包含数据库和资源文件。
- 将生成的
wechat_archive_*.zip传到 Mac，不要手动解压或修改归档内容。 - 在 Mac 端进入“导入数据”，选择“账号归档 ZIP”，预览账号后确认导入。
- 导入器会校验每个文件的 SHA-256；若本地已有同名账号，会在完整导入成功后保留旧目录备份。
已经由本项目解密并归档的数据，迁移后可直接离线查看；只有连接 Mac 上微信原始 WCDB 做实时读取时才需要手动填写数据库密钥。
也欢迎加入下方 QQ 群一起讨论。
- 打开 Release 页面（最新版）：https://github.com/LifeArchiveProject/WeChatDataAnalysis/releases/latest
- Windows 下载
Setup.exe；macOS 15+ 的 Apple Silicon Mac 下载.dmg或mac.zip - 安装完成后启动
WeChatDataAnalysis
如果 Windows 弹出“未知发布者/更多信息”等提示，请确认下载来源为本仓库 Release 后再选择“仍要运行”。
macOS 首次打开若提示来源限制，请在“系统设置 → 隐私与安全性”中确认来自本仓库的应用。图片密钥扫描还可能需要授予终端或应用辅助功能权限。
git clone https://github.com/LifeArchiveProject/WeChatDataAnalysis.git
cd WeChatDataAnalysis# 使用uv (推荐)
uv synccd frontend
npm install# 在项目根目录
uv run main.py# 在frontend目录
cd frontend
npm run dev- 前端界面: http://localhost:3000
- API服务(默认): http://localhost:10392 （可通过环境变量 WECHAT_TOOL_PORT 修改）
- API文档(默认): http://localhost:10392/docs
设置页中的“AI 接入提示词”会包含 endpoint 和 Bearer token，可直接复制给客户端作为接入指令。
本项目提供基于 Electron 的桌面端安装包（NSIS Setup.exe）。
# 1) 安装桌面端依赖
cd desktop
npm install
# 2) 打包（会自动：nuxt generate -> 拷贝静态资源 -> PyInstaller 打包后端 -> electron-builder 生成安装包）
npm run dist输出位置：desktop/dist/WeChatDataAnalysis Setup <version>.exe
需要 Apple Silicon Mac、macOS 15+、Xcode Command Line Tools、Rust、Python 3.11、Node.js 20+ 和 uv。当前不发布 Intel Mac 安装包。
cd desktop
npm install
npm run dist:mac该命令会生成静态前端、编译 macOS wce_integrity 模块、使用 PyInstaller 打包 ARM64 后端，并生成 DMG 与 ZIP。输出位于 desktop/dist/。
若更新了图片密钥扫描 helper 源码或 entitlements，执行 npm run build:mac:image-helper 并一并提交更新后的 desktop/scripts/macos-image-helper-manifest.json。npm run verify:mac:native 会核对清单中的源码与 tracked binary SHA-256，并检查所有原生资源的架构、最低系统版本、签名和自包含依赖路径。
本地 npm run dist:mac 生成 ad-hoc 签名包，供开发自测使用；npm run smoke:mac 会分别解开 ZIP、挂载 DMG，并核验其中应用的资源和签名。macOS 与 Windows 一样只在推送 v* tag 时由 Release 工作流构建，日常 PR 与 main 推送不会触发桌面端打包。正式 tag Release 必须在 GitHub Actions 配置 MACOS_CSC_LINK、MACOS_CSC_KEY_PASSWORD、MACOS_APPLE_ID、MACOS_APPLE_APP_SPECIFIC_PASSWORD、MACOS_APPLE_TEAM_ID 五个 secrets。发布任务会强制 Developer ID 签名、公证与票据装订，任一 secret 缺失或 ZIP/DMG 内应用未通过 Apple distribution 检查都会停止发布。
内置 Mac 原生资源的来源、哈希、修改内容和许可见 THIRD_PARTY_NOTICES.md。运行和打包均不依赖仓库外或根目录下的 WeFlow 副本。
重要提醒:
- 仅限个人使用: 此工具仅用于解密您自己的微信数据
- 密钥安全: 请妥善保管您的解密密钥，不要泄露给他人
- 数据隐私: 解密后的数据包含个人隐私信息，请谨慎处理
- 合法使用: 请遵守相关法律法规，不得用于非法目的
请在充分理解以下内容，并自愿承担相应责任的前提下使用本项目：
-
项目性质
本项目为独立开发的非官方开源工具，与微信、腾讯及其关联主体不存在隶属、授权、合作或认可关系。相关产品名称和商标归其权利人所有。
-
合法使用
本项目仅可用于处理使用者本人合法持有、管理或已经取得明确授权访问的数据。使用者应遵守适用的法律法规、软件许可协议、平台规则和隐私保护义务。
-
数据与备份
使用过程可能涉及本地数据库、密钥、聊天记录、媒体文件、微信进程和系统接口。开始前请备份重要数据、密钥及配置，并自行负责密钥保管、数据安全和隐私保护。
-
兼容性与运行风险
客户端版本变化、内存扫描、Hook、第三方组件及其他本地处理流程，可能导致账号提醒、功能失效、处理失败、文件异常或其他不可预期结果。本项目不保证对未来微信版本持续兼容。
-
责任范围
本项目按现状提供，不对功能的准确性、完整性、稳定性或持续可用性作出明示或默示保证。在适用法律允许的范围内，因使用、误用、版本不兼容、操作中断或第三方策略变化产生的损失和后果，由使用者自行承担。
使用或继续使用本项目，即表示使用者已经阅读、理解并同意以上内容，并愿意对自己的操作及其结果负责。
欢迎提交Issue和Pull Request来改进这个项目。