GetQzonehistory完整使用指南:扫码登录备份QQ空间全部历史说说

📅 2026/8/22 22:42:16
GetQzonehistory完整使用指南:扫码登录备份QQ空间全部历史说说
GetQzonehistory完整使用指南扫码登录备份QQ空间全部历史说说【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory小林在整理旧手机前想把几年前发在QQ空间的说说导出来留档但QQ空间网页版没有导出入口往前翻几年就会发现不少旧说说已经翻不到。GetQzonehistory就是为此做的模拟扫码登录QQ空间分批抓取历史说说、评论和图片导出为Excel与网页HTML所有数据都存在本地resource/目录不经过其他第三方服务。GetQzonehistory数据处理流程登录、抓取、解析到导出的完整工作流首次运行前检查清单五步跑通导出克隆代码git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory然后进入目录cd GetQzonehistory。安装系统级zbar库二维码解码依赖pyzbar而pyzbar需要zbar共享库RPM系Linux执行sudo dnf install -y zbarmacOS执行brew install zbar。缺了这一步程序会在启动时直接退出。创建并激活虚拟环境python -m venv myenvWindows执行.\myenv\Scripts\activatemacOS/Linux执行source myenv/bin/activate。安装依赖pip install -r requirements.txt。依赖全部锁定了版本如pandas2.2.3、requests2.32.3国内网络慢可改用README给出的阿里云镜像源命令。运行python main.py。终端会打印一张ASCII二维码用手机QQ扫一扫终端显示“登录成功”后开始分批抓取进度条显示为每10条一批。跑完后在resource/result/下会看到一个以QQ号命名的文件夹。GetQzonehistory导出文件结构按QQ号建目录存放各分类列表与网页文件文件夹内包含六个Excel_全部列表.xlsx、_说说列表.xlsx、_转发列表.xlsx、_留言列表.xlsx、_其他列表.xlsx、_好友列表.xlsx一份{QQ号}_说说网页版.html以及存放下载图片的pic/目录。Windows上程序结束会自动打开该文件夹Linux上若没有图形环境会提示“未找到可用的打开命令请手动打开文件”。两类说说数据是怎么抓来、再合并的工具的数据来自两个接口的并集。第一类是QQ空间历史消息列表由util/RequestUtil.py实现每批取10条批间等待3秒单次请求本身还有5秒间隔开始抓取前先用二分法估算消息总量。第二类是“全部可见未删除说说”由util/GetAllMomentsUtil.py的get_visible_moments_list()实现每页30条翻页拉取能覆盖到2014年以前的内容。用两个接口是因为各自有盲区消息列表只包含还保留在消息页里的条目说说列表接口则拿不到“消息列表中没有的说说”。合并后两边重复的内容会用util/ToolsUtil.py中的is_any_mutual_exist()去重互补短板。代价是全程有节流几千条说说的账号完整导出需要较长时间进度条走动慢是正常现象。边界也要说清楚仅自己可见的说说、已删除的说说都拿不到这是QQ空间接口本身的限制README中也有同样的说明。进阶用法与边界复用登录态、Markdown导出复用登录态首次扫码成功后cookie会存到resource/user/。再次运行时终端会列出“已登录用户列表”输入序号直接沿用该会话输入0则丢弃旧状态重新扫码。会话过期后只能重新扫码。只要Markdown单独运行fetch_all_message.py它把可见说说整理成./resource/fetch-all/所有可见说说.md图片下载进同一目录并在文中以相对路径引用适合喂给静态博客或笔记软件。改保存位置resource/config/config.ini里的temp、user、result三项分别是缓存目录、登录态目录和结果目录把路径改到其他磁盘即可。边界程序没有增量模式重复运行会整份重新抓取运行中按CtrlC会触发信号处理函数把已抓到的部分先存成Excel已抓数据不会丢但下次仍需从头拉。踩坑排查三种常见报错与处理现象启动即提示“无法找到 zbar 共享库。请确保安装了 zbar。”然后退出。原因pip install -r requirements.txt只装了pyzbar这个Python包系统层的zbar共享库没有装。 做法用系统包管理器安装。Fedora/RPM系统执行sudo dnf install -y zbarmacOS上程序检测到Homebrew后可以自动代跑brew install zbar并建好符号链接。装完直接重跑。现象终端显示“二维码已失效”或扫完提示“登录失败:请重新登录,错误信息:...”后退出。原因二维码有效期短过期后继续扫旧图无效登录态文件里的cookie失效时也会走到这个分支。 做法重新运行python main.py获取新二维码如果启动时列出了“已登录用户列表”输入0丢弃旧登录态再扫。现象抓取中途出现“请求超时”或“获取消息失败第 X 批次返回值为空或无效”。原因网络波动导致单批请求失败程序会跳过该批次继续往下跑最终数据可能缺一段。 做法先看结尾统计共有多少条消息、最早一条说说的时间是否与记忆一致对不上就等网络稳定后重跑。登录态已缓存不必重扫但重跑是整份重新抓取不是断点续传。项目速览技术栈、许可与反馈渠道技术栈Python 3仓库自带Python 3.12虚拟环境 requests、BeautifulSoup4、pandas、qrcode、pyzbar、tqdm结果输出xlsx与HTML全部仅本地落盘。许可GPLv3见LICENSE文件README含免责声明工具仅限学习与技术研究使用。反馈与贡献发现缺陷或想加功能直接在项目仓库提Issue或提交PR。现在就可以先跑一遍python main.py扫一次码拿到一份自己的说说存档遇到问题先搜一下仓库Issue区没有同类问题再新建一个附上终端输出会更快得到回复。【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考