GetQzonehistory 快速指南:一次扫码导出 QQ 空间全部历史说说
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
QQ 空间网页版翻十几页就翻不到早年动态,想把几年前的文字、配图、评论原样留存在本地,手动复制不现实。GetQzonehistory 是一个 QQ 空间历史说说导出工具:手机扫码登录一次,它把账号下可见的历史说说、配图、评论全部抓下来,整理成 Excel 表格、时间线网页和本地图片。
📦 GetQzonehistory 安装步骤:Python 依赖与 zbar 配置
需要 Python 3.7 以上版本。克隆代码并进入目录:
git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory安装依赖,requirements.txt 共 11 个包,国内网络可加镜像源:
pip install -r requirements.txt⚠️ 登录用的条码识别库 pyzbar 依赖系统里的 zbar 共享库,pip 装不了它。启动前先用系统包管理器装好:
- Linux(RPM 系):
sudo dnf install -y zbar;Debian/Ubuntu 系:sudo apt install libzbar0 - macOS:
brew install zbar
🚀 QQ 空间说说导出全流程:扫码登录到 Excel 落盘
- 扫码登录:运行
python main.py,终端打印字符拼成的二维码,用手机 QQ 直接扫,全程不用输账号密码。 - 确认登录:终端打印「用户<QQ号>,<昵称>登录成功」后,cookie 已写入
resource/user/;下次启动会列出已登录账号让你选,不用再扫。 - 看两条进度条:前一条对应互动消息列表(10 条/页,页间歇 3 秒),后一条对应可见说说列表(30 条/页)。耗时和条数成正比,几千条跑几十分钟属正常。
- 出结果:跑完打印总消息数、最早说说时间、好友数、图片数等统计,并自动打开结果目录。
中途想停按 Ctrl+C 即可:程序注册了信号处理,已抓到的数据会先落盘再退出(见 main.py 里的signal_handler)。
📄 导出产物清单:result 目录文件结构与用途
所有文件落在resource/result/你的QQ号/下:
| 文件 | 内容与用途 |
|---|---|
| QQ号_全部列表.xlsx | 全部记录:时间、内容、图片链接、评论 |
| QQ号_说说列表.xlsx / 转发列表.xlsx / 留言列表.xlsx / 其他列表.xlsx | 按类型分表,说说与转发两张表额外带评论列 |
| QQ号_好友列表.xlsx | 互动中出现的好友:昵称、QQ 号、空间主页链接 |
| QQ号_说说网页版.html | 时间线网页,浏览器打开即用,文字表情渲染成图片 |
| pic/ | 说说配图全部下载,文件名取说说文本前 40 个字符 |
🔍 核心机制拆解:数据从哪来、记录如何分类
两条数据通路合并
互动消息列表在 main.py 主循环里逐页拉取;可见未删除说说列表在 util/GetAllMomentsUtil.py 中先查总条数算出页数,再逐页取完。后者能捞到互动列表已翻不到、但空间里仍可见的早期记录。两路合并后按内容去重,同一条说说只进一次表格。
四条分类规则
按内容关键词先切一刀:带「留言」字样进留言表,带「转发」字样进转发表;再看昵称是不是你自己,是则进说说表,剩下归入其他表。早期记录的时间有的缺秒数,解析时带秒、不带秒两种格式各试一次。
本地缓存与中断保护
两份数据都有本地缓存:可见说说的原始结果存在resource/fetch-all/你的QQ号/下,重跑不会重复请求。配合 Ctrl+C 落盘机制,中断后再启动不必从头抓。
常见问题排查:GetQzonehistory 报错速查表
| 现象 | 原因 | 处理 |
|---|---|---|
| 启动即提示找不到 zbar 共享库并退出 | pyzbar 依赖系统 zbar,pip 装不了 | 用系统包管理器安装,参考 util/LoginUtil.py 输出的提示 |
| 终端二维码显示不全、扫不出 | 字符图案在部分终端字体下缺块 | 改扫终端自动保存的图片resource/temp/QR.png |
| 每次运行都要重新扫码 | 登录 cookie 过期 | 重新扫一次;若频繁出现,检查系统时间是否准确 |
| 导出的条数比印象里少 | 消息列表只覆盖有互动的记录 | 核对「可见说说总条数」输出,两路合并后才是全量 |
⚖️ 使用边界与备份建议
- 只取你账号可见的数据,「仅自己可见」和已删除的说说拿不到,这是机制边界不是故障。
- 登录、抓取、导出全在本地机器完成,数据不出机器;但导出文件含好友昵称、QQ 号和评论内容,别对外上传分享。
- 工具仅限个人备份与技术研究,不要商用或大规模抓取。
- 跑完打开网页版 HTML 翻到最底部,时间和你记忆中第一条说说得得上,就说明完整了。
- 之后把
resource/result目录定期备份到另一块存储即可。
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考