Skip to content

项目介绍

本项目是 李晨煜(绝赞stars我一生之敌) QQ空间说说的近一年完整备份(2025年4月~2026年4月)。

备份缘起

2026年4月12日前后,李晨煜的QQ空间疑似开启了“访客仅能查看最近一年说说”的权限设置,导致更早期的说说内容对非好友访客不可见。
为了避免多年积累的珍贵记忆再次面临丢失风险,作者决定对近一年的说说进行完整本地备份,并以 VitePress 静态站的形式长期保存。

所有说说已导出为 Markdown 格式,按 年/月 结构组织,支持图片本地化显示,可直接部署在 VitePress 静态站点上,方便永久存档、搜索与阅读。

项目技术基础

QzoneExporter

本备份主要基于开源项目 QzoneExporter 进行数据导出:

  • 仓库地址https://github.com/wwwpf/QzoneExporter
  • 功能特点
    • 支持导出说说、日志、相册、留言板等 QQ空间数据
    • 自动下载说说和相册中的图片、视频至本地
    • 将导出的数据以网页形式本地化展示(时间轴风格)
    • 支持 Exif 信息写回等实用功能

License:GPL-3.0 license

本项目使用的自定义 Python 脚本

为了让备份更适合 VitePress 阅读,我编写了以下辅助 Python 脚本:

1. 主生成脚本(qqspace_fix_final.py

  • shuoshuo_*.json 文件中读取所有说说数据
  • 严格按照 JSON 中的图片原始 URL 计算 MD5 短哈希,生成稳定、安全的文件名(img_xxxxxxxx.jpeg
  • 将图片从原始 downloaded 文件夹复制到 VitePress 的 public/downloaded/ 目录(不破坏原始文件)
  • yyyy/mm/ 目录结构生成独立的 .md 文件
  • 每条说说包含 Front Matter、正文、图片展示、转发内容等
  • 彻底解决 QQ空间图片防盗链问题

2. 图片复制与重命名脚本(fix_downloaded_copy.py

  • 专门用于将已下载的图片批量复制到新目录
  • 保证文件名与 Markdown 中引用的路径 100% 严格一致
  • 支持断点续复制,避免重复操作

这些脚本已针对 VitePress 的构建特性进行优化(避免特殊字符导致的 Rollup 解析错误),文件名简洁、安全且稳定。

项目特点

  • 完全本地化:所有图片均为本地文件,无需依赖 QQ空间服务器
  • 结构清晰:按年/月自动分类,方便浏览历史说说
  • 移动端友好:VitePress 默认支持响应式布局与暗黑模式
  • 搜索支持:可通过站点搜索快速找到包含关键词的说说
  • 长期可维护:后续可继续追加新说说,脚本可重复运行

致谢


声明
本项目仅用于个人数据存档与回忆,不做任何商业用途。所有内容版权归原作者(李晨煜)所有。

如果你对备份脚本、部署方式或说说内容有任何疑问,欢迎在 GitHub Issue 中讨论。