SuperAPI AI 工具集

apple-photos

设计与创作

查看项目

更新于 10-16 01:50

技能介绍

用途:在 macOS 上通过 SQLite 查询访问 Apple Photos.app,实现照片库的浏览、搜索与导出。运行脚本前需切换到 {baseDir} 目录(cd {baseDir})。

前提条件:终端需要「完全磁盘访问权限」(系统设置 → 隐私与安全性 → 完全磁盘访问权限)。

主要能力与命令:

  • 资料库统计:scripts/photos-count.sh
  • 列出相册:scripts/photos-list-albums.sh
  • 最近照片:scripts/photos-recent.sh [count]
  • 列出人物:scripts/photos-list-people.sh
  • 按人物搜索:scripts/photos-search-person.sh <name> [limit]
  • 按内容搜索:scripts/photos-search-content.sh <query> [limit]
  • 按日期搜索:scripts/photos-search-date.sh <start> [end] [limit]
  • 照片信息:scripts/photos-info.sh <uuid>
  • 导出照片:scripts/photos-export.sh <uuid> [output_path]

输出格式:最近/搜索结果为「Filename | Date | Type | UUID」;人物结果为「ID | Name | Photo Count」。默认导出路径为 /tmp/photo_export.jpg。

使用方式示例(查看照片):先用 scripts/photos-recent.sh 1 获取 UUID,再用 scripts/photos-export.sh "UUID" 导出,然后在 /tmp/photo_export.jpg 查看。

限制与说明:日期格式为 YYYY-MM-DD 或 YYYY-MM-DD HH:MM;内容搜索使用机器学习,较慢(约 5-10 秒),日期/人物搜索较快(约 100ms);HEIC 在导出时自动转换为 JPEG;名称搜索不区分大小写且支持部分匹配。