feat: Implement ONNX model inference for BEN2, Depth Anything 3, and MoGe

- Added `ben2_onnx.py` for BEN2 ONNX inference with preprocessing. - Introduced `da3_onnx.py` for Depth Anything 3 inference, including camera projection calculations. - Created `moge_onnx.py` for MoGe-2 ONNX inference and post-processing. - Implemented shared ONNX Runtime session helpers in `onnx_runtime.py`. - Added model synchronization script `sync_models.py` for downloading and verifying ONNX models. - Developed unit tests for BEN2, Depth Anything 3, and MoGe ONNX models to ensure functionality. - Updated `vendor.lock.toml` to remove unused artifacts.
2026-08-14 10:27:09 +08:00
parent 13fab9ce88
commit 2ad30bf4a3
41 changed files with 1569 additions and 2109 deletions
--- a/docs/depth-plane.md
+++ b/docs/depth-plane.md
@@ -4,17 +4,17 @@

 1. 在 3D View 选中 `Object Type = Empty`、`Display As = Image` 的对象。
 2. 右键打开 `SnapForm` 子菜单并选择 `Convert to Depth Plane`，通过 `Depth from` 选择深度来源：
-   - `DA3`：显示 Model、Use Ray Pose 和 Resolution Scale。Process Res 先以原图长边乘以
+   - `DA3`：显示 Model 和 Resolution Scale。ONNX 模型使用 camera decoder 恢复相机。Process Res 先以原图长边乘以
     Resolution Scale，再钳制到 `252–1008`，最后对齐到最接近的 `14` 倍数。Resolution Scale 以百分比
     显示，范围为 `1–100%`，默认 `100%`；界面只在标签中实时显示最终 Process Res。
     转换导出 `mini_npz`，使用前需要在
     `Models` panel 下载所选模型，并固定使用 `process_res_method="upper_bound_resize"`；设备和参考视图策略
     继续使用场景设置。Model 下拉菜单只列出已经下载的 DA3 模型；若没有可用模型，对话框会引导到
     `Models` panel 下载。
-   - `MoGe-2`：使用所选模型输出 metric depth、normal、validity mask 与 normalized intrinsics。Depth Plane 不保存体积较大的 points；Surface 会在 AI 进程内用 points 和官方 `utils3d.build_mesh_from_map` 直接生成 `mesh.npz`。Debug 始终保留原始 `results.npz`，并按 Output Format 单独生成 Maps、纹理 GLB 或彩色 PLY。
+   - `MoGe-2`：使用所选模型输出 metric depth、normal、validity mask 与 normalized intrinsics。Depth Plane 不保存体积较大的 points；Surface 会在 AI 进程内用内置 NumPy 网格构建生成 `mesh.npz`。Debug 始终保留原始 `results.npz`，并按 Output Format 单独生成 Maps、纹理 GLB 或彩色 PLY。
   - `Original`：直接把原图作为深度贴图，不显示估算参数。仅在开启 `Remove Background` 时运行 BEN2
      取得前景 Alpha；视频或序列帧按需同时抽取原始帧与前景序列，把原始帧作为 `.depth` 序列。
-   `Original` 是默认深度来源。选择 `DA3` 时，其 Model、Use Ray Pose 与 Resolution Scale
+   `Original` 是默认深度来源。选择 `DA3` 时，其 Model 与 Resolution Scale
   参数会集中显示在独立边框中。`Remove Background` 与 `Unshaded` 直接显示，不再使用 Options 折叠；
   `Keep Original` 默认关闭，并在分割线下方保持为最后一项。仅当开启 `Remove Background` 时才需要
   `BEN2 Base`，并把 `.foreground` 的 Alpha 作为独立
@@ -63,4 +63,3 @@
   节点组根据 `Frame` 计算从 `1` 开始的 Image Texture Frame：场景帧与 Start 都为 `1` 时读取图片第 `1` 帧；非循环输入
   钳制到有效范围；循环输入使用 Floored Modulo，让 `Frame Start` 前后的负、正相对帧都映射到
   `1…Frames`，因此开始帧之前也会循环播放。Geometry 置换会像材质 Image Texture 一样随场景帧刷新。
