Modly 3D工作流节点完全参考：Image到AddToScene的9种核心节点详解

Modly 3D工作流节点完全参考：Image到AddToScene的9种核心节点详解

【免费下载链接】modlyDesktop app to generate 3D models from images or prompt using local AI — runs entirely on your GPU项目地址: https://gitcode.com/GitHub_Trending/mo/modly

Modly 是一款完全在本地 GPU 上运行的 AI 3D 生成桌面应用，支持从图片或提示词生成 3D 模型。它的核心亮点之一就是可视化工作流编辑器：把节点拖进画布、连线，就能搭出从图片输入、模型生成到送入 3D 场景的自动化流水线。本文带你逐个详解 9 种核心节点——从 Image 到 Add to Scene 的完整参考，帮你快速上手 Modly 工作流。

🗺️ 一图看懂 Modly 工作流节点：连线即自动化

在开始逐节点讲解之前，先看这张工作流截图：左侧是Image 节点（导入一张图片），中间是 TripoSG 生成节点（消费图片、输出 mesh），右侧是Add to Scene 节点（把生成的网格放进 3D 场景）。蓝色的线代表 image 数据流，紫色的线代表 mesh 数据流——连线的颜色和类型一一对应，接错线根本无法连通。

📋 节点总览：9 种核心节点一张表

所有节点都基于同一个外壳组件 BaseNode.tsx 构建，连理由 WorkflowEdge.tsx 渲染。

🖼️ 1. Image 节点：导入本地图片作为输入

工作流的起点通常是图片。点击节点内的Browse…按钮即可选择本机的 PNG / JPG / WebP 文件，选完后节点上会直接显示缩略图，再次点击可以更换。

• 输出类型：image（天蓝色接口）
• 典型用途：喂给 TripoSG 等图生 3D 模型
• 源码：ImageNode.tsx

✍️ 2. Text 节点：为工作流注入提示词

当工作流需要文字输入（例如文本提示词、参数说明）时使用。直接在节点内的多行文本框里输入即可，节点高度会随内容自动增长，输出琥珀色的text数据流。源码见 TextNode.tsx。

🔀 3. Input 节点：可切换类型的灵活输入源

Input 节点内置Image / Text 切换按钮，同一个节点可以随时在图片输入和文本输入之间切换，非常适合"先搭骨架、后定素材"的调试场景。注意它是工作流的固定入口，不可删除（源码中deletable={false}）。详见 InputNode.tsx。

🧊 4. Load 3D Mesh 节点：加载模型文件

对已有模型做后续处理（修复、减面、平滑）时，需要先把模型装进工作流。该节点提供两种来源：

• 文件模式：Browse 选择本机 3D 网格文件
• 当前模型模式：一键开关，直接取用 3D 场景中正在编辑的模型

输出紫色的mesh数据流。源码：Load3DMeshNode.tsx。

👀 5. Preview Views 节点：多视角图片网格预览

部分扩展（如 MV-Adapter 多视角生成）会输出"多张视角上下拼接"的长图。Preview Views 节点会自动把这张长图裁切成 2×3 网格展示，方便你快速检查每个视角的质量。它只接收 image 输入、不做输出。实现见 PreviewImageNode.tsx。

📂 6. For Each 节点：批量遍历文件夹的循环起点

想要一次性处理整个文件夹的素材？For Each 节点提供For Each Image / Text / Mesh三种模式：

1. 选择一个文件夹，节点会按字母顺序逐文件发射
2. 下游所有已连线的节点会为每个文件各跑一遍
3. 运行中支持暂停（Pause）→ 继续下一个文件 / 重试当前文件，全程可随时 Stop

批量生成 3D 模型场景下，它是效率提升最大的一个节点。源码：ForEachNode.tsx。

🔁 7. While 节点：可拖大边界的循环容器

While 是一个可缩放的虚线框，把其他节点拖进框内就构成循环体。头部有个loop N ×输入框：

• 填3：循环体自动重复执行 3 次
• 留空或0：纯手动模式，通过 Continue / Retry 按钮逐次推进

运行过程中循环次数会被锁定，防止中途改动造成混乱。实现见 WhileNode.tsx。

⏸️ 8. Wait 节点：手动暂停与人工确认

Wait 节点是流程中的"检查站"：运行到它时会停住，亮起一个Continue 按钮，由你人工确认后工作流才继续向右执行。适合插在"生成 → 预览 → 优化"之间，先确认结果满意再跑后续步骤。它有左右两个接口，可以无损耗地串在任意两个节点中间。源码：WaitNode.tsx。

🎯 9. Add to Scene 节点：把结果送进 3D 场景

工作流的终点站。它只接收mesh输入；当上游网格就绪后，节点上会显示绿色Mesh ready标记和Add to 3D scene按钮，点击即可跳转回生成页，把刚产出的模型放进 3D 视图中查看。

源码：AddToSceneNode.tsx。

🎨 接口颜色 = 数据类型：一眼看懂连线规则

Modly 用颜色严格区分数据类型，接口颜色不同就无法连线：

🧩 附加：扩展节点（Extension Node）

除了 9 种内置节点，Modly 还能把 TripoSG、Mesh Smoother、Mesh Repair、Mesh Optimizer 等能力以"扩展节点"形式加载进画布。每个扩展用一份manifest.json声明自己的输入/输出类型和参数面板（例如 mesh-smoother/manifest.json 声明了迭代次数、平滑强度、Taubin/Laplacian 模式），前端由 ExtensionNode.tsx 动态渲染出参数控件，无需写代码就能调参。

🚀 新手上手：3 步搭好第一条 Modly 工作流

1. 加输入：拖入 Image 节点，Browse 选择一张素材图
2. 接生成：连一条 image 线到 TripoSG（或其他图生 3D 扩展），调好 Inference Steps、Seed 等参数
3. 送场景：把 mesh 输出连到 Add to Scene，运行工作流，完成后点击 "Add to 3D scene" 查看模型

📌 提示：需要人工把关时，在第 2、3 步之间插一个 Wait 节点；需要批量处理时，把 Image 节点换成 For Each Image。

📁 相关源码路径速查

• 工作流页面入口：WorkflowsPage.tsx
• 节点外壳组件：BaseNode.tsx
• 运行状态管理：workflowRunStore.ts
• 节点行为测试：nodeBehaviors.test.mjs
• 扩展清单与类型定义：mockExtensions.ts

掌握这 9 种节点与 4 类数据接口的组合规则，你就能在 Modly 中自由编排出从图片到 3D 场景的任意自动化流程。

【免费下载链接】modlyDesktop app to generate 3D models from images or prompt using local AI — runs entirely on your GPU项目地址: https://gitcode.com/GitHub_Trending/mo/modly