QQ空间历史说说导出工具:扫一次码,把多年前的记录全捞回来
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
翻 QQ 空间,往上翻几页就到底,三五年前的内容根本看不全。GetQzonehistory 是一个 QQ 空间历史说说导出工具:用手机 QQ 扫一次码,它把所有可见的历史记录按页拉全,最后给你分类 Excel、本地图片目录和一个能直接打开的网页版时间线。
这个工具能替你做什么
- 登录只要扫码,账号密码从头到尾不经过程序
- 跳过网页只能翻近几页的限制,从两个数据源分页拉取,连互动列表里已经翻不到的早期记录也能捞回来
- 自动下载说说配图,存到本地目录
- 按"说说 / 转发 / 留言 / 其他"分类,输出 5 张 Excel、1 张好友表和 1 个 HTML 网页
- 全程在本机运行,数据不出你的电脑
从零跑起来的最短路径
环境要求只有Python 3.7 及以上。
git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory建议用虚拟环境隔离依赖:
python -m venv myenv # Windows 激活 myenv\Scripts\activate # Linux / macOS 激活 source myenv/bin/activate安装 requirements.txt 里的 11 个依赖包:
pip install -r requirements.txt启动前有一个必踩的坑:登录用的 pyzbar(Python 的条码识别库)依赖系统里的 zbar 共享库,pip 装不了它。先装系统库:
- Linux:
sudo dnf install -y zbar或sudo apt install libzbar0 - macOS:
brew install zbar
装完再启动:
python main.py它会依次做这几件事
启动后你只做一件事:等终端打印出二维码图案,用手机 QQ 扫掉。登录逻辑在 util/LoginUtil.py,等待期间程序每 3 秒轮询一次状态,提示"未失效 / 认证中 / 已失效"。扫完码,登录信息会存到本地resource/user/,下次运行直接读,不用再扫。
扫完之后分两阶段取数:
- 两条线拉数据。互动消息列表每 10 条取一批、批间停 3 秒,控制请求频率;可见未删除说说列表先查总条数算出总页数,再每页 30 条逐页请求,实现见 util/GetAllMomentsUtil.py。第二个来源能补上互动列表里翻不到的早期记录。
- 归类加去重。每条记录按发布者和关键词归位:含"留言"进留言表,含"转发"进转发表,你自己发的进说说表,其余归"其他";互动里出现的好友单独汇成好友表。合并前按内容去重,同一条不会计两次。时间字段做了兼容——早期记录有的缺秒数,两种格式各试一次。
- 落盘加兜底。图片逐张下载到
pic/子目录;程序注册了信号处理,中途按 Ctrl+C 退出时,已抓到的数据会先保存再结束。
跑通之后你手里有什么
全部产出在resource/result/你的QQ号/目录下:
| 文件 | 内容 |
|---|---|
| QQ号_全部列表.xlsx | 抓到的全部记录 |
| QQ号_说说列表.xlsx | 你发布的原创说说 |
| QQ号_转发列表.xlsx | 你的转发记录 |
| QQ号_留言列表.xlsx | 你留下的留言 |
| QQ号_其他列表.xlsx | 其他好友的动态 |
| QQ号_好友列表.xlsx | 互动中出现的好友(昵称 / QQ / 空间主页) |
| QQ号_说说网页版.html | 网页版时间线,QQ 文字表情已换成图片 |
| pic/ | 说说的本地图片 |
内容表统一四个字段:时间、内容(开头带发布者昵称)、图片链接(多张逗号分隔)、评论。
两步自查,确认它真的跑通了:
- 看结尾统计:终端会打印总消息数、最早一条说说时间、好友数、各列表条数、图片数。重点核对"最早一条说说"——你用了多少年空间,它就该回到多少年前。
- 打开 HTML 网页版,确认时间线、图片、评论显示正常,再看说说表行数和
pic/里的图片数量是否对得上。
对得上,这份导出就可以留用。
出问题时先查这里
| 现象 | 原因 | 处理 |
|---|---|---|
| 启动提示"无法找到 zbar 共享库"并退出 | pyzbar 需要系统级 zbar 库,pip 装不了 | 用系统包管理器装:Linuxsudo dnf install -y zbar或sudo apt install libzbar0,macOSbrew install zbar |
| 终端二维码看不清、扫不出 | 字符图案在部分终端字体下显示不全 | 二维码同时存成了图片resource/temp/QR.png,打开那张图扫 |
| 导出结果缺某些说说 | 只取"可见"范围,仅自己可见或已删除的拉不到 | 这是机制边界不是故障;数据按内容去重,重跑是安全的 |
| 运行很久像卡死 | 每 10 条停 3 秒,总耗时和数据量成正比 | 让它跑完;要中断按 Ctrl+C,已抓数据会先保存 |
| 下次运行又要求扫码 | 登录 cookie 过期 | 重新扫码即可;若频繁出现,检查系统时间是否准确 |
动手之前先记住的边界
- 只取本人可见的数据:登录、抓取、导出全在本地机器上完成,不上传任何第三方服务器。"仅自己可见"和已删除的说说天然不在范围内,别把缺失当成 bug。
- 文件里有别人的信息:Excel 和 HTML 包含好友的昵称、QQ 号与评论内容,这些是他人个人信息,不要把导出文件对外公开。
- 仅限个人备份与技术研究:说说文字和图片受平台及原作者版权约束,不要用于商业用途或大规模抓取。
先核对结尾统计里的"最早一条说说"时间和各表行数是否符合预期,再把resource/result目录定期备份到另一块存储。
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考