-
--- a/docs/development.md
+++ b/docs/development.md
@@ -12,11 +12,10 @@ uv run python pack.py

 ```text
 .
-├── vendor.lock.toml        第三方构建输入的版本、URL 与 SHA-256
-├── prepare_vendor.py       下载并校验第三方构建输入
+├── vendor.lock.toml        各平台 uv 的版本、URL 与 SHA-256
+├── prepare_vendor.py       下载并校验各平台 uv
 ├── pack.py
-├── patches/                进入 Git 的 DA3 源码覆盖文件
-├── vendor/                 不进入 Git 的下载缓存；本地调试也直接读取这里
+├── vendor/                 不进入 Git 的 uv 下载缓存
 ├── src/
 │   └── snapform/
 │       ├── blender_manifest.toml
@@ -36,7 +35,6 @@ uv run python pack.py
 ## 上游与许可证

 - Depth Anything 3 代码采用 Apache 2.0。
- BEN2 代码与模型权重采用 MIT License。
+- BEN2 ONNX 模型采用其仓库声明的 Apache 2.0 License。
 - 本 Extension 代码采用 GPL-3.0-or-later。
 - 模型权重许可证由所选 Hugging Face 模型仓库决定，Extension 下载前会在界面显示。
-
--- a/docs/features.md
+++ b/docs/features.md
@@ -12,14 +12,14 @@
 ## 当前功能

 - 使用 Blender Extension manifest，可通过 `Install from Disk` 安装
- 在独立 Environment 中通过常驻 Service 运行 Torch、DA3、MoGe-2 与 BEN2，避免污染 Blender Python 进程
+- 在独立 Environment 中通过常驻 Service 运行 ONNX Runtime；MoGe-2、DA3 与 BEN2 的模型执行及后处理完全不使用 PyTorch，避免污染 Blender Python 进程
 - Service 的深度模型缓存只保留 DA3 或 MoGe-2 其中一个，切换时主动释放前一个；BEN2 使用独立缓存，
  可与当前深度模型共存
 - Blender 使用内置 `urllib.request` 访问仅监听 `127.0.0.1` 的 Service；请求带随机 Token
- 常驻 Service 复用 Torch、CUDA、BEN2 与最近使用的 DA3 模型，连续执行时不再重复加载
+- 常驻 Service 复用 ONNX Runtime session、BEN2 与最近使用的深度模型，连续执行时不再重复加载
 - 多个 Blender 实例自动连接同一个共享 Service；`AI Service` 面板显示状态、端口、客户端与模型缓存，并提供安装、启动、清理、重启和停止控制
 - Environment、模型和任务结果默认保存在 `~/.snapform`，可由多个 Blender 版本共享
- 当前启用 DA3 Small 和 Base；Large 1.1、Giant 1.1 与 Nested Giant Large 1.1 暂停使用
+- 当前仅启用 FP32 DA3 Small 和 Base；它们不随首次安装下载，Giant 1.1 与 Nested Giant Large 1.1 暂停使用
 - 支持 BEN2 Base 单图背景剔除测试，输出透明 PNG 与推理耗时
 - 支持单张 JPG、JPEG、PNG、WEBP 图片或常见视频文件输入
 - 视频按顺序截取前若干帧，可设置参与重建的最大帧数
@@ -52,17 +52,16 @@
 1. 先运行 `uv run python prepare_vendor.py`，按 `vendor.lock.toml` 下载并校验固定版本的
   第三方构建输入；再运行 `uv run python pack.py`，分别构建 `windows-x64`、`macos-arm64`、
   `linux-x64` 三个平台的 Extension ZIP（如 `SnapForm.v0.10.12.macos-arm64.zip`）。
-   每个包只含对应平台的 uv 二进制，并内置 DA3、BEN2 源码包。
+   每个包只含对应平台的 uv 二进制，不再携带 AI 项目的源码包。
 2. 在 Blender 的 `Preferences > Extensions` 中选择 `Install from Disk`。
 3. 在 Extension Preferences 中确认 Storage Root 与 Device。Device 是正式功能
-   （Image Empty 右键菜单）使用的推理设备，默认取本机最快的 CUDA/MPS，否则 CPU，且只列出
+   （Image Empty 右键菜单）使用的推理设备，默认取本机最快的 DirectML/CoreML provider，否则 CPU，且只列出
   本机支持的设备。
-4. 在 `AI Service` 点击 `Install Environment`。首次安装会下载 Python、PyTorch、FastAPI、Uvicorn；
-   DA3、BEN2 源码包与 uv 已内置在扩展中，安装时从 安装任务的临时目录中使用，安装结束后自动清理，
-   并在 Environment 安装后自动下载 `DA3 Small` 和 `BEN2 Base` 推荐模型。Environment 安装
-   固定显示 `Environment`、`PyTorch`、`AI components` 三个用户阶段；xFormers（macOS 跳过）、
-   FastAPI 等内部安装步骤合并在 `AI components` 中。耗时最长的 PyTorch 与 AI 组件占主要进度
-   区间。安装完成后直接写入 Environment Manifest，不再额外导入全部组件进行验证。推荐模型属于安装
+4. 在 `AI Service` 点击 `Install Environment`。首次安装会下载 Python、ONNX Runtime、FastAPI、Uvicorn；
+   uv 已内置在扩展中，DA3、BEN2 与 MoGe 不安装源码包，
+   并在 Environment 安装后自动下载 `MoGe-2 ViT-S Normal` 和 FP16 `BEN2 Base` 推荐模型。Environment 安装
+   固定显示 `Environment`、`ONNX Runtime` 两个用户阶段；FastAPI 等内部安装步骤合并在 `ONNX Runtime` 中。
+   安装完成后直接写入 Environment Manifest，不再额外导入全部组件进行验证。推荐模型属于安装
   后的自动步骤，不计入阶段编号；`DA3 Base` 等其他模型可稍后在 `Models` 面板按需下载。
   状态文字使用 `阶段/总数 阶段名 | 当前操作 | 预计剩余时间`，依赖安装会结合预设耗时与实际
   进度修正预期；模型下载根据字节数和速度计算剩余时间，例如
--- a/docs/outputs.md
+++ b/docs/outputs.md
@@ -1,31 +1,29 @@
 # 输出格式

-## 输出格式说明
+## DA3 ONNX

 `Output Type` 提供以下结果：

- Point Cloud (GLB)：DA3 `glb`
- Gaussian Splats (PLY)：DA3 `gs_ply`，同时传入 `infer_gs=True`
- Depth Preview (Images)：DA3 `depth_vis`
- Depth Data (NPZ)：DA3 `mini_npz`
- Textured Surface (GLB)：SnapForm 根据 DA3 Prediction 构建并输出 `mesh.glb`
+- Point Cloud (GLB)：由 depth、confidence、相机参数和原图生成彩色点云
+- Depth Preview (Images)：保存深度着色预览
+- Depth Data (NPZ)：保存 depth、confidence、extrinsics、intrinsics 与处理后的图像
+- Textured Surface (GLB)：SnapForm 根据 Prediction 构建纹理网格

-Point Cloud 专属设置仅在对应类型下显示，`gs_views_interval` 仅用于 Gaussian Splats。
-Textured Surface 使用 0–100% 的 Confidence Threshold 删除置信度最低的一定比例：
+DA3 Small 与 Base 的 ONNX 图不包含 Gaussian head，因此不提供 Gaussian Splats。默认推理参数为：

 - `process_res=504`
 - `process_res_method="upper_bound_resize"`
- `use_ray_pose=False`
 - `ref_view_strategy="saddle_balanced"`
 - `conf_thresh_percentile=40.0`
 - `num_max_points=1_000_000`
 - `show_cameras=True`
- `export_kwargs["gs_ply"]["gs_views_interval"]=1`

-DA3 官方 `glb` 是彩色点云与可选相机线框；`gs_ply` 是带 Gaussian 属性的 PLY；
-`depth_vis` 是原图与着色深度图的并排预览；`mini_npz` 保存深度、置信度和可用的相机参数。
-Point Cloud GLB 任务会关闭其默认附带的深度预览，使五种输出产物保持分离。
+相机外参与内参由模型的 camera decoder 输出恢复，不运行 ray-pose 求解器。

-官方格式与限制可参阅
-[DA3 Python API 文档](https://github.com/ByteDance-Seed/Depth-Anything-3/blob/main/docs/API.md)。
+## MoGe-2 ONNX

+MoGe-2 Debug 可保存原始 NPZ、depth/normal/mask maps、纹理 GLB 或彩色 PLY。Surface 输出由模型 points、mask 与 depth edge 在内部构建三角网格。
+
+## BEN2 ONNX
+
+BEN2 输出 `foreground.png`，RGB 保留原始输入，Alpha 来自 ONNX mask 并恢复到输入分辨率。
--- a/docs/service.md
+++ b/docs/service.md
@@ -1,98 +1,61 @@
 # AI Service

-## AI Service
+## 运行架构

-Environment 指磁盘上已安装的 Python、依赖及模型执行组件；Service 是由 Environment 启动、接收 Blender 任务的
-常驻 HTTP 进程。`manifest.json` 记录当前 Environment 的安装信息；Service 的 `/health` 返回进程状态和
-实例标识。项目发布前不维护安装清单或任务协议的兼容版本号。
+SnapForm 在独立的 Python 3.12 Environment 中运行常驻 HTTP Service，Blender 只通过标准库 `urllib.request` 提交任务，不把 AI 运行库载入 Blender Python。Service 只监听 `127.0.0.1`，请求使用随机 Token；同一 Storage Root 由 `service.lock` 保证只有一个实例。

-Extension 本身不包含 Torch。`Install Environment` 使用 `uv` 创建独立 Python 3.12
-环境，并安装。机器上即使没有安装 `uv` 或 Python 也没关系：安装程序由 Blender
-自带的 Python 启动，缺 `uv` 时会解包扩展内置的对应平台二进制，再用它下载
-Python 3.12 与全部依赖。`uv` 会缓存在扩展存储目录下，后续安装直接复用。
-安装不做网络预检，直接开始；环境变量仍可切换镜像与代理：`PIP_INDEX_URL`（PyPI 镜像）、
-`SNAPFORM_TORCH_INDEX`（PyTorch 索引）、`HF_ENDPOINT`（Hugging Face 镜像）、
-`HTTP(S)_PROXY`/`ALL_PROXY`（代理）。未指定 PyPI 镜像时，
-pip 安装失败会自动依次重试镜像（清华、阿里云）；模型下载不预探测，官方 Hugging Face
-失败后自动回退 OmooLab R2（`models.omoolab.xyz`），并校验文件大小和 SHA-256。
-GitHub 不再参与安装：DA3、BEN2、uv 已内置，缺少内置文件会直接报错提示重新安装，不再下载兜底。
-单独下载模型时遵循同样的顺序：Hugging Face（可用 `HF_ENDPOINT` 指定其他入口）失败后自动切换到
-OmooLab R2，不再使用 ModelScope。
-Windows 上代理若只在系统设置里而未写入环境变量，安装程序会尝试自动从系统代理注入子进程。
-
- PyTorch 2.9.1
- TorchVision 0.24.1
- xFormers 0.0.33.post2（与 PyTorch 2.9.1 对应，仅 Windows/Linux；macOS 无 wheel 自动跳过）
- 固定到已验证 commit 的 Depth Anything 3
- 固定到已验证 commit 的 BEN2
- FastAPI 0.139.2 与 Uvicorn 0.51.0
- DA3 与 BEN2 源码包随扩展打包，安装时复制到临时目录后由 uv 本地安装，完成后立即清理
-  （无需访问 GitHub）；SnapForm 直接调用 DA3
-  底层 export 接口，`gs_ply` 导出不会触发 `gs_video` 渲染，因此不需要 gsplat
-  与 C++ 编译工具链
- `vendor/` 是不进入 Git 的本地缓存；`vendor.lock.toml` 固定下载 URL、commit/version 与
-  SHA-256，`patches/<包名>/` 进入 Git 并存放 SnapForm 对源码的覆盖文件（移除 xformers
-  硬依赖、export 入口改懒加载、
-  射线位姿的 3×3 QR 分解在 MPS 上改走 CPU），
-  `pack.py` 打包时自动套入官方包，扩展 zip 内才是修补后的版本；更新上游只需替换官方包
-  并核对覆盖文件是否仍适用
- `addict` 2.4.0（补充 DA3 上游包元数据暂未声明的运行依赖）
-
-安装 Environment 时会自动选择 PyTorch 后端：检测到 NVIDIA 驱动则安装 CUDA 12.8 版本，否则安装
-CPU 版；macOS 始终安装 CPU 版 PyTorch（MPS 包含其中）。CPU 可以用于验证，但实际推理通常很慢。
-Extension Preferences 的 `Device` 决定正式功能的推理设备，默认取本机最快的 CUDA/MPS，否则
-CPU；Debug 面板的 `Debug Device` 只影响 Debug 任务。两处设备选项都只列出本机支持的设备：
-Windows 不显示 MPS，机器上没有可用 NVIDIA 驱动时不显示 CUDA。Environment 安装完成时会检测真实
-可用的设备并写入 `manifest.json`，设备列表以该检测结果为准。
-CUDA 12.8 的 PyTorch wheel 自带 CUDA 运行库，无需安装 CUDA Toolkit；只需要
-NVIDIA 驱动 ≥ 570（数据中心显卡可用更老驱动）。驱动不满足或没有 NVIDIA 显卡时，
-设备会自动回退到 CPU（macOS 为 MPS），只有显式选择 CUDA 才会报错。
-
-macOS（Apple Silicon）会自动从 PyPI 安装 CPU 版 PyTorch，推理设备默认使用 MPS
-（Apple Metal）加速，也可以在设备选项里切换 CPU。PyTorch 自 2.3 起不再提供 Intel
-Mac（x86_64）轮子，Intel Mac 暂不支持。DA3 射线位姿估计中的 3×3 QR 分解在 MPS
-上尚未实现，SnapForm 的覆盖文件会单独把该分解放到 CPU 执行，其余推理仍走 MPS。
-
-Extension 启用后只会查找已有的共享 Service，不会主动启动新进程。第一次执行 AI 操作或在侧边栏
-手动点击 `Start` 时才会启动 Service。Service 只绑定回环地址，并让操作系统分配动态端口；第一个实例把
-端口、进程和随机 Token 写入 `service.json`，其余 Blender 通过标准库
-`urllib.request` 连接同一个 Service。`service.lock` 保证同一 Storage Root 同时只有一个 Service，Token
-则阻止同机其他进程直接调用接口。Service 全局同时只执行一个 AI 任务。
-
-每个 Blender 会注册独立客户端并每 5 秒发送心跳。正常关闭 Blender 时先注销自身；如果当前 Service
-就是由这个 Blender 启动的，会直接终止它，无需等待。异常退出的客户端会在 10 秒后过期；Service
-在最后一个客户端离开后仍会保留模型缓存等待 20 秒再退出，作为 Service 由其他进程启动等场景的兜底。
-取消任务不会重启 Service，并会保留已经加载的模型；
-如果取消发生在一次不可中断的 Torch 调用中，任务会在该调用返回后的最近检查点结束。
-
-侧边栏 `AI Service` 面板以 `Running (Clients: n)` 表示空闲服务，以 `Running (Busy)` 表示正在执行任务，
-并显示缓存模型和活动任务。Blender 完成结果导入时会立即释放当前任务对应的本地 Busy 快照，无需等待
-下一次 Service 轮询。空闲且只有当前 Blender 连接时，可以清理模型缓存、重启或停止 Service；
-多客户端或任务执行期间不会允许破坏共享服务。
-
-BEN2 在首次使用后保持加载；DA3 保留最近使用的一个模型。切换 DA3 模型时会释放旧模型；加载时如果
-显存不足，会先释放另一类缓存模型并重试。
-
-Environment Manifest Revision 变化时，旧 Environment 需要重新执行 `Install Environment`。
-Service 的启动和崩溃日志写入 `~/.snapform/service.log`。
-
-Environment、模型和任务结果默认保存在用户主目录的 `~/.snapform`：
+Environment、模型和任务结果默认保存在 `~/.snapform`：

 ```text
 ~/.snapform/
 ├── .venv/
 ├── models/
 ├── jobs/
