3步掌握QQ空间备份神器：从数据拯救到记忆珍藏

🌟 项目核心价值

在这个数字时代，QQ空间承载着我们十年以上的青春记忆——那些深夜的情绪记录、毕业季的合影、重要时刻的分享。GetQzonehistory作为一款专注于QQ空间数据备份的工具，就像为你的数字记忆打造了一个安全的"时光胶囊"。它能完整保存文字动态、图片信息和评论互动，让珍贵的网络记忆不再因账号异常或平台调整而丢失。

🚀 快速入门流程

环境准备（3分钟完成）

首先获取项目代码并安装必要依赖：

1. 克隆项目仓库到本地：git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
2. 进入项目目录：cd GetQzonehistory
3. 安装依赖包：pip install -r requirements.txt

依赖包小科普：

• requests：如同浏览器般帮助工具与QQ空间服务器对话
• pandas：数据整理专家，负责将杂乱的信息变成整齐的表格
• qrcode：生成登录二维码的小画家
• beautifulsoup4：HTML解析能手，帮你提取网页中的有用信息

执行备份（5分钟完成）

1. 在项目根目录运行主程序：python main.py
2. 使用手机QQ扫描终端显示的二维码
3. 等待程序自动完成数据抓取，结果将保存在resource/result目录

🔍 核心功能解析

安全登录系统 [LoginUtil.py]

就像电影院的检票系统，这个模块负责验证你的身份并让你安全进入数据区。它通过二维码扫描登录，避免了直接输入账号密码的风险。核心功能包括：

• Cookie管理：维持登录状态的"门票"
• BKN参数计算：生成访问权限的"特殊通行证"

应用场景：在公共电脑上使用时，无需担心账号密码泄露，扫码即登，退出即清。

智能数据抓取引擎 [GetAllMomentsUtil.py]

这个模块如同一个细心的档案管理员，负责将你的所有说说按时间顺序整理归档。核心函数get_visible_moments_list()能够分页获取历史数据，即使你有上千条说说也能完整抓取。

应用场景：多年未整理的QQ空间，只需一次运行就能把从大学到工作的所有动态整理成有序数据。

数据处理中心 [ToolsUtil.py]

这是数据的"美容师"，负责将原始数据变得整洁可用：

• 时间格式化：把杂乱的时间戳转换成"2023-05-20 13:14"这样易读的格式
• 表情转换：将系统表情转换为图片形式保存，避免导出后变成乱码

应用场景：导出的数据在任何设备上查看都保持一致的美观格式。

⚙️ 个性化定制方案

基础配置修改

首次运行后，程序会自动创建resource/config/config.ini配置文件，你可以根据需要修改：

参数名称	作用	推荐设置
account	记录你的QQ号码	保持默认
output_file	数据保存路径	建议修改为"我的QQ空间备份_2023.xlsx"

性能优化设置

对于内容较多的用户，可以通过调整参数提升抓取效率：

• 增大page_size：一次请求获取更多数据（默认20条/页）
• 设置请求间隔：添加适当延迟避免触发频率限制

应用场景：拥有5000+说说的重度用户，可以通过调整参数将抓取时间从2小时缩短到40分钟。

🛠️ 常见问题解决

二维码显示异常

问题：终端无法正常显示二维码
解决：程序会自动在temp目录生成QR.png图片文件，直接打开该图片扫描即可

登录后无数据返回

可能原因：Cookie缓存过期或登录状态异常
解决步骤：

1. 关闭程序
2. 删除resource/user目录下的所有文件
3. 重新运行程序并扫码登录

导出文件失败

排查方向：

• 检查目标路径是否存在
• 确认是否有写入权限
• 关闭可能正在打开的Excel文件

💡 高级应用指南

增量备份实现

通过调整get_visible_moments_list()函数中的offset参数，可以从指定位置开始抓取，实现增量备份：

1. 首次运行：获取全部历史数据
2. 后续运行：设置offset为上次抓取的最后位置，只获取新内容

应用场景：每月定期备份，只需几分钟就能完成新增内容的备份工作。

自定义导出模板

修改util/ToolsUtil.py中的get_html_template()函数，可以定制专属的导出样式：

• 添加个人博客风格的CSS样式
• 调整照片展示方式
• 添加自定义水印或签名

应用场景：将备份数据制作成精美的个人回忆录网页，分享给亲友或永久保存。

📝 使用注意事项

• 操作频率：建议单次登录完成所有操作，避免频繁登录导致账号安全验证
• 数据安全：resource/user目录下的Cookie文件包含登录信息，需妥善保管
• 定期备份：每3-6个月执行一次完整备份，重要时刻（如毕业、生日）可额外备份

GetQzonehistory不仅是一个工具，更是连接过去与未来的桥梁。通过简单的操作，就能为珍贵的数字记忆提供可靠的安全保障，让那些承载情感的文字和图片，能够跨越时间的限制，成为永恒的回忆。