bighardperson 📸 QQ空间相册管理器
QQ空间相册的自动化管理工具，支持扫码登录、相册浏览、照片上传/下载、相册创建等功能。
🤖 Agent 工作流示例
场景一：备份指定相册
用户: "帮我备份 QQ空间的旅行相册"
场景二：上传照片到指定相册
用户: "把桌面上的 vacation.jpg 上传到我的旅行相册"
场景三：全量备份所有相册
用户: "帮我把 QQ空间所有相册都下载下来"
场景四：创建相册并上传多张照片
用户: "创建一个叫'2024毕业季'的相册，把这几张照片传上去"
📋 AI Agent 调用指南
AI Agent 在调用本 Skill 前，需确保虚拟环境已激活且 cookies.json 有效。所有命令格式：
source <项目路径>/.venv/bin/activate && python3 <项目路径>/scripts/qzone_photos.py --action <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 |
调用示例
# 扫码登录
python3 scripts/qzone_photos.py --action login --cookies cookies.json
# 列出相册
python3 scripts/qzone_photos.py --action list --cookies cookies.json
# 浏览照片
python3 scripts/qzone_photos.py --action photos --album-id "ALBUM_ID" --cookies cookies.json
# 上传照片
python3 scripts/qzone_photos.py --action upload --photo "/path/to/image.jpg" --album-id "ALBUM_ID" --cookies cookies.json
# 下载整个相册
python3 scripts/qzone_photos.py --action download-album --album-id "ALBUM_ID" --output ./downloads --cookies cookies.json
# 创建新相册
python3 scripts/qzone_photos.py --action create --title "我的新相册" --cookies cookies.json
⚙️ 配置
Cookie 文件格式
创建 cookies.json，结构如下：
{
"qq_number": "123456789",
"p_skey": "your_p_skey_value",
"skey": "your_skey_value",
"uin": "o0123456789"
}
获取方式
- 推荐：使用
--action login扫码登录，Cookie 自动保存 - 手动：登录 QQ空间 后，通过浏览器开发者工具（F12 → Application → Cookies）提取
🔒 安全与隐私
- Cookie 文件包含 QQ空间完整访问权限，请勿泄露或分享
- 凭证仅存储在本地，不会上传到任何服务器
- 会话 Cookie 有时效性，过期后需重新登录
- 本工具使用 QQ空间非官方 API，腾讯更新接口后可能需要适配