用途:在 macOS 上通过 SQLite 查询访问 Apple 照片图库,提供命令行脚本完成统计、浏览、搜索和导出。
主要能力:查看图库统计、列出相册、获取最近照片、列出人物、按人物/内容/日期搜索、查看照片信息、导出照片。输出格式:最近/搜索结果为“文件名 | 日期 | 类型 | UUID”;人物为“ID | 名称 | 照片数量”;默认导出路径为 /tmp/photo_export.jpg。
使用方式:需从 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]。查看照片流程:先用 scripts/photos-recent.sh 1 获取 UUID,再执行 scripts/photos-export.sh "UUID",查看 /tmp/photo_export.jpg。
限制:需要为终端开启完全磁盘访问权限(系统设置 → 隐私与安全性 → 完全磁盘访问权限)。日期格式为 YYYY-MM-DD 或 YYYY-MM-DD HH:MM。内容搜索使用 ML,较慢(约 5-10 秒),日期/人物搜索约 100 毫秒。导出时 HEIC 自动转换为 JPEG。名称搜索不区分大小写,支持部分匹配。未提供收费、价格或平台支持范围等信息。