Skip to content

Self-hosted personal gallery application with online photo management and albums, supporting Live/Motion Photos, EXIF parsing, geolocation recognition, and an explore map.

feat(exif): 新增颜色空间推断,当 EXIF 中没有ColorSpace 信息时从 ICC 配置文件解析颜色空间信息

Timothy Yin98f1655058e7
diff --git a/server/services/image/exif.ts b/server/services/image/exif.ts
index c7853c12..8fa10d90 100644
--- a/server/services/image/exif.ts
+++ b/server/services/image/exif.ts
@@ -88,6 +88,148 @@ const formatExifDate = (date: string | ExifDateTime | undefined) => {
return date.toISOString()
}
+/**
+ * 从 Sharp metadata 中推断颜色空间信息
+ */
+const inferColorSpaceFromMetadata = (metadata: Metadata): string | undefined => {
+ // 优先使用 ICC 配置文件信息
+ if (metadata.icc) {
+ const colorSpace = parseICCProfile(metadata.icc)
+ if (colorSpace) {
+ return colorSpace
+ }
+ }
+
+ // 根据图片格式和通道数推断
+ if (metadata.space) {
+ const colorSpace = mapSharpSpaceToColorSpace(metadata.space)
+ if (colorSpace) {
+ return colorSpace
+ }
+ }
+
+ // 根据图片类型的默认颜色空间
+ if (metadata.format) {
+ const colorSpace = getDefaultColorSpaceForFormat(metadata.format)
+ if (colorSpace) {
+ return colorSpace
+ }
+ }
+
+ return undefined
+}
+
+/**
+ * 解析 ICC 配置文件以确定颜色空间
+ */
+const parseICCProfile = (iccBuffer: Buffer): string | undefined => {
+ try {
+ const iccString = iccBuffer.toString('latin1')
+
+ // 常见的颜色空间标识符
+ if (iccString.includes('sRGB') || iccString.includes('IEC61966-2.1')) {
+ return 'sRGB'
+ }
+ if (iccString.includes('Adobe RGB') || iccString.includes('ADOBERGB')) {
+ return 'Adobe RGB'
+ }
+ if (iccString.includes('Display P3') || iccString.includes('P3')) {
+ return 'Display P3'
+ }
+ if (iccString.includes('ProPhoto') || iccString.includes('ROMM')) {
+ return 'ProPhoto RGB'
+ }
+ if (iccString.includes('Wide Gamut') || iccString.includes('WideGamut')) {
+ return 'Wide Gamut RGB'
+ }
+ if (iccString.includes('Rec2020') || iccString.includes('ITU-R BT.2020')) {
+ return 'Rec. 2020'
+ }
+ if (iccString.includes('DCI-P3') || iccString.includes('DCI')) {
+ return 'DCI-P3'
+ }
+ if (iccString.includes('Rec709') || iccString.includes('ITU-R BT.709')) {
+ return 'Rec. 709'
+ }
+
+ // 检查 ICC 配置文件头部的颜色空间签名(偏移量 16-19)
+ if (iccBuffer.length >= 20) {
+ const colorSpaceSignature = iccBuffer.toString('ascii', 16, 20)
+ switch (colorSpaceSignature) {
+ case 'RGB ':
+ return 'RGB'
+ case 'CMYK':
+ return 'CMYK'
+ case 'GRAY':
+ return 'Grayscale'
+ case 'LAB ':
+ return 'Lab'
+ case 'XYZ ':
+ return 'XYZ'
+ default:
+ break
+ }
+ }
+ } catch {
+ // 忽略解析错误,继续尝试其他方法
+ }
+
+ return undefined
+}
+
+/**
+ * 将 Sharp 的 space 映射到标准颜色空间名称
+ */
+const mapSharpSpaceToColorSpace = (space: string): string | undefined => {
+ switch (space) {
+ case 'srgb':
+ return 'sRGB'
+ case 'rgb16':
+ return 'RGB'
+ case 'cmyk':
+ return 'CMYK'
+ case 'lab':
+ return 'Lab'
+ case 'xyz':
+ return 'XYZ'
+ case 'grey16':
+ case 'b-w':
+ return 'Grayscale'
+ default:
+ return undefined
+ }
+}
+
+/**
+ * 根据图片格式获取默认颜色空间
+ */
+const getDefaultColorSpaceForFormat = (format: string): string | undefined => {
+ const formatLower = format.toLowerCase()
+ switch (formatLower) {
+ case 'jpeg':
+ case 'jpg':
+ return 'sRGB' // JPEG 默认使用 sRGB
+ case 'png':
+ return 'sRGB' // PNG 通常使用 sRGB
+ case 'webp':
+ return 'sRGB' // WebP 通常使用 sRGB
+ case 'tiff':
+ case 'tif':
+ return 'sRGB' // TIFF 可能使用各种颜色空间,默认 sRGB
+ case 'heif':
+ case 'heic':
+ return 'Display P3' // HEIC 通常支持 Display P3
+ case 'avif':
+ return 'sRGB' // AVIF 通常使用 sRGB,但也可能支持其他
+ case 'gif':
+ return 'sRGB' // GIF 使用 sRGB
+ case 'bmp':
+ return 'sRGB' // BMP 通常使用 sRGB
+ default:
+ return undefined
+ }
+}
+
const processExifData = (exifData: Tags, metadata: Metadata): NeededExif => {
const date = {
DateTimeOriginal: formatExifDate(exifData.DateTimeOriginal),
@@ -101,6 +243,7 @@ const processExifData = (exifData: Tags, metadata: Metadata): NeededExif => {
ImageWidth: exifData.ExifImageWidth || metadata.width,
ImageHeight: exifData.ExifImageHeight || metadata.height,
}
+
const result: any = structuredClone(exifData)
for (const key in result) {
Reflect.deleteProperty(result, key)
@@ -109,6 +252,14 @@ const processExifData = (exifData: Tags, metadata: Metadata): NeededExif => {
result[key] = (exifData as any)[key]
}
+ // 如果 EXIF 中没有 ColorSpace,尝试从图片数据中推断
+ if (!result.ColorSpace) {
+ const inferredColorSpace = inferColorSpaceFromMetadata(metadata)
+ if (inferredColorSpace) {
+ result.ColorSpace = inferredColorSpace
+ }
+ }
+
return {
...date,
...size,
@@ -150,6 +301,18 @@ export const extractExifData = async (
const exifData = await exiftool.read(tempImagePath)
const result = processExifData(exifData, metadata)
+ // 记录颜色空间信息的来源
+ if (result.ColorSpace) {
+ if (exifData.ColorSpace) {
+ logger?.info(`ColorSpace from EXIF: ${result.ColorSpace}`)
+ } else {
+ logger?.info(`ColorSpace inferred from image data: ${result.ColorSpace}`)
+ logger?.info(`Image format: ${metadata.format}, Space: ${metadata.space}, Has ICC: ${!!metadata.icc}`)
+ }
+ } else {
+ logger?.warn('No ColorSpace information available')
+ }
+
await unlink(tempImagePath).catch(noop)
return result
} catch (err) {