GetQzonehistory：一次扫码归档 QQ 空间全部历史说说，6 张表格加 1 个网页版一次产出-平芜编程栈

GetQzonehistory：一次扫码归档 QQ 空间全部历史说说，6 张表格加 1 个网页版一次产出

【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory

很多年前发的说说早已不在 QQ 空间的页面展示，GetQzonehistory 能直接从历史消息列表把它们取回，导出成 Excel 表格与网页版存档。扫码登录、无需输密码，适合想把旧动态备份整理的普通用户。

它解决什么问题 📥

QQ 空间首页信息流只展示近期内容，几年前的老说说、转发和留言翻不到，想逐条回忆只能手动翻页。GetQzonehistory 把这件事变成一次批量抓取：它的数据来源是 QQ 空间的历史消息列表，覆盖范围比页面信息流更早、更全，抓完按 QQ 号统一归档。

不用它	用它之后
截图、复制粘贴，素材散落各处，格式混乱	6 张 Excel 表格 + 1 个网页版，按 QQ 号自动归档到同一文件夹

手动翻页只能看当前页面还展示的内容，掉出信息流的老说说基本找不回；工具直接从历史消息列表按批拉全量，结尾还会打印总条数
手动归档耗时以小时计，中断就前功尽弃；工具一条命令跑完，带进度条，中途 Ctrl+C 也会先把已抓数据存盘
网页版登录要输密码；工具沿用与网页版 QQ 空间一致的扫码登录，凭证只保存在本地
表格里的内容、图片链接、评论都是结构化字段，随时可以筛选、检索；截图和聊天记录做不到这一点

从零跑通：安装到第一次运行 🚀

环境准备与安装命令

需要 Python 3.8 以上版本，其余依赖都写在 requirements.txt 里，一条命令装完：

git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory python -m venv myenv # Windows 激活：myenv\Scripts\activate # macOS/Linux 激活：source myenv/bin/activate pip install -r requirements.txt

检查点：

pip install结束时全部显示 Successfully installed，没有出现成片的红色报错栈
如果 macOS 提示找不到 zbar 库，程序会询问是否通过 Homebrew 安装，回复 y 即可；装完重新运行，二维码识别依赖（pyzbar）才能正常工作

运行与验证的 3 个成功标志

python main.py

终端弹出二维码，用手机 QQ 扫码；第二次运行时若提示已登录用户列表，直接选序号即可，不用重扫
登录成功后出现以"10条"为单位的进度条，每批拉完会等待 3 秒再继续，进度条走完说明历史消息列表已拉完
结束时终端打印消息总数、最早一条说说的发布时间、各列表条数，并自动打开 resource/result/你的QQ号/ 结果文件夹

背后是怎么跑的 ⚙️

登录由 util/LoginUtil.py 完成：程序生成二维码，扫码后用 pyzbar 解析回调拿到登录凭证，只写入本地 resource/user/ 目录。后续所有网络请求集中在 util/RequestUtil.py：先查询历史消息总数，再按每批 10 条、批间隔 3 秒的节奏逐批请求，小批量加间隔是为了降低触发风控的概率。

历史消息列表不是唯一来源。GetAllMomentsUtil.py 会额外拉取当前可见且未删除的说说做补充，并用内容相似度比对剔除两边重复的条目——消息列表里删过的还在页面上的、页面上有但列表里没进过的，两个来源叠加后都不至于漏掉。

最后是清洗与产出：main.py 把时间格式统一、[em] 表情码替换成可显示的图片、说说图片逐张下载到 pic/ 并按内容命名（重名自动加时间戳），再按"全部 / 说说 / 转发 / 留言 / 好友 / 其他"六个维度拆表落盘，同时用说说和转发两份表渲染出 QQ 空间样式的网页版 HTML。程序注册了 Ctrl+C 中断处理，即使中途手动结束，已抓到的数据也会先存盘再退出。

结果都在哪 📂

所有产出集中在resource/result/你的QQ号/目录下，首次运行后会自动打开该文件夹：

文件 / 格式	内容	适合场景
QQ号_全部列表.xlsx	全部历史消息：时间、内容、图片链接、评论	完整盘点、整体回顾
QQ号_说说列表.xlsx	你自己发布的说说	年度回顾、内容分析
QQ号_转发列表.xlsx	你转发过的内容	梳理过去的兴趣点
QQ号_留言列表.xlsx	好友在你空间留下的留言	回顾好友互动
QQ号_好友列表.xlsx	互动好友的昵称、QQ 号、空间主页链接	整理通讯录、查关系
QQ号_其他列表.xlsx	与你的其他相关互动内容	补全互动全貌
QQ号_说说网页版.html	说说与转发合成的 QQ 空间样式页面，含头像、评论、图片	浏览器直接翻看、打印分享
pic/ 子目录	说说图片的本地副本，按内容命名	离线查看、做相册

数据还能怎么玩 💡

年度回顾：在"全部列表"表里按年份筛选，整理成一份"那年我在说什么"的年历，适合年末或生日时翻看。
心情时间线：搜索"累""开心"这类高频词，看看不同时期的情绪分布，等于给自己画一张心情地图。
好友关系盘点：把留言列表和好友列表对着看，统计互动次数，能看出哪些朋友陪你走过哪个阶段。
电子纪念册：网页版已经把时间线、头像、评论都还原了，稍作样式调整或打印成册，就是现成的纪念册底稿。
内容迁移素材：表格里的时间、正文、图片链接都是结构化字段，将来把老内容搬到别的平台时可直接当迁移底稿。

卡住了？自查清单 🛠

二维码生成失败或扫码后没反应：先确认网络能正常打开 QQ 空间网页版；macOS 报缺 zbar 就按提示用 Homebrew 装上；然后重新运行 main.py 生成新二维码即可。
导出的条数比想象少：能不能取到取决于数据源——没进过历史消息列表的（已删除、原本仅自己可见）取不到，这是机制决定的。重新运行一次可补齐新可见的说说，以结尾打印的总条数为准。
部分图片下载失败：老图片链接失效属常见现象，工具会自动跳过并继续，不中断流程；特别重要的图可以按表格里的图片链接手动补存。
想换账号或重新登录：登录凭证保存在本地 resource/user/ 目录，再次运行程序时会出现已登录用户列表，输入 0 即可放弃旧凭证、扫码登录新账号。