GetQzonehistory 使用指南:扫码登录后 5 分钟导出 QQ 空间历史说说
2026/8/25 1:12:57 网站建设 项目流程

GetQzonehistory 使用指南:扫码登录后 5 分钟导出 QQ 空间历史说说

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

GetQzonehistory 是一个纯本地运行的 Python 工具,专治"QQ 空间没导出入口、被删的说说想找回却无门"。它用官方扫码登录帮你把还能拿到的历史说说、收到的留言、转发记录连同配图和评论,一次整理成本地 Excel 表格和网页文件。适合不写代码、只想把数据搬回自己电脑的人:装环境加扫码约 5 分钟跑通,之后全自动。

先看最终成果:你会得到六张表加一张网页

不用翻日志,成果就摆在一个按 QQ 号命名的文件夹里。所有输出落在本地resource/result/你的QQ号/目录,程序跑完会自动打开这个文件夹:

文件装的是什么
QQ号_全部列表.xlsx所有互动消息的完整时间线
QQ号_说说列表.xlsx你自己发的原创说说
QQ号_转发列表.xlsx转发过的内容
QQ号_留言列表.xlsx别人给你的留言
QQ号_好友列表.xlsx互动过的好友昵称、QQ、空间主页
QQ号_其他列表.xlsx没归进上面分类的其余内容
QQ号_说说网页版.html还原空间样式的可视化页面
pic/ 目录说说配图,按内容命名归档

每张说说的 Excel 固定四列:时间、内容、图片链接、评论。网页版会把说说里的 QQ 表情还原成图,并自动把图片链接换成高清版本,方便直接看。

能拿到什么、拿不到什么:先把预期对齐

它能覆盖两条通道,但彻底删掉的记录它同样够不着。工具靠"历史消息列表 + 当前仍可见的未删除说说"两条路取数,util/GetAllMomentsUtil.py 负责把后者补全到 2014 年之前。能拿到多少拿多少,这是现有条件下的极限,别指望它把已清空的数据变出来。

数据能否拿到原因
消息列表里的说说官方历史消息接口保留
当前可见的未删除说说接口含 2014 年前数据
彻底删除的说说不能服务端已无
仅自己可见且未进消息列表的不能两条通道都不覆盖

登录全程走官方扫码,不碰账号密码;util/LoginUtil.py 处理二维码识别。所有数据只写本地硬盘,不经过任何第三方中转。

从零到跑通的 4 条命令

每一步只给必要命令,装完即跑,互不干扰。虚拟环境的作用是把工具依赖和你电脑上其他项目隔开。先克隆代码并建环境:

# 克隆项目到当前目录 git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory # 进入项目文件夹 cd GetQzonehistory # 创建名为 myenv 的虚拟环境(需本机已装 Python 3) python -m venv myenv

⚠️ 激活命令两个系统不一样:Windows 敲myenv\Scripts\activate,macOS/Linux 敲source myenv/bin/activate。激活失败时python指向的还是系统环境,依赖就白装了。

接着装依赖。核心包分工明确:requests发请求、beautifulsoup4解析页面、pandas生成表格、qrcode出登录二维码、tqdm画进度条,清单全在 requirements.txt:

# 激活环境后,一次性装齐 requirements.txt 里的依赖 pip install -r requirements.txt

💡 登录靠pyzbar识别二维码。Windows 一般装完即用;macOS 若提示缺 zbar 共享库,先brew install zbar;RPM 系 Linux 用sudo dnf install -y zbar

最后启动,用手机版 QQ 扫终端里输出的字符二维码并确认,登录即完成。凭证以 cookie 形式存在resource/user/下,下次运行直接复用,不用再扫:

# 启动主程序,终端会打印一个字符二维码 python main.py

登录成功后程序先读取消息总数,再每批 10 条分页抓取,批间停顿 3 秒——这是刻意的防风控节奏,别嫌慢。说说上千条的耐心等几分钟到几十分钟,进度条会实时滚动。

六张表加一张网页都放在哪

结果按 QQ 号建文件夹,随时可查、随取随用。路径固定为resource/result/你的QQ号/,Excel 用 WPS、Office 或在线表格都能打开。

两个细节别忽略:pic/里的图以说说内容命名,重名时自动追加时间戳防止互相覆盖,程序还会尝试把链接替换成高清版;表格若打不开,多半是文件正被其他程序占用,关掉占用的窗口再开即可。取走后建议把整个resource/result再复制一份到移动硬盘或网盘,多存一份更安心。

扫码失败、导出一半断了:4 种情况的解法

出问题先看是哪一类,对号入座即可。

现象原因一句话解法
二维码扫了没反应码已过期重跑python main.py生成新码,确认手机和电脑网络通畅
提示登录失败或报 zbar缺二维码识别库macOSbrew install zbar,RPM 系 Linuxsudo dnf install -y zbar
导出到一半断了中断保护已生效重跑一次即可,已保存的 Excel 是完整的
Excel 打不开文件被其他程序占用关掉占用的 WPS/Office 窗口再打开

💡 程序注册了中断保护,Ctrl+C 或进程被杀时都会先把已抓到的数据存盘再退出,所以中断不等于前功尽弃。

照着做就完事的 6 步

  1. 克隆项目并创建虚拟环境myenv
  2. 激活环境后装齐依赖
  3. 运行python main.py,手机扫码登录
  4. 等进度条走完,检查resource/result下的表格和图片
  5. 把结果复制到至少两个不同存储位置
  6. 每季度全量跑一次,QQ 接口有调整时关注项目仓库更新

回忆不该只寄存在别人的服务器上——它值得一个你自己说了算的家。

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

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

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

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

立即咨询