A FIELD GUIDE FOR A TIDIER LIBRARY
OmniRaw 使用文件
給 RAW + JPEG 工作流程的選片與整理指南。每一個動作都從「照片群組」而不是「單一檔案」開始。
快速開始
- 開啟資料夾。 OmniRaw 會遞迴掃描目前選定的資料夾，將可辨識的檔案整理成群組。
- 在瀏覽畫面篩選。 以名稱、路徑、配對狀態或排序方式快速找到要處理的照片。
- 進入選片。 用方向鍵前進或後退，按
Delete、J、R或Space建立標記。 - 審閱後再移除。 Review 會列出確切檔案；確認後才送入作業系統回收桶。
提示：
F5 在任何畫面都會重新掃描目前資料夾，並保留仍然有效的標記。選片快捷鍵
選片畫面讓雙手留在鍵盤上：先快速建立意圖，再到 Review 做精確確認。
| 按鍵 | 動作 |
|---|---|
| ← / → | 上一張／下一張照片群組 |
| Delete / Backspace / X | 切換整組刪除標記，並自動前進 |
| J | 只標記非 RAW 檔案（JPEG、PNG、HEIC 等） |
| R | 只標記 RAW 檔案 |
| Space | 切換目前預覽檔案的單一標記 |
| P / ↑ / ↓ | 在同一群組的相機 JPEG、輸出檔與 RAW 間輪播 |
| U | 取消整組標記 |
| Enter / Esc | 前往審閱／返回瀏覽 |
| F5 | 重新掃描目前資料夾 |
配對規則
同資料夾、同 basename
預設情況下，位於同一資料夾且 basename 不分大小寫相同的檔案會形成群組。例如 IMG_0001.CR3 與 IMG_0001.JPG 是同一張照片。
輸出檔前綴配對
若非 RAW 檔名為某個 RAW 檔名加上非英數分隔符與後綴，OmniRaw 會把它歸入相同群組。例如 IMG_0001_edit.jpg 會跟隨 IMG_0001.CR3；最長相符的 RAW 名稱優先，因此 IMG_00010.jpg 不會誤配。
同層資料夾配對
你可在設定中開啟 sibling-folder matching，並明確指定 raw、jpeg、exports 等資料夾名稱；未列出的同層資料夾不會被自動合併。
孤兒檔清理與 RAW → JPG
Orphan Cleanup 會分別顯示沒有非 RAW 配對的 RAW-only 群組，以及沒有 RAW 配對的 JPG-only 群組。你可批次標記，也可以先進入選片檢視內容。
對 RAW-only 群組，OmniRaw 能輸出 RAW 的嵌入式 JPEG 預覽到 RAW 同一資料夾。現有檔案絕不覆寫；若同名 JPG 已存在，會建立 _converted-N 版本，接著自動重掃。
設定
設定會儲存在應用程式資料目錄，並在下一次掃描時生效。
| 設定 | 用途 |
|---|---|
rawExtensions | 列出要視為 RAW 的副檔名。 |
nonRawExtensions | 列出要視為非 RAW 的副檔名，例如 JPG、PNG、HEIC。 |
defaultDeleteMode | 控制 Delete 鍵預設標記整組、非 RAW 或 RAW。 |
matchExportedSuffixes | 控制輸出檔前綴配對，預設啟用。 |
matchSiblingFolders | 控制明確列出的同層資料夾是否可互相配對，預設關閉。 |
language | 切換繁中或 English 介面。 |
安全與已知限制
- 只進回收桶。 v1 沒有永久刪除命令；所有刪除皆透過 Windows Recycle Bin 或 macOS Trash。
- 路徑被限制於掃描根目錄。 所有前端傳入路徑都會 canonicalize，並檢查是否仍在目前 scan root。
- 既有 XMP 不覆寫。 寫入星等只會建立新的 sidecar；碰到既有檔案會明確拒絕。
- HEIC/HEIF 依賴系統解碼器。 macOS 使用 ImageIO；Windows 需要 Microsoft HEIF Image Extensions，缺少時會顯示預覽錯誤。
- RAW → JPG 不是完整顯影。 目前輸出的是 RAW 內嵌預覽，目標是快速選片，不是替代 RAW 轉檔軟體。
刪除稽核： 每次完成的刪除會追加寫入 JSONL，並重建 manifest。若稽核寫入失敗，已完成的刪除不會被前端重試。