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 步
- 克隆项目并创建虚拟环境
myenv - 激活环境后装齐依赖
- 运行
python main.py,手机扫码登录 - 等进度条走完,检查
resource/result下的表格和图片 - 把结果复制到至少两个不同存储位置
- 每季度全量跑一次,QQ 接口有调整时关注项目仓库更新
回忆不该只寄存在别人的服务器上——它值得一个你自己说了算的家。
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考