QQ空间相册入门工具（免费版）

概述

本工具为个人用户提供QQ空间相册管理能力。支持登录QQ空间、浏览相册列表、查看照片和单张下载。适合个人用户备份与管理QQ空间中的珍贵照片。

核心能力

管理功能

输入: 用户提供管理功能所需的指令和必要参数。 处理: 按照skill规范执行管理功能操作,遵循单一意图原则。 输出: 返回管理功能的执行结果,包含操作状态和输出数据。

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 按照skill规范执行核心功能执行操作,遵循单一意图原则。 输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 按照skill规范执行参数配置与调用操作,遵循单一意图原则。 输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：空间相册管理工具、支持相册浏览与单、张照片下载、面向个人用户的、支持登录、浏览相册、查看照片与单张下、Use、when、需要项目管理、任务规划、进度跟踪、团队协作时使用、不适用于实际人员、绩效评估、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：浏览相册

用户输入："查看我的QQ空间相册"

# 登录QQ空间
python3 scripts/qzone.py login --qq 123456789

# 查看相册列表
python3 scripts/qzone.py albums list

# 输出：
# === 我的相册 ===
# 1. 旅行照片 (156张)
# 2. 家庭聚会 (89张)
# 3. 工作记录 (45张)

场景二：查看照片

用户输入："看看旅行相册里的照片"

# 查看相册照片
python3 scripts/qzone.py photos list 
  --album "旅行照片" 
  --page 1

# 输出照片列表（缩略图链接）

场景三：下载照片

用户输入："下载这张照片"

# 下载单张照片
python3 scripts/qzone.py photo download 
  --photo-id 12345 
  --output ./downloads/

# 下载到指定目录

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

环境准备

# 依赖说明
pip install requests beautifulsoup4

# 登录QQ空间
python3 scripts/qzone.py login --qq 123456789
# 根据提示完成登录认证

常用命令

# 登录
python3 scripts/qzone.py login --qq 123456789

# 相册管理
python3 scripts/qzone.py albums list
python3 scripts/qzone.py albums info --name "旅行照片"

# 照片管理
python3 scripts/qzone.py photos list --album "旅行照片"
python3 scripts/qzone.py photo download --photo-id 12345 --output ./downloads/
python3 scripts/qzone.py photo info --photo-id 12345

# 登出
python3 scripts/qzone.py logout

示例

QQ空间配置

qzone_config:
  auth:
    method: "cookie"              # cookie | qrcode
    cookie_file: "./qzone_cookies.json"
    qrcode_timeout: 120

  download:
    default_dir: "./downloads"
    naming: "original"            # original | sequential | date
    quality: "original"           # original | thumbnail

  cache:
    enabled: true
    ttl: 3600

最佳实践

1. 登录安全：使用Cookie登录，避免频繁输入密码
2. 下载路径：指定明确的下载目录，便于管理
3. 照片备份：定期下载重要照片，防止丢失
4. 遵守规则：仅下载自己的照片，尊重他人隐私

常见问题

Q1：如何登录QQ空间？

支持Cookie登录和扫码登录两种方式。Cookie登录需手动获取Cookie；扫码登录使用QQ手机版扫码，更便捷安全。

Q2：免费版支持批量下载吗？

免费版仅支持单张照片下载。如需批量下载整个相册，建议升级PRO版。

Q3：下载的照片是什么质量？

免费版默认下载原图（最高质量）。如果原图不可用，会下载最高可用质量的版本。

Q4：可以下载好友的相册吗？

本工具仅支持管理自己的QQ空间相册。下载他人照片涉及隐私和版权问题，不建议使用。

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• Python版本: 3.8+

第三方依赖

API Key 配置

• 无需API Key
• 通过QQ账号Cookie或扫码认证

可用性分类

• 分类: MD+EXEC（Markdown指令+Python脚本执行）
• 说明: 通过QQ空间Web接口管理相册
• 免费版限制: 单张下载、不支持批量与相册管理
• 合规声明: 仅支持管理自己的照片，请尊重他人隐私与版权

错误处理

已知限制

• 需LLM支持,无LLM环境不可用
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响