PSD 调整图层¶
Photoshop 的调整图层不是画稿 —— 它们是指令。OSA 把它们从 .psd 里读出来，把有 Harmony 对应物的那些变成真正的效果节点，连同它们的数值。
没有对应物的那些会变成导入报告里的一行，而绝不会变成一张神秘的空 drawing。
对应表¶
这里的每一行都是拿一个探针在 Harmony 24 安装上实测出来的 —— 包括一个阴性对照，因为那个探针的第一次运行对 18 个候选中的 18 个都答"存在"，连编造的名字也算。
| Photoshop | Harmony 节点 | 结论 |
|---|---|---|
| Brightness/Contrast | BRIGHTNESS_CONTRAST |
✅ 可转换 —— 数值能过来 |
| Hue/Saturation | HUE_SATURATION |
✅ 可转换 —— Master 三件套能过来 |
| Levels | COLOR_LEVELS |
✅ 可转换 —— RGB 复合记录能过来 |
| Curves | COLOR_CURVES |
⚠️ 节点会创建；曲线控制点读得出来，但还没写进去 |
| Solid Color | COLOR_CARD |
✅ 生成器，含颜色 |
| Gradient Fill | GRADIENT-PLUGIN |
⚠️ 生成器，只有两个色标 |
| Black & White | COLOR2BW |
❌ 是另一种效果 —— 一个去饱和滑块对上 Photoshop 的六个色相滑块 |
| Colour Balance | — | ❌ Harmony 里不存在 |
| Photo Filter | — | ❌ 无法转换 |
这张表背后的规矩很短：能转换？收。转换不了但有用且用得多？也收。 第二条正是 Tone 和 Highlight 会出现在效果目录里的原因。
究竟有什么过来了¶
Brightness/Contrast —— 亮度和对比度，作为整数，直接进节点的两个字段。
Hue/Saturation —— 来自 Master 条目的色相、饱和度和明度。六个按颜色分的范围不读：它们每个又是三个滑块，而编排它们的诚实场所是 Harmony。
Levels —— 来自 RGB 复合记录的输入黑白点、gamma、输出黑白点。按通道分的那些记录（Red、Green、Blue、Alpha）不读。
Curves —— 控制点会被解码，但把它们写进 COLOR_CURVES 需要一项 OSA 还没有的测量：这个节点接受多少个点，以及它怎么重采样。在那之前节点会被创建，数值进报告，因为一条写对一半的曲线比完全没写更糟。
树里的数值和 Harmony 里的数值 —— 是两个不同的问题
上面那些数值落进 staging 树，所以你在预检时看得到、也能改。把复合属性写进 Harmony 节点（Hue/Saturation 的各范围、Levels 的各通道）是另一个步骤，还等着实测 —— 导入报告会逐图层说明这件事，而不是让你以为它已经发生了。
图层蒙版变成遮罩¶
Photoshop 里带图层蒙版的调整图层，读作"这次校正只作用于这里"。OSA 把这层意思带过来：蒙版被提取成它自己的 drawing，接进效果的 matte 端口 —— 就是 Cutter 用的那个端口。
剪贴图层¶
一个被剪贴的调整图层附着到它下方的图层上，完全按它在 Photoshop 里的读法 —— 效果落在那个图层的槽位上，而不是落在组上。
没有剪贴的则作用于整个组，落在父槽位上。
报告¶
任何不完整或被拒绝的东西都会变成一行导入后可读的信息，点名那个 Photoshop 图层以及它遭遇了什么：
Hue/Saturation values read into the node; they are not written to Harmony yet (composite attributes) Gradient has 3 or more stops; Harmony's gradient takes two
这就是整个这一块的家规：宁可警告，也不沉默。一个悄悄什么都不做的调整图层和一个 bug 无法区分，而你会在最糟的时刻发现它 —— 在渲染里。
绝不会发生的事¶
空图层绝不会被剪掉。 一个包围盒为空的空白图层，在很多流程里是合法的占位符。OSA 把它 staging 成一张空 drawing，而不是替你判定它是个失误。