PyWxDump 完全指南：在电脑上解密微信聊天记录并导出成可读文件

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