XMP 辅助文件

Immich 可以在文件上传时（通过 CLI）提取 XMP 辅助文件，也可以检测在文件系统中为现有图片放置的新辅助文件。

XMP 辅助文件是包含与媒体文件相关的元数据的外部 XML 文件。许多应用程序会专门读写这些文件，或者将其作为写入图像文件元数据的补充工具使用。它们是一个非常强大的工具，可以编辑和存储媒体文件的元数据，而无需修改媒体文件本身。当 Immich 接收或检测到媒体文件的 XMP 辅助文件时，它将尝试同时从辅助文件和媒体文件中提取元数据。对于字段中的元数据，它将优先使用辅助文件中的数据，但如果必要的话会回退并使用媒体文件中的元数据。

当通过 CLI 批量上传器导入文件或为外部库解析照片元数据时，Immich 将自动检测作为原始媒体文件旁边存在的文件的 XMP 辅助文件。Immich 会查找与照片同名但扩展名为 .xmp 的文件。同名可以包括照片的文件扩展名，也可以不包括。例如，对于名为 PXL_20230401_203352928.MP.jpg 的照片，Immich 会查找名为 PXL_20230401_203352928.MP.jpg.xmp 或 PXL_20230401_203352928.MP.xmp 的 XMP 文件。如果同时存在 PXL_20230401_203352928.MP.jpg.xmp 和 PXL_20230401_203352928.MP.xmp，Immich 会优先使用 PXL_20230401_203352928.MP.jpg.xmp。

与辅助文件相关联有两个管理员任务: SYNC 和 DISCOVER。同步任务会重新扫描所有存在辅助文件的媒体，并将它们排队以刷新元数据。当第三方应用程序用于修改媒体元数据时，这是一个很好的使用场景。发现任务将尝试扫描文件系统以查找所有当前未关联辅助文件的媒体的新辅助文件。