> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cyberun.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 运行 Nerfstudio 工作流

> 用向导构建一个 Gaussian splatting 工作流，然后在代理上运行。

Cloud 中的 Nerfstudio 向导可以为 3D Gaussian
splatting 流水线（`splatfacto` 或 `splatfacto-big`）构建一个工作流，
无需手动编辑 JSON。你提供输入采集与参数，
向导输出一个可保存并运行的工作流。

向导必须出现在工作流创建流程上。如果没有，
说明此部署未启用 Nerfstudio（请联系你的团队管理员），或者你团队中
没有任何代理带有 `nerfstudio` 标签。

## 开始之前

* 一个你想要重建的采集。支持三种输入类型：

  | 输入类型                    | 是什么                        |
  | ----------------------- | -------------------------- |
  | `images_zip`            | 主体的静态图像 ZIP 包。             |
  | `video`                 | 会被采样为帧的视频文件。               |
  | `processed_dataset_zip` | 已预处理好的 Nerfstudio 数据集 ZIP。 |

* 一个带有 `nerfstudio` 标签的团队代理（当然还要带 `gpu`
  标签）。

## 构建工作流

1. 打开侧边栏中的 **工作流**。

2. 点击 **创建工作流** 并选择 **Nerfstudio 向导**。

3. 填写向导：

   | 字段                | 说明                                                |
   | ----------------- | ------------------------------------------------- |
   | 输入类型              | `images_zip`、`video` 或 `processed_dataset_zip`。   |
   | 训练方法              | `splatfacto`（更快，质量较低）或 `splatfacto-big`（更慢，质量更高）。 |
   | 文件参数键             | 调用者提供的文件参数名。会有合理的默认值。                             |
   | 文件参数标签            | 在运行表单上显示的人类可读标签。                                  |
   | 最大迭代次数            | 训练迭代次数，1000–100000。                               |
   | 相机类型              | 自由文本。留空可让运行时自行选择。                                 |
   | 运行 process\_data  | 开关。启用 Nerfstudio 的预处理步骤。                          |
   | 导出 Gaussian splat | 开关。在末尾添加 `.ply` 导出步骤。                             |

4. 点击 **保存** 以创建工作流。

向导会在保存前内联展示生成的工作流规格（在可折叠的
预览中），便于你检查。

## 运行

新的工作流会出现在 **工作流** 列表中。在详情页：

1. 点击 **运行**。
2. 上传输入（图像 ZIP、视频或已处理的数据集）。
3. 提交。

任务会依次经历 `pending → waiting → queued → running → completed`。
长时间运行的训练任务会发出带步数计数的进度事件，
任务详情页会内联渲染。

## 输出

任务成功时，输出面板显示：

* 一个主工件（splat 的 `.ply` 或视频，取决于
  开关设置）。
* 一个引用其余输出的存储键（配置、文件
  清单、清单）。

你可以通过提交另一个任务，用新的输入或不同的参数
重新运行该工作流。

## 相关

* [工作流](/zh/cloud/concepts/workflows) —— 概念。
* [任务](/zh/cloud/concepts/tasks) —— 生命周期与进度事件。
* [代理](/zh/cloud/concepts/agents) —— 谁会带有 `nerfstudio`
  标签。