mirror of
https://wget.la/https://github.com/Wxw-Gu/WechatExplorer
synced 2026-08-17 19:47:08 +08:00
电摇小子
f6f8bc33f9
- 接入微信 4.0 WCDB 数据库解密，兼容微信 3.0 解密方式 - 支持图片解密及图片预览、缩放、旋转和拖动 - 支持语音解密与播放 - 支持表情包、引用、分享、名片、位置及通话消息解析 - 支持联系人和群聊真实头像 - 优化群聊、联系人分类及排序 - 修复复合消息类型和压缩消息内容解析 - 完善原生解密库打包及数据库错误提示
77 lines
3.5 KiB
Markdown
77 lines
3.5 KiB
Markdown
# WechatExplorer
|
|
|
|
MAC系统 获取微信聊天记录 AI一键生成群聊总结
|
|
是一个基于 Electron + React + TypeScript 开发的微信聊天记录查看与分析工具。它支持查看解密后的微信数据库内容，提供聊天记录搜索、导出以及 AI 智能总结功能。
|
|
|
|
## 📸 预览
|
|
|
|
<img src="./public/example1.png" alt="预览图1" />
|
|
<img src="./public/example2.png" alt="预览图2" />
|
|
<img src="./public/example3.png" alt="预览图3" />
|
|
|
|
## [点击这里下载](https://github.com/Wxw-Gu/WechatExplorer/releases)
|
|
|
|
## 📦 安装说明
|
|
|
|
1. 下载下方的 `xxx.dmg` 文件。
|
|
2. 打开 DMG 并将应用拖动到 **Applications** (应用程序) 文件夹。
|
|
3. 如果遇到“无法打开，因为开发者无法验证”的提示，请前往：
|
|
`系统设置 -> 隐私与安全性 -> 仍要打开`。
|
|
|
|
## ✨ 功能特性
|
|
|
|
- **聊天记录查看**: 浏览微信好友和群聊的聊天记录。
|
|
- **全局搜索**: 快速搜索聊天内容。
|
|
- **AI 智能总结**: 支持多模型服务配置（DeepSeek/GPT-4o/Claude/Moonshot），一键总结群聊精华内容，生成话题报告。
|
|
- **图片生成**: 将 AI 总结的内容生成精美图片，方便分享。
|
|
- **数据导出**: 支持导出聊天记录为 CSV 文件（今日、昨日、近7天或全部）。
|
|
- **安全隐私**: 所有数据仅在本地处理，AI 功能需自行配置 API Key。
|
|
|
|
## 🚀 快速开始
|
|
|
|
### 使用前置要求
|
|
|
|
- **微信版本**: 推荐使用微信 **4.0 以下**版本（4.0以上版本不支持数据库解密）
|
|
- 微信 <= 4.0: 可正常使用，获取数据库密码方式参考：[Mac 导出微信聊天记录](https://blog.vcvit.me/2024/08/02/mac-export-wechat-chat-records/)
|
|
- 微信 >= 4.0: 可正常使用 (正在迭代) ，推荐使用 [WeFlow](https://github.com/hicccc77/WeFlow) [Chatlog](https://github.com/sjzar/chatlog)
|
|
- 如无法获取本地数据库密码，则无法使用当前项目
|
|
- Node.js (推荐 v16+)
|
|
- pnpm@7
|
|
- 解密后的微信数据库文件 (`.db`) 和对应的密钥
|
|
- AI API Key（支持 OpenAI 兼容 API，可选 DeepSeek/GPT/Claude/Moonshot 等）
|
|
|
|
### 环境变量配置 (.env)
|
|
|
|
可选配置项，可在 `.env` 文件中设置：
|
|
|
|
| 变量名 | 说明 | 示例 |
|
|
|--------|------|------|
|
|
| `VITE_DB_KEY` | 微信数据库密钥 (32字节hex) | `YOUR_DB_KEY_HERE` |
|
|
| `VITE_IMAGE_XOR_KEY` | 图片解密 XOR 密钥 (hex格式) | `0x40` |
|
|
| `VITE_IMAGE_AES_KEY` | 图片解密 AES 密钥 (16字符) | `YOUR_AES_KEY_HERE` |
|
|
| `VITE_DEEPSEEK_API_KEY` | DeepSeek API Key | `sk-xxx` |
|
|
| `VITE_AI_BASE_URL` | AI API 地址 | `https://api.deepseek.com` |
|
|
| `VITE_AI_MODEL` | AI 模型 | `deepseek-chat` |
|
|
| `VITE_FILTER_MSG_TYPES` | 过滤的消息类型 | `分享消息,图片,表情包,视频` |
|
|
|
|
#### 图片解密密钥说明
|
|
|
|
微信 4.0+ 的图片以 `.dat` 文件存储，需要密钥解密：
|
|
|
|
- **XOR Key**: 单字节 hex 值（如 `0x40`），用于简单的字节异或解密
|
|
- **AES Key**: 16字符字符串，用于 AES-128-ECB 解密
|
|
|
|
这两个密钥可以通过以下方式获取：
|
|
1. 从 WeFlow/Chatlog 设置中导出
|
|
2. 使用内存扫描工具从微信进程中自动提取（待实现）
|
|
|
|
## ⚠️ 免责声明
|
|
|
|
本项目仅供学习和研究使用。请勿用于非法用途。开发者不对使用本项目造成的任何后果负责。请遵守相关法律法规和微信使用协议。
|
|
|
|
## 🔗 参考
|
|
|
|
- [WechatMessageExplorer](https://github.com/svcvit/WechatMessageExplorer)
|
|
- [WechatExplorer](https://github.com/hicccc77/WechatExplorer)
|
|
- [chatlog](https://github.com/sjzar/chatlog)
|