mcpField
A
apple-photos

apple-photos

github.com/sundial-org创意与媒体67059 次安装34 周前更新
代码仓库

关于 apple-photos

apple-photos 是一组通过 SQLite 查询 Apple Photos 图库的脚本，适合需要检查相册、人物和照片的用户。它支持按人物、内容或日期搜索，并可导出照片。

主要功能

  1. 01查看图库统计和相册
  2. 02列出近期照片和人物
  3. 03按人物、内容或日期搜索
  4. 04获取照片信息
  5. 05导出照片并转换 HEIC

适用场景

  1. 01查看图库照片数量
  2. 02按人物或日期查找照片
  3. 03按照片内容搜索
  4. 04导出照片以供查看

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/sundial-org/awesome-openclaw-skills --skill apple-photos

安装后在 Claude Code 中输入/apple-photos确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

scripts/
photos-count.sh
photos-export.sh
photos-info.sh
photos-list-albums.sh
photos-list-people.sh
photos-recent.sh
photos-search-content.sh
photos-search-date.sh
photos-search-person.sh

详细介绍

Apple Photos

通过 SQLite 查询访问 Photos.app。从以下目录运行脚本：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

工作流：查看照片

  1. 获取 UUID：scripts/photos-recent.sh 1
  2. 导出：scripts/photos-export.sh "UUID"
  3. 查看 /tmp/photo_export.jpg

备注

  • 日期格式：YYYY-MM-DD 或 YYYY-MM-DD HH:MM
  • 内容搜索使用机器学习，速度比按日期/人物搜索慢（约 5–10 秒；后者约 100 毫秒）
  • 导出时会自动将 HEIC 转换为 JPEG
  • 人名搜索不区分大小写，并支持部分匹配

评论

支持 Markdown