QzonePhoto

项目概述

企鹅相册 · QzonePhoto 是一款给想把自己 QQ 空间内容搬回本地的用户用的桌面客户端，主要解决相册、视频和说说媒体难以批量保存的问题。它基于 Electron 43.7 与 Vue 3 构建，复用 QQ 空间网页端的官方接口完成登录与数据读取，cookie 与 p_skey 只在本地保存。除下载之外，它还能把本地照片视频批量传回指定相册，并备份好友分组、群成员与亲密度名单。

项目	内容
平台	Windows、macOS、Linux
技术栈	Electron 43.7 + Vue 3.5
当前版本	2.9.0
登录方式	扫码或本地 QQ 账号
许可	GPL-3.0-only

下载结果按 QQ 号 / 相册名 两级目录落地，原图与视频混排在同一个相册树下。

主要功能

• 相册整批下载：按相册勾选或一键全选，任务统一进入底部「下载管理」排队
• 原图优先：先取回照片的原始分辨率，视频保存为空间转码后的 MP4
• 动态聚合下载：在动态页下载单条说说时，会把该条说说里的原图与视频一并取回
• 断点续传：中断后重新开始会跳过已存在的同名文件
• 上传与配额：拖拽或多选本地文件上传到指定相册，同时显示磁盘配额与今日剩余上传额度
• 好友名单备份：导出联系人总览 HTML、数据 JSON、汇总 CSV 与说明 TXT 四份文件
• 好友空间切换：从底部好友抽屉进入对方空间，停留在当前 tab 并重新拉取数据
• 隐私模式：一键给媒体、头像、昵称、正文和评论加遮罩
• 节日主题：国庆、元旦、春节按时间窗口自动切换配色
• 应用内更新：检查新版本、显示下载进度并直接安装

界面与操作

• 相册视图：顶部显示权限状态与访客统计，下方是相册分组和原图预览
• 三个内容 tab：照片、视频、动态各自独立筛选，照片可按年份与来源过滤
• 下载管理：底部常驻入口，可按任务状态筛选、批量暂停或继续，并可修改保存位置与并发数
• 好友抽屉：底部打开，包含好友分组、我在意谁、谁在意我三个视角与群成员列表
• 标题栏：右侧「反馈」按钮可直接提交问题，也可切换回 GitHub 反馈页

适用人群

• 想把多年前 QQ 空间相册完整存档的用户
• 需要把本地照片视频批量传回空间的人
• 想备份 QQ 好友分组与群成员名单的用户
• 习惯在桌面大屏上批量勾选与整理文件的用户

快速上手

1. 打开 Releases，按系统与芯片选择安装包：Windows 用 *-win-x64-setup.exe 或 *-win-ia32-setup.exe
2. 首次启动后选择扫码登录，或在本机 QQ 已登录时用本地账号一键登录
3. 在相册列表勾选目标相册并点下载，也可切到照片、视频或动态 tab 下载当前列表的全部媒体
4. 打开底部「下载管理」，在「更改位置」里指定保存目录，下载变慢时把并发数调成 1 或 2
5. 需要回传时进入相册点「上传照片」，拖入本地文件后等待配额进度条走完
6. 备份名单：好友抽屉 →「备份名单」，选择当前列表或全部联系人，结果同样进入下载管理

系统要求

项目	要求
操作系统	Windows、macOS、Linux
安装包	Windows x64 与 ia32、macOS arm64 与 x64 DMG、Linux AppImage 与 deb
源码运行	Node.js ≥ 20.19、pnpm 10.33.2
默认保存目录	Windows C:/Users/<用户>/Pictures/QzonePhoto/，macOS 与 Linux ~/Pictures/QzonePhoto/

注意事项

• macOS 未签名：当前 DMG 未完成 Apple 开发者签名与公证，macOS 15 及以上无法靠右键放行，需到「系统设置 → 隐私与安全性」点「仍要打开」
• 可见性限制：仅自己可见、密码相册或未通过问答的相册会被自动跳过，好友内容只下载当前账号有权限查看的部分
• 媒体格式：照片为 JPG、PNG、GIF、BMP、WEBP，视频为 MP4、MOV、AVI，空间转码后通常只留 MP4
• 诊断日志：文件名固定为 qzone-helper-dev.log，macOS 位于 ~/Library/Application Support/qzone-photo/
• 登录态依赖：本地登录要求电脑端 QQ 已登录，头像不显示时退出重登或按 Ctrl/Cmd + R 刷新