feat: Introduce Balloon Lasso Tool for mesh extraction

- Added BalloonTool workspace tool to facilitate the extraction of balloon meshes in the 3D viewport.
- Implemented ActivateBalloonTool operator to activate the Balloon Lasso Tool.
- Refactored BalloonLasso operator into ExtractBalloon for better clarity and functionality.
- Enhanced properties for balloon extraction, including mode, thickness, resolution, and material reuse options.
- Updated SnapFormSettings to include new balloon-related properties.
- Improved material and image handling for balloon extraction, ensuring compatibility and reusability.
- Added tests to validate the registration and functionality of the new balloon tools and properties.

docs/outputs.md

@@ -1,37 +1,28 @@
 # 输出格式
 
-本页说明任务文件的字段与序列化约定，主要用于开发与数据检查。普通使用者只需了解
-[模型、设备与存储](models-and-storage.md)中的 Job 文件夹说明。
+本页记录 Job 产物的稳定用途与主要字段。日常使用只需了解 [Job 文件夹](models-and-storage.md)。
 
-## Debug
+## 文件概览
 
-Debug 用于直接比较 DA3、MoGe-2 与 BEN2 模型 API 的返回效果，不复用 Depth、Surface 或 Geometry
-后处理。三个入口对应三个独立 Job：
+| Job | 主要文件 | 内容 |
+| --- | --- | --- |
+| `generate-depth` | `results.npz`、深度与颜色序列 | Depth Plane 所需深度、相机和贴图 |
+| `generate-surface` | `mesh.npz`、`normal.png`、颜色层 | Surface 网格、相机与材质输入 |
+| `remove-background` | `color.0001.png` 起 | 带 Alpha 的颜色层 |
+| `debug-da3` | `prediction.npz` | DA3 API 返回 |
+| `debug-moge2` | `prediction*.npz` | MoGe-2 API 返回 |
+| `debug-ben2` | `foreground*.png` | BEN2 API 返回 |
 
-- debug-da3：保存 prediction.npz，字段直接来自 DA3 Prediction，包括 depth、conf、
-  extrinsics、intrinsics、processed_images 及模型实际返回的可选标量或数组
-- debug-moge2：每张输入保存一个 prediction.npz 或 prediction.0001.npz，完整保留 MoGe-2 API
-  字典中的 points、depth、normal、mask 与 intrinsics
-- debug-ben2：直接保存 BEN2 API 返回的 foreground.png 或 foreground.0001.png
+## NPZ 字段
 
-Debug 不生成点云、三角网格、深度预览、置信度 percentile 或坐标变换后的派生产物。输入为多帧时，
-DA3 保留联合推理；MoGe-2 与 BEN2 按其单图 API 逐帧保存结果。
+DA3 Depth 结果包含 `depth`、`conf`、`extrinsics` 与 `intrinsics`。MoGe-2 Depth 结果包含 `depth`、`normal`、`mask` 与 `intrinsics`。
 
-## Depth
+Surface 的 `mesh.npz` 包含 `vertices`、`faces`、`uv`、`intrinsics`、`image_size` 与 `reference_depth`，以及 Geometry Nodes 使用的网格属性。
 
-generate-depth 输出 Blender Depth Plane 所需的 results.npz。DA3 保存 depth、conf、
-extrinsics 与 intrinsics；MoGe-2 保存 depth、normal、mask 与 intrinsics，并额外写出
-Depth Plane 导入所需的贴图。这里的文件转换属于正式 Depth 工作流，不属于 Debug。
+Debug 文件保持模型 API 的数据形态，用于比较推理结果；正式 Job 则提供 Blender 导入所需的派生数据。
 
-## Surface
+## 图片序列
 
-generate-surface 统一写出 `mesh.npz`，不再生成 `texture.png`。DA3 与 MoGe-2 都使用
-`geometry/surface.py` 的同一套 Surface 构建算法；序列化位于 `outputs/surface.py`。MoGe-2 normal
-仍由 Server 单独导出为 `normal.png`，Blender 只负责加载并用于材质，不写入几何 NPZ。未去背景时
-无论颜色来自原图复制还是 BEN2，Server 都统一写为 `color.0001.*` 起始的颜色层。Blender 不依据文件数量判断图片类型：源 Empty 为普通单图时载入为 `IMAGE`，源 Empty 为 Movie/Sequence 时即使只有一帧也载入为 `SEQUENCE`；`.depth` 使用相同规则。材质只在 Blender
-端创建。MoGe-2 的 `normal.png` 仍由 Server 生成，Blender 只负责加载使用。
+正式颜色层统一使用 `color.0001.*` 起始的文件名。深度动画使用 EXR 序列以保存浮点值。源 Empty 为 Movie 或 Sequence 时，Blender 按序列载入这些文件，即使任务只输出一帧。
 
-## BEN2
-
-正式 remove-background 工作流输出 `color.0001.png` 起始的透明颜色层。BEN2 ONNX API 返回的 Alpha
-恢复到输入分辨率，RGB 保留输入图像颜色。Debug BEN2 仍保留模型 API 语义，使用 `foreground` 文件名。
+MoGe-2 Surface 的法线单独保存为 `normal.png`。材质在 Blender 端创建，不属于 Job 文件格式。