Refactor Cutout and Image Editing Logic

- Renamed "Base Plane Depth" to "Reference Depth" across validate_cutout.py for consistency.
- Introduced a new specification for Cutout mesh sampling to ensure source pixel spacing is preserved and limits are applied correctly.
- Unified naming conventions for image editing results to maintain consistency across Remove Background, Upscale, and Crop operations.
- Updated the handling of Refine Selection to ensure it retains the original bounds and does not apply unnecessary cropping.
- Enhanced material generation logic to connect image color directly to IOR Level, improving the rendering of dark areas.
- Established clear requirements for geometry depth controls and image result materials to ensure consistent behavior across different components.
- Removed outdated logic and ensured all changes are documented and tested for regression.

openspec/changes/refine-image-output-semantics/specs/geometry-depth-controls/spec.md

@@ -0,0 +1,23 @@
+## ADDED Requirements
+
+### Requirement: Geometry depth groups expose Reference Depth
+系统 SHALL 在 `O Image Depth Plane`、`O Image Cutout`、Depth Balloon 与 Depth Surface 的 Geometry Nodes 接口中使用 `Reference Depth` 表示深度纹理的参考距离，并且 MUST 不再公开 `Base Plane Depth`。
+
+#### Scenario: Depth Plane initializes its reference
+- **WHEN** 系统根据 `depth.json` 创建 Depth Plane Modifier
+- **THEN** `reference_depth × uniform_scale` SHALL 写入 `Reference Depth`
+
+#### Scenario: Depth Cutout initializes its reference
+- **WHEN** 系统根据最终网格内容标定 Depth Balloon 或 Depth Surface
+- **THEN** 标定结果 SHALL 写入主 Cutout 与对应子组的 `Reference Depth`
+
+#### Scenario: Node asset exposes the current interface only
+- **WHEN** 系统构建并验证 `O_AnyImage.blend`
+- **THEN** 所有相关节点组、面板、依赖连线和 Modifier 输入 SHALL 只包含 `Reference Depth`，不得保留旧名称或兼容 socket
+
+### Requirement: Reference Depth keeps existing geometry meaning
+`Reference Depth` SHALL 继续作为采样 Depth 的运算基准，不改变 Depth Plane、Depth Balloon 或 Depth Surface 的几何方向、尺度、厚度和位移公式。
+
+#### Scenario: Reference control changes relative depth
+- **WHEN** 用户修改 `Reference Depth`
+- **THEN** Geometry Nodes SHALL 使用 `Reference Depth - sampled depth` 的既有相对深度关系更新几何

openspec/changes/refine-image-output-semantics/specs/image-result-materials/spec.md

@@ -0,0 +1,16 @@
+## ADDED Requirements
+
+### Requirement: Image color drives generated material IOR Level
+系统 SHALL 将 Plane、Depth Plane 与 Cutout 的非 Shadeless 生成材质中 `O Image Layer` 的 Color 输出直接连接到 Principled BSDF 的 IOR Level，同时保留既有 IOR、Base Color、Roughness、Alpha、Normal 与 Displacement 连接。
+
+#### Scenario: Dark image content suppresses highlights
+- **WHEN** 生成材质采样到黑色或暗色图片内容
+- **THEN** Principled BSDF 的 IOR Level SHALL 接收对应的低颜色值，从而降低该区域的高亮
+
+#### Scenario: Bright image content preserves direct color response
+- **WHEN** 生成材质采样到白色或亮色图片内容
+- **THEN** Principled BSDF 的 IOR Level SHALL 接收 `O Image Layer` Color 的直接转换值，不经过额外缩放或固定上限
+
+#### Scenario: Generated material keeps its IOR value
+- **WHEN** Cutout 或 Depth Plane 以 IOR `1.2` 创建材质
+- **THEN** 系统 SHALL 保留 IOR `1.2`，并由 Color 独立驱动 IOR Level

openspec/changes/refine-image-output-semantics/specs/selection-content-processing/spec.md

