一键把 QQ 空间的说说、日志、日记、相册、视频、留言、好友、收藏、分享、访客等数据备份为本地文件的浏览器扩展，内置离线查看器可直接浏览与分析。
当前版本 v3.0。支持 Chrome / Edge 等 Chromium 内核浏览器与 Firefox（Manifest V3）。
- 全类型备份：说说 / 日志 / 日记 / 相册 / 视频 / 留言 / 好友 / 收藏 / 分享 / 访客，含评论、点赞、最近访问等关联数据。
- 离线查看器：备份直接本地打开，含数据看板、互动关系分析、足迹地图、图片 / 视频大图画廊。
- 多种媒体下载方式：助手直写目录 / 浏览器下载器 / Aria2，支持并发控制与失败重试。
- 增量备份与断点续传：跳过已备份数据、中断后可继续，适合超大空间。
- 离线也完整：QQ 表情图片与头像一并本地化下载，不依赖在线服务器。
- 后台保活：备份时无需守在空间页面。
Firefox 现已正式支持（Manifest V3），可从 Firefox 扩展商店（AMO） 在线安装，或用发布页的构建产物在 about:debugging 中「临时加载附加组件」安装。
- 用支持的浏览器打开并登录 QQ空间（备份他人空间则打开对方主页）。
- 在弹出的备份窗口中勾选要备份的模块，点击「开始备份」（首次按提示选择保存目录）。
- 等待进度面板完成，打开保存目录里的
index.html即可离线浏览。
| 维度 | Chrome / Edge（Chromium 内核） | Firefox |
|---|---|---|
| 文案 / 查看器落盘 | File System Access 直写你选择的目录 | downloads.download 直写浏览器下载目录 / QQ空间备份_<uin>/ |
| 媒体下载方式选项 | 助手直写目录 / 浏览器下载器 / Aria2 | 浏览器下载器 / Aria2（无「助手直写目录」） |
| 默认媒体下载方式 | 助手直写目录 | 浏览器下载器 |
| 打包 ZIP | 已移除 | 已移除（文案 / 查看器直接落盘） |
文案落盘路径与「媒体下载方式」相互独立：
- Chrome / Edge：文案始终写入你选择的目录。媒体落点由下载方式决定——「助手直写目录」落所选目录（文案与媒体同目录、一步到位）；「浏览器下载器」落浏览器下载目录；「Aria2」落 Aria2 配置目录。后两者媒体在外部目录，需自行合并回备份目录。
- Firefox：文案恒写「下载目录 / QQ空间备份_<uin>/」。「浏览器下载器」下媒体与文案同根、免合并；「Aria2」下媒体在 Aria2 目录、仍需合并。
面向开发者的环境、构建与测试说明。
- Node.js ≥ 22（WXT 所需）
- 包管理器：npm（项目使用
package-lock.json）
npm install # postinstall 会自动执行 wxt prepare| 命令 | 说明 |
|---|---|
npm run dev |
启动 WXT 开发模式（热重载） |
npm run build |
构建 Chrome 生产包（输出 .output/QZoneExport-chrome-mv3） |
npm run build:firefox |
构建 Firefox 生产包（输出 .output/QZoneExport-firefox-mv3） |
npm run zip / npm run zip:firefox |
构建并打包对应浏览器为可发布 zip |
npm run sign:firefox |
对 Firefox 构建产物调 AMO 自签名（web-ext sign，需本地 AMO 凭据；仅自建分发用，上架商店不需此步） |
npm run build:viewer |
仅构建查看器（输出到 public/viewer/） |
npm run dev:viewer |
单独启动查看器开发服务器（需先生成 mock 数据） |
npm run compile / compile:viewer |
TS / 查看器类型检查 |
npm run test |
Vitest 单元测试 |
npm run lint / format |
ESLint / Prettier |
- 执行
npm run build（Chrome）或npm run build:firefox（Firefox）。 - Chrome：
chrome://extensions开启「开发者模式」→「加载已解压的扩展程序」，选.output/QZoneExport-chrome-mv3。 - Firefox：
about:debugging→「临时加载附加组件」，选.output/QZoneExport-firefox-mv3。
| 领域 | 技术 |
|---|---|
| 扩展框架 | WXT 0.21（MV3，TypeScript SDK 化构建） |
| 语言 | TypeScript 6（严格模式） |
| 前端 UI | Vue 3 + Naive UI + Pinia（popup / options / 查看器） |
| 备份进度面板 | 纯 TypeScript + Shadow DOM（entrypoints/backup-panel，非 Vue） |
| 查看器 | ECharts + PhotoSwipe |
| 存储 | idb（IndexedDB）+ chrome.storage + chrome.cookies |
| 测试 / 代码质量 | Vitest 4 + ESLint 10 + Prettier |
QZoneExport/
├── core/ # 核心 TS 逻辑（采集 / 下载 / 导出 / 存储 / 通用工具，可单测）
├── entrypoints/ # WXT 入口（background / 内容脚本 / 进度面板 / popup / options / welcome）
├── viewer/ # 备份查看器（Vue3，独立 Vite 构建，产物打入扩展）
├── public/ # 静态资源（含 viewer 构建产物）
├── scripts/ shell/ # 辅助脚本
├── tests/ # Vitest 单元测试
├── wxt.config.ts # WXT 构建与 manifest 配置
└── tsconfig.json
许可证：Apache-2.0。仅供个人学习研究与数据备份之用。
免责声明：本项目为开源的个人学习研究工具，开源免费。请仅从官方商店、GitHub Releases 等官方渠道安装，不要从任何第三方地址购买或安装第三方打包版本。使用本项目导出个人信息（含你拥有访问权限的他人空间数据）时，请遵守相关法律法规：导出内容仅限你有权访问的部分，不得对他人隐私数据进行传播或滥用；因不正当使用导致的侵权或信息泄露，由使用者自行承担。使用第三方工具（如 Aria2）下载文件造成的风险亦由使用者自行承担。