{"skill":{"slug":"qq-zone-photo","displayName":"Qq Zone Photo","summary":"管理 QQ空间相册。支持扫码登录、列出相册、浏览照片、上传照片、下载照片/相册、创建相册。当用户需要备份、整理或管理 QQ空间中的照片时使用此技能。","description":"---\nname: qq-zone-photo\ndescription: 管理 QQ空间相册。支持扫码登录、列出相册、浏览照片、上传照片、下载照片/相册、创建相册。当用户需要备份、整理或管理 QQ空间中的照片时使用此技能。\nmetadata: {\"openclaw\":{\"emoji\":\"📸\",\"requires\":{\"auth\":[\"qq-cookies\"]}}}\n---\n\n# 📸 QQ空间相册管理器\n\n> QQ空间相册的自动化管理工具，支持扫码登录、相册浏览、照片上传/下载、相册创建等功能。\n\n---\n\n## 🤖 Agent 工作流示例\n\n#### 场景一：备份指定相册\n\n```\n用户: \"帮我备份 QQ空间的旅行相册\"\n```\n\n#### 场景二：上传照片到指定相册\n\n```\n用户: \"把桌面上的 vacation.jpg 上传到我的旅行相册\"\n```\n\n#### 场景三：全量备份所有相册\n\n```\n用户: \"帮我把 QQ空间所有相册都下载下来\"\n```\n\n#### 场景四：创建相册并上传多张照片\n\n```\n用户: \"创建一个叫'2024毕业季'的相册，把这几张照片传上去\"\n```\n\n![](./image/image3.png)\n![](./image/image4.png)\n![](./image/image5.png)\n\n---\n\n## 📋 AI Agent 调用指南\n\nAI Agent 在调用本 Skill 前，需确保虚拟环境已激活且 `cookies.json` 有效。所有命令格式：\n\n```bash\nsource <项目路径>/.venv/bin/activate && python3 <项目路径>/scripts/qzone_photos.py --action <ACTION> [参数]\n```\n\n### Action 一览\n\n| Action | 说明 | 必填参数 | 可选参数 |\n|--------|------|----------|----------|\n| `login` | 扫码登录，自动保存 Cookie | `--cookies` | — |\n| `list` | 列出所有相册 | `--cookies` | `--qq` |\n| `photos` | 浏览相册中的照片 | `--album-id` `--cookies` | `--qq` |\n| `upload` | 上传照片到相册 | `--photo` `--cookies` | `--album-id` `--qq` |\n| `download` | 下载单张照片 | `--url` `--cookies` | `--output` |\n| `download-album` | 下载整个相册 | `--album-id` `--cookies` | `--output` `--qq` |\n| `create` | 创建新相册 | `--title` `--cookies` | `--desc` `--qq` |\n\n### 调用示例\n\n```bash\n# 扫码登录\npython3 scripts/qzone_photos.py --action login --cookies cookies.json\n\n# 列出相册\npython3 scripts/qzone_photos.py --action list --cookies cookies.json\n\n# 浏览照片\npython3 scripts/qzone_photos.py --action photos --album-id \"ALBUM_ID\" --cookies cookies.json\n\n# 上传照片\npython3 scripts/qzone_photos.py --action upload --photo \"/path/to/image.jpg\" --album-id \"ALBUM_ID\" --cookies cookies.json\n\n# 下载整个相册\npython3 scripts/qzone_photos.py --action download-album --album-id \"ALBUM_ID\" --output ./downloads --cookies cookies.json\n\n# 创建新相册\npython3 scripts/qzone_photos.py --action create --title \"我的新相册\" --cookies cookies.json\n```\n\n---\n\n## ⚙️ 配置\n\n### Cookie 文件格式\n\n创建 `cookies.json`，结构如下：\n\n```json\n{\n  \"qq_number\": \"123456789\",\n  \"p_skey\": \"your_p_skey_value\",\n  \"skey\": \"your_skey_value\",\n  \"uin\": \"o0123456789\"\n}\n```\n\n![](./image/image1.png)\n![](./image/image2.png)\n\n### 获取方式\n\n- **推荐**：使用 `--action login` 扫码登录，Cookie 自动保存\n- **手动**：登录 [QQ空间](https://user.qzone.qq.com/) 后，通过浏览器开发者工具（F12 → Application → Cookies）提取\n\n---\n\n## 🔒 安全与隐私\n\n- Cookie 文件包含 QQ空间完整访问权限，**请勿泄露或分享**\n- 凭证仅存储在本地，不会上传到任何服务器\n- 会话 Cookie 有时效性，过期后需重新登录\n- 本工具使用 QQ空间非官方 API，腾讯更新接口后可能需要适配\n","topics":["备份"],"tags":{"latest":"1.0.3"},"stats":{"comments":0,"downloads":20571,"installsAllTime":777,"installsCurrent":1,"stars":8,"versions":4},"createdAt":1773535855461,"updatedAt":1778491913988},"latestVersion":{"version":"1.0.3","createdAt":1773542653366,"changelog":"- Skill 名称从 \"qq-zone-photo-skills\" 修改为 \"qq-zone-photo\"。\n- 更新并简化了 README 和说明文档表述。\n- 明确 skill 描述及 metadata 信息，使表述更简洁一致。\n- 无新增功能或接口变更，仅文档和元数据调整。","license":"MIT-0"},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"wscats","userId":"s17bw1sf2hsjw09jmyh7nhzshn83h2gf","displayName":"enoyao","image":"https://avatars.githubusercontent.com/u/17243165?v=4"},"moderation":null}