GetQzonehistory 完全指南：轻松备份QQ空间历史说说

GetQzonehistory是一款专注于QQ空间历史说说备份的实用工具，能够帮助用户轻松抓取并保存个人QQ空间的所有历史动态，包括文字内容、图片链接及评论信息，为珍贵的网络记忆提供可靠的本地存档方案。

一、如何准备运行环境

1.1 安装必要依赖

项目依赖Python环境及多个第三方库，需先通过以下命令安装：

pip install -r requirements.txt

📌 核心依赖说明：

• requests：处理网络请求
• pandas：数据处理与Excel导出
• qrcode/pyzbar：二维码登录支持
• beautifulsoup4：HTML解析

1.2 解决常见依赖问题

💡 zbar库安装提示：

• Linux系统：需额外安装系统库

  sudo dnf install -y zbar  # Fedora/RHEL系
  sudo apt install -y libzbar0  # Debian/Ubuntu系
  

• macOS系统：推荐使用Homebrew安装

  brew install zbar
  

二、项目核心功能解析

2.1 功能模块对应关系

目录/文件	主要功能	核心工具类
util/LoginUtil.py	二维码登录与Cookie管理	cookie() - 处理登录流程 bkn() - 计算认证参数
util/GetAllMomentsUtil.py	说说数据抓取	get_visible_moments_list() - 获取所有可见说说
util/RequestUtil.py	网络请求处理	get_message() - 获取分页说说数据
util/ToolsUtil.py	数据处理与格式化	format_timestamp() - 时间格式化 replace_em_to_img() - 表情转换

2.2 两种启动文件对比

启动文件	适用场景	功能差异
main.py	常规使用	标准流程，包含完整交互提示
fetch_all_message.py	脚本集成	精简输出，适合作为子模块调用

💡 使用建议：普通用户优先选择main.py，可获得更友好的操作指引。

三、如何配置与运行程序

3.1 配置文件设置

程序首次运行时会自动创建配置目录，核心配置文件路径：

resource/config/config.ini

📌 必须配置项：

[Common]
account = 你的QQ账号
output_file = resource/result/你的qq.xlsx

💡 安全提示：配置文件中无需填写密码，程序采用二维码扫描登录方式。

3.2 执行备份操作

在项目根目录执行以下命令启动程序：

python main.py

程序运行流程：

1. 生成登录二维码（控制台会显示ASCII艺术码）
2. 使用手机QQ扫描二维码授权登录
3. 自动获取说说总数并开始分页抓取
4. 数据保存至resource/result目录下的Excel文件

3.3 常见错误解决方案

错误现象	可能原因	解决方法
二维码无法显示	终端不支持ASCII艺术码	查看temp/QR.png文件获取二维码
登录后无数据返回	Cookie失效	删除resource/user目录下缓存文件重新登录
Excel文件生成失败	路径权限问题	修改output_file为用户可写路径

四、高级使用指南

4.1 自定义导出格式

通过修改util/ToolsUtil.py中的get_html_template()函数，可自定义导出的HTML格式。默认模板包含：

• 说说内容与时间戳
• 图片网格布局（3列自适应）
• 评论区嵌套显示

4.2 增量备份实现

💡 进阶技巧：通过修改get_visible_moments_list()函数中的offset参数，可实现从指定位置开始抓取，适用于增量备份场景。

4.3 数据导出扩展

程序默认支持Excel格式导出，如需其他格式，可修改main.py中的数据保存逻辑，利用pandas库轻松实现CSV、JSON等格式转换。

五、注意事项与最佳实践

5.1 操作规范

• 登录频率限制：建议单次登录后完成所有操作，避免频繁登录
• 抓取间隔控制：默认已设置5秒请求间隔，请勿修改缩短
• 敏感信息保护：resource/user目录下的Cookie文件包含登录凭证，需妥善保管

5.2 性能优化建议

• 大数据量处理：当说说数量超过1000条时，建议分多次导出
• 内存占用控制：可修改get_user_qzone_info()中的page_size参数调整分页大小（默认30条/页）

通过本指南，您已掌握GetQzonehistory的全部核心功能与使用技巧。如有功能改进需求，可关注项目源码中的TODO标记点，主要集中在图片下载优化和多账号管理功能上。