[GetQzonehistory]高效使用指南：从安装到精通

步骤1：核心功能解析 ⚡️

GetQzonehistory作为一款专业的QQ空间数据备份工具，通过Python数据采集技术实现历史说说的完整抓取与本地存储。其核心功能模块包括：

🔍 数据采集模块

• 说说抓取引擎：深度遍历QQ空间动态，支持获取文字内容、发布时间、点赞数等完整元数据
• 多媒体处理：自动下载说说配图并关联存储（依赖Pillow图像处理库）
• 增量备份：通过临时文件缓存机制避免重复抓取（存储于temp目录）

⚙️ 配置管理模块

• 账号安全系统：加密存储QQ账号凭证（通过config.ini配置文件管理）
• 输出定制工具：支持自定义Excel导出路径及文件名格式
• 运行参数调节：可配置请求间隔、重试次数等高级参数

💡 提示：该工具采用模块化设计，所有核心功能均封装在util目录下的工具类中，便于二次开发扩展

步骤2：快速上手教程 ⌨️

环境准备

# 克隆项目仓库
git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
cd GetQzonehistory

# 安装依赖包
pip install -r requirements.txt

# 检查Python环境（需3.8+版本）
python --version

启动程序

# 方式一：通过主入口启动
python main.py

# 方式二：通过备用入口启动
python fetch_all_message.py

💡 提示：首次运行将自动生成默认配置文件，程序会通过qrcode库生成登录二维码，支持扫码登录

步骤3：深度配置指南 🔧

基础配置项（config.ini）

配置节	参数名	说明	示例值
[Common]	account	QQ账号（必填）	123456789
[Common]	password	QQ密码（选填，优先扫码登录）	yourpassword
[Common]	output_file	导出文件路径	resource/result/123456789.xlsx

高级选项设置

在配置文件中添加以下可选配置项实现功能增强：

[Advanced]
# 设置请求超时时间（秒）
timeout = 30
# 开启调试模式（输出详细日志）
debug_mode = True
# 设置并发请求数
max_threads = 5

💡 提示：所有配置变更需重启程序生效，建议修改前备份原始配置文件。高级用户可直接修改util/ConfigUtil.py实现自定义配置逻辑

技术栈说明 🛠️

• 核心框架：Python 3.8+
• 网络请求：requests + fake-useragent
• 数据处理：pandas + openpyxl
• 可视化：qrcode + pyzbar（二维码登录）
• 解析工具：beautifulsoup4 + chardet