核心用法
该 Skill 通过封装 Google Photos Library API,提供命令行式的照片管理能力。主要功能包括:
- 相册管理:列出现有相册(获取 Album ID)、创建新相册并自定义标题
- 照片上传:支持单张图片上传,可选指定目标相册
- OAuth 认证:采用标准 OAuth 2.0 流程,首次运行生成
token.pickle持久化凭证
使用时需通过 scripts/gphotos.py 脚本执行,依赖本地 Python 虚拟环境。
显著优点
1. 官方 API 背书:直接调用 photoslibrary.googleapis.com,非第三方逆向接口,稳定性与长期兼容性有保障
2. 权限粒度可控:仅访问应用上传的照片及用户明确共享的内容,不触碰完整图库
3. 轻量无侵入:纯命令行工具,不驻留后台服务,用完即走
潜在局限
- 无批量上传:示例命令为单文件上传,大规模备份需自行编写循环脚本
- 依赖本地环境:需维护 Python 虚拟环境及凭证文件路径,对非技术用户门槛较高
- Token 过期风险:
token.pickle需定期刷新,长期无人值守运行可能中断
适合人群
- 开发者或技术用户,希望将 Google Photos 集成到自动化工作流
- 需要定期将本地相机/服务器照片归档至云端备份的摄影师或工作室
- 注重数据主权、倾向官方 API 而非第三方同步工具的用户
常规风险
- 凭证泄露:
credentials.json与token.pickle包含完整 OAuth 凭据,务必纳入.gitignore并限制文件权限 - 误操作覆盖:当前未提及重复上传检测,同名文件可能产生重复条目
- API 配额限制:Google Photos API 存在每日调用上限,大规模同步需关注配额策略