企业官网建设流程全解析

📷 QQ 相册照片下载器

安全、高效地将 QQ 空间全部相册照片下载到本地
扫码登录 · 原图下载 · 断点续传 · 并发加速

下载地址：https://github.com/hou-jia88/qq-album-downloader

✨ 功能亮点

🚀 快速开始

环境要求

• Python3.8 或更高版本
• 支持Windows / macOS / Linux

安装

# 克隆仓库gitclone https://github.com/hou-jia88/qq-album-downloader.gitcdqq-album-downloader# 安装依赖pipinstall-rrequirements.txt

运行

# 交互模式（推荐首次使用）python qq_album_downloader.py# 自动模式（跳过确认，适合脚本化运行）python qq_album_downloader.py--auto

登录流程

1. 程序启动后，终端会显示一个二维码
2. 打开手机QQ→ 右上角扫一扫
3. 扫描终端中的二维码，在手机上确认登录
4. 登录成功后，程序自动开始下载所有相册

💡 登录状态会保存在.cookie.json中，下次运行无需重复扫码。

⚙️ 配置说明

编辑config.json自定义下载行为：

{"下载设置":{"导出路径":"E:\\qq文件\\QQ_Pictures","下载原图":true,"并发下载数":10,"列表请求间隔_秒":1.5,"下载重试次数":3},"过滤设置":{"跳过私密相册":true,"仅下载指定相册":[],"跳过视频":true}}

📁 输出目录结构

E:\qq文件\QQ_Pictures\ ├── 幸福\ │ ├── 2025-04-25_a1b2c3d4.jpg │ ├── 2025-04-25_e5f6g7h8.jpg │ └── ... ├── 2023.11.27\ │ ├── ... ├── 记忆录\ │ ├── ... └── ...

文件名格式：原始名称_8位哈希.扩展名，哈希值确保同名文件不会覆盖。

📦 项目文件

🧠 技术原理

┌─────────────┐ QR 扫码 ┌──────────────┐ │ 手机 QQ │ ◄────────────── │ 终端二维码 │ └─────────────┘ └──────┬───────┘ │ 确认登录 ▼ ┌─────────────────────────────────────────────┐ │ QQ 登录 API │ │ (ptqrshow → ptqrlogin → p_skey → g_tk) │ └─────────────────────┬───────────────────────┘ │ ┌──────────┴──────────┐ ▼ ▼ ┌──────────────┐ ┌──────────────────┐ │ 相册列表 API │ │ 照片列表 API │ │ (fcg_list_ │ │ (cgi_list_photo) │ │ album_v3) │ │ 分页 + 去重 │ └──────┬───────┘ └────────┬─────────┘ │ │ ▼ ▼ ┌──────────────────────────────────┐ │ 并发下载引擎 │ │ ThreadPoolExecutor + tqdm 进度 │ └──────────────┬───────────────────┘ ▼ ┌────────────────┐ │ 本地文件系统 │ │ E:\qq文件\ │ │ QQ_Pictures\ │ └────────────────┘

⚠️ 注意事项

1. 首次使用需要扫码登录，Cookie 会保存供后续使用
2. Cookie 有效期约 2~4 小时，程序会自动心跳保活
3. 下载中断后重新运行会自动跳过已下载文件，无需担心
4. 建议在稳定的网络环境下运行，避免频繁中断
5. 大相册（数千张）下载较慢，请耐心等待
6. 私密相册会自动跳过，不会尝试破解

🔒 安全策略

本工具严格遵守以下安全原则：

1. 仅扫码登录— 不收集、不存储密码，登录过程完全透明
2. 频率限制— 列表请求间隔 1.5 秒，避免触发反爬机制
3. 跳过受限内容— 不尝试访问私密/加密相册
4. 本地存储— Cookie 仅保存在本地文件，不进行任何网络传输
5. 尊重平台规则— 不暴力爬取，模拟正常用户操作行为

📜 免责声明

• 本工具仅用于个人数据备份，请勿用于商业用途
• 使用前请阅读并遵守腾讯 QQ 空间用户协议
• 使用者需自行承担使用风险
• 请勿使用本工具进行任何违法违规操作

☕ 支持项目

如果这个工具帮到了你，欢迎请我喝杯咖啡 ☕

微信 / 支付宝 通用收款码

📄 License

MIT © 2024