Qq Zone Photo

--- name: qq-zone-photo description: 管理 QQ空间相册。支持扫码登录、列出相册、浏览照片、上传照片、下载照片/相册、创建相册。当用户需要备份、整理或管理 QQ空间中的照片时使用此技能。 metadata: {"openclaw":{"emoji":"📸","requires":{"auth":["qq-cookies"]}}} --- # 📸 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/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`，结构如下： ```json { "qq_number": "123456789", "p_skey": "your_p_skey_value", "skey": "your_skey_value", "uin": "o0123456789" } ```   ### 获取方式 - **推荐**：使用 `--action login` 扫码登录，Cookie 自动保存 - **手动**：登录 [QQ空间](https://user.qzone.qq.com/) 后，通过浏览器开发者工具（F12 → Application → Cookies）提取 --- ## 🔒 安全与隐私 - Cookie 文件包含 QQ空间完整访问权限，**请勿泄露或分享** - 凭证仅存储在本地，不会上传到任何服务器 - 会话 Cookie 有时效性，过期后需重新登录 - 本工具使用 QQ空间非官方 API，腾讯更新接口后可能需要适配