Qq Zone Photo

核心用法

QQ空间相册管理器是一款面向QQ空间用户的照片自动化管理工具，通过命令行脚本实现相册的完整生命周期管理。核心功能涵盖六大场景：扫码登录获取持久化Cookie、列出全部相册清单、浏览指定相册内照片、单张/批量上传本地图片、下载单张照片或整相册备份、创建新相册并设置描述。

显著优点

操作完整性：覆盖相册管理的全链路需求，从登录认证到批量备份，无需人工逐页操作；自动化效率：支持整相册一键下载，解决QQ空间原生界面逐张保存的低效痛点；凭证本地化：Cookie仅存储于本地JSON文件，无云端传输环节；灵活扩展：基于Python脚本架构，可二次开发集成到个人工作流。

潜在缺点与局限性

非官方API依赖：工具基于QQ空间非公开接口开发，腾讯服务端变更可能导致功能失效；认证繁琐：首次使用需扫码登录或手动提取浏览器Cookie，对非技术用户门槛较高；会话时效性：Cookie存在过期机制，长期使用需定期重新认证；功能边界：不支持智能分类、人脸识别、原图无损压缩等高级相册管理特性；平台锁定：仅服务QQ空间生态，无法迁移至其他云相册服务。

适合人群

• QQ空间重度用户，积累了大量历史照片需系统性备份
• 有基础命令行操作能力的效率工具爱好者
• 担忧QQ空间服务稳定性、希望本地留存数字资产的怀旧用户
• 需批量整理旅行、毕业、家庭等主题相册的内容管理者

常规风险

凭证泄露风险：Cookie文件包含QQ空间完整会话权限，若被窃取可导致账号被盗、隐私照片泄露；数据完整性风险：非官方API在批量下载时可能因接口限流或网络中断导致部分照片遗漏；服务中断风险：腾讯封禁第三方工具或重构接口后，备份功能将不可逆失效，建议定期验证备份完整性。

核心用法

qq-zone-photo 是一款面向 QQ空间相册的自动化管理工具，主要解决用户历史照片备份、迁移与整理的痛点。核心功能包括：

• 扫码登录：通过 --action login 触发二维码登录，自动保存 Cookie 到本地 JSON 文件
• 相册管理：列出所有相册、创建新相册、浏览指定相册照片列表
• 照片操作：支持单张/批量上传、单张照片下载、整相册批量下载
• 命令行调用：通过 Python 脚本执行，需预先激活虚拟环境

典型工作流：登录获取 Cookie → 列出相册获取 album-id → 执行下载/上传操作。所有命令需携带 --cookies cookies.json 参数。

显著优点

1. 功能完整闭环：覆盖 QQ空间相册的 CRUD 全生命周期，尤其整相册批量下载功能填补了官方客户端的不足
2. 凭证安全设计：Cookie 仅本地存储，无云端传输或第三方服务器交互，符合隐私最小化原则
3. 网络边界清晰：所有 API 调用严格限定于 *.qq.com 官方域名（user.qzone.qq.com、ptlogin2.qq.com 等），HTTPS 加密传输
4. 依赖风险可控：仅 4 个核心依赖（requests、Pillow、qrcode、pycryptodome），无已知 CVE 漏洞
5. 平台兼容性：支持 macOS/Linux/Windows 三平台的二维码展示（open/xdg-open/os.startfile）

潜在缺点与局限性

1. 非官方 API 依赖：基于腾讯非公开接口实现，存在接口变更导致功能失效的风险
2. 来源可信度 T3：维护者为随机生成 ID，无公开 GitHub 仓库或可追溯的维护记录
3. 会话时效性：Cookie 存在过期机制，需定期重新扫码登录
4. Windows 系统调用：使用 os.startfile 打开二维码图片，虽用途明确但属于平台特定行为
5. 未使用依赖：pycryptodome 已列入依赖但未实际调用，增加潜在攻击面

适合人群

• 需要批量备份 QQ空间历史照片的怀旧用户
• 希望将 QQ空间相册迁移到本地/NAS 的整理控
• 有自动化照片管理需求的开发者/高级用户
• 愿意承担非官方 API 风险的腾讯生态重度用户

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 凭证泄露 | Cookie 文件包含完整 QQ空间访问权限 | 设置 `chmod 600 cookies.json` 限制访问 |

| 接口失效 | 非官方 API 可能因腾讯更新而失效 | 关注技能更新，保留手动备份方案 |

| 隐私合规 | 扫码登录需用户主动授权 | 确认登录设备归属，避免公共电脑保存 Cookie |

| 来源不明 | T3 级别个人/社区项目，无可验证源码 | 敏感账号建议先用小号测试 |