Qq Zone Photo

核心用法

本技能提供 QQ空间相册的自动化管理能力，覆盖六大核心场景：

| 功能 | 典型场景 |

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

| `login` | 扫码登录自动获取 Cookie，无需手动抓包 |

| `list` | 快速浏览所有相册列表 |

| `photos` | 查看指定相册内的全部照片 |

| `upload` | 将本地照片批量上传至指定相册 |

| `download/download-album` | 单张或整相册下载，支持自定义输出路径 |

| `create` | 快速创建新相册并设置标题/描述 |

显著优点

1. 闭环体验完整：从登录授权、相册浏览、照片管理到批量下载，覆盖 QQ空间相册管理的全生命周期，无需切换多个工具
2. 扫码登录简化认证：通过 --action login 自动完成 OAuth 流程并持久化 Cookie，大幅降低技术门槛，替代传统手动抓 Cookie 的繁琐步骤
3. 批量操作效率高：支持整相册下载（download-album）和批量上传，适合照片备份、迁移等大型任务
4. 本地隐私优先：Cookie 仅存储于本地 cookies.json，明确声明不上传服务器，符合用户对社交数据敏感性的预期

潜在缺点与局限性

1. 非官方 API 依赖：明确标注使用 QQ空间非官方接口，腾讯随时可能变更协议导致功能失效，存在维护不确定性
2. Cookie 时效性问题：QQ 登录态通常 1-7 天过期，需频繁重新扫码，长期自动化场景稳定性不足
3. 功能粒度较粗：缺少照片编辑、相册权限管理、评论/点赞互动等高级功能，定位为工具型而非平台型
4. 错误处理机制未明：文档未提及网络异常、相册权限限制（如私密相册）、文件格式不支持等场景的容错处理

适合人群

• 怀旧备份需求：早期 QQ空间用户，需要批量导出历史照片存档
• 多平台迁移用户：将 QQ空间照片迁移至 NAS、云盘或本地存储
• 轻量化管理者：不愿安装 QQ 客户端，仅需偶尔管理相册的极简用户

常规风险

• 凭证泄露风险：Cookie 包含完整 QQ空间访问权限，若 cookies.json 被窃取可导致账号被滥用
• 账号风控风险：高频批量下载可能触发腾讯反爬虫机制，导致临时封禁或滑块验证
• 数据完整性风险：非官方 API 不保证照片原图质量，可能存在压缩或下载失败情况

核心功能

QQ空间相册管理器（qq-zone-photo）是一款针对QQ空间相册的自动化管理工具，主要解决用户批量备份、整理历史照片的需求。核心功能包括：扫码登录获取Cookie凭证、列出所有相册、浏览单相册照片、上传照片到指定相册、下载单张照片或整相册、创建新相册等六类操作。

显著优点

1. 完整的相册生命周期管理：覆盖从登录授权到相册创建、照片上传下载的全流程，无需手动操作网页版QQ空间
2. 批量备份能力：支持整相册下载，配合0.5秒延迟的速率控制，兼顾效率与API稳定性
3. 凭证安全设计：采用本地JSON文件存储Cookie，不上传至第三方服务器，符合数据最小化原则
4. HTTPS全链路加密：所有与QQ空间的通信（user.qzone.qq.com、h5.qzone.qq.com、up.qzone.qq.com等官方端点）均使用TLS 1.2+加密

潜在局限

1. 非官方API依赖：基于QQ空间未公开接口实现，腾讯接口变更可能导致功能失效需适配
2. 凭证时效性问题：Cookie会话有有效期，过期后需重新扫码登录
3. 文件权限风险：cookies.json默认以明文存储，依赖操作系统文件权限控制，多用户环境存在泄露隐患
4. 维护持续性：个人开发者项目（T3来源），长期更新维护能力待观察

适合人群

• 需要批量备份QQ空间历史照片的怀旧用户
• 希望将云端相册迁移到本地NAS或硬盘的整理者
• 有定期相册归档需求的轻度自动化用户

常规风险

| 风险类型 | 等级 | 说明 |

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

| 凭证泄露 | 中 | Cookie文件包含完整QQ空间访问权限，需妥善保管 |

| 接口失效 | 中 | 非官方API可能因平台更新而中断 |

| 速率限制 | 低 | 批量操作可能触发腾讯API限流 |

| 隐私合规 | 低 | 照片数据本地处理，不上传第三方 |