PyWxDump 完全指南：在电脑上解密微信聊天记录并导出成可读文件
【免费下载链接】PyWxDump删库项目地址: https://gitcode.com/GitHub_Trending/py/PyWxDump
PyWxDump 是一款做微信聊天记录解密的免费命令行工具：从微信 PC 端进程内存中取回密钥，还原 SQLCipher 加密的聊天记录，再导出为 HTML 等格式。先交代现状：项目收到官方律师函后，作者已删除全部代码，仓库目前只留一份移除通知。
三十秒看清项目现状
- 适合谁：想备份自己微信 PC 端聊天记录的人，以及想研究数据库解密类工具工作方式的人。
- 项目现状：仓库已被清空，能拉到的只有 README.md 和 img/ 目录，拿不到可运行的 pywxdump 模块。
- 核心链路：项目存续期间，一条
python -m pywxdump命令串起取密钥、解密、导出三件事。- 最大坑：环境装得再干净也会"找不到模块"——因为代码本身已经不存在了。
- 复现流程的前提：Python 3.7+、微信 PC 端保持登录、终端具备管理员权限。
先懂原理：内存取密钥与 SQLCipher 数据库解密三步走
不用啃代码，看懂三个环节，后面所有输出你都能读懂。
- 取密钥：微信运行期间，扫描它的进程内存，找到打开数据库用的那把密钥。类比：不用撬保险箱，从随身的人身上抄一把钥匙就行。
- 解数据库：微信把聊天记录存在一个用 SQLCipher 加密的 SQLite 文件里，密钥填进去，文件就还原成普通可读格式。类比：SQLCipher 相当于给整本日记加了密码锁，密钥就是开锁的口令。
- 导格式：把消息表写成 HTML、TXT、JSON 或 CSV，你要哪种拿哪种。类比：像把日记内容印成不同尺寸的相册，按需取用。
整个过程不碰微信的安装目录——这既是工具当年的卖点，也是后来合规争议的源头。
从零跑通：克隆到导出微信 PC 聊天记录的四个阶段
📌 现状：以下流程是项目存续期间的用法。代码已删除，这一节用于理解链路，当前仓库上跑不通。
拿到代码
准备 Python 3.7+，克隆仓库并装依赖：
git clone https://gitcode.com/GitHub_Trending/py/PyWxDump cd PyWxDump pip install -r requirements.txt克隆完如果只看到 README 和图片，说明拉到的是删库后的仓库，后面模块全部不可执行，对照"卡住时"第一条确认即可；依赖装好则继续下一阶段。
取出数据库密钥
保持微信 PC 端登录并驻留（托盘能点到图标），用管理员身份打开终端执行：
python -m pywxdump bias --auto看到终端打印出找到的进程、版本号，再给出密钥值，当前目录落下一份密钥缓存文件，就算成功。若提示未找到进程，去"卡住时"查进程与权限两条。
还原加密文件
密钥文件在手，批量解密：
python -m pywxdump decrypt --all终端逐个列出数据库文件，写出解密后的 .db 副本，结尾给出汇总，即为成功。出现"文件被占用"时说明微信正在写库，别直接杀进程，处理办法在后文对应条目里。
导出可读记录
至少一个库解密成功后，选格式导出：
python -m pywxdump export --format html导出完用浏览器打开 HTML，核对三件事：会话列表不为空、消息完整、时间戳连续。三项都过才算真正跑通；哪项没过，对照"卡住时"的 HTML 导出条目自查。
密钥模式与导出格式怎么选：两张对照表
取密钥的三种模式
bias子命令是取密钥的入口，三种模式对应不同处境：
| 想省事选它 | 选它的理由 | 什么时候别选 |
|---|---|---|
bias --auto自动识别 | 单账号最常见，一条跑完 | 多开场景可能选错账号，解出来是空库就要换模式 |
bias --account <标识>指定账号 | 同机多开时精准指向目标账号 | 单账号用不上，多一步操作 |
bias --multi批量 | 多账号一次跑完，逐个提示确认 | 某个账号报错会中断该账号的流程，需要重跑 |
导出的四种格式
--format参数决定输出长相，选哪种取决于你要拿数据做什么：
| 想省事选它 | 选它的理由 | 什么时候别选 |
|---|---|---|
| HTML | 浏览器直接打开，保真度最高 | 体积大，不方便机器处理 |
| TXT | 体积最小，纯文本消息流 | 没有发送者与时间戳，做不了统计 |
| JSON | 结构化字段含发送者、时间戳，脚本好读 | 不能直接看，得写脚本 |
| CSV | Excel 直接打开 | 只适合表格化统计 |
🧭 判断：只存档就导一份 HTML 足够；打算自己做统计、画时间线的话，多导一份 JSON，省得回头重新导出。
卡住时：六个常见现象与处理方式
🚧 按下面的顺序排查，从"模块不存在"到"权限错位"，逐项成本递减。
克隆仓库里没有 pywxdump 模块
现象——目录里只有 README.md 和 img/。 原因——不是装坏了：仓库已删库，这是项目现状，不是环境问题。 处理——没有解法可执行，别再排查环境，把本文当学习资料或另找替代方案。
提示"未找到微信进程"
现象——bias --auto扫不到进程。 原因——微信没登录驻留，或终端与微信的运行权限不一致。 处理——任务管理器确认微信在运行且已登录，而不是只开着启动器；再以管理员身份重开终端，两边权限对齐后重试。
密钥取到、解出的库却是空的
现象——解密流程走完，消息表一条数据都没有。 原因——多开环境下认错了账号，密钥和库对不上。 处理——先删掉旧的密钥缓存文件，再用bias --account <标识>重新指向目标账号取值。
解密报"文件被占用"
现象——某个 .db 文件写不出来，流程中断。 原因——微信正在同步写入数据库，文件被锁。 处理——在微信里结束正在进行的文件传输，等一两分钟让写入落盘再重试；仍失败就重启微信后再解密，不建议直接杀进程。
导出的 HTML 看不到图片
现象——文字消息都在，媒体文件不显示。 原因——导出时媒体目录没有随 HTML 一起生成。 处理——查看输出目录，HTML 同级没有独立的媒体文件夹就删掉这轮输出重新导出，导出期间别移动输出目录。
命令报 ModuleNotFoundError
现象——命令刚执行就提示缺模块。 原因——依赖装进了另一个 Python，和实际执行命令的不是同一个解释器。 处理——分别查看 pip 与 python 各自报告的所在路径，不一致就用python -m pip重装一遍 requirements。
边界与合规：律师函对你意味着什么
⚖️ 风险类说明集中在这一节，其余章节不再重复。
律师函主张项目未经授权修改、拆解微信客户端软件，并通过第三方工具获取客户端数据，构成对软件著作权的侵害。2025 年 10 月 20 日，作者删除了全部代码与提交历史，同时停止提供任何技术支持。
数据处置上有三件事建议你自己评估：
- README 请求本地留有旧版本的使用者停止使用并删除 pywxdump 相关内容（含线上宣传内容）。保留还是清理由你决定，后果自负，本文不下法律结论。
- 处理聊天记录时注意群聊内容涉及他人隐私，对外展示前确认自己有使用权利；需要留存凭证时，把原始导出文件和展示版分开存放，对原始文件计算 MD5 留底。
- 只是想备份自己的记录，微信自带的迁移与备份功能是风险更低的路径。
接下来：
- 通读 README.md 全文，把删库原因与作者声明记清楚
- 清理本机残留的旧版本代码与密钥缓存文件
- 把"内存取密钥 → 数据库解密 → 多格式导出"这条链路整理成笔记，方法论可以迁移到其他解密工具的研究里
工具已经退场，但找密钥、开锁、导内容这套思路，读完这一篇就够你讲清楚了。
【免费下载链接】PyWxDump删库项目地址: https://gitcode.com/GitHub_Trending/py/PyWxDump
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
