QQ 空间作为国内主流的社交动态记录平台，承载了大量用户的成长轨迹。然而，依赖单一的云端存储存在数据丢失或访问权限变更的风险。为了实现数据的自主掌控，利用自动化工具进行本地化备份成为技术人员的首选方案。GetQzonehistory 是一款基于 Python 开发的开源工具，通过模拟登录与接口解析，能够高效地将 QQ 空间说说及配套媒体资源导出到本地。

核心功能与技术优势

• 非侵入式安全登录：采用官方扫码授权机制，无需在脚本中明文存储账号密码，极大降低了账号安全风险。
• 多格式数据持久化：支持导出为结构化的 Excel 报表（便于二次开发与数据分析）和还原度极高的 HTML 网页（便于离线浏览）。
• 容错与增量处理：内置断点续传逻辑，在网络波动或中断后，再次启动可从上次进度继续执行。
• 本地化资源管理：自动下载说说中包含的图片资源，并维护本地路径引用，确保脱离网络环境后依然可以完整查看。

部署与运行流程

在开始备份之前，请确保本地已安装 Python 3.x 环境，并具备基础的命令行操作能力。

1. 获取项目源码与初始化

首先通过 Git 协议将工具包克隆至本地：

git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory.git
cd GetQzonehistory

2. 构建隔离运行环境

为了避免依赖冲突，建议为该备份工具创建独立的虚拟环境：

# 创建名为 qzone_env 的虚拟环境
python -m venv qzone_env

# 激活环境 (Windows)
qzone_env\Scripts\activate

# 激活环境 (Linux/macOS)
source qzone_env/bin/activate

# 安装必要的库文件
pip install -r requirements.txt

3. 执行数据抓取任务

运行主程序启动备份流程：

python main.py

启动后，控制台会生成一个登录二维码。用户需使用手机 QQ 应用进行扫码确认。一旦验证成功，脚本将自动遍历接口获取所有历史动态。

导出数据结构说明

执行完毕后，系统会在 resource/result/ 路径下生成以 QQ 号命名的文件夹，其目录结构如下：

12345678/  (QQ号文件夹)
├── 12345678_说说列表.xlsx  # 包含时间、内容、点赞数等结构化数据
├── 12345678_说说网页版.html # 静态网页，适配浏览器查看
└── pic/                   # 存放所有下载的说说配图

系统架构与模块划分

该工具采用了模块化的设计思路，便于开发者进行功能扩展或 Bug 修复：

功能模块	核心职责	涉及组件
身份验证层	维护扫码登录生命周期与 Cookie 获取	LoginUtil.py
数据通信层	封装 API 请求，处理反爬虫策略与速率限制	RequestUtil.py
内容解析层	提取 JSON 数据中的文本、表情及图片链接	GetAllMomentsUtil.py
持久化引擎	负责文件 IO 操作与 Excel/HTML 的渲染生成	ToolsUtil.py

技术细节与常见问题解决

网络超时与重试

在备份超大规模数据（如说说数量过万）时，网络超时是常见现象。GetQzonehistory 内部实现了重试机制，若单次请求失败，程序会等待随机时间后重新发起。建议在网络环境稳定的条件下运行该程序。

私密说说处理

程序仅能备份当前登录账号有权查看的内容。如果某些说说被设置为"仅自己可见"，只要使用该账号扫码，依然可以完整备份。但如果目标空间设置了访问限制且当前账号不在白名单内，则无法抓取相关数据。

增量备份技巧

当用户在未来产生了新动态时，无需重新下载全部资源。通过对比 result 文件夹中的记录，可以手动调整抓取的时间范围，或利用工具自带的缓存对比功能实现增量更新。