@@ -0,0 +1,68 @@
+## ADDED Requirements
+
+### Requirement: Refine preserves the submitted bounds canvas
+系统 SHALL 让 BEN2 Refine 输出保持输入 RGBA 的完整矩形尺寸，并沿用提交前的 Selection bounds；Server MUST 不按生成 Alpha 紧裁切输出，也 MUST 不接收 Selection Mask。
+
+#### Scenario: BEN2 output occupies only part of the bounds
+- **WHEN** BEN2 只在输入矩形的一部分生成可见 Alpha
+- **THEN** Refine 输出 SHALL 保留完整输入尺寸和透明区域，Blender SHALL 沿用提交前保存的 bounds
+
+#### Scenario: Refine Job reports its files
+- **WHEN** `refine-image-selection` 或 Cutout artifact Job 完成 Refine
+- **THEN** Job SHALL 返回完整尺寸的 Refine 图片，并且 MUST 不生成或返回 Refine 后的局部 bounds 文件
+
+### Requirement: Refined content Alpha combines source and BEN2
+BEN2 Refine 内容 Alpha SHALL 等于 `Source Alpha × BEN2 Alpha`，并且 Selection Mask MUST 不参与 BEN2 推理或 Server 端 Refine 输出。
+
+#### Scenario: Source contains transparent pixels
+- **WHEN** BEN2 在源 Alpha 为零或半透明的像素生成前景 Alpha
+- **THEN** Refine 图片 SHALL 通过 `preserve_input_alpha` 保持源 Alpha 与 BEN2 Alpha 的乘积
+
+#### Scenario: Selection excludes visible content inside bounds
+- **WHEN** bounds 内存在位于 Selection Mask 外的可见内容
+- **THEN** BEN2 与 Server Refine 输出 SHALL 仍能使用并保留该内容，不得预先乘入 Selection Mask
+
+### Requirement: Cutout textures share refined content scope
+启用 Refine Selection 的 Cutout SHALL 使用同一份 `Source Alpha × BEN2 Alpha` 内容生成 Color、Normal 与 Depth 贴图，Selection Mask MUST 不限制这些贴图的生成。
+
+#### Scenario: Cutout generates color and normal
+- **WHEN** Cutout 同时启用 Refine Selection 与 Normal Map
+- **THEN** Color Alpha 与 Normal 可见区域 SHALL 来自完整 Refine 图片 Alpha，不得乘入 Selection Mask
+
+#### Scenario: Cutout generates depth
+- **WHEN** Refined Cutout 生成 Vector 或 Z Depth
+- **THEN** MoGe-2 黑底输入和 Depth Metadata 参考内容范围 SHALL 来自完整 Refine 图片 Alpha，不得乘入 Selection Mask
+
+#### Scenario: Depth texture preserves model validity
+- **WHEN** 系统写出 Vector 或 Z Depth EXR
+- **THEN** RGB SHALL 保留完整连续 Field，Alpha SHALL 保存 MoGe-2 Validity，不得用 Refine Alpha 或 Selection Mask 覆盖
+
+### Requirement: Cutout mesh combines refined content with Selection
+Cutout SHALL 只在 Blender 网格构建阶段计算 `Source Alpha × BEN2 Alpha × Selection Mask`，并使用该结果约束 BaseShape、内容空值检查和网格标定。
+
+#### Scenario: BEN2 keeps content outside the user Selection
+- **WHEN** BEN2 在 Selection bounds 内保留了 Selection Mask 外的前景
+- **THEN** Color、Normal 与 Depth SHALL 保留该内容，但最终 Cutout 网格 MUST 不包含 Selection Mask 外的区域
+
+#### Scenario: Combined Cutout content is empty
+- **WHEN** Refine Alpha 与 Selection Mask 相乘后没有超过 Cutout Alpha 阈值的像素
+- **THEN** Cutout SHALL 报告空内容且不创建网格
+
+#### Scenario: Cutout generates only Normal or Depth
+- **WHEN** Cutout 未启用 Refine、但因 Normal 或 Depth 进入 Job
+- **THEN** 贴图 SHALL 使用完整 bounds 源 Alpha，网格 SHALL 使用 `Source Alpha × Selection Mask`
+
+### Requirement: Crop Refine applies Selection in Blender
+Crop Refine SHALL 在 Blender 中计算 `Source Alpha × BEN2 Alpha × Selection Mask` 作为最终图片 Alpha，同时保持提交前的矩形尺寸和 placement bounds。
+
+#### Scenario: BEN2 keeps pixels outside a Crop Selection
+- **WHEN** BEN2 在 Crop Selection Mask 外生成可见 Alpha
+- **THEN** 最终 Crop 图片 SHALL 将这些像素 Alpha 置为零，但 MUST 不改变提交前 bounds
+
+#### Scenario: Crop uses one rasterized Selection
+- **WHEN** Crop 提交 Refine Job 并异步接收结果
+- **THEN** 系统 SHALL 复用提交阶段生成的 Selection Mask，不得在响应阶段重新栅格化 SelectionPath，也不得把 Mask 发送给 Server
+
+#### Scenario: Combined Crop content is empty
+- **WHEN** Refine Alpha 与 Selection Mask 相乘后没有可见像素
+- **THEN** Crop SHALL 报告空内容且不创建结果 Image Empty