还记得那些珍藏在QQ空间里的美好回忆吗？
- 🎓 毕业季的青春照片 - 那些和同窗好友的珍贵合影
- 🌸 恋爱时光的甜蜜瞬间 - 记录爱情故事的每一个细节
- 👨👩👧👦 家庭聚会的温馨时刻 - 和家人团聚的快乐时光
✈️ 旅行路上的精彩片段 - 世界各地留下的足迹
时光荏苒，这些回忆太珍贵了，不能只存在云端！
Qzone Photo 不仅帮助你将这些无价的回忆安全下载到本地，还支持将本地照片/视频上传到QQ空间，让空间管理更加便捷。
- 批量下载相册：支持一键下载所有相册或选择性下载
- 照片与视频：同时支持照片和视频内容下载
- 原图下载：自动获取原始分辨率图片，不下载压缩版
- 断点续传：意外中断也不怕，继续下载不重复
- 智能分类：按QQ号和相册名自动整理文件
- 好友列表：浏览好友列表，快速进入好友相册
- 好友动态照片：网格卡片布局展示好友最新动态照片
- 好友相册下载：支持下载好友的公开相册和有权限的相册
- 原图获取：通过浮层视图接口获取好友相册原图 URL
- 视频下载：支持下载好友相册中的视频内容
- 智能存储：好友相册按
QQ号/好友相册/好友QQ/相册名自动归类
- 照片上传：支持批量上传本地照片到指定相册
- 视频上传：支持上传视频文件到QQ空间
- 进度跟踪：实时显示上传进度和状态
- 照片浏览：高清预览相册中的照片
- 视频播放：在线播放QQ空间视频
- 隐私模式：默认开启隐私模糊，保护个人隐私
相册列表中通过不同图标直观展示相册权限状态：
| 图标 | 权限类型 | 说明 |
|---|---|---|
| 无 | 所有人可见 | 公开相册 |
| 👤 | QQ好友可见 | 仅QQ好友可查看 |
| ❓ | 回答问题可见 | 需回答设定问题，点击可查看问答 |
| 🔑 | 密码访问 | 需输入密码 |
| 👁️ | 部分好友可见 | 仅指定好友可查看 |
| 🙈 | 部分好友不可见 | 屏蔽指定好友 |
| 🔒 | 仅自己可见 | 私密相册 |
对于设置了「回答问题可见」的相册，支持查看问题和答案：
- 侧栏快捷查看：点击相册旁的 ❓ 图标，弹出气泡显示问题与答案
- 顶栏详情查看：进入相册后，顶部信息栏点击问题卡片可展开查看答案
- 仅主人可见：答案仅相册主人可查看，查看好友相册时会提示"仅主人可见"
- 官方接口：使用QQ空间官方API，数据安全有保障
- 本地存储：所有文件保存在你的电脑上
- 权限控制：只能操作你有权限访问的内容
- 开源透明：代码完全公开，接受社区监督
- 跨平台支持：Windows、macOS、Linux 全平台支持
- 界面简洁：现代化UI设计，操作简单直观
- 自动更新：支持应用自动更新到最新版本
如果你想从源码运行或参与开发，需要准备以下环境：
- Node.js: 建议使用 v18.x 或更高版本
- 包管理器: pnpm（推荐）
- 克隆项目
git clone https://github.com/11273/QzonePhoto.git
cd QzonePhoto- 安装依赖
# 使用 pnpm（推荐）
pnpm install- 启动开发模式
# 开发模式（带热重载）
pnpm dev- 打包应用
# 构建所有平台
pnpm build
# 构建特定平台
pnpm build:win # Windows
pnpm build:mac # macOS
pnpm build:linux # Linux- 64位系统（推荐）：下载
*-win-x64-setup.exe - 32位系统：下载
*-win-ia32-setup.exe - 不确定：下载
*-win-setup.exe（通用版，文件较大）
- Apple M系列芯片（2020年后）：下载
*-mac-arm64.dmg - Intel芯片（2020年前）：下载
*-mac-x64.dmg - DMG打不开：下载对应的
.zip文件
💡 查看芯片：点击 → 关于本机
- 推荐：下载
*-linux-x86_64.AppImage（通用版） - Ubuntu/Debian：下载
*-linux-amd64.deb
💡 AppImage需要执行权限：
chmod +x *.AppImage
- Windows提示安全警告：点击"更多信息" → "仍要运行"
- macOS提示未验证：系统偏好设置 → 安全性与隐私 → "仍要打开"
- 文件选择：
.blockmap和.yml文件无需下载
打开应用后，选择你喜欢的登录方式：
- 📱 扫码登录（推荐）：用手机QQ扫一扫，安全快捷
- 💻 本地登录：直接使用电脑上已登录的QQ
登录成功后，可以看到所有可访问的相册列表，包括：
- 相册封面预览
- 相册名称和照片数量
- 创建时间等信息
点击相册可以查看详细内容：
- 照片查看：高清预览，支持缩放和切换
- 视频播放：在线播放，支持全屏和进度控制
- 隐私模式：默认开启模糊效果，保护隐私
🔒 隐私保护：照片页面默认开启隐私模糊模式，不会被旁边的人看到照片内容，可点击眼睛图标切换
选择想要下载的相册：
- 选择相册 - 勾选要下载的相册
- 开始下载 - 点击下载按钮
- 查看进度 - 实时显示下载进度和状态
💡 小贴士：文件会自动保存到
电脑图片/Qzone Photo/QQ号码/相册名称/文件夹中
支持将本地照片和视频上传到QQ空间：
- 选择相册 - 选择目标相册或创建新相册
- 选择文件 - 从本地选择要上传的照片/视频
- 开始上传 - 批量上传，实时显示进度
下载的文件会自动保存到你的电脑照片文件夹下的 Qzone Photo 目录中，并按以下格式分类：
电脑照片/QzonePhoto/
├── QQ号码/
│ ├── 相册名称1/
│ │ ├── 照片1.jpg
│ │ ├── 照片2.jpg
│ │ └── 视频1.mp4
│ ├── 相册名称2/
│ │ └── ...
│ └── 好友相册/
│ ├── 好友QQ号1/
│ │ ├── 相册名称1/
│ │ │ └── ...
│ │ └── 相册名称2/
│ │ └── ...
│ └── 好友QQ号2/
│ └── ...
└── ...
默认保存路径：
- Windows:
C:\Users\你的用户名\Pictures\QzonePhoto\ - macOS:
/Users/你的用户名/Pictures/QzonePhoto/ - Linux:
/home/你的用户名/Pictures/QzonePhoto/
💡 小贴士：你也可以在设置中自定义保存位置
🤔 可以下载好友的相册吗？
可以。支持下载好友的公开相册以及你有权限查看的相册（如"QQ好友可见"、已回答问题的相册等）。仅自己可见、密码相册等无权限的相册会自动跳过。
📂 下载的文件保存在哪里？
默认保存路径：
- Windows:
C:\Users\你的用户名\Pictures\QzonePhoto\ - macOS:
/Users/你的用户名/Pictures/QzonePhoto/ - Linux:
/home/你的用户名/Pictures/QzonePhoto/
文件会按照 QQ号码/相册名称/ 的结构自动分类整理。
🐌 下载速度很慢怎么办？
- 降低并发数到1-2（在设置中调整）
- 检查网络连接是否稳定
- 避开网络使用高峰期
- 关闭其他占用网络的程序
🔐 登录失败怎么办？
- 确保网络连接正常
- 检查QQ是否在手机上正常登录
- 尝试重新扫码或重启应用
- 如果使用本地登录，确保电脑QQ正常运行
| 类型 | 下载 | 上传 | 预览 |
|---|---|---|---|
| 📸 照片 | ✅ | ✅ | ✅ |
| 🎬 视频 | ✅ | ✅ | ✅ |
| 👥 好友相册 | ✅ | - | ✅ |
- 批量下载：支持一键下载所有相册，提高效率
- 合理设置并发数：建议设置为1-3，既保证速度又避免被限制
- 选择合适时间：深夜或早晨网络较好时下载
- 断点续传：下载中断后重新开始会自动跳过已下载的文件
- 批量上传：可以一次选择多个文件进行上传
- 创建相册：上传前可以创建新相册进行分类
- 格式支持：支持常见的图片格式（JPG、PNG、GIF等）和视频格式
- 定期备份：将下载的照片备份到移动硬盘或云盘
- 分类整理：可以按年份或事件重新整理文件夹
- 隐私模式：在公共场所使用时，隐私模式会自动模糊照片，保护个人隐私
- 🏢 使用官方接口，安全可靠
- ✅ 直接调用QQ空间官方API，无任何第三方服务器
- 🛡️ 数据传输加密，与QQ空间官方同等安全级别
- 💻 所有数据仅在本地处理，绝不上传到外部服务器
- 🔍 开源代码，任何人都可以审查验证安全性
- ⚖️ 请合法合规使用本工具
- 🔒 仅下载你有权限访问的内容
- 💾 下载内容仅供个人使用
- 📖 遵守相关法律法规
如果你在使用过程中遇到问题或有改进建议，欢迎：
本项目采用 MIT License 开源协议，你可以自由使用和修改。
让美好回忆永远陪伴你 💝
Made with ❤️ by QzonePhoto Team