微信聊天记录导出 4 种格式加年度报告:WeChatMsg 免费开源,数据不出本机
【免费下载链接】WeChatMsg提取微信聊天记录,将其导出成HTML、Word、CSV文档永久保存,对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
换手机那天,你发现旧微信三年没备份,聊天记录全卡在旧设备里——重装、转存都没救回来。WeChatMsg 是一款免费开源的微信聊天记录导出工具:它直接读微信 PC 端的本地数据库,把记录导出成 HTML、Word、CSV、PDF 四种格式,还能生成年度聊天报告,全程数据不出本机。照这篇做一遍,你自己就能跑通第一次导出。
📸 先看结果
跑通之后,你手上会有三种产物:一个能在浏览器里搜人搜话的 HTML 页面,一份 Excel 直接打开就能统计的 CSV 表格,还有一页年度聊天报告。
报告长这样:全年统计、活跃时段分布、关键词热度排名、社交网络图谱,都画在一页里。
想看更多样例,仓库 doc/ 目录里还有现成效果文件。
🧾 前提条件
四样东西齐了再动手,缺一样后面都会卡:
- Python 3.8 及以上,终端里查一下版本号;
- 微信 PC 客户端:装最新版并正常登录。主要用手机微信的话这条路走不通,本地数据库在 PC 端;
- 磁盘空间留几个 GB:导出文件加图片、语音媒体,容量不小;
- 依赖装好,命令是:
git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg pip install -r requirements.txt🏁 第一次跑通的最短路径
三步,每步都有判定标准:
- 装依赖:上面 clone 和
pip install跑完,终端没有报错,就算过。 - 确认环境:微信 PC 已登录,导出期间别退出账号,窗口保持打开。
- 跑最小命令:只需要联系人名称和格式两个信息:
python wechat_export.py --contact "家人群" --format html去输出目录找到生成的 HTML,双击用浏览器打开:发言人、时间、消息体都在,页面里能直接搜索、翻页。文件能打开,就说明全链路已打通,后面所有参数都挂在这条命令上。
🎛️ 按需求定制:导出参数组合与格式怎么选
参数都是往上面那条命令上追加。对号入座,直接粘贴:
- 想只导某段时间,就加
--start-date "2024-01-01" --end-date "2024-12-31",适合只备份去年的记录; - 想连图片语音一起走,就加
--include-media,不带的话只导文字; - 想自定义输出文件名,就加
--output "存档.html",免得默认命名不好找; - 想换格式,就把
--format的值改成word、csv或pdf,其余参数不变。
要"去年 + 媒体 + 加密 + 密码"一起上的组合,长这样:
python wechat_export.py --contact "工作群" --format pdf \ --start-date "2024-01-01" --end-date "2024-12-31" --include-media \ --encrypt aes256 --password "your_password"四种格式各有去处,对照这张表选:
| 导出格式 | 适合你 | 技术实现 | 文件体积 |
|---|---|---|---|
| HTML | 日常浏览、发给别人看 | Jinja2 模板渲染,浏览器内可搜索 | 中等 |
| Word | 正式文档、打印输出 | python-docx 生成,Office 可直接编辑 | 较大 |
| CSV | 数据分析、Excel 二次加工 | Pandas 写出结构化表格 | 最小 |
| 长期存档、证据留存 | ReportLab 渲染,可加密码 | 中等 |
怎么选:自用和分享,HTML 起步;要拿 Excel 做统计,补一份 CSV;需要"立起来"归档或备证,走 PDF。四种不冲突,各导一份也不费事。
📊 核心功能深挖:年度聊天报告怎么生成
年度报告是 WeChatMsg 里最有差异化的功能。它按对话顺序把一整年走完:先出全年统计概览和活跃时段分布,再给关键词热度排名、情感变化趋势,最后画一张社交网络图谱,标出你和谁聊得最勤。一年聊了多勤快、情绪在哪些点波动,一页看完。效果样例见上面那张报告截图,完整文件在 doc/ 目录。
🛡️ 数据边界:记录到底去了哪里
这条工具的边界很清楚:所有读取、解密、导出都发生在你的电脑上,不连接任何外部服务器。记录不经过任何云端,这是默认行为,不用额外配置。
默认本地处理之外,还有两层可选防护,按需打开:
| 防护层级 | 防护内容 | 启用方式 |
|---|---|---|
| 本地处理 | 全部操作在用户设备完成 | 默认启用 |
| 文件加密 | AES-256 加密导出文件 | 加--encrypt aes256 |
| 敏感信息脱敏 | 自动替换手机号、身份证等 | 加--redact-sensitive |
怎么选:涉及合同内容、个人信息的群,把--format pdf、--encrypt aes256、--password "你的密码"、--redact-sensitive一起挂上;导出后文件无法直接打开,要输密码才能解密。哪怕它被拷到移动硬盘里,也不用担心内容外泄。
🩹 卡住了怎么办
三个高频故障,对着症状处理:
- 跑完没找到文件:核对
--contact的群名或昵称和微信里是否一字不差,空格、全半角字符都算。 - 导出中途卡住或中断:把时间范围拆小,按月分批执行,别一次拉全年;文件过大就加
--split-by-date切分、--compress压缩。 - 图片、语音导出来缺失:确认微信媒体存储路径没被改过、磁盘空间充足,导出时明确加上
--include-media。
🚀 往远了走
- 定时任务:用 cron 把导出命令挂成每周固定执行,结果自动落到备份目录,不再靠自觉。
- 自定义分析:基于插件机制写话题聚类、决策点识别这类分析,不用改核心代码。
- API 集成:项目提供了 RESTful API,其他本地工具可直接调用导出能力,不用每次手敲命令。
别等换设备那天才想起备份。今天就挑一个你舍不得丢的群,把"第一次跑通的最短路径"里那条命令跑一遍——打开页面看到记录都还在,剩下的就是格式和节奏的事了。
【免费下载链接】WeChatMsg提取微信聊天记录,将其导出成HTML、Word、CSV文档永久保存,对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考