苹果照片库管理

技能简介

通过SQLite直接访问macOS系统照片库，无需打开Photos.app即可完成相册浏览、按日期/人物/内容搜索、照片信息查看及导出等操作。

能做什么

• 列出所有相册和人物分类
• 按日期范围检索照片
• 通过人物名称查找相关照片
• 使用自然语言描述搜索画面内容（基于机器学习）
• 导出指定UUID的照片为JPEG格式
• 获取照片库统计信息

使用说明

前置要求

1. 打开 系统设置 → 隐私与安全性 → 完全磁盘访问权限
2. 将终端应用（Terminal.app或iTerm等）添加到允许列表

安装步骤

1. 克隆技能仓库到本地目录
2. 进入技能目录：cd {baseDir}
3. 确保脚本具有执行权限：chmod +x scripts/*.sh

常用命令示例

# 查看最近10张照片
scripts/photos-recent.sh 10

# 搜索包含"海滩"的照片（限20张）
scripts/photos-search-content.sh "海滩" 20

# 导出指定照片到桌面
scripts/photos-export.sh "UUID-HERE" ~/Desktop/photo.jpg

日期格式：YYYY-MM-DD 或 YYYY-MM-DD HH:MM；内容搜索耗时约5-10秒，日期/人物搜索约100毫秒。

输入与输出

见下方输入与输出表格。

风险提示

• 需要授予终端完全磁盘访问权限，涉及系统隐私设置变更
• 直接操作SQLite数据库存在误删风险，建议仅使用提供的脚本
• HEIC格式导出时自动转为JPEG，可能损失部分元数据
• 内容搜索依赖本地机器学习模型，首次使用可能触发索引重建

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/tyler6204/apple-photos/SKILL.md
来源类型：GitHub开源项目