Lap RAW+JPEG 配对机制详解：无损原片与压缩图从此不分离
【免费下载链接】lapAn offline-first photo manager for large local libraries项目地址: https://gitcode.com/GitHub_Trending/lap3/lap
Lap 是一款离线优先的本地照片管理工具，专为海量照片库设计。它内置的RAW+JPEG 配对机制会自动将同一张拍摄的无损原片（RAW）与压缩图（JPEG/HEIC）识别为一组，让原片与预览图始终"形影不离"——不再重复占位、不再丢失关联，浏览与导出时自动选对文件。
痛点：RAW 和 JPEG 各显各的，管理起来有多乱？
用相机"RAW + 大/小 JPEG"双格式拍摄时，一个文件夹里同一张照片会变成两个文件：
- RAW（如
.CR2、.NEF、.ARW）：无损数据，体积大，适合后期 - JPEG/HEIC：压缩预览图，体积小，适合快速浏览和分享
传统方式下，照片管理器往往把它们当成两张独立的照片，造成：网格重复显示、选 RAW 时却加载不了缩略图、删除 JPEG 后 RAW 变"孤儿"等一堆麻烦。
Lap 的解法是：按文件名自动配对，把两者绑定成一个逻辑条目。
配对是如何实现的：按文件名"一键匹配"
配对逻辑在扫描索引阶段执行，核心函数pair_raw_jpeg_in_folder会遍历每个文件夹，按以下规则匹配：
| 规则 | 说明 |
|---|---|
| 同名匹配 | 以文件主名（不含扩展名）为准，忽略大小写，如DSC0001.CR2↔DSC0001.jpg |
| 压缩图范围 | 支持jpg、jpeg、heic、heif、hif作为配对伙伴 |
| 唯一性要求 | 同一主名下只有恰好 1 个 RAW + 1 个压缩图才会配对，避免误绑 |
| 失效自动解除 | 伙伴文件被移出或删除后，重新扫描即可自动清除配对关系 |
配对成功后，RAW 文件会在索引数据库中标记为raw_jpeg_pair子类型，并记录其压缩伙伴的 ID（逻辑上复用了 Live Photo 的伴生文件字段）。相关实现位于 pair_raw_jpeg_in_folder。
💡 注意：配对的前提是相册同时纳管了"图片"和"RAW 文件"两种类型；若相册只允许其中一种，Lap 会主动清除该文件夹下的旧配对，保证数据一致。
支持哪些 RAW 格式？
Lap 内置了一份覆盖主流厂商的 RAW 扩展名清单（RAW_IMGS），包括：
- 佳能：CR2 / CR3 / CRW
- 尼康：NEF / NRW
- 索尼：ARW / SR2
- 富士：RAF、松下：RW2、奥林巴斯：ORF
- 通用：DNG（Adobe 通用 RAW）、PEF、SRW、MOS 等
也就是说，无论相机品牌，只要命名习惯是"同名双格式"，就能被自动识别。
配对后你能得到什么？三个直观体验
1️⃣ 缩略图角标：一眼看出"这是一对"
配对的 RAW 文件在网格缩略图角落会显示RAW+JPEG（或RAW+HEIC）角标，鼠标扫过就知道它背后绑定了压缩图。角标逻辑见 Thumbnail.vue。
2️⃣ 合并显示：网格不再"一人占两坑"
在排序/显示选项中开启**"合并显示 RAW 配对"**（对应group_raw_jpeg_pairs索引参数），同名 RAW 与 JPEG 会合并为一个条目，网格立刻清爽一倍。该选项随索引参数传入 index_album，重新索引即可生效。
3️⃣ 智能"替身"：用 RAW，看 JPEG
这是最实用的一环——系统知道"RAW 是数据本体，JPEG 是展示替身"：
- 设桌面壁纸：右键 RAW 选择设壁纸时，Lap 会自动改用其 JPEG/HEIC 伙伴（系统壁纸不支持 RAW），实现逻辑见 clickSetDesktopWallpaper 与 set_desktop_wallpaper
- 文件信息面板：选中 RAW 时可查看其压缩伙伴详情（FileInfo.vue）
- 智能相册：可按
raw_jpeg_pair子类型筛选，快速找出"所有已成对的拍摄"，方便核查哪些照片缺伙伴 - 复制/导出：复制 RAW 时会自动带上压缩伙伴，10 个条目限额按"配对展开"计算
如何让自己的照片库享受配对？
- 保持同名习惯：相机或导出工具导出的 RAW 与 JPEG 必须主名一致（这是唯一硬性条件）
- 相册类型包含 RAW：在相册设置中同时勾选"图片"和"RAW 文件"两种文件类型
- 执行索引：在 Lap 中扫描或重新索引该文件夹，配对会在扫描过程中自动建立、更新或解除
全程无需手动操作，配对关系由索引驱动，文件增删后重新扫描即可自愈。
总结
Lap 的 RAW+JPEG 配对机制用一条简单的规则——同名即一对——解决了 RAW 工作流中最常见的管理混乱：缩略图角标让你一眼识别，合并显示让网格保持整洁，"智能替身"则在壁纸、导出等场景自动选对文件。对以 RAW 为主力格式、管理数万张照片的摄影用户来说，这套离线、自动、零配置的机制让无损原片与压缩预览图从此不分离。
📁 想了解更多，可查阅官方文档 getting-started 与 版本更新日志。
【免费下载链接】lapAn offline-first photo manager for large local libraries项目地址: https://gitcode.com/GitHub_Trending/lap3/lap
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
