GetQzonehistory 使用教程:3 条命令完整导出 QQ 空间历史说说
2026/9/20 12:39:25 网站建设 项目流程

GetQzonehistory 使用教程:3 条命令完整导出 QQ 空间历史说说

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

GetQzonehistory 是一个开源的 Python 工具,通过手机 QQ 扫码登录后,自动抓取账号下的全部历史说说、评论和配图,并导出为 Excel 表格与 HTML 页面。它解决的是空间数据只增不备份、删除后无法找回的问题,适合想整理自己空间数据的新手。

它到底能做什么

一句话定位:把 QQ 空间里"可见且未删除"的说说记录,完整落到本地磁盘。

  • 扫码登录 QQ 空间,全程不输入账号密码,登录态以 cookie 形式缓存在本地
  • 两条数据通道并行:历史消息列表接口覆盖带互动的完整时间线,未删除说说接口补齐早期记录(含 2014 年以前)
  • 自动分类落盘:原创说说、转发、留言、他人内容分表存放,图片与评论一并保存
对比项手动翻空间用 GetQzonehistory
获取范围翻到多少算多少,早期记录基本翻不动按接口分页拉全,含未删除的早期说说
数据形式截图或复制文本,无结构带时间、内容、图片链接、评论的 Excel
图片逐张右键保存自动下载到本地文件夹

从零跑通:环境与最小命令

需要 Python 3(3.8 及以上);Linux 和 macOS 上还需系统级安装 zbar,pyzbar 依赖它的共享库来解码登录二维码。

git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory pip install -r requirements.txt python main.py

首次运行会在终端以字符形式打印登录二维码,用手机 QQ 扫码确认即可;登录成功后出现进度条,程序按批次拉取数据,每批之间有短暂停顿,总耗时取决于账号消息量。

跑完之后你会得到什么

所有产物位于resource/result/{QQ号}/目录下:

文件格式用途
{QQ号}_说说列表.xlsxExcel自己发布的原创说说,含时间、内容、图片链接、评论
{QQ号}_转发列表.xlsxExcel自己转发的全部内容
{QQ号}_留言列表.xlsxExcel好友在说说下留下的评论与留言
{QQ号}_其他列表.xlsxExcel消息列表中归入他人的其他内容
{QQ号}_全部列表.xlsxExcel分类前的汇总记录,便于核对总量
{QQ号}_好友列表.xlsxExcel出现在消息列表中的好友,含 QQ 号与空间主页链接
{QQ号}_说说网页版.htmlHTML还原空间样式的网页,可离线浏览说说与评论
pic/JPG 文件夹说说中的全部图片,按内容摘要命名

如果只想把未删除说说当纯文本阅读,可单独运行fetch_all_message.py:它不走消息列表接口,直接分页拉取全部未删除说说(包含 2014 年之前的记录),输出到resource/fetch-all/下的"所有可见说说.md",图片同步下载。

源码里值得看的部分

  • [util/LoginUtil.py]:生成登录二维码、轮询扫码状态,登录成功后把 cookie 存到resource/user/,下次运行免扫码
  • [util/GetAllMomentsUtil.py]:分页拉取未删除说说接口,用本地 JSON 文件做缓存,中断后重跑不会全部重来
  • [util/RequestUtil.py]:负责历史消息列表请求,先用二分查找估算消息总数,请求之间插入固定休眠控制频率
  • [util/ToolsUtil.py]:集中处理时间戳格式化、QQ 表情代码转图片、HTML 页面模板等细节

踩坑与进阶

  • 如果启动时报"无法找到 zbar 共享库" → 先装 zbar 再运行:Linux 用包管理器安装(如sudo dnf install -y zbar),macOS 上程序检测到 Homebrew 后会在终端交互询问是否自动安装
  • 如果终端里的二维码显示错乱或看不清 → 程序同时把二维码图片存到了resource/temp/QR.png,直接打开这张图片扫码即可
  • 如果抓取过程被中断(断网、手动 Ctrl+C)→ 程序注册了信号处理器,中断时会保存已抓到的数据;再次运行时依赖resource/下的本地缓存继续,不必从零开始
  • 如果导出条数比印象里少 → 工具只能拿到"可见且未删除"的内容,已删除的说说和仅自己可见的动态不会出现在列表里,属于平台限制而非程序缺陷
  • 如果担心隐私 → cookie 与全部导出文件都以明文存放在本地resource/目录,不经过任何第三方服务器;使用完注意不要把这个目录随项目一起分享出去

整体来看,GetQzonehistory 是一个功能单一的小工具:一次扫码、一轮抓取、一套结构化文件。对想把个人空间记录做备份或分析的人来说够用,代码量不大、结构平直,也适合当作阅读爬虫类项目的入门样例。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询