+├── manifest.json
 ├── service.log
 ├── service.json       # Service 运行时存在
 └── service.lock       # Service 运行时持有
 ```

-`models/` 下每个模型一个文件夹，命名统一带前缀：DA3 为 `da3_*`（如 `da3_small`、`da3_base`），
-BEN2 为 `ben2_*`（如 `ben2_base`）。旧版无前缀的 DA3 文件夹会在首次使用时自动改名为新名称。
+不同 Blender 版本可共享此目录。也可以在 Extension Preferences 的 `Storage Root` 中修改位置。

-不同 Blender 版本安装相同 Extension 后会共用这个目录。也可以在 Extension
-Preferences 的 `Storage Root` 中修改共享位置。不要把模型写入 Extension 安装目录，
-因为该目录可能只读，并且升级时会被替换。不要同时从多个 Blender 实例执行
-`Install Environment`；Service、任务队列和模型读取可以共享。
+## ONNX-only Environment

+扩展只内置对应平台的 `uv` 可执行文件。`Install Environment` 使用它创建环境并安装：
+
+- ONNX Runtime 1.24.4；Windows 使用 `onnxruntime-directml`
+- NumPy 2.4.2、Pillow 12.1.1、OpenCV Headless 4.13.0.92、trimesh 4.11.2
+- FastAPI 0.139.2、Uvicorn 0.51.0、huggingface-hub 1.4.1
+
+运行环境不安装 PyTorch、TorchVision、xFormers，也不安装 DA3、MoGe、BEN2 或 utils3d 的 Python 源码包。模型推理和 SnapForm 所需的相机、点云、网格后处理均由 ONNX Runtime、NumPy 与内部实现完成。
+
+Windows 当前发行环境提供 DirectML 与 CPU；`Auto` 优先使用 `DmlExecutionProvider`。显式指定不可用设备时会安全回退到 CPU。其他平台安装标准 ONNX Runtime，并按可用 provider 选择 CoreML、OpenVINO 或 CPU。
+
+`manifest.json` 记录 Environment 版本、ONNX Runtime 版本、runtime variant 与设备列表。Manifest Revision 改变后需要重新执行 `Install Environment`。
+
+## 模型
+
+所有正式功能都使用 ONNX：
+
+- MoGe-2 ViT-S、ViT-B、ViT-L Normal
+- DA3 Small、DA3 Base
+- BEN2 Base
+
+首次安装自动下载 `MoGe-2 ViT-S Normal` 与 FP16 `BEN2 Base`，其他模型在 `Models` panel 按需下载。模型按 Hugging Face 仓库末段名称保存在 `~/.snapform/models/`，并保留仓库内部结构。下载顺序为 Hugging Face，然后回退到 `https://models.omoolab.xyz/<repository-name>/<relative-path>`；R2 文件会校验大小与 SHA-256。可用 `HF_ENDPOINT` 指定 Hugging Face 镜像。
+
+DA3 ONNX 使用模型的 camera decoder 恢复外参与内参；旧版 `Use Ray Pose` 参数只为任务协议兼容保留，不参与 ONNX 推理。MoGe-2 的 metric depth、normal、mask、normalized intrinsics，以及 BEN2 的 Alpha，均在 NumPy 后处理中恢复。
+
+
+## 安装网络与镜像
+
+安装器直接开始工作，不做阻塞式网络预检。依赖安装失败时会依次重试清华与阿里云 PyPI 镜像，也可用 `PIP_INDEX_URL` 或 Preferences 中的 `PyPI Index` 显式指定。Windows 系统代理会注入子进程；同时支持 `HTTP_PROXY`、`HTTPS_PROXY` 与 `ALL_PROXY`。
+
+GitHub 不参与用户安装流程。`prepare_vendor.py` 只为扩展打包准备各平台的 `uv` 二进制。
+
+## 生命周期
+
+扩展启用后只查找已有 Service；第一次执行 AI 操作或点击 `Start` 时才启动。每个 Blender 客户端每 5 秒发送心跳，正常关闭时注销。最后一个客户端离开后，Service 保留模型缓存 20 秒再退出。
+
+Service 全局同时执行一个 AI 任务。BEN2 独立缓存，深度模型只保留最近使用的一个；切换模型时释放旧会话。取消任务不会重启 Service，ONNX Runtime 当前调用返回后在最近检查点结束。
+
+启动与崩溃信息写入 `~/.snapform/service.log`。
--- a/docs/surface.md
+++ b/docs/surface.md
@@ -25,7 +25,7 @@
   - Smooth 采用 `O Smooth` 的边界检测和模糊法线权重，固定开放边界与薄面，只保留一个
     `Smooth` 程度系数；节点组不再额外执行 Flip Faces；
   - 从修改前的原始表面以 nearest-surface 重新采样 `UVMap`，最终明确写为 Corner 域 `2D Vector`。
