PyWxDump:3步解密微信PC聊天记录,把数据导出到自己手里
【免费下载链接】PyWxDump删库项目地址: https://gitcode.com/GitHub_Trending/py/PyWxDump
PyWxDump 是一款命令行工具,能把微信聊天记录解密并导出:它在微信 PC 端进程运行时扫描内存提取数据库密钥,再用该密钥把本地用 SQLCipher(一种对整个数据库文件加密的方案)加密的聊天记录库解开,最后输出 HTML、TXT、JSON 等格式。目前项目已于 2025 年 10 月 20 日删除全部代码与提交历史,仓库中只剩一份移除通知。
⚠️ 该项目收到微信官方律师函,作者已声明核心功能存在合规风险。以下内容仅供了解其技术思路,是否继续研究或操作,法律风险需自行评估。
一、技术链路——它怎么把加密库变可读的
整个过程分三段,每段各司其职:
- 从进程内存扫密钥:微信运行期间,解开数据库用的密钥只存在于进程内存中。工具找到微信进程后扫描出这串字符。之所以这么做,是因为密钥不会以明文形式留在磁盘上,只能从活着的进程里取——好处是完全不碰微信安装目录,你只需保持微信登录并运行,不用手动翻找任何路径。
- 用 SQLCipher 解开数据库:微信把聊天记录存在 SQLite 数据库里,且整体经过 SQLCipher 加密,普通数据库工具直接打开只会看到乱码。工具拿上一步的密钥逐文件解密,在旁边生成一份能正常读取的
.db副本。解密只读取本地数据文件,不会改动微信程序目录里的东西,你也不需要预先备份或搬移任何文件。 - 多格式导出:解密成功后消息就是普通的数据库表,工具把消息表转换成你指定的格式写盘。你只需要在命令里选一个参数,路径和目录归拢都是自动完成的。
二、从零到出结果——最短路径
提醒:代码已删除,以下命令是项目存续时期的用法,仅供理解流程,现在克隆下来跑不通。
动作一:准备
- 前置检查:Python 3.7+ 已装好,微信 PC 端已登录并留在后台运行。
- 命令:
git clone https://gitcode.com/GitHub_Trending/py/PyWxDump cd PyWxDump pip install -r requirements.txt- 成功标志:
pip提示依赖安装成功;若克隆后只看到 README 和图片目录,说明拉到的是删库后的仓库,停在这里即可。 - 卡住怎么办:用
pip -V和python -V核对解释器路径是否一致,不一致就改用python -m pip安装。
动作二:取密钥
- 前置检查:微信进程存活(托盘可见图标),终端以管理员权限打开。
- 命令:
python -m pywxdump bias --auto- 成功标志:终端打印出扫描到的微信进程、版本号和密钥值,当前目录生成一份密钥缓存文件。
- 卡住怎么办:提示「未找到进程」时,确认微信是已登录状态而非启动器,再以管理员权限重开终端重试。
动作三:解密+导出
- 前置检查:密钥文件已生成,微信仍在运行(关闭可能导致文件锁定)。
- 命令:
python -m pywxdump decrypt --all python -m pywxdump export --format html- 成功标志:终端逐个列出数据库文件并显示解密成功,输出目录里生成可打开的 HTML 页面且会话列表非空。
- 卡住怎么办:报「文件被占用」时先在微信里结束正在进行的传输,等一两分钟让写入落盘再重试,不要直接杀进程。
三、参数与格式——一张表选完
| 你要解决什么问题 | 推荐参数/格式 | 理由 |
|---|---|---|
| 单账号取密钥,图省事 | bias --auto | 自动识别最稳 |
| 同机多开、自动识别选错账号 | bias --account <标识> | 手动指定目标账号 |
| 多个账号想一次性处理 | bias --multi | 逐个确认不互卡 |
| 要存档、用浏览器直接读 | --format html | 可直接浏览保真 |
| 要做关键词统计、时间线分析 | --format json | 字段结构化好加工 |
| 要进 Excel 做统计报表 | --format csv | 表格行体积最小 |
| 只要纯文本流快速检索 | --format txt | 内容最简占用小 |
💡 一句话经验:只留档选 HTML,要脚本二次加工选 JSON 更顺手;多账号场景先跑--multi看一眼识别列表,确认无误再决定逐个处理还是批量跑。
四、三个场景的操作清单
换机前:把聊天记录搬进保险箱
- 在旧电脑上跑完「取密钥→解密→导出」,导出 HTML 供阅读、再留一份 JSON 保结构。
- 把整个导出目录压缩后存入加密网盘或移动硬盘,别散放在桌面。
- 在自己的台账里记下备份日期、账号名和当时的微信版本,日后核对有据。
- 换机完成后抽查打开 HTML,确认最近会话的消息与时间戳连续完整。
需要凭证:让文件不可抵赖
- 解密后的
.db文件与导出文件各存一份,原始版和展示版分开存放。 - 对每个导出文件计算 MD5(能证明文件内容是否被改动过的指纹值)并单独记录,随时可自证未被篡改。
- 需要展示时再转成 HTML 格式,展示副本与原始副本不混放。
- ⚠️ 内容若涉及他人隐私(如共同群聊),对外使用前务必确认自己有权展示。
想复盘:用数据看自己的聊天习惯
- 用 JSON 导出,按会话过滤出目标对象,脚本直接读文件即可。
- 统计每月消息条数,观察消息发送集中在白天还是深夜。
- 提取高频关键词,看看自己的表达习惯;分析脚本几行代码就够。
五、卡住了?按症状对号入座
提示未找到微信进程:微信没真正运行,或两端权限不一致。任务管理器确认登录状态,把终端与微信的权限对齐后重试。
密钥取到了但解密后库是空的:多半是取错了账号。把旧密钥缓存文件移走,再用
--account指定目标账号重取。解密报文件被占用 / 克隆的仓库里没有 pywxdump 模块:前者是微信正在写库,先停掉传输等写入落盘再重启微信解密;后者是仓库已被清空而非环境问题,别再花时间排环境。
导出 HTML 里图片看不到:媒体目录没有同步生成。检查输出目录里有没有与 HTML 同级的媒体文件夹,没有就删掉旧输出重新导出,导出期间别移动输出目录。
命令报 ModuleNotFoundError:依赖没装进当前解释器。对照
pip -V与python -V的路径,不一致就用python -m pip install -r requirements.txt重装。把「内存取密钥→SQLCipher 解密→多格式导出」这条链路整理成笔记,思路可以平移到其他数据库解密工具。
清理本地残留:旧版本代码与密钥缓存文件建议删除,README.md 中的移除通知已明确给出该建议。
⚠️ 合规提醒:只操作自己账号、自己的数据,遵守法律法规与平台协议;项目已下线,使用旧副本的风险自行承担。
如果确实需要导出聊天记录,优先使用微信自带的迁移与备份功能——这是合规无争议的路径。
【免费下载链接】PyWxDump删库项目地址: https://gitcode.com/GitHub_Trending/py/PyWxDump
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考