From 7954d49240baeb34234a0d4dde96d2910cc1e294 Mon Sep 17 00:00:00 2001 From: ylytdeng Date: Sun, 17 May 2026 17:08:03 +0800 Subject: [PATCH] =?UTF-8?q?docs(readme):=20=E9=87=8D=E7=BB=84=E9=A1=B9?= =?UTF-8?q?=E7=9B=AE=E8=AF=B4=E6=98=8E=E8=A6=86=E7=9B=96=20PR=20#107=20/?= =?UTF-8?q?=20#95=20/=20#93=20/=20#94=20=E6=96=B0=E5=86=85=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## 顶部介绍 老版本只说"实时消息监听、MCP Server、批量导出和语音转录",漏了: - 企业微信解密 (PR #107) - 朋友圈解密 (PR #107) - Windows GUI + EXE 打包 (PR #107) - 增量 / 日期范围 / dry-run (PR #95) - 交互式配置向导 / cleanup (PR #93 / #94) 改成 7 行能力矩阵 (个人微信 / 企微 / 监听 / 导出 / 图片 / 语音 / 朋友圈 / GUI) 一眼看清覆盖范围。 ## 快速开始 Windows 部分从 1 条 (CLI) 扩成 3 条: - Windows — 最小路径 (CLI) — 老用户 - Windows — GUI / EXE (推荐非技术用户) — PR #107 新增 - Windows — 企业微信 (实验) — PR #107 新增 ## 文件说明 从 28 行无序大表 (`find_all_keys.py` 还重复了 2 次) 重组成 8 个折叠分组: ① 入口 / 一键脚本 (5 个) ② 密钥提取 (9 个, 含 wxwork) ③ 数据库 / 图片 / 语音解密 (6 个, 含 sns + wxwork) ④ 导出 (6 个) ⑤ 实时监听 / 服务 (4 个, 加上 decode_transfer CLI) ⑥ 语音 / 音频 (2 个) ⑦ 打包 / 配置 / 文档 (7 个, 含 EXE_USAGE / WeChatDecrypt.spec) ⑧ 测试 / 文档 (tests/ + docs/ + latency_test) 修正: - 老版漏了: decrypt_sns.py / export_sns.py / wxwork_crypto.py / batch_decrypt_images.py / setup.py / cleanup.py / app_gui.py / decode_transfer.py / EXE_USAGE.md / WeChatDecrypt.spec / key_scan_common.py / key_utils.py / find_image_key_monitor.py / latency_test.py - 老版重复了 2 次的: find_all_keys.py - 老版顺序混乱 (GUI/企微/扫描/导出混在一起) --- README.md | 182 +++++++++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 152 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index 55d8c00..5ec2f5c 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,18 @@ # WeChat 4.x Database Decryptor -微信 4.0 (Windows / macOS / Linux) 本地数据库解密工具。从运行中的微信进程内存提取加密密钥，解密所有 SQLCipher 4 加密数据库，并提供实时消息监听、MCP Server、批量导出和语音转录。 +**微信 / 企业微信本地数据库解密 + 数据工具集** (Windows / macOS / Linux) + +从运行中的进程内存提取加密密钥,解密 SQLite 加密数据库,衍生出一整套实用工具: + +| 能力 | 支持范围 | +|---|---| +| 🔓 **数据库解密** | 个人微信 4.0 (SQLCipher 4) + 企业微信 5.x (wxSQLite3 AES-128) | +| 📡 **实时消息监听** | Web UI (SSE) / 命令行 / MCP Server (Claude AI 集成) | +| 📦 **批量导出** | 全部聊天 → JSON / CSV / HTML, 含增量 + 日期范围 + dry-run | +| 🖼️ **图片解密** | V1 / V2 / wxgf 三种 .dat 格式 + 朋友圈缓存 | +| 🎙️ **语音转录** | SILK → WAV → 文本 (local Whisper / OpenAI / whisper.cpp 三种 backend) | +| 🪧 **朋友圈** | SnsTimeLine 解析 + 缓存图片解密 + HTML 时间线 | +| 🖱️ **Windows GUI** | tkinter 界面整合所有功能 + PyInstaller 单 exe 打包 | --- @@ -33,7 +45,7 @@ make all
-Windows — 最小路径 +Windows — 最小路径 (CLI) ```bash # 1. 以管理员身份打开终端 @@ -49,6 +61,38 @@ python export_all_chats.py
+
+Windows — GUI / EXE (推荐非技术用户) + +```bash +# 直接跑 GUI (开发模式) +python app_gui.py + +# 或打包成单 exe 分发给别人 +build.bat # 输出 dist/WeChatDecrypt.exe +``` + +按钮覆盖: 解密 / 导出 / 朋友圈 / 企业微信 / 语音转 MP3。详见 [EXE_USAGE.md](./EXE_USAGE.md)。 + +
+ +
+Windows — 企业微信 (实验) + +```bash +# 1. 启动企业微信并登录 +# 2. 提取企微 keys + 解密 +python find_wxwork_keys.py # 自动检测 Documents\WXWork\\Data +python decrypt_wxwork_db.py # 解密到 wxwork_decrypted/ + +# 3. (可选) 导出聊天记录 +python export_wxwork_messages.py +``` + +仅 Windows 5.x 实测可用。详见技术细节里的「企业微信数据库解密」章节。 + +
+
Linux — 最小路径 @@ -272,35 +316,113 @@ make help # 列出所有命令 ## 文件说明 +文件按功能分组,方便定位。 + +
+① 入口 / 一键脚本 + | 文件 | 说明 | -|------|------| -| `main.py` | **一键启动入口** — 自动配置、提取密钥、启动服务 | -| `app_gui.py` | **GUI 工具箱** — tkinter 界面，整合解密/导出/音频转换 | -| `export_messages.py` | 聊天记录导出（CSV / HTML / JSON） | -| `voice_to_mp3.py` | 语音消息 SILK 转 MP3 | -| `build.bat` | 一键打包为单 exe（PyInstaller） | -| `config.py` | 配置加载器（自动检测微信数据目录） | -| `find_all_keys.py` | 平台分发入口（Windows / Linux） | -| `find_all_keys_windows.py` | Windows 版内存扫描提 key | -| `find_all_keys_linux.py` | Linux 版内存扫描提 key | -| `decrypt_db.py` | 全量解密所有数据库 | -| `export_all_chats.py` | 批量导出所有聊天为 JSON（支持 `-t` 附带语音转录） | -| `export_chat.py` | 单会话导出（供 export_all_chats.py 内部调用） | -| `chat_export_helpers.py` | 导出格式化共享函数（两脚本共用，避免代码漂移） | -| `transcribe_chat.py` | 语音消息转录（共享 config.json 配置的 backend） | -| `find_wxwork_keys.py` | 企业微信 Windows 版内存扫描提 key | -| `decrypt_wxwork_db.py` | 企业微信 wxSQLite3 AES-128 数据库解密 | -| `export_wxwork_messages.py` | 企业微信聊天记录导出（按个人/群筛选，CSV / HTML / JSON） | -| `mcp_server.py` | MCP Server，让 Claude AI 查询微信数据 | -| `monitor_web.py` | 实时消息监听 (Web UI + SSE) | -| `monitor.py` | 实时消息监听 (命令行) | -| `find_all_keys.py` | 平台分发入口（Windows / Linux） | -| `find_all_keys_macos.c` | macOS 版内存密钥扫描器 (C, Mach VM API) | -| `find_image_key.py` | 从进程内存提取图片 AES 密钥（Windows / Linux） | -| `find_image_key_macos.py` | macOS 版图片密钥派生（从磁盘 kvcomm 缓存推算） | -| `decode_image.py` | 图片 .dat 文件解密模块 (XOR / V1 / V2) | -| `config.json` | 配置文件（自动生成，手动编辑） | -| `setup.sh` | 一键安装脚本 | +|---|---| +| `main.py` | **CLI 总入口** — 子命令 `decrypt` / `export` / `all` / `status` / `decode-images` / `help` | +| `app_gui.py` | **Windows GUI** — tkinter 界面整合所有功能 (PR #107) | +| `setup.sh` | 一键安装依赖 (macOS / Linux / Windows Git Bash) | +| `setup.py` | 交互式配置向导 (`python setup.py --check` 仅检查环境) | +| `cleanup.py` | 磁盘清理工具 (`status` 查看用量 / `--dry-run` 预览) | + +
+ +
+② 密钥提取 (从进程内存) + +| 文件 | 说明 | +|---|---| +| `find_all_keys.py` | 平台分发入口 (Windows / Linux) | +| `find_all_keys_windows.py` | Windows: 扫 Weixin.exe 内存找 SQLCipher raw key | +| `find_all_keys_linux.py` | Linux: 同上, 走 /proc//mem | +| `find_all_keys_macos.c` | macOS: C + Mach VM API (需 codesign + 重签 WeChat.app) | +| `find_image_key.py` | 从进程内存提取图片 AES 密钥 (Windows / Linux) | +| `find_image_key_macos.py` | macOS: 从磁盘 kvcomm 缓存推算 (无需进程在线) | +| `find_image_key_monitor.py` | 持续监控模式 (Windows) | +| `find_wxwork_keys.py` | **企业微信 5.x** wxSQLite3 raw key 提取 (cipher 结构体扫描) | +| `key_scan_common.py` / `key_utils.py` | 扫描器共用工具 | + +
+ +
+③ 数据库 / 图片 / 语音解密 + +| 文件 | 说明 | +|---|---| +| `decrypt_db.py` | 全量解密 SQLCipher 4 数据库 (支持 `-i` 增量) | +| `decode_image.py` | 图片 `.dat` 解密 (V1 / V2 / 旧 XOR), 含 `aligned_aes_block_size` 公共 helper | +| `decrypt_wxwork_db.py` | **企业微信** wxSQLite3 AES-128 数据库解密 | +| `decrypt_sns.py` | **朋友圈缓存图片**解密 (V1 / V2 / XOR) | +| `wxwork_crypto.py` | 企业微信 wxSQLite3 per-page 加密原语 (MD5 派生 + AES-128-CBC) | +| `batch_decrypt_images.py` | CLI: 任意目录递归批量解 .dat | + +
+ +
+④ 导出 (JSON / CSV / HTML) + +| 文件 | 说明 | +|---|---| +| `export_all_chats.py` | 批量导出全部聊天为 JSON (含 `-t` 转录 / `-i` 增量 / 日期范围 / `--dry-run`) | +| `export_chat.py` | 单会话 JSON 导出 (供 `export_all_chats` 调用) | +| `chat_export_helpers.py` | JSON 导出共享格式化函数 (避免漂移) | +| `export_messages.py` | CSV / HTML / JSON 三种格式导出, 图片可内联 (PR #107) | +| `export_wxwork_messages.py` | 企业微信版导出 (CSV / HTML / JSON) | +| `export_sns.py` | 朋友圈 SnsTimeLine 导出 (JSON + HTML 时间线) | + +
+ +
+⑤ 实时监听 / 服务 + +| 文件 | 说明 | +|---|---| +| `monitor_web.py` | Web UI (浏览器实时收消息, SSE 推送, http://localhost:5678) | +| `monitor.py` | 命令行实时监听 | +| `mcp_server.py` | **MCP Server** — Claude AI 查询微信数据 (含 `get_chat_history` / `decode_voice` / `decode_refer` 等 20+ 工具) | +| `decode_transfer.py` | CLI: 查单条转账消息 (mcp_server `decode_transfer` 工具的命令行包装) | + +
+ +
+⑥ 语音 / 音频 + +| 文件 | 说明 | +|---|---| +| `transcribe_chat.py` | 语音转文本 (local Whisper / OpenAI / whisper.cpp 三 backend) | +| `voice_to_mp3.py` | SILK_V3 → MP3 (需要 ffmpeg in PATH) | + +
+ +
+⑦ 打包 / 配置 / 文档 + +| 文件 | 说明 | +|---|---| +| `config.py` | 配置加载器 (自动检测微信数据目录, 支持打包后 exe 路径) | +| `config.json` | 配置文件 (首次运行自动生成) | +| `WeChatDecrypt.spec` | PyInstaller 打包描述 | +| `build.bat` | Windows 一键打包为单 exe | +| `requirements.txt` | Python 依赖 | +| `EXE_USAGE.md` | GUI / EXE 使用说明 | +| `Makefile` | 常用命令快捷方式 (`make all` / `make clean` / `make status`) | + +
+ +
+⑧ 测试 / 文档 + +| 路径 | 说明 | +|---|---| +| `tests/` | 单元测试 (185+ 用例, 含 wxsqlite3 / image v2 / msg types / pagination 等) | +| `docs/` | 部署 / 排错指南 + 字段研究报告 | +| `latency_test.py` | 开发工具: 测量消息从 WeChat 写入到我们检测的延迟 | + +
---