# 输出格式

本页说明任务文件的字段与序列化约定，主要用于开发与数据检查。普通使用者只需了解
[模型、设备与存储](models-and-storage.md)中的 Job 文件夹说明。

## Debug

Debug 用于直接比较 DA3、MoGe-2 与 BEN2 模型 API 的返回效果，不复用 Depth、Surface 或 Geometry
后处理。三个入口对应三个独立 Job：

- 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

Debug 不生成点云、三角网格、深度预览、置信度 percentile 或坐标变换后的派生产物。输入为多帧时，
DA3 保留联合推理；MoGe-2 与 BEN2 按其单图 API 逐帧保存结果。

## Depth

generate-depth 输出 Blender Depth Plane 所需的 results.npz。DA3 保存 depth、conf、
extrinsics 与 intrinsics；MoGe-2 保存 depth、normal、mask 与 intrinsics，并额外写出
Depth Plane 导入所需的贴图。这里的文件转换属于正式 Depth 工作流，不属于 Debug。

## 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 只负责加载使用。

## BEN2

正式 remove-background 工作流输出 `color.0001.png` 起始的透明颜色层。BEN2 ONNX API 返回的 Alpha
恢复到输入分辨率，RGB 保留输入图像颜色。Debug BEN2 仍保留模型 API 语义，使用 `foreground` 文件名。