Qzone Photo 是一个跨平台的 QQ 空间桌面客户端，复用 QQ 空间网页端官方接口完成登录与数据获取，所有数据仅在本地处理。它现在不只看相册，也能在「照片 / 视频 / 动态」里查看自己和好友的空间内容，下载原图、视频和整条说说媒体，并把官方空间页放进应用内窗口打开。
 |
 |
| 相册视图：权限状态、相册分组、原图预览和批量下载 | 动态：我的主页、好友动态、与我相关、那年今日、收藏统一展示 |
 |
 |
| 照片时间线：按来源 / 媒体 / 年份筛选，单条或全页下载 | 视频网格：统一播放态、时长 / 年份 / 排序筛选和下载全部 |
 |
 |
| 好友抽屉：分组搜索、QQ 号查找，进入好友后保留当前 tab 并刷新数据 | 下载管理：并发数、跳过重复、任务状态分类筛选 |
 |
 |
| 上传管理：相册筛选、状态筛选、整体进度和实时速度 | 登录页：扫码或本地 QQ 登录，登录态会同步给内置官方页 |
截图来自真实运行界面，已开启隐私模式并做局部脱敏处理。头像、昵称、QQ 号、好友列表、相册名、动态正文、评论和媒体内容均不可识别，仅保留界面结构与交互状态。
- 一键下载全部相册或选择性下载，支持批量任务
- 自动获取原图分辨率，照片和视频混合下载
- 支持照片页、视频页、动态页分别下载当前列表全部媒体
- 动态里的单条下载会按当前说说聚合，下载整条说说里的原图 / 视频
- 断点续传：意外中断后自动跳过已下载的文件
- 自动按
QQ号 / 相册名 /整理目录
- 拖拽 / 多选本地文件，支持照片和视频
- 选择目标相册或新建相册，实时进度
- 显示磁盘配额进度条 + 今日上传剩余配额（来自空间官方接口）
- 真实好友分组：直接拉 QQ 好友分组（不只是亲密度榜），按 uin 自动去重
- 三视角并存：分组 / 我在意谁 / 谁在意我，按需切换
- 好友空间：一键切换上下文，进入好友时保留当前 tab（相册 / 照片 / 视频 / 动态）并重新拉取该好友数据
- 返回顺手：进入好友后，底部好友抽屉左侧会出现返回按钮，离开好友空间时平滑收起
- 相册访客：每个相册独立的总访客 / 今日新增 / 最近访客头像与时间
- 暗色主题：背景层级 / 边框 / 文本灰阶 / 主题色全部走 CSS 变量统一管理
- 隐私模式：右上角一键保护敏感内容，媒体、头像、昵称、正文和评论的遮罩风格统一
- 动态时间线：我的主页、好友动态、特别关心、与我相关、那年今日、我的收藏统一用同一套卡片和评论层级
- 富文本适配：说说里的
@、QQ 表情、评论回复层级会按更接近官方页面的方式渲染 - 内置官方页：点击头像 / 昵称 / QQ 空间链接会在应用内打开，并复用应用登录态，不依赖外部浏览器是否已登录
- 一键复制：QQ 号 / 相册问题 / 答案 / 相册 ID / 版本号 / 访客 QQ 号 全部点击或右键即可复制
- 统一权限弹层：标题旁灰字
N 张 / 权限文案 ▾，点开看完整问答 + 允许的功能 + 朋友圈范围 - 反馈入口：标题栏「反馈」支持应用内快捷提交；需要截图或长说明时可一键打开 GitHub 反馈页
| 平台 | 下载文件 | 备注 |
|---|---|---|
| Windows | *-win-x64-setup.exe |
64 位（主流） |
| Windows | *-win-ia32-setup.exe |
32 位老电脑 |
| macOS | *-mac-arm64.dmg |
M 系列 Apple Silicon |
| macOS | *-mac-x64.dmg |
Intel 芯片 |
| Linux | *-linux-x86_64.AppImage |
通用版（chmod +x 后双击） |
| Linux | *-linux-amd64.deb |
Ubuntu / Debian 系 |
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 ≥ 18 + pnpm。
- 登录：扫码登录或使用本地 QQ 账号一键登录
- 浏览：进入相册看权限、访客、StatCard；切到「照片 / 视频 / 动态」tab 看时间线和网格
- 下载：相册、照片、视频、动态都支持单项或批量下载；任务在底部「下载管理」里追踪
- 上传：进入相册 → 「上传照片」 → 拖入文件；任务在「上传管理」里追踪
- 好友空间：底部「好友」抽屉 → 点头像进入对方空间，会停留在你当前正在看的 tab 并刷新成好友数据
- 反馈问题：标题栏右上角「反馈」可直接提交简短问题或建议；需要截图、长说明时再打开 GitHub 反馈页
[默认照片目录]/QzonePhoto/
├── <你的 QQ 号>/
│ ├── <相册名>/
│ │ ├── 照片.jpg
│ │ └── 视频.mp4
│ └── 好友相册/
│ └── <好友 QQ 号>/<相册名>/
│ └── ...
| 平台 | 默认路径 |
|---|---|
| Windows | C:\Users\<用户>\Pictures\QzonePhoto\ |
| macOS | ~/Pictures/QzonePhoto/ |
| Linux | ~/Pictures/QzonePhoto/ |
可在「下载管理 → 更改位置」自定义。
- 直接调用 QQ 空间官方接口，无第三方服务器中转
- 所有 cookie / p_skey / 文件全部仅在本地存储和处理
- 代码全开源，任意时刻可审查
- 请仅下载你有权限访问的内容，下载内容仅供个人使用，遵守相关法律法规
能下载好友的相册吗？
可以。支持下载好友的公开相册以及你有权限查看的（QQ 好友可见、已通过的回答问题相册等）。仅自己可见、密码相册等会自动跳过。
下载速度很慢怎么办？
- 降低并发数到 1–2（下载管理 → 并发数）
- 检查网络稳定性，避开高峰期
- 关闭其他占网络的程序
登录失败怎么办？
- 确认 QQ 在手机上能正常用
- 重新扫码或重启应用
- 本地登录失败时确认电脑端 QQ 已登录
支持哪些文件格式？
- 照片：JPG / PNG / GIF / BMP / WEBP
- 视频：MP4 / MOV / AVI（QQ 空间转码后通常为 MP4）
我自己电脑上的 QQ 头像没显示？
第一次登录时有可能 cookie 还没建立。退出重登一次，或者刷新页面（Ctrl/Cmd + R）。
- 🐛 应用内「反馈」— 适合快速提交问题和建议，提交后会显示反馈编号，并自动附带版本、系统、当前页面和最近错误摘要。未配置快捷提交接口时会直接打开 GitHub 反馈页
- 🧩 Issues — 适合带截图、复现步骤或较长说明的问题
- 💬 Discussions — 经验交流
- ⭐ Star 一下这个项目支持作者持续迭代
MIT License — 自由使用、修改、分发，无商业限制。
Made with ❤️ — 让美好回忆永远陪伴你