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/modlyModly 是一款完全在本地 GPU 上运行的 AI 3D 生成桌面应用支持从图片或提示词生成 3D 模型。它的核心亮点之一就是可视化工作流编辑器把节点拖进画布、连线就能搭出从图片输入、模型生成到送入 3D 场景的自动化流水线。本文带你逐个详解 9 种核心节点——从 Image 到 Add to Scene 的完整参考帮你快速上手 Modly 工作流。️ 一图看懂 Modly 工作流节点连线即自动化在开始逐节点讲解之前先看这张工作流截图左侧是Image 节点导入一张图片中间是 TripoSG 生成节点消费图片、输出 mesh右侧是Add to Scene 节点把生成的网格放进 3D 场景。蓝色的线代表 image 数据流紫色的线代表 mesh 数据流——连线的颜色和类型一一对应接错线根本无法连通。 节点总览9 种核心节点一张表#节点名称输入输出一句话用途1Image—image导入本地图片作为工作流素材2Text—text输入提示词或任意文本3Input—image / text可切换类型的通用输入源4Load 3D Mesh—mesh加载 3D 文件或当前场景中的模型5Preview Viewsimage—网格化预览多视角图片6For Each文件夹image / text / mesh批量遍历文件夹逐文件处理7While子节点子节点循环容器重复执行内部节点8Wait任意任意手动暂停点确认后才继续9Add to Scenemesh—把结果网格送进 3D 场景所有节点都基于同一个外壳组件 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三种模式选择一个文件夹节点会按字母顺序逐文件发射下游所有已连线的节点会为每个文件各跑一遍运行中支持暂停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 用颜色严格区分数据类型接口颜色不同就无法连线颜色数据类型常见来源天蓝#38bdf8imageImage、Preview Views琥珀#fbbf24textText、Input紫色#a78bfameshLoad 3D Mesh、Add to Scene翠绿#34d399audio音频类扩展灰色#71717a无类型Wait透传任意数据 附加扩展节点Extension Node除了 9 种内置节点Modly 还能把 TripoSG、Mesh Smoother、Mesh Repair、Mesh Optimizer 等能力以扩展节点形式加载进画布。每个扩展用一份manifest.json声明自己的输入/输出类型和参数面板例如 mesh-smoother/manifest.json 声明了迭代次数、平滑强度、Taubin/Laplacian 模式前端由 ExtensionNode.tsx 动态渲染出参数控件无需写代码就能调参。 新手上手3 步搭好第一条 Modly 工作流加输入拖入 Image 节点Browse 选择一张素材图接生成连一条 image 线到 TripoSG或其他图生 3D 扩展调好 Inference Steps、Seed 等参数送场景把 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考