用 PhotoCraft 的 RAW 显影编辑相机 RAW 照片
PhotoCraft v0.23.1 怎么打开和冲洗相机 RAW：RAW 显影窗口和各个面板、胶片栏和“完成”按钮、XMP 附属文件和 Lightroom 裁剪、RAW 默认设置、RAW 显影滤镜、批处理和命令行用法、支持的相机，以及已知限制。
在 PhotoCraft 里编辑 RAW 照片，用 文件 › 打开…（Ctrl+O，Mac 上是 ⌘O）打开，或者直接拖进窗口。文件不会马上打开，而是先进入 RAW 显影（RAW Develop）窗口：左边是预览，右边是各个调整面板。调好白平衡和曝光，再按需要调其他参数，然后点 打开（Open）。照片会作为普通的 16 位文档打开（没改过默认设置的话是 Adobe RGB），之后就像编辑其他图片一样。点 取消（Cancel）则关掉它。PhotoCraft 有自己的 RAW 解码器，是照着公开规范写的，所以不需要 Adobe 的软件、编解码器或插件。它免费、离线可用，也不用注册账号。
本文按 PhotoCraft v0.23.1（2026 年 11 月 12 日）编写。v0.22.0（11 月 9 日）给这个功能改了名，能解码更多相机的文件，还新增了胶片栏、完成（Done）按钮和附属文件里的裁剪；v0.23.0（11 月 11 日）能解码压缩的富士文件，并把更多预览计算交给 GPU。RAW 窗口本身从 v0.6.0 起就有。可以在下载页下载 PhotoCraft；在线编辑器运行的也是 v0.23.1，差别见下文。其他文件类型见文件格式。
Camera Raw 改名为 RAW 显影
从 v0.22.0 起，PhotoCraft 把自己的 RAW 处理功能叫作 RAW 显影（RAW Develop）（#12403）。较早的发布说明、issue 和本站以前的版本里写的是 Camera Raw，指的是同一个功能：
| v0.22.0 之前 | v0.22.0 起 |
|---|---|
| Camera Raw 窗口 | RAW 显影（RAW Develop），标题为“RAW 显影（文件名）” |
| 滤镜 › Camera Raw 滤镜… | 滤镜 › RAW 显影滤镜…（Filter › RAW Develop Filter…，Ctrl+Shift+A，Mac 上是 ⌘⇧A），标题为“RAW 显影滤镜（图层名）” |
| 编辑 › 首选项 › Raw 默认设置… | 编辑 › 首选项 › RAW 默认设置…（Edit › Preferences › RAW Defaults…） |
改的只是界面上看到的名字。命令 ID 仍是 filter.cameraRaw，首选项 ID 和保存的设置也没变，所以脚本和旧的首选项照常能用。文档保留保存时的滤镜名称。Photoshop 动作文件自己存着步骤名，所以从 .atn 载入的 Camera Raw 步骤仍叫 Photoshop 的“Camera Raw Filter”，存回时原样不变。设置文件和附属文件仍是 Adobe Camera Raw 的 .xmp 文件，用 Adobe 的 crs: 命名空间；处理这些文件的按钮提示里仍写“Camera Raw .xmp 文件”，因为这就是它们的格式（feature-names.md）。
能打开哪些 RAW 文件
PhotoCraft 识别 .dng、.cr2、.cr3、.nef、.nrw、.arw、.srf、.sr2、.pef、.orf、.rw2、.raf、.3fr 和 .fff。大多数文件会解码传感器数据；有些类型只能打开相机存在文件里的 JPEG 预览图：
| 格式 | 从传感器数据冲洗 | 只能打开内嵌预览图 |
|---|---|---|
| DNG | 无压缩、Deflate、无损 JPEG、有损 JPEG 和 JPEG XL（DNG 1.7，仅桌面版）；彩色和单色都行 | JPEG XL 以外的浮点数据 |
| 佳能 CR2 | 支持；v0.22.0 起 sRAW 和 mRAW 也支持（#7122） | – |
| 佳能 CR3 | – | 一律如此：不解码 CRX 传感器数据 |
| 尼康 NEF、NRW | 无压缩、无损压缩和有损压缩，12 位和 14 位。v0.22.0 起也支持“lossy after split”文件，上游发现 D3400、D5、D5000、D5200、D5500、D5600、D7000、Nikon 1 J5 和 Z 6_2 会拍出这种文件（#10529） | 高效率（HE 和 HE*） |
| 索尼 ARW、SR2、SRF | 无压缩、无损和压缩（cRAW） | 索尼“Compressed RAW 2” |
| 富士 RAF | 无压缩；v0.23.0 起也支持无损压缩和有损压缩，X-Trans 和拜耳阵列，12、14 和 16 位（#7377） | 早期 FinePix / SuperCCD 文件 |
| 松下 / 徕卡 RW2 | RawFormat 3、4 和 5 | RawFormat 6 及更新的类型 |
| 奥林巴斯 / OM System ORF | 无压缩 16 位（E-1、E-400 等） | 压缩 ORF |
| 宾得 PEF | 无压缩和无损 JPEG | 压缩 PEF |
| 哈苏 3FR、FFF | v0.22.0 新增：无压缩文件，在 X2D II 100C 上实测过（#9058）。其他机身的无压缩文件也能打开，但会警告其滤色阵列排列是推定的 | 早期 X 系列和 H 系列相机的无损 JPEG 文件 |
只能打开预览图的文件会作为 8 位图像打开并给出警告，也不会弹出 RAW 显影窗口：这个窗口只用于从传感器数据冲洗的 RAW。
颜色：DNG 文件自带颜色数据。其他格式里，PhotoCraft 只有一个上游实测的相机配置（尼康 D4）。其余相机从 v0.8.2 起会参照文件里相机存的 JPEG 来拟合每个文件的颜色和影调，效果接近相机直出的 JPEG（#2135）。这只是估算，不是校准。没有可用预览图的文件会得到中性的渲染，看起来比较平淡。把这类文件先转成 DNG 能得到校准过的颜色。
冲洗一张 RAW
- 用 文件 › 打开…、最近打开文件（Open Recent）、拖放或命令行打开 RAW。
- RAW 显影 以独立窗口打开，可以移动和调整大小。完成之前，主窗口会变暗，不接受操作。v0.23.0 起，切回 PhotoCraft（
⌘Tab、程序坞，或点击变暗的窗口）会把 RAW 显影窗口带到最前面，最小化了也会恢复；以前变暗的主窗口可能盖在上面，程序看起来像卡死了（#7119）。 - 调整各个面板。在窗口里
Ctrl+Z（⌘Z）可以撤销；按Y或勾选 调整前（Y）（Before (Y)）可以看没调整时的样子。 - 点 打开 保留，点 取消（或按
Esc）关掉，点 完成 则只保存设置、不打开（见下文）。
打开 不只是套用滑块。如果改过色温、色调、曝光、阴影、高光、清晰度、纹理或去雾，或者换了去马赛克方法，它会从传感器数据重新冲洗，所以白平衡和高光恢复是在线性光下、相机色调曲线之前，作用在 RAW 原始数值上的。其余设置作为一步 RAW 显影滤镜应用。之后 RAW 默认设置 会转换色彩空间和位深，新文档算作未修改。所以白平衡和曝光要在这里调，不要留到之后用滤镜调，滤镜只能看到冲洗好的像素。
各个面板
| 面板 | 控件 |
|---|---|
| 光线（Light，一开始就展开） | 自动（Auto，按图像设置影调滑块），然后是曝光、对比度、高光、阴影、白色色阶和黑色色阶 |
| 颜色（Color） | 白平衡：拍摄时设置（White Balance: As Shot）、色温和色调（以相机白平衡为基准的 −100 到 +100，不是开尔文值）、自然饱和度、饱和度 |
| 效果（Effects） | 纹理、清晰度、去雾；晕影，含样式（高光优先、颜色优先或绘画叠加）、数量、中点、圆度、羽化和高光；颗粒，含数量、大小和粗糙度 |
| 曲线（Curve） | 点曲线（最多 16 个点），以及高光、亮调、暗调和阴影滑块 |
| 颜色混合器（Color Mixer） | 红、橙、黄、绿、浅绿、蓝、紫、洋红八个色段的色相、饱和度和明亮度 |
| 色彩分级（Color Grading） | 阴影、中间调、高光和全局四个色轮，以及混合和平衡 |
| 细节（Detail） | 去马赛克（Demosaic，只在打开 RAW 时出现）：AHD（默认，边缘最干净）、Malvar–He–Cutler 或 Bilinear。富士 X-Trans 文件始终用自己的方法。然后是锐化（数量、半径、细节、蒙版保护）和降噪（明亮度、亮度细节、颜色、颜色细节） |
| 校准（Calibration） | 阴影色调，以及红、绿、蓝原色的色相和饱和度 |
RAW 显影没有的东西：裁剪和拉直、几何校正、镜头配置文件、蒙版、污点去除、相机配置文件、白平衡吸管或“日光”“阴天”这类预设，以及开尔文值。打开之后，滤镜 › 镜头校正…（Filter › Lens Correction…，Ctrl+Shift+R，Mac 上是 ⌘⇧R）和裁剪工具可以在冲洗好的图像上完成其中一部分。
预览、直方图和缩放
面板上方的直方图会显示溢出：U 和 O 打开阴影和高光溢出警告，拖动光线面板的滑块时按住 Alt（⌥）会显示哪里溢出了。S 放置颜色取样点（最多九个），读数可选 RGB 或 Lab；直方图的右键菜单可以打开矢量示波器。缩放用 Z，平移用 H 或按住 Space，Ctrl+0（⌘0）适合窗口，Ctrl+Alt+0（⌘⌥0）显示 100%。在 100% 下，预览会按全分辨率细化，适用于 6400 万像素以内的图像（camera-raw-zoom.md）。
拖动时，预览是用一份最长边不超过 900 像素的缩小副本冲洗的。v0.23.0 起，阴影和高光（#6951）以及去雾、清晰度和纹理（#7020）也和逐像素的设置一起在 GPU 上冲洗这份预览，只有细节（锐化和降噪）还会让预览回到 CPU。渲染模式设为 CPU、使用软件图形适配器，以及在浏览器里，也都用 CPU。v0.23.1 生成这份缩小副本更快了（#11064）。
胶片栏和完成按钮
胶片栏（v0.22.0 新增，#7120）：在 文件 › 打开… 里选中几个 RAW，或者一起拖进来，它们会共用一个 RAW 显影窗口，左边是一列缩略图。正在显示的那张有边框，调整过的会有一个圆点。名字太长时保留结尾，也就是帧号所在的部分。点缩略图切换：每张 RAW 保留自己的设置和去马赛克选择。还没显示过的 RAW 先用它的附属文件，没有的话，如果 RAW 默认设置里开了 应用自动色调（Apply auto tone）就用自动，否则用默认值。打开 会按各自的设置冲洗胶片栏里的每一张，取消 则全部关掉。目前还不能同时编辑多张，也不能把一张的设置复制给其他几张（#13025、#13094）。
完成（v0.22.0 新增，#7121）：完成 在打开和取消旁边，它把每张 RAW 的设置存进各自的 .xmp 附属文件，一张也不打开，和 Adobe Camera Raw 的“完成”一样。状态栏会列出写入的文件；如果每张都是默认设置，就提示无需保存。即使关掉了 写入 XMP 附属文件（Write xmp sidecars），完成也会写入，但其他附属文件规则照样适用（见下文）：DNG 旁边不写，别的程序的附属文件不覆盖。如果有文件写入失败，窗口和所有 RAW 都保持打开，什么都不会丢。下次打开这些 RAW 时，会从保存的设置开始。
XMP 附属文件
读取：从磁盘打开 RAW 时，PhotoCraft 会找同名的附属文件，比如 IMG_0001.CR2 旁边的 IMG_0001.xmp，也就是 Lightroom、Bridge 和 Adobe Camera Raw 写的那种，并从里面的设置开始 RAW 显影（v0.17.0 起，#5128）。DNG 旁边的附属文件也会读。状态栏会写出附属文件的名字和用不上的设置。它读取 Adobe Process 2012 及之后的控件：基本影调滑块，纹理、清晰度、去雾、自然饱和度和饱和度，参数曲线和点曲线，HSL，色彩分级（分离色调），锐化，降噪，颗粒，裁剪后晕影和校准。镜头校正、几何、去边等 PhotoCraft 没有对应控件的设置会被忽略并列出。超过 4 MiB 或解析不了的附属文件会被跳过，RAW 照常打开。
白平衡不会带过来：对 RAW 文件，Adobe 用开尔文值存白平衡（crs:Temperature 和 crs:Tint）。PhotoCraft 的色温和色调是相对相机白平衡的，所以它只读 Adobe 的相对值 IncrementalTemperature 和 IncrementalTint，开尔文值会被忽略。请在颜色面板里重新设白平衡。
裁剪（v0.22.0 新增，#9991）：附属文件里的裁剪（crs:HasCrop="True"，加上 CropTop、CropLeft、CropBottom 和 CropRight）会在点打开时应用：RAW 重新冲洗，并在其他设置之前裁剪，所以裁剪后晕影以裁剪区域为中心。RAW 显影里的预览仍显示整幅画面。带拉直的裁剪（CropAngle 不为 0）不会应用，状态栏会把它列为不支持。关掉 Open in camera raw（在 RAW 显影中打开）时裁剪同样生效。v0.22.0 还不再把 RawFileName 列为不支持的设置。
写入：写入 XMP 附属文件 开着时（默认开），点打开会在你改过设置后把它们写回附属文件。默认设置，或者和附属文件里一样的设置，什么都不写。PhotoCraft 会把自己写的文件标记为自己的，重写时会保留裁剪。以下情况它从不写入：
- DNG 旁边，Adobe 把设置存在 DNG 文件里面；
- 其他程序写的附属文件，因为 Lightroom 和 Bridge 的附属文件里有 PhotoCraft 保留不了的裁剪、蒙版、评级和关键字（会有通知说保留了原文件）；
- 来自脚本或 AI 代理的请求。
设置文件：窗口底部的 存储设置…（Save Settings…）和 载入设置…（Load Settings…）用同样的控件读写 Adobe Camera Raw 的 .xmp 设置文件（v0.9.0 起，#4279）。
PSD 文件：作为智能滤镜的 RAW 显影滤镜，存进 PSD 时会写成 Photoshop 的 Camera Raw 智能滤镜，限于上游对照 Photoshop 核实过的设置。带有这个范围以外设置的滤镜会被略去，并给出警告。设置一致不等于像素一致：PhotoCraft 用的是自己的冲洗流程，不是 Adobe 的（camera-raw-histogram.md）。
RAW 默认设置
编辑 › 首选项 › RAW 默认设置… 决定每张打开的 RAW 怎么处理（v0.17.0 起，#5128）。下表的英文是 v0.23.1 英文界面里的写法，括号外是中文界面的名称：
| 设置 | 默认 | 作用 |
|---|---|---|
| 色彩空间（Color space） | Adobe RGB | 冲洗后文档的色彩空间：sRGB、Adobe RGB、ProPhoto RGB 或 Display P3。RAW 在 ProPhoto RGB 里冲洗，最后再转换 |
| 位深度（Bit depth） | 16 | 每通道 16 位或 8 位 |
| 分辨率（Resolution） | 300 | 文档的 ppi；RAW 文件本身没有记录分辨率 |
| 锐化目标（Sharpen for） | None | 加到冲洗里的输出锐化：Screen（屏幕，数量 25、半径 1.0）、Glossy（光面纸，40、1.0）或 Matte（哑光纸，35、1.2） |
| 作为智能对象打开（Open as smart object） | 关 | 把冲洗好的图层转成智能对象，之后加的滤镜可以继续修改。智能对象里存的是冲洗好的像素 |
| 应用自动色调（Apply auto tone） | 关 | 打开没有附属文件的 RAW 时，用自动填好光线面板的滑块 |
| Open in camera raw（在 RAW 显影中打开） | 开 | 关掉后 RAW 不经窗口直接打开；附属文件和这些默认设置仍然生效 |
| 去马赛克（Demosaic） | AHD | 冲洗 RAW 用的方法：AHD、Malvar–He–Cutler 或 Bilinear |
| 写入 XMP 附属文件（Write xmp sidecars） | 开 | 关掉后仍读取附属文件，但除了“完成”之外不再写入 |
在任意图层上用 RAW 显影滤镜
滤镜 › RAW 显影滤镜…（Ctrl+Shift+A，⌘⇧A）在任意文档（比如一张 JPEG）的当前 RGB 或灰度图层上打开同一个窗口。按钮是 确定（OK）和 取消，没有去马赛克菜单、胶片栏和完成按钮。它作用在图层的像素上，有选区时只作用于选区内，点确定在历史记录里算一步。在智能对象上它会成为智能滤镜：在图层面板里双击它，就能带着原来的设置重新打开。想让图层保持可修改，先用 滤镜 › 转换为智能滤镜（Filter › Convert for Smart Filters）。
批处理、动作、命令行和 AI 代理
- 动作：v0.20.1 起，Photoshop 动作里的 Camera Raw 滤镜步骤，只要用到的滑块 PhotoCraft 都有，就会作为 RAW 显影滤镜步骤播放（#8714）。见 Photoshop 动作。
- 批处理：文件 › 自动化 › 批处理… 打开每张 RAW 时，用默认设置冲洗，不弹窗口、不读附属文件，分辨率取 RAW 默认设置里的值。格式选 Same（相同）时，结果存成 PSD，因为 PhotoCraft 写不了 RAW 格式。批处理命令还接受
suppressOpenOptions参数，录制的 Photoshop 批处理步骤和快捷批处理勾了 Suppress File Open Options Dialogs（禁止显示文件打开选项对话框）时就会用它：这时每张 RAW 都像交互打开一样，按你的 RAW 默认设置和它的附属文件打开，裁剪也包括在内。附属文件里有 PhotoCraft 用不了的设置，或者文件只能打开预览图时，这张就会报错失败；文件访问受限的会话会拒绝这个参数。 - 命令行：
photocraft-cli convert、run和info打开 RAW 时用默认设置冲洗：16 位 ProPhoto RGB，300 ppi，不读附属文件，也不做 RAW 默认设置里的转换。v0.23.1 的命令行没有 RAW 专用选项。RAW 显影滤镜对应命令filter.cameraRaw，参数就是各面板的设置（photocraft-cli commands --filter cameraRaw --json会列出来）。它作用在冲洗好的像素上。例如：
photocraft-cli run IMG_0001.CR2 --cmd filter.cameraRaw --params '{"exposure":0.5,"shadows":30}' --cmd edit.convertToProfile --params '{"profile":"srgb","intent":"relative"}' --out IMG_0001.jpg
- AI 代理：通过控制通道或 MCP 打开文件时，从不弹出 RAW 显影，也从不写附属文件。窗口打开时，用
ui.menu.invoke发送filter.cameraRaw加一个ui对象，可以设置滑块、选去马赛克方法，以及确认、取消或按完成。见 MCP 与命令行。
在浏览器里使用
在线编辑器运行 v0.23.1，也能打开 RAW，差别如下：
- RAW 显影画在页面里，而不是单独的窗口。
- 不读也不写附属文件，所以“完成”什么都存不了。
- JPEG XL 的 DNG（如三星 Expert RAW 文件）会被拒绝：为了控制体积，浏览器版去掉了它的解码器（v0.7.0 起，#2233）。
- 解码和预览都在 CPU 上单线程运行；放大查看时，预览保持缩小副本的精度，不会细化。
大文件或大量 RAW，请用下载页上的桌面版。
已知限制
以下是截至 2026 年 11 月 12 日值得注意的未解决 issue。上游在 #50 里跟踪 RAW 支持。
- CR3 只能打开预览图，尼康高效率 NEF（#9714）、压缩 ORF（#12714）以及上表里的其他类型也是。
- 大多数相机的颜色是估算的。有用户反映 CR2 和 NEF 的颜色和其他转换软件不同（#9699），苹果 ProRAW 的 DNG 颜色发灰（#9904）。
- 没有白平衡吸管和预设（#10004），也没有蒙版（#8335）。
- 胶片栏里的 RAW 之间不能同步设置，也没有“上一次的设置”（#13025、#13094）。
- 没有文件路径的 RAW（比如拖进来的是字节数据）不能重新冲洗：点打开时，白平衡和曝光会作用在冲洗好的像素上，而不是传感器数据上（#12415）。
- Intel Mac 上拖动滑块会崩溃，这是 11 月 12 日报告的，尚未确认（#13478）。
- 窗口的大小和位置 不会被记住（#10102）。
- 尺寸：解码器拒绝超过 2.68 亿像素或缓冲区需要超过 2 GiB 的 RAW；v0.23.1 起，点打开时重新读取的 RAW 也限制在 2 GiB 以内（#11204）。
常见问题
RAW 显影窗口没出来：文件是以内嵌预览图打开的（警告里会说），或者 RAW 默认设置里关掉了 Open in camera raw，或者文件是脚本或代理打开的。
Lightroom 里的白平衡没了：Adobe 的开尔文值不会读取。请重新设色温和色调。
Lightroom 的裁剪没生效：这是带拉直的裁剪，PhotoCraft 暂时应用不了。打开后再裁剪。
没有写入附属文件：设置是默认值或没改过，文件是 DNG，附属文件属于其他程序，写入 XMP 附属文件 关掉了，或者你在用浏览器版。
颜色看起来很平淡：文件里没有可以拿来拟合颜色的预览图。先转成 DNG，或者调自然饱和度、对比度和曲线。
主窗口像卡住了：RAW 显影窗口被挡在后面了。更新到 v0.23.0 或更新的版本，或者点一下变暗的窗口，把 RAW 显影带到前面。