企业官网建设流程全解析

QQ空间历史说说完整导出：扫码登录与三步备份成Excel

【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory

你打开空间，在说说流里不停地往回翻，翻到某个年代就停住了。页面只保留最近的一截，更早的动态像被“折叠”了一样，看不到，也没有可保存的入口。开源工具 GetQzonehistory 针对的正是这个需求：把QQ空间历史说说完整导出到本地。

📌 项目定位：历史说说一键导出为本地Excel与网页

GetQzonehistory 是一款开源的 Python 命令行工具，面向想备份自己空间记录的普通用户。它通过官方扫码流程登录，从历史消息列表里抓取说说、转发与留言，并自动分类整理。跑完一遍后，你的电脑里会多出 5 张分类 Excel 表、1 个还原空间版式的网页、1 个图片文件夹。全部产物存放在resource/result/你的QQ号/目录下，登录凭证则缓存在resource/user/。

🔍 数据流动全景：从扫码登录到结果落盘

1. 扫码登录：util/LoginUtil.py 在终端生成登录二维码，你用手机QQ扫一下，cookies 按QQ号缓存在resource/user/，下次启动选序号即可复用，不必重扫。
2. 拉取历史消息列表：每 10 条请求一次，批次之间固定间隔 3 秒，进度条以“10条”为单位推进，直到翻到最早一条消息为止。
3. 补充当前可见说说：再抓取全部未删除的可见说说，与消息列表内容比对去重后合并，覆盖“最近发过、但消息列表里没有”的那部分记录。
4. 分类解析落盘：按发送者和消息类型拆成说说、转发、留言、好友、其他五类，正文图片下载进pic/文件夹，最后生成 Excel 与 HTML，统一写入resource/result/你的QQ号/。

🚀 从零到导出：扫码登录与抓取流程完整走查

准备环境与依赖

git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory python -m venv myenv pip install -r requirements.txt

先激活虚拟环境（Windows 用myenv\Scripts\activate，macOS/Linux 用source myenv/bin/activate）再执行安装。依赖一共十几个包，以requests、beautifulsoup4、pandas、pyzbar为主，一行命令装完，不必逐个关心。终端里会看到什么：pip 走完依赖树后只剩安装汇总，无报错即成功。卡住了怎么办：Windows 先执行chcp 65001切到 UTF-8 防止中文乱码；macOS 若后续报缺 zbar，按提示用 Homebrew 安装即可。

扫码登录空间

python main.py

终端会打印一个 ASCII 二维码，用手机QQ扫它。看到终端里“二维码认证中”变为“登录成功”后，cookies 自动写入resource/user/，程序直接进入抓取阶段。卡住了怎么办：二维码失效或长时间无响应时，重新运行程序并输入“0”重新扫码；仍不行的话，先确认手机QQ能正常打开空间网页版。

等待抓取与查看产物

这一步不需要新命令。进度条以 10 条为单位推进，每批休息 3 秒；结束时打印消息总数、最早一条说说的时间、好友数等统计，并自动打开结果目录。卡住了怎么办：进度条长时间不动通常不是卡死——批次间隔加上单次请求最长 10 秒的等待，消息量大时整体耗时几十分钟属正常；中途想停，按 Ctrl+C 后程序会先把已抓到的部分写盘，重跑可接着用。

📦 产出物清单：5张Excel、1个网页、1个图片文件夹

• 用于日常查阅
  • QQ号_说说网页版.html：还原QQ空间版式的网页，含头像、时间、正文与评论区，点图片可看高清。
  • pic/：自动下载的全部说说图片，按内容命名，重名自动追加时间戳。
• 用于二次编辑
  • QQ号_全部列表.xlsx：两个来源合并后的完整记录，字段为时间、内容、图片链接、评论。
  • QQ号_说说列表.xlsx与QQ号_转发列表.xlsx：按“自己发布 / 自己转发”拆分，同样是四个字段，方便筛选。
  • QQ号_留言列表.xlsx与QQ号_其他列表.xlsx：好友给你的留言及其余通知类消息，字段为时间、内容、图片链接。
• 用于归档
  • QQ号_好友列表.xlsx：互动过的所有好友，字段为昵称、QQ、空间主页，适合做一份人际记录底档。

三类真实使用时刻

毕业生在离校前抽一个晚上跑完全流程，把十年的动态存成 Excel 和网页，压缩发进家庭群，谁翻谁认得出当年的梗。

写个人年表的人直接打开说说列表.xlsx，按时间列排序、逐年筛选，比在网页里一页页翻快得多，还省得担心链接失效。

帮父母各导一份的人利用启动时的序号选择切换账号，cookies 在resource/user/里分开缓存，一个账号导完再导下一个，互不干扰。

🩺 故障诊断手册：扫码登录与数据抓取高频问题

• 症状：启动时提示“无法找到 zbar 共享库”。原因：pyzbar 依赖的系统组件 zbar 未安装。操作：Linux（RPM 系）执行sudo dnf install -y zbar；macOS 选y让程序走 Homebrew 安装，或手动brew install zbar。
• 症状：扫码后长时间停在“认证中”，或直接提示登录失败。原因：本地缓存的 cookies 过期或登录态失效。操作：重新运行程序、登录时输入“0”重新扫码，并确认手机QQ能打开空间网页版。
• 症状：导出条数比记忆中的少。原因：主数据源是消息列表，从未进入列表的内容（如仅自己可见的早期说说）抓不到。操作：另行运行 fetch_all_message.py 把当前可见说说补齐对照。
• 症状：个别图片下载失败、报 404。原因：老图片链接随时间失效，属正常现象。操作：无需处理，程序会跳过坏链接继续下载其余图片，不阻塞整体流程。
• 症状：Windows 终端输出乱码。原因：终端默认 GBK 编码与程序的 UTF-8 输出冲突。操作：先执行chcp 65001，再启动程序。
• 症状：进度条看起来很久不动。原因：批次间隔 3 秒、单次请求最长等待 10 秒，消息量大时耗时以分钟计。操作：耐心等待即可；中途想停按 Ctrl+C，已抓部分会自动保存。

⚙️ 深度定制与扩展

• 改导出位置：修改 resource/config/config.ini 中 temp、user、result 三个路径，不动代码。
• 只要可见说说的 Markdown 版：运行python fetch_all_message.py，产出含 2014 年之前记录与高清图片的一份 Markdown，存于resource/fetch-all/。
• 多账号切换：不同账号的 cookies 分别缓存在resource/user/，启动时按序号选择，导完一个再导下一个。
• 定期备份：给python main.py套一层计划任务（Windows 任务计划程序 / Linux cron），每月跑一次，档案常新。

打开那个网页版，翻到最早一条说说时，这份备份才算真正完成。现在克隆仓库、运行python main.py并扫码即可。仅用于备份个人数据，请遵守平台规则。

【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory