# Depth Anything 3 场景导出教程

给同一原创物件六张有顺序的视图，运行da3 images导出场景GLB与原始数组，检查相机、置信度与表面缺口。照片还原3D空间与凭单图补全物体是不同任务。

## 执行范围

已执行：Blender 5.2.1原创几何、真实相机渲染、UV展开、CPU手工材质烘焙、GLB/OBJ导出重载；本题附带离线检查。未执行：目标项目模型下载/推理、Gradio运行、生成纹理/深度/视频mask。reference、geometry-reference、original命名文件都是原创输入或手工参考，绝非模型结果。官方图片只在网页按来源引用。

## 步骤

### 1. 核对六图场景和文件顺序

views/view-00到05按60度间隔来自同一个原创物件，固定几何、尺度与照明。cameras.json是原始Blender相机真值参考，不是DA3预测；先看六图，剔除重复或错物件输入。

### 2. 选择DA3实际模型与独立输出目录

按官方CLI准备da3命令和用户自己的权重/硬件。指定新的--export-dir actual-da3-scene，不启用--auto-cleanup。低分辨率是控制成本的选择，不代表本机已完成CUDA推理。

### 3. 使用images目录入口导出GLB和mini_npz

命令使用da3 images ./views --export-format mini_npz-glb。不要把单图生成物体接口或其他Depth Anything仓库的run.py参数拼在一起；配置以同一版本--help为准。

### 4. 先列出真实返回文件与数组字段

inspect-da3.py只读取实际输出目录里的NPZ键、形状和有限性，并列出GLB；不预先编造相机数组名称或深度结果。保存模型、处理分辨率、排序和实际输出路径。

### 5. 旋转场景核对相机与可见表面

在官方查看入口或Blender导入真实GLB，检查相机排列、表面缺口与对象尺度。下载包的参考场景和相机由已知几何生成，需与实际DA3重建分开摆放，不能当成预测吻合。

### 6. 比较不同置信度阈值的实际导出

需要过滤低置信度点时，保留默认结果，再把--conf-thresh-percentile调为60导出新目录。高阈值可能减少离群点也会删掉真实细结构；对比同一角度，记录消失区域，不自动称改善。

### 7. 交付可重载场景与运行证据

实际GLB、mini_npz、命令、输入列表和运行记录一起保存。本包可打开的网格/标定相机是Blender手工参考；DA3模型推理及置信度过滤未执行。

## 命令

```bash
# 在官方DA3匹配环境执行，先确认当前CLI
da3 images --help
da3 images ./views --export-dir ./actual-da3-scene --export-format mini_npz-glb --process-res 504
python inspect-da3.py actual-da3-scene
# 另存阈值对照，不覆盖第一份
da3 images ./views --export-dir ./actual-da3-conf60 --export-format mini_npz-glb --process-res 504 --conf-thresh-percentile 60
```

## 参考文件

- 以“本题实际文件”列表为准：original-toy.png或front.png/views为Blender原创输入。
- 若本包含reference-colored.glb：它是手工材质参考。
- 若本包含reference-textured.obj/MTL/PNG：它们是Blender真实UV/烘焙交换文件。
- 若本包含geometry-reference-depth.npy/PLY：它们是原创场景已知几何，非深度模型预测。
- runtime.json：目标模型初始not-executed。
- verification.json / blender-reload.json：文件及重载证据，不是模型生成证据。

## 官方依据

https://github.com/ByteDance-Seed/Depth-Anything-3
https://github.com/ByteDance-Seed/Depth-Anything-3/blob/main/docs/CLI.md

## 本题实际文件

- `back.png`
- `blender-reload.json`
- `cameras.json`
- `clay-back.png`
- `clay-front.png`
- `commands.md`
- `exchange-reload.json`
- `front.png`
- `helper-checks.json`
- `inspect-da3.py`
- `known-cameras.png`
- `left.png`
- `original-toy.png`
- `reference-camera-scene.glb`
- `reference-clay.glb`
- `reference-colored.glb`
- `reference-texture.png`
- `reference-textured.glb`
- `reference-textured.mtl`
- `reference-textured.obj`
- `reference-vertexcolor.glb`
- `review.csv`
- `runtime.json`
- `verify.py`
- `viewer.html`
- `viewer.js`
- `views/view-00.png`
- `views/view-01.png`
- `views/view-02.png`
- `views/view-03.png`
- `views/view-04.png`
- `views/view-05.png`

模型命令仅供在你准备好的官方环境执行；from_pretrained类入口首次运行可能拉取大权重，本轮没有执行。