11273/QzonePhoto

企鹅相册 · QzonePhoto

把 QQ 空间的相册、照片、视频、动态和好友空间带回本地，并按你想要的方式管理。

📥 下载安装 · 官方网站 · 使用指南 · 常见问题 · 反馈

企鹅相册 · QzonePhoto 是一个跨平台的 QQ 空间桌面客户端，复用 QQ 空间网页端官方接口完成登录与数据获取，所有数据仅在本地处理。它现在不只看相册，也能在「照片 / 视频 / 动态」里查看自己和好友的空间内容，下载原图、视频和整条说说媒体，并把官方空间页放进应用内窗口打开。

相册视图：权限状态、相册分组、原图预览和批量下载	动态：我的主页、好友动态、与我相关、那年今日、收藏统一展示
照片时间线：按来源 / 媒体 / 年份筛选，单条或全页下载	视频网格：统一播放态、时长 / 年份 / 排序筛选和下载全部
下载管理：总体进度、任务筛选、批量控制与下载设置	上传管理：相册 / 状态筛选、实时进度与失败处理

截图来自真实运行界面，账号、相册、动态、任务和媒体均为本地生成的演示数据，不包含任何真实用户信息。

• 一键下载全部相册或选择性下载，支持批量任务
• 自动获取原图分辨率，照片和视频混合下载
• 支持照片页、视频页、动态页分别下载当前列表全部媒体
• 动态里的单条下载会按当前说说聚合，下载整条说说里的原图 / 视频
• 断点续传：意外中断后自动跳过已下载的文件
• 支持保留照片拍摄时间，并可按下载设置写入动态文案等媒体信息
• 自动按 QQ号 / 相册名 / 整理目录

• 拖拽 / 多选本地文件，支持照片和视频
• 选择目标相册或新建相册，实时进度
• 显示磁盘配额进度条 + 今日上传剩余配额（来自空间官方接口）

• 真实好友分组：直接拉 QQ 好友分组（不只是亲密度榜），按 uin 自动去重
• 三视角并存：分组 / 我在意谁 / 谁在意我，按需切换
• QQ群与成员：查看群列表和当前可读取的群成员，并保留群、好友和亲密度列表的浏览位置
• 联系人名单备份：可备份全部联系人、好友分组、群与可见成员，以及「我在意谁 / 谁在意我」名单
• 好友空间：一键切换上下文，进入好友时保留当前 tab（相册 / 照片 / 视频 / 动态）并重新拉取该好友数据
• 返回顺手：进入好友后，底部好友抽屉左侧会出现返回按钮，离开好友空间时平滑收起
• 相册访客：每个相册独立的总访客 / 今日新增 / 最近访客头像与时间

• 暗色主题：背景层级 / 边框 / 文本灰阶 / 主题色全部走 CSS 变量统一管理
• 节日主题：国庆、元旦、春节按时间窗口自动启用，桌面端与官网使用同一套克制的中国风视觉规范
• 隐私模式：右上角一键保护敏感内容，媒体、头像、昵称、正文和评论的遮罩风格统一
• 视频悬停预览：照片、视频和动态里的视频均支持默认静音预览，不遮挡标题与主要操作
• 动态时间线：我的主页、好友动态、特别关心、与我相关、那年今日、我的收藏、我的日志和留言板统一用同一套卡片与评论层级
• 富文本适配：说说里的 @、QQ 表情、评论回复层级会按更接近官方页面的方式渲染
• 内置官方页：点击头像 / 昵称 / QQ 空间链接会在应用内打开，并复用应用登录态，不依赖外部浏览器是否已登录
• 一键复制：QQ 号 / 相册问题 / 答案 / 相册 ID / 版本号 / 访客 QQ 号 全部点击或右键即可复制
• 统一权限弹层：标题旁灰字 N 张 / 权限文案 ▾，点开看完整问答 + 允许的功能 + 朋友圈范围
• 应用内更新：可直接检查正式版本、查看下载进度并按提示安装，国内源不可用时会核对 GitHub 官方发布
• 反馈入口：标题栏「反馈」支持应用内快捷提交；需要截图或长说明时可一键打开 GitHub 反馈页

👉 前往最新版本

Windows 提示安全警告 → "更多信息 → 仍要运行"。 macOS 提示未验证 → 系统设置 → 隐私与安全性 → 仍要打开。

git clone https://github.com/11273/QzonePhoto.git
cd QzonePhoto
pnpm install
pnpm dev          # 开发模式（热重载）
pnpm build:mac    # / build:win / build:linux 打包

需要 Node.js ≥ 20.19 + pnpm。

1. 登录：扫码登录或使用本地 QQ 账号一键登录
2. 浏览：进入相册看权限、访客、StatCard；切到「照片 / 视频 / 动态」tab 看时间线和网格
3. 下载：相册、照片、视频、动态都支持单项或批量下载；任务在底部「下载管理」里追踪
4. 上传：进入相册 → 「上传照片」 → 拖入文件；任务在「上传管理」里追踪
5. 好友空间：底部「好友」抽屉 → 点头像进入对方空间，会停留在你当前正在看的 tab 并刷新成好友数据
6. 备份名单：底部「好友」抽屉 → 「备份名单」，选择当前列表或全部联系人；进度和结果会进入「下载管理」
7. 反馈问题：标题栏右上角「反馈」可直接提交简短问题或建议；需要截图、长说明时再打开 GitHub 反馈页

[默认照片目录]/QzonePhoto/
├── <你的 QQ 号>/
│   ├── <相册名>/
│   │   ├── 照片.jpg
│   │   └── 视频.mp4
│   ├── 好友相册/
│   │   └── <好友 QQ 号>/<相册名>/
│   │       └── ...
│   └── 联系人备份/
│       └── <时间>_<备份范围>/
│           ├── 联系人总览_<时间>.html
│           ├── 备份说明_<时间>.txt
│           ├── 联系人数据_<时间>.json
│           ├── 联系人汇总_<数量>条.csv
│           └── 好友 / 群 / 亲密度/

可在「下载管理 → 更改位置」自定义。

好友抽屉右上角的「备份名单」支持按当前内容或全部联系人备份：

• 好友分组、好友备注、昵称和 QQ 号
• QQ 群以及当前账号有权限读取的群成员
• 「我在意谁」「谁在意我」及可获取的亲密度
• 可直接浏览的 HTML、适合表格处理的 CSV、完整 JSON 和备份说明 TXT

备份文件保存在当前下载位置的 <QQ号>/联系人备份/ 中，并作为独立任务显示在「下载管理」里。接口暂时无法读取的部分会写入备份说明，已经取得的数据仍会正常保存。

• 直接调用 QQ 空间官方接口，无第三方服务器中转
• 所有 cookie / p_skey / 文件全部仅在本地存储和处理
• 代码全开源，任意时刻可审查
• 请仅下载你有权限访问的内容，下载内容仅供个人使用，遵守相关法律法规

• 🐛 应用内「反馈」— 适合快速提交问题和建议，提交后会显示反馈编号，并自动附带版本、系统、当前页面和最近错误摘要。未配置快捷提交接口时会直接打开 GitHub 反馈页
• 🧩 Issues — 适合带截图、复现步骤或较长说明的问题
• 💬 Discussions — 经验交流
• ⭐ Star 一下这个项目支持作者持续迭代

本项目采用 GPL-3.0-only 许可证。