用途：面向 AI 智能体的 Google Photos 管理技能，可浏览、搜索、下载、上传并组织照片和视频。
主要能力：列出媒体项（按时间倒序、分页）；按日期范围和/或内容类别（如 LANDSCAPES、FOOD、SELFIES 等）搜索；按 ID 获取媒体项元数据；下载全分辨率照片/视频到本地磁盘；上传本地照片/视频（可选放入相册）；列出、创建、查看相册详情与内容；向相册添加/移除媒体项。
前置条件：需启用 Photos Library API 的 Google Cloud 项目，以及 OAuth 2.0 凭据（gcloud ADC 或 credentials.json）。
设置方式：推荐快速设置（一次配置 Gmail、Calendar、Contacts、Drive 和 Photos）：uv run ~/.agents/skills/gmail/scripts/setup_workspace.py。也可用 gcloud ADC 登录并带 photoslibrary、photoslibrary.sharing、cloud-platform 作用域，然后用 uv run skills/google-photos/scripts/google_photos.py verify 验证；或把 credentials.json 放到 ~/.photos_credentials/ 后运行 uv run skills/google-photos/scripts/google_photos.py setup。
常用用法：列表 uv run skills/google-photos/scripts/google_photos.py list（可加 --limit 和 --page-token）；搜索加 --date-start、--date-end、--categories；获取、下载、上传分别使用 get、download、upload 子命令；相册相关使用 albums、album-get、album-create、album-add、album-remove。输出为 JSON 格式的媒体项或相册信息。
限制：Photos Library API 仅允许修改由本应用上传的媒体项，无法删除或重新组织通过 Photos 网页/移动端 UI 上传的媒体。其他收费、价格或平台细节暂未提供。