GetQzonehistory:10分钟把QQ空间历史说说完整备份到本地
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
GetQzonehistory 是一款免费开源的 QQ 空间历史说说备份工具,通过扫码登录即可把你发布过的说说、转发、留言、评论和配图一条条抓下来,整理成表格、网页版和图片目录存进本地。全文不用输一次密码,数据只落在你自己的硬盘上。这篇文章按"先跑通、再深入、后玩出花"的顺序,带你从安装环境到拿回全部回忆,全程照抄即可。
一段容易发生在你身上的场景
深夜打开 QQ 空间,想翻一翻高中毕业那天发的那条说说。结果页面卡了半天,图片加载失败,评论区只剩零星几条,往下的内容直接翻不到头。你隐约记得那几年发过几百条动态,但此刻它们就像散落在别人服务器上的碎纸片——平台一旦改版、清库,或某天手滑删除,这些回忆就再也找不回来了。把数据真正下载到自己的电脑里,才算"拥有"。GetQzonehistory 要解决的就是这件事:不用截图、不用手动复制,一次性把你的历史说说结构化地搬回家。
3条命令装好运行环境,Windows / macOS / Linux 都能跑
项目基于 Python,三个系统全支持。哪怕你从没配过 Python 环境,照下面一步步抄就行。
第 1 步:克隆项目并进入目录
git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory第 2 步:创建并激活虚拟环境
虚拟环境相当于给这个项目单独开一间"房间",避免依赖包和你系统里其他 Python 项目打架。
# Windows python -m venv myenv myenv\Scripts\activate # macOS / Linux python -m venv myenv source myenv/bin/activate第 3 步:安装依赖并启动
pip install -r requirements.txt python main.py如果依赖下载很慢,换成国内镜像源,几秒就能装完:
pip install -i https://mirrors.aliyun.com/pypi/simple/ -r requirements.txt启动后程序会弹出一个二维码,用手机 QQ 扫一下,确认登录即完成——全程不碰密码。登录状态会以 Cookie 形式缓存在resource/user/目录,下次再运行会先列出已登录账号让你选择,不用反复扫码。
为什么选择虚拟环境而不是直接装进系统?因为 requirements.txt 里锁定了 beautifulsoup4、pandas、pyzbar 等一批依赖的精确版本,隔离安装可以避免"昨天还能跑、今天莫名报错"的经典问题。
扫码登录与首次抓取:全程不用输一次密码
第一次运行时,程序会按下面这套流程走完,整个过程你只需要扫一次码:
几点需要提前知道的节奏:
- 抓取按批次进行,每批 10 条,批与批之间会停顿 3 秒,这是刻意设计的"慢节奏",目的是降低请求频率、减少触发平台风控的概率。条数多时整体耗时偏长,属于正常现象。
- 想中途退出?直接按
Ctrl+C。程序会先把已抓到的数据保存好再退出,中断保护逻辑写在main.py的signal_handler里,所以你每次尝试都不会白费。 - 跑完后导出文件夹会自动打开,并在终端汇总报告总条数、最早一条说说的发布时间、好友数、图片数等统计信息。
整个抓取分为两条线:main.py负责从空间历史消息列表抓取动态,util/GetAllMomentsUtil.py则专门补抓"未删除的可见说说"(含 2014 年之前的数据),两条结果会去重合并,尽量做到不重不漏。
运行一次 GetQzonehistory 能拿到什么:6张表格 + 网页版 + 图片目录
跑完一次,resource/result/你的QQ号/下会生成完整的结果集,结构长这样:
6 张 Excel 表格,各管一摊
- 全部列表:所有抓取到的消息汇总,含时间、内容、图片链接、评论四列
- 说说列表:你自己发布的正经说说,时间精确到秒
- 转发列表:转发过的每一条内容
- 留言列表:空间留言板上的互动记录
- 其他列表:朋友在你空间的互动消息
- 好友列表:昵称、QQ 号、空间主页地址一一对应
图片链接单独成列,评论做了结构化拆分(每条评论带时间、内容、昵称、QQ 号),方便后续二次处理。
网页版 HTML:离线也能翻旧账
自动生成的你的QQ号_说说网页版.html会把说说、转发按时间倒序排好,还原出头像、昵称、发布时间、正文、配图和评论列表,连 QQ 表情都做了还原。不用联网,双击就能打开,翻起来像看一本数字纪念册。这段渲染逻辑在main.py的render_html函数里,模板在util/ToolsUtil.py的get_html_template中,想看细节可以直接翻源码。
pic/ 图片目录:自动下载并转高清
配图会被自动下载到pic/目录,文件名直接取自说说内容,一眼就能认出是哪条动态。抓取时还会自动把图片链接中的/m&ek=1&kp=1替换为/s&ek=1&kp=1的高清版本,避免只存下一堆模糊缩略图。就算将来原链接失效,本地这张原图也依然完好。
另外,项目里还有一个fetch_all_message.py,它走的是另一条 API 路径,把"未删除的可见说说"导出成一份 Markdown 文件(所有可见说说.md),图片会以文件名的形式内嵌引用。如果你想要的是纯文本+图片的文档式存档,而不是 Excel,可以试试它。
拿到Excel后怎么二次利用:用Pandas统计你的"说说十年"
导出的 Excel 列名是固定的时间、内容、图片链接、评论,时间格式为2024年08月20日 13:38:52,这意味着几行代码就能做各种分析。
示例:统计你每年发了几条说说
import pandas as pd df = pd.read_excel('你的QQ号_说说列表.xlsx') df['时间'] = pd.to_datetime(df['时间'], format='%Y年%m月%d日 %H:%M:%S') df['年份'] = df['时间'].dt.year print(df['年份'].value_counts().sort_index())跑完你就能看到哪年是话痨高峰期、哪年突然沉默。再往深了做,还能统计内容里的高频词、分析配图数量变化,把回忆变成一份属于自己的"年度报告"。
如果想定期留档,可以把python main.py配进定时任务:Linux/macOS 在 crontab 里加一行,Windows 用任务计划程序同样可以。增量备份的意义在于——往后的每一条新说说,也会被安稳收进这份档案里。注意程序有登录态复用,二次运行会直接选择已登录账号,不用再扫码。
高频报错与处理:遇到这些情况别慌
把最常见的坑整理成清单,直接对号入座:
- 报"无法找到 zbar 共享库":这是二维码识别库没装。Linux 系执行
sudo dnf install -y zbar(Debian/Ubuntu 对应apt install libzbar0);macOS 上项目在util/LoginUtil.py里做了引导,会提示你通过 Homebrew 一键安装。 - 扫码后一直提示"二维码已失效"或没反应:确认手机 QQ 已登录、网络通畅,检查电脑系统时间是否准确,然后重新运行生成新二维码;如果刚被安全策略拦截,等几分钟再试,避免多设备同时登录空间。
- 只抓到了一部分说说:工具能获取的是空间历史消息列表中的内容,列表之外的(比如仅自己可见的说说)天然抓不到;网络不稳也可能漏掉部分批次。保持网络通畅,必要时分多次运行。
- 图片没下载全:先检查网络和
pic/目录是否可写;若个别链接失效,Excel 的图片链接列里还留着原始 URL,可以手动补下。 - 程序跑得很慢:单批请求有间隔是刻意设计,条数多时整体耗时确实长。耐心等进度条走完,也可以分成几次运行、分批保存结果。
关于安全与合规,你需要知道的边界
这类工具最值得关心的就是安全,GetQzonehistory 的几个设计可以放心:
- 全程本地处理:抓到的数据只写入你的硬盘,不会上传到任何第三方服务器
- 扫码免密登录:不收集、不保存你的 QQ 密码,Cookie 存在本地
resource/user/目录,不放心可随时删除重新登录 - 开源可审查:登录、请求、解析逻辑分别在
util/LoginUtil.py、util/RequestUtil.py、util/GetAllMomentsUtil.py里,每一步都能自己核对 - 缓存按号隔离:请求缓存存放在
resource/fetch-all/下并按 QQ 号分区,多账号互不干扰
同时也要把话说在前面:项目自带免责声明,工具仅供学习与技术研究使用,请勿用于商业或非法用途。请只备份你自己的空间内容,别拿它去采集他人数据,尊重平台规则和他人隐私——这是使用任何工具的前提。
现在就动手:4步跑通你的第一次备份
- 克隆项目到本地:
git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory,按上面的命令建好虚拟环境并安装依赖 - 运行
python main.py,用手机 QQ 扫码完成登录 - 等进度条走完,打开
resource/result/你的QQ号/,翻一翻你的说说、表格和图片 - 遇到问题先翻项目里的 README 和
util/下的源码注释,作者也在 B 站发布了详细的使用教程
备份这件事,最怕的从来不是技术,而是"以为它还在"的侥幸。趁现在能打开,花十分钟把这些数字记忆搬回自己电脑里,比收藏任何链接都实在。
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考