PyWxDump:PC 微信聊天记录解密与导出
【免费下载链接】PyWxDump删库项目地址: https://gitcode.com/GitHub_Trending/py/PyWxDump
系统重装之后,旧电脑上的微信无法再运行,几年的对话记录随之无法读取——对从不导出记录的用户来说,这是数据丢失最常见的原因,也是多数微信聊天记录备份需求的起点。PC 版微信的本地数据存放在加密数据库中,官方客户端只允许备份到另一台设备,并不提供可浏览文件的导出入口。PyWxDump 是一款在存续期间提供微信数据库解密能力的命令行开源工具:它在微信进程运行时从内存中读取密钥,对本地数据库文件解密,并将聊天记录导出为多种格式。本文梳理该工具的能力边界、操作流程与当前状态,适合想快速了解它、或本地还留有旧版副本的读者。
能做什么与不能做什么
存续期间的核心能力:
- 密钥获取:自动扫描微信进程内存定位数据库密钥,不需要手工推算偏移量
- 数据库解密:对 PC 微信账号目录下的加密 DB 文件在本地完成解密
- 多格式导出:聊天记录可输出为 HTML、TXT、JSON
- 全程本地执行:解密与导出都在本机完成,数据不经过网络
| 场景 | 结论 |
|---|---|
| 备份自己 PC 账号的聊天记录 | 支持(限于当时支持的微信版本范围) |
| 手机微信的数据 | 不支持,工具只针对 PC 客户端 |
| 找回服务器端已删除的历史消息 | 不支持,仅能解密本地磁盘上已存在的数据库 |
| 直接运行本仓库的代码 | 不支持,代码已全部删除,见后文「项目现状」 |
环境与前置条件
- Windows 10/11 系统,密钥获取依赖读取 PC 微信进程内存
- Python 3.7 及以上版本
- PC 微信保持登录且全程运行,取密钥时进程必须存活
- 磁盘留足空间,解密后的数据库与导出产物建议至少预留 500MB
- 本地持有一份项目代码副本(仓库现已无代码,这是复现下述流程的前提)
操作流程:从密钥获取到导出
由于代码已移除,以下流程为项目存续期间文档化用法的回顾。
获取代码与安装依赖:克隆仓库后按清单安装依赖。
git clone https://gitcode.com/GitHub_Trending/py/PyWxDump cd PyWxDump pip install -r requirements.txt获取密钥:微信处于登录运行状态时执行自动扫描。
python -m pywxdump bias --auto同一台电脑登录多个微信账号时,可改用带--multi参数的命令一次扫描多账号:python -m pywxdump bias --multi。
解密数据库:拿到密钥后解密本地数据库文件。
python -m pywxdump decrypt --all导出记录:按需要选择格式输出聊天记录。
python -m pywxdump export --format html如果只是想验证安装是否生效,可以先执行python -m pywxdump --version查看模块是否可用。
导出格式怎么选
| 格式 | 适用场景 | 说明 |
|---|---|---|
| HTML | 浏览与归档 | 保留聊天结构,浏览器可直接打开 |
| TXT | 搜索、转交其他工具 | 纯文本,体积最小 |
| JSON | 脚本化处理 | 结构化字段,便于二次开发 |
故障排查:常见现象与处理
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
python -m pywxdump提示找不到模块 | Python 环境与安装依赖的环境不一致,或依赖未装全 | 在项目目录重跑pip install -r requirements.txt,并用python --version确认解释器 |
bias --auto取不到密钥 | 微信未运行、未登录,或该版本的内存结构有变化 | 登录 PC 微信后重试;核对版本是否在支持范围内 |
| 导出中断或没有生成文件 | 磁盘空间不足,工作目录含中文或特殊字符 | 释放空间,把项目移动到纯英文路径 |
| 导出结果缺少部分消息类型 | 该类型消息未被导出逻辑解析 | 改用 JSON 格式获取原始字段 |
项目现状与使用边界
2025 年 10 月,作者收到来自微信方面的律师函,函件认定解密功能涉嫌违反软件许可约定,作者随后删除了全部代码与提交历史,仓库当前仅保留 README.md 这份移除通知和两张图片。
图:微信方面发出的律师函扫描件,是项目被移除的直接原因,对应正文「项目现状」一节。
从合规角度看,该工具原本也只适合用于本人设备数据的备份与个人研究;解密商业产品的加密数据库本身就带有合规风险,律师函已经表明了这一态度。若本地仍保留旧版本副本,建议按仓库通知删除,或自行充分评估风险后再做决定。
PyWxDump 以相对轻量的方式验证了「内存取密钥—数据库解密—记录导出」这条 PC 微信数据导出路径的可行性,代码移除之后,这条路径可以视为已经关闭。真正需要长期留存聊天记录的话,更稳妥的办法依然是依托官方客户端自带备份功能,并养成周期性执行的备份习惯。
【免费下载链接】PyWxDump删库项目地址: https://gitcode.com/GitHub_Trending/py/PyWxDump
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考