Self-hosted personal gallery application with online photo management and albums, supporting Live/Motion Photos, EXIF parsing, geolocation recognition, and an explore map.
TypeScript albumsexif-extractiongeocodinglive-photomotion-photophoto-galleryphoto-sharingwebgl-viewer
feat(exif): 新增颜色空间推断,当 EXIF 中没有ColorSpace 信息时从 ICC 配置文件解析颜色空间信息
Timothy Yin98f1655058e7
diff --git a/server/services/image/exif.ts b/server/services/image/exif.tsindex 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) {