📸 QQ空间相册管理器

QQ空间相册的自动化管理工具，支持扫码登录、相册浏览、照片上传/下载、相册创建等功能。

---

🤖 Agent 工作流示例

场景一：备份指定相册

用户: 帮我备份 QQ空间的旅行相册

场景二：上传照片到指定相册

用户: 把桌面上的 vacation.jpg 上传到我的旅行相册

场景三：全量备份所有相册

用户: 帮我把 QQ空间所有相册都下载下来

场景四：创建相册并上传多张照片

用户: 创建一个叫2024毕业季的相册，把这几张照片传上去

---

📋 AI Agent 调用指南

AI Agent 在调用本 Skill 前，需确保虚拟环境已激活且 cookies.json 有效。所有命令格式：

bash
source <项目路径>/.venv/bin/activate && python3 <项目路径>/scripts/qzone_photos.py --action [参数]

Action 一览

Action	说明	必填参数	可选参数
login	扫码登录，自动保存 Cookie	--cookies	—
list

列出所有相册 | --cookies | --qq | | photos | 浏览相册中的照片 | --album-id --cookies | --qq | | upload | 上传照片到相册 | --photo --cookies | --album-id --qq | | download | 下载单张照片 | --url --cookies | --output | | download-album | 下载整个相册 | --album-id --cookies | --output --qq | | create | 创建新相册 | --title --cookies | --desc --qq |

调用示例

bash

扫码登录

python3 scripts/qzone_photos.py --action login --cookies cookies.json

列出相册

python3 scripts/qzone_photos.py --action list --cookies cookies.json

浏览照片

python3 scripts/qzonephotos.py --action photos --album-id ALBUMID --cookies cookies.json

上传照片

python3 scripts/qzonephotos.py --action upload --photo /path/to/image.jpg --album-id ALBUMID --cookies cookies.json

下载整个相册

python3 scripts/qzonephotos.py --action download-album --album-id ALBUMID --output ./downloads --cookies cookies.json

创建新相册

python3 scripts/qzone_photos.py --action create --title 我的新相册 --cookies cookies.json

---

⚙️ 配置

Cookie 文件格式

创建 cookies.json，结构如下：

json
{
qq_number: 123456789,
pskey: yourpskeyvalue,
skey: yourskeyvalue,
uin: o0123456789
}

获取方式

• - 推荐：使用 --action login 扫码登录，Cookie 自动保存
• 手动：登录 QQ空间 后，通过浏览器开发者工具（F12 → Application → Cookies）提取

---

🔒 安全与隐私

• - Cookie 文件包含 QQ空间完整访问权限，请勿泄露或分享
• 凭证仅存储在本地，不会上传到任何服务器
• 会话 Cookie 有时效性，过期后需重新登录
• 本工具使用 QQ空间非官方 API，腾讯更新接口后可能需要适配