-   MoGe-2 使用独立的 `O MoGe2 Surface`。Service 由 `utils3d.np.build_mesh_from_map(..., tri=True)`
+   MoGe-2 使用独立的 `O MoGe2 Surface`。Service 由内置 NumPy 网格构建函数
   生成有限深度范围内的紧凑三角网格，并保留模型 mask、逐点 depth 及相邻点相对深度差。Geometry Nodes
   按官方 `mask & ~depth_map_edge(depth, rtol=0.04)` 的含义，先由 `Mask` 删除 mask 外的面，再由
   `Depth Continuity` 按同一份 3×3 邻域相对深度差删除断层面。DA3 与 MoGe-2 使用相同的属性、
@@ -163,7 +163,7 @@ Image Empty 使用 Packed Image 时，SnapForm 会通过 Blender 写出临时 PN
 浮点深度；保存 `.blend` 后再次打开仍需对应 job 目录存在。

 选择 PLY 后，模型菜单只会提供 `DA3 Giant 1.1` 和
-`DA3 Nested Giant Large 1.1`。Small、Base 和 Large 没有 Gaussian head，无法由
+`DA3 Nested Giant Large 1.1`。Small 和 Base 没有 Gaussian head，无法由
 DA3 生成 `gs_ply`。

 每个任务在 `~/.snapform/jobs/` 下用独立文件夹包裹。文件夹统一采用
@@ -185,7 +185,7 @@ Blender 为 Packed Image 或序列帧生成的输入副本也归档到对应 job
 - `remove-image-background`
 - `generate-original-depth-plane`

-DA3 官方 exporter 产生的 `gs_ply/`、`depth_vis/`、`exports/mini_npz/` 会在完成后自动平铺，
+DA3 ONNX exporter 产生的 `depth_vis/`、`exports/mini_npz/` 会在完成后自动平铺，
 不会保留只含一层产物的子目录：

 ```text
@@ -218,6 +218,4 @@ remove-background_20260807-153000-123456/
 └── depth.0001.exr…           AI 深度序列帧
 ```

-建议从 `DA3 Base` 开始。它使用 Apache 2.0 模型权重；`DA3 Large 1.1` 权重采用
-CC BY-NC 4.0，仅限非商业用途。
-
+建议从 `DA3 Base` 开始。它使用 Apache 2.0 模型权重。