feat: Implement cutout tool and depth generation features

- Added a new cutout tool for selecting regions in images, allowing users to choose mesh shapes based on selected areas.
- Introduced depth generation capabilities for rasterized images, including normal data extraction.
- Created jobs for generating depth planes and region data, enhancing the AI data generation workflow.
- Developed a selection refinement process for cutout regions, improving accuracy in generated outputs.
- Established a new region module for handling rasterized image regions and their associated AI generation tasks.
- Enhanced node graph builders for asset generation, facilitating smoother integration of new features.

docs/internals/outputs.md

@@ -21,16 +21,16 @@ flowchart TD
 | Job | 主要文件 | 消费方 |
 | --- | --- | --- |
 | `remove-background` | `image.0001.png` 起 | 替换 Image Empty 的颜色数据 |
-| `upscale-image` | `upscale.0001.png` 起 | 创建 `_upscale.png` Image 并记录原图引用 |
-| `refine-image-mask` | `selection-input.png`、`image.png`、`bounds.json` | Image Box / Lasso 读取 Alpha 与原图坐标 |
-| `prepare-geometry-data`：Depth Plane | `image.0001.*`、`field.npz` | 创建颜色图、深度图、材质和 Plane |
-| `prepare-geometry-data`：Cutout | `image.0001.png`、`selection.png`、`analysis.png`、`bounds.json`，以及按形状生成的 `field.npz` / `normal.png` | Blender 主线程构建局部网格与贴图 |
+| `upscale-image` | `upscale.0001.png` 起 | 按共享引用情况替换当前 Image Empty 的颜色数据，并沿用原 Image 命名语义 |
+| `refine-image-mask` | `image.png`、`bounds.json` | Image Box / Lasso 读取细化 Alpha 与原图坐标 |
+| `generate-depth-plane` | `image.0001.*`、`image_geometry.npz` | 创建颜色图、深度图、材质和 Plane |
+| `generate-region-data` | 可选的 `region.png`、`region_bounds.json`、`image_geometry.npz`、`normal.png` | Blender 主线程构建 Cutout Shape 与贴图 |
 
-`prepare-geometry-data` 不输出 Blender 网格。它只准备颜色、选区和模型数组；轮廓提取、约束三角化、Geometry Nodes Modifier 与法线烘焙都在 Blender 响应阶段完成。
+两个几何 Job 都不输出 Blender 网格。`generate-depth-plane` 生成完整图片的颜色副本与深度场；`generate-region-data` 只生成请求的 AI 产物。轮廓提取、约束三角化以及 Mesh、Material 和 Geometry Nodes 创建都在 Blender 主线程完成。
 
 ## 深度场
 
-`field.npz` 是 Depth Plane、Depth Balloon 与 Depth Surface 共用的模型中间结果：
+`image_geometry.npz` 是 Depth Plane、Depth Balloon 与 Depth Surface 共用的模型中间结果。Blender 侧统一通过 `operators/common/mesh_result.py` 的 `load_image_geometry()` 读取为 `ImageGeometry`，功能模块不分别解释字段：
 
 | 字段 | 含义 |
 | --- | --- |
@@ -38,21 +38,21 @@ flowchart TD
 | `depth` | 相机深度 |
 | `intrinsics` | 像素坐标下的 3×3 相机内参 |
 | `valid` | 模型与数值检查后的有效区域 |
-| `calibration_valid` | 用于结果定位或深度基准的区域；Cutout 时与选择相交 |
+| `calibration_valid` | 用于结果定位或深度基准的区域；Cutout 时与 Region 相交 |
 | `image_size` | 深度场宽高 |
 | `reference_depth` | 校准区域中的参考深度 |
 
 Server 保留模型空间数据，不提前换算 Blender 单位。Depth Plane 在导入时根据 Image Empty 平面范围和相机内参锚定点场；Cutout 深度形状则计算 `Uniform Scale` 和局部坐标，再把相机点写入 Packed 浮点 Image 供 Geometry Nodes 采样。
 
-## Cutout 三类图片
+## Cutout Region 产物
 
-Cutout 把“显示内容”“几何范围”和“模型分析”分开：
+Blender 侧先把 `RegionPath` 栅格化为 `RegionMask`，再将 Region 裁切为带有效 Alpha 的临时 RGBA 输入。Server 不接收路径或 Mask 协议，只按需产生 AI 数据：
 
-- `image.0001.png` 保存裁切矩形中的源颜色与原 Alpha，用作材质。
-- `selection.png` 保存最终选择 Alpha，用于轮廓与网格。
-- `analysis.png` 只保留选择内的有效 RGBA，供深度或法线模型分析。
+- 启用 Refine 时，`region.png` 保存细化后的局部 RGBA，`region_bounds.json` 保存它在输入裁切图中的范围；
+- Depth Shape 使用 `image_geometry.npz`；
+- Tangent 或 Object Normal 使用 `normal.png`。
 
-`bounds.json` 把裁切矩形映射回源图像素坐标。这样 Server 可以只处理局部数据，Blender 仍能恢复局部平面范围、UV 和世界位置。
+Blender 将局部范围与原始 `RegionMask.bounds` 合成回源图坐标，并直接从源 Image 创建最终 Color Image。未启用 Refine、Depth 或 Normal 时不提交 Job。
 
 ## Debug 产物
 
@@ -65,7 +65,7 @@ Debug Job 保留模型适配层的直接输出，不执行正式功能的 Blende
 | `debug-ben2` | `foreground*.png` |
 | `debug-upscale` | `prediction*.png` |
 
-这些文件用于验证模型、Device 和适配层。正式 Job 会继续派生选择、Alpha、深度场或可导入图片，因此两者的文件结构有意不同。
+这些文件用于验证模型、Device 和适配层。正式 Job 会继续派生 Region、Alpha、深度场或可导入图片，因此两者的文件结构有意不同。
 
 ## 单图与序列