GetQzonehistory使用指南：把QQ空间全部历史说说导出为Excel和本地图库
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
QQ空间会把多年前的说说逐渐隐藏，官方也没有提供批量导出入口。GetQzonehistory 是一个本地 Python 工具，扫码登录后遍历账号的历史消息列表，恢复历史说说、转发与留言，并以 Excel 和图片形式保存到本机硬盘。适合想备份自己 QQ 空间历史数据、全程不愿交出账号密码的用户。
核心定位
- 工作方式：模拟官方扫码登录流程获取账号 cookie，再按每批 10 条分页拉取 QQ 空间历史消息列表，同时抓取当前可见说说进行去重补充，逻辑见 util/GetAllMomentsUtil.py。
- 产出内容：说说、转发、留言、好友等 5 份 Excel 表格，一份还原 QQ 空间时间线的网页版 HTML，以及说说原图的本地图片库，统一放在
resource/result/你的QQ号/下。 - 数据流向：全部文件只写入本地磁盘，不上传到任何服务器；cookie 缓存在
resource/user/目录，下次运行可直接复用登录状态。
准备工作
环境要求：Python 3.x，以及扫码登录依赖的系统 zbar 库（Linux 执行sudo dnf install -y zbar，macOS 可通过 Homebrew 安装 zbar，程序会给出提示）。获取项目并安装依赖的最小命令如下：
git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory python -m venv myenv source myenv/bin/activate # Windows 用 myenv\Scripts\activate pip install -r requirements.txt操作步骤
- 运行
python main.py。终端会先打印一个 ASCII 二维码，用 QQ 手机客户端扫码，终端状态从"二维码认证中"变为"登录成功"。 - 程序开始遍历历史消息列表，进度条按批显示，每读取 10 条自动暂停 3 秒，总时长取决于你的历史消息数量。
- 消息列表取完后，程序自动抓取当前可见说说做去重补充，并逐张下载说说图片到
pic/子文件夹。 - 结束时终端输出消息总数、最早一条说说时间、各列表条数等统计，并自动打开结果文件夹。
产出说明
结果目录为resource/result/你的QQ号/，路径可在 resource/config/config.ini 中修改：
| 文件 | 用途 |
|---|---|
| QQ号_全部列表.xlsx | 全部历史互动记录时间线，含时间、内容、图片链接、评论 4 列 |
| QQ号_说说列表.xlsx | 你本人发布的原创说说 |
| QQ号_转发列表.xlsx | 所有转发内容记录 |
| QQ号_留言列表.xlsx | 收到好友留言的说说记录 |
| QQ号_其他列表.xlsx | 其余不属于上述类别的消息 |
| QQ号_好友列表.xlsx | 互动好友的昵称、QQ 号与空间主页 |
| QQ号_说说网页版.html | 还原说说时间线的网页版，含头像、高清图与评论区 |
| pic/ 文件夹 | 说说原图，按内容自动命名，重名自动追加时间戳 |
另有python fetch_all_message.py，专门拉取"所有可见未删除说说"（含 2014 年之前的内容），在resource/fetch-all/下生成所有可见说说.md和对应图片。
实用提示
- 为什么有些说说恢复不出来？只能获取出现在历史消息列表或当前仍可见的内容，已删除的、"仅自己可见"的说说无法恢复。
- 每次都要重新扫码吗？不需要。cookie 缓存在
resource/user/，再次运行会从已登录用户列表中选择序号，输入 0 才重新扫码。 - 运行要预留多少时间？消息列表每 10 条停 3 秒，图片还要逐张下载，请保持网络稳定、不要中途关闭终端；中途按 Ctrl+C 中断也会先保存已抓到的数据。
- 保存位置能改吗？可以，编辑
resource/config/config.ini中[File]段下的 temp、user、result 三项即可。
GetQzonehistory 把"账号里的说说"变成"自己硬盘上的文件"，数据全程留在本地，是备份 QQ 空间历史说的直接工具。项目以 GNU GPL v3 协议开源。
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
