企业官网建设流程全解析

RAWmakase 是一款免费、快速、兼容 Lightroom 的 RAW 照片编辑器（支持 Linux、macOS 与 Windows），除了桌面图形界面，它还内置了一组实用的命令行工具：inspect检查 RAW 文件元数据、render一行命令完成渲染导出、thumbnail提取相机内嵌预览、fingerprint输出解码指纹用于回归校验。本文带你快速上手这 4 个最常用子命令，让你不打开 GUI 也能批量处理照片。

一、先了解：rawmakase 的两种启动方式

安装 RAWmakase 后（参考 README.md 中的安装说明），你会得到一个统一的rawmakase命令，它根据是否带子命令决定行为：

rawmakase # 不带参数：启动图形界面，重开上次的光目录 rawmakase photo.dng # 传一张照片：加入最近的光目录并打开编辑 rawmakase inspect photo.dng # 带子命令：执行命令行操作 rawmakase help # 查看全部子命令与参数帮助

所有 CLI 子命令的解析与分发都在 src/main.rs 中定义，想看完整参数列表随时运行rawmakase --help。

二、inspect：给 RAW 文件做一次"体检"

inspect打开一张 RAW 文件并打印它的完整元数据，适合在渲染前确认相机、白平衡、色彩矩阵等信息是否正确读出：

rawmakase inspect photo.dng

输出内容包括两部分：

• 标准输出：当前 LibRaw 版本 + 格式化的 JSON 元数据（相机型号、尺寸、裁剪区域、白平衡、色彩矩阵等）；
• 标准错误输出：本机可用的相机配置文件（camera profile）列表及读取错误，方便排查"为什么这张照片颜色不对"。

💡 小技巧：把 JSON 部分重定向到文件，再配合jq批量查看一批照片的白平衡值：

rawmakase inspect photo.dng 2>/dev/null | jq '.wb'

三、render：不开 GUI，一行命令渲染导出

这是 CLI 中最实用的命令——把 RAW 直接渲染为 JPEG 或 16-bit TIFF（由输出文件扩展名决定），导出始终为 sRGB 色彩空间。

基本用法

rawmakase render photo.dng edited.jpg rawmakase render photo.dng edited.tiff --exposure 0.7 --max-edge 2400

常用参数速查表

渲染的"起点"规则

render的编辑起点按以下优先级确定（见 src/main.rs）：

1. 指定了--recipe时，使用该预设；
2. 否则读取照片旁的旧版 sidecar 编辑文件（如photo.dng.rawmakase.json）；
3. 都没有时，使用相机默认外观 + 已安装的相机配置文件。

--xmp则是在起点之上叠加一个 XMP 预设，预设里没写的参数保留起点值。

看懂输出状态行

渲染完成后会打印一行统计，例如：

6000x4000 | develop 1.823s | render 0.412s | total 2.431s | camera max 65535.0000 | scale 1.000000 | integer clipped false

依次为：输出尺寸、解码耗时、渲染耗时、总耗时、相机满阱值、缩放系数、是否发生整数裁剪——排查"渲染变慢"或"高光溢出"问题非常有用。

⚠️ 注意：默认情况下输出文件已存在会直接报错，加--overwrite才会覆盖。

四、thumbnail：秒级提取相机内嵌预览

RAW 文件内嵌了一张相机生成的 JPEG 预览。thumbnail子命令把它原样提取出来，速度快到几乎无感，适合做快速浏览、批量缩略图或网页占位图：

rawmakase thumbnail photo.dng preview.jpg

实现位于 crates/rawmakase-native/src/raw/mod.rs：它会读取内嵌 JPEG，并按相机 EXIF 方向信息自动摆正（横置照片不会输出倒着的图）。

注意两点：

• 输出文件已存在时会直接失败（使用create_new创建），这是防止误覆盖的保护；
• 提取的是拍摄时的预览，不包含任何 RAWmakase 的后期调整——想要完整渲染请用render。

五、fingerprint：为 RAW 解码建立"回归基线"

fingerprint是面向开发者和重度用户的硬核命令：它打开每个 RAW 文件、完整解包传感器数据，然后以 JSON 行的形式打印出一份"解码指纹"：

rawmakase fingerprint *.NEF > fingerprints.json

每个文件一行 JSON，包含关键字段（定义见 crates/rawmakase-native/src/fingerprint.rs）：

• sha256：文件字节哈希；
• make/model/size/crop：相机与可见区域；
• wb/camera_matrix：拍摄时白平衡与相机色彩矩阵；
• cfa：拜尔/X-Trans 像素阵列模式（如RG/gB）；
• black/white/data_sha256：黑场、白场水平与解包数据的哈希。

它不做去马赛克，因此结果在任何机器上都完全一致。典型用途：升级 LibRaw 或 RAWmakase 版本前后各跑一次，diff 两份指纹，即可立刻发现解码行为是否发生了变化。仓库自带的测试数据就靠这个机制对比（见 scripts/corpus/dataset-fingerprints.py）。

六、实战组合与延伸命令

几个日常高频组合：

# 全尺寸自动色调，导出 JPEG rawmakase render photo.dng auto.jpg --auto # 快速出小样：半分辨率解码 + 长边限制 2400 rawmakase render photo.dng web.jpg --fast --max-edge 2400 # 套用 Lightroom 预设渲染，并保存配方以便复现 rawmakase render photo.dng out.tiff --xmp Warm.xmp --save-recipe recipe.json # 同一张照片渲染多个预设版本（对比用） rawmakase render-batch photo.dng jobs.json

render-batch的jobs.json是一个 JSON 数组，每项包含{"xmp", "output", "max_edge"}三个字段，照片只解码一次、渲染多次，适合和 Camera Raw 的成品做对比评测。

除本文主角外，CLI 还提供不少辅助命令（运行rawmakase --help查看完整列表）：

• import-catalog Lightroom.lrcat Photos.rawmakase：非破坏性导入 Lightroom 目录；
• import-profiles *.dcp：批量导入相机配置文件；
• benchmark photo.dng --iterations 50：测量渲染性能。

📖 如果你的目标是脚本化控制正在运行的编辑器（而非离线渲染），请参阅 docs/automation.md 和 docs/mcp.md；更多模块与命令的对应关系可在 docs/code-map.md 中查找。