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号}_说说列表.xlsx | Excel | 自己发布的原创说说,含时间、内容、图片链接、评论 |
| {QQ号}_转发列表.xlsx | Excel | 自己转发的全部内容 |
| {QQ号}_留言列表.xlsx | Excel | 好友在说说下留下的评论与留言 |
| {QQ号}_其他列表.xlsx | Excel | 消息列表中归入他人的其他内容 |
| {QQ号}_全部列表.xlsx | Excel | 分类前的汇总记录,便于核对总量 |
| {QQ号}_好友列表.xlsx | Excel | 出现在消息列表中的好友,含 QQ 号与空间主页链接 |
| {QQ号}_说说网页版.html | HTML | 还原空间样式的网页,可离线浏览说说与评论 |
| 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),仅供参考