快速开始

15 分钟内运行 wechat-decrypt，解密你的微信数据库

安装流程图

前置要求

验证环境

# 检查 Python 版本
python --version
# 预期输出: Python 3.10.x 或更高

# 检查微信进程是否运行
tasklist | findstr Weixin
# 预期输出: Weixin.exe ... 正在运行

常见错误 #1：Python 未安装或版本过低

'python' 不是内部或外部命令，也不是可运行的程序

修复：从 python.org 下载安装，或 winget install Python.Python.3.12

第一步：安装依赖

# 克隆仓库
git clone https://github.com/yourusername/wechat-decrypt.git
cd wechat-decrypt

# 安装依赖
pip install pycryptodome

预期输出：

Successfully installed pycryptodome-3.20.0

常见错误 #2：pip 安装失败

ERROR: Could not find a version that satisfies the requirement pycryptodome

修复：升级 pip 后重试

python -m pip install --upgrade pip
pip install pycryptodome

第二步：配置

首次运行会自动生成配置模板：

python find_all_keys.py

预期输出：

[!] 已生成配置文件: C:\...\wechat-decrypt\config.json
    请修改 config.json 中的路径后重新运行

编辑 config.json，将 db_dir 改为你的微信数据目录：

{
    "db_dir": "D:\\xwechat_files\\wxid_xxxxxxxxxxxx\\db_storage",
    "keys_file": "all_keys.json",
    "decrypted_dir": "decrypted",
    "wechat_process": "Weixin.exe"
}

💡 如何找到 db_dir？ 打开微信 → 设置 → 文件管理 → 查看"文件管理"路径，追加 \db_storage

配置项说明

常见错误 #3：路径配置错误

[!] 数据库目录不存在: D:\xwechat_files\...

修复：确认路径存在且包含 .db 文件：

ls "D:\xwechat_files\*\db_storage\*.db"

第三步：提取密钥（需要管理员权限）

右键点击 PowerShell 或 CMD，选择"以管理员身份运行"，然后执行：

cd C:\path\to\wechat-decrypt
python find_all_keys.py

预期输出：

[*] 发现微信进程 PID: 12345
[*] 扫描内存中...
[*] 找到 26 个数据库
[✓] session/session.db -> key: x'abc123...'
[✓] message/message_0.db -> key: x'def456...'
...
[✓] 成功提取 26/26 个密钥
[*] 密钥已保存到: all_keys.json

首次运行交互时序

常见错误 #4：权限不足

[!] 无法打开进程: Access is denied

修复：必须以管理员身份运行终端。右键 PowerShell → "以管理员身份运行"

常见错误 #5：微信未运行

[!] 未找到微信进程: Weixin.exe

修复：先登录微信，确认任务管理器中有 Weixin.exe 进程

第四步：解密数据库

python decrypt_db.py

预期输出：

[*] 加载 26 个密钥
[*] 解密: session/session.db -> decrypted/session/session.db
[*] 解密: message/message_0.db -> decrypted/message/message_0.db
...
[✓] 完成! 共解密 26 个数据库
[*] 输出目录: C:\...\wechat-decrypt\decrypted

现在可以用任意 SQLite 工具打开解密后的数据库：

# 使用 SQLite 命令行
sqlite3 decrypted/session/session.db ".tables"

# 预期输出
Contact        SessionAttach  SessionInfo    ...

第五步：实时消息监控（可选）

Web UI 方式（推荐）

python monitor_web.py

预期输出：

[*] 加载 26 个密钥
[*] 启动监控服务器 http://localhost:5678
[*] SSE 端点: /events

浏览器访问 http://localhost:5678，即可看到实时消息流。

命令行方式

python monitor.py

预期输出：

[*] 监控会话变化 (每 3 秒)...
[2024-03-15 14:32:01] 文件传输助手: [图片]
[2024-03-15 14:32:15] 工作群: @所有人 下午三点开会

第六步：接入 Claude AI（可选）

# 安装 MCP 依赖
pip install mcp

# 注册到 Claude Code
claude mcp add wechat -- python C:\full\path\to\mcp_server.py

然后在 Claude Code 中直接对话：

> 看看微信最近谁找我了

常见问题速查

下一步