技术深度解析
osxphotos通过直接读取位于`.photolibrary`包（通常路径为`~/Pictures/Photos Library.photoslibrary/database/Photos.sqlite`）内的`Photos.sqlite`数据库来运行。这个SQLite数据库是苹果的私有架构，未公开文档且随时可能变更。该库逆向工程了超过40张表，包括`ZASSET`、`ZGENERICASSET`、`ZADDITIONALASSETATTRIBUTES`、`ZPERSON`、`ZKEYWORD`和`ZALBUM`。每张表都映射到苹果内部的Core Data实体。
架构亮点：
- 只读设计： osxphotos从不写入照片数据库，从而防止数据损坏。所有修改都在导出的副本或侧边栏文件上进行。
- 基于UUID的链接： 每张照片和视频都有一个持久的`uuid`（在数据库中存储为`ZUUID`）。osxphotos利用此ID跨表关联资源，确保即使文件被移动，元数据完整性也不受影响。
- 人脸检测数据： 该库提取人脸区域（`ZFACE`表），包含坐标、置信度分数和人物姓名（来自`ZPERSON`）。这实现了自动人脸标记工作流，而苹果的UI仅允许手动确认。
- 侧边栏文件生成： 用户可以将元数据导出为XMP侧边栏文件（兼容Adobe）、JSON或CSV。XMP侧边栏文件包含关键词、标题、描述、GPS坐标和人脸区域——这对Lightroom和Capture One的集成至关重要。
- 模板系统： 强大的模板引擎允许使用`{title}`、`{created.date}`、`{keyword}`、`{album}`、`{face.name}`以及自定义Python函数进行动态文件命名。示例：`osxphotos export /output --filename "{created.year}-{created.month}-{original_name}"`。
性能基准测试：
| 操作 | 库大小（10,000张照片） | 时间（macOS 14, M2 Pro） |
|---|---|---|
| 数据库扫描（仅元数据） | 10,000个资源 | 3.2秒 |
| 完整导出（JPEG + 元数据） | 1,000张照片 | 2分14秒 |
| 人脸检测导出（XMP） | 500张照片，含1,200张人脸 | 45秒 |
| JSON元数据转储 | 10,000个资源 | 8.7秒 |
数据要点： osxphotos在纯元数据操作上速度极快，但导出速度受限于磁盘I/O和图像解码。由于SQLite索引的存在，数据库扫描时间呈亚线性增长，使其适用于多达50万以上资源的库。
值得关注的开源仓库：
- rhettbull/osxphotos (⭐3,608)：主仓库。最近的提交包括对macOS 15 Sequoia新`Photos.sqlite`架构变更的支持，以及改进的人脸检测精度。
- RhetTbull/osxphotos_exportdb (⭐45)：一个配套工具，用于跟踪导出状态，防止重复导出未更改的文件。
- RhetTbull/osxphotos_utils (⭐12)：用于批量操作的实用脚本，如去重和相册重组。
工程挑战： 苹果的数据库架构随每次macOS大版本更新而变化。例如，macOS 14 Sonoma引入了`ZASSET.ZDATECREATED`作为新的时间戳列，同时弃用了`ZADDITIONALASSETATTRIBUTES.ZDATEADDED`。osxphotos维护了一个架构版本检测系统，可动态调整查询。该项目的测试套件针对来自不同macOS版本的20多个数据库快照运行。
关键人物与案例研究
创建者：Rhett Bullock
Rhett Bullock是一名软件工程师兼摄影师，他于2018年因对苹果导出限制感到沮丧而启动了osxphotos项目。他作为唯一的维护者，与15名以上的活跃贡献者共同维护该项目。他优先考虑向后兼容性和详尽文档（超过200页）的做法，对项目的采用至关重要。Bullock关于逆向工程苹果数据库的博客文章在macOS开发者社区中被视为权威。
案例研究：某大学的媒体资产管理
加州大学伯克利分校的新闻学院使用osxphotos将学生摄影师拍摄的5万多张照片导入中央数字资产管理系统（ResourceSpace）。此前，学生通过苹果的UI导出照片，导致关键词和人脸标签丢失。借助osxphotos，他们运行一个夜间脚本，将完整元数据导出为JSON，然后通过API导入。结果：元数据保留率达到100%，手动标记时间减少了80%。
竞争格局：
| 工具 | 方法 | 元数据访问 | 导出格式 | 价格 |
|---|---|---|---|---|
| osxphotos | 直接SQLite解析 | 完整（EXIF、人脸、关键词、相册、位置） | JPEG, TIFF, PNG, HEIC, RAW, XMP, JSON, CSV | 免费（MIT） |
| Apple Photos Export | 原生UI | 有限（仅EXIF，无人脸/关键词） | JPEG, TIFF, PNG, HEIC, RAW | 免费（捆绑） |
| ExifTool by Phil Harvey | 文件级元数据 | 仅EXIF（无苹果特定字段） | 所有格式 | 免费（Perl） |
| PowerPhotos (Fat Cat Software) | GUI工具 | 部分（关键词、相册） | JPEG, TIFF, PNG | $29.99 |
| Photo Library Manager (iMazing) | GUI工具 | 部分（相册、位置） | JPEG, HEIC | $39.99 |
数据要点： osxphotos是唯一提供程序化访问苹果照片库完整元数据的工具，且完全免费开源。