ComfyUI UltraShape 1.0: 生产就绪的网格优化和形状优化
ComfyUI UltraShape 1.0 是一个专注的网格优化管道，将粗糙或嘈杂的几何图形升级为更平滑、更一致的资产，准备好用于渲染、动画和下游生产。尤其适用于需要表面清理、结构一致性和改进细节的AI生成或扫描网格。
整个工作流程在ComfyUI内运行。您提供一个粗糙的3D网格，并可选地提供一个引导图像。ComfyUI UltraShape 1.0 加载其优化模型，清理输入几何，执行形状优化，保存GLB，并显示交互式3D预览，一次性完成。
Comfyui ComfyUI UltraShape 1.0 工作流程中的关键模型
- UltraShape v1 检查点。驱动网格清理、表面平滑和细节重建的核心优化模型。在此工作流程中，它由
UltraShapeLoadModel加载，并由使用与扩散-变换器风格设计一致的优化策略的YAML配置。有关打包的检查点和配置文件，请参见项目存储库：ComfyUI-UltraShape1。有关扩散变换器的架构背景，请参见 DiT: Scalable Diffusion Models with Transformers。
如何使用 Comfyui ComfyUI UltraShape 1.0 工作流程
此图表遵循从输入到输出的清晰路径：加载模型，导入粗糙网格，可选地提供参考图像，优化形状，然后输出和预览结果。以下阶段描述了每个部分的作用以及您在何处提供输入。
阶段1：参考图像输入 (LoadImage (#7))
- 加载一个代表目标比例、轮廓提示或对象特征细节的图像。图像是可选的，用作优化期间的软引导，而不是严格的纹理投影。使用光线充足的正面或三分之一视图对许多资产效果良好。如果您希望仅依靠几何驱动的优化，可以跳过此步骤。即使没有图像，ComfyUI UltraShape 1.0 仍会生成一致的改进网格。
阶段2：3D模型导入 (Load3D (#8))
- 将节点指向您的粗糙网格文件。GLB 是此工作流程的首选，尽管如果您的构建支持，其他常见格式可能也能使用。节点传递路径字符串，以便加载器可以可靠地获取和预处理网格。保持文件名简单，避免使用不寻常的字符以防止路径问题。如果您的场景有多个对象，请从单个网格开始以获得可预测的结果。
阶段3：模型设置 (UltraShapeLoadModel (#1))
- 加载 UltraShape v1 检查点及其相应的配置。精度可以设置为 bfloat16 或其他支持的选择，以平衡速度和内存。节点初始化一次，并为网格加载器和优化器提供输入，以便预处理和优化共享一致的权重。ComfyUI UltraShape 1.0 受益于现代GPU，但根据精度和网格复杂性可在不同硬件上运行。
阶段4：粗糙网格加载和清理 (UltraShapeLoadCoarseMesh (#3))
- 节点从阶段2接收文件路径，并准备稳定、规范化的网格表示进行优化。它解决了比例和方向问题，去除明显的伪影，并确保几何处于模型友好的状态。此准备减少了下游的不稳定性，并有助于保持大规模结构。如果您的网格在预览中看起来很小或很大，请重新访问此阶段并在优化前调整输入比例或上游单位。
阶段5：优化和形状优化 (UltraShapeRefine (#2))
- 这是 ComfyUI UltraShape 1.0 的核心部分。节点接收模型、准备好的粗糙网格和可选的参考图像。它运行一个迭代优化，平滑噪声，锐化显著特征，并在尊重输入拓扑的同时提高结构一致性。为了可重复性，提供了一个种子，并提供了一个拓扑模式，以便在您需要一致的顶点索引用于装配或混合形状时保持连接性。
阶段6：导出和3D查看 (UltraShapeSaveGLB (#4) 和 Preview3D (#6))
- 优化后的网格以GLB格式写入磁盘，适合DCC工具和实时引擎。文件路径直接输入到查看器中，您可以在图表中旋转、缩放和检查表面。这个紧密的循环使您能够快速比较变体，并确认平滑和细节是否达到了预期。如果需要，可以使用新种子或略微不同的设置重新运行，以使用 ComfyUI UltraShape 1.0 生成受控的变体。
Comfyui ComfyUI UltraShape 1.0 工作流程中的关键节点
UltraShapeLoadModel (#1)
- 加载 UltraShape v1 检查点及其YAML配置，并设置计算精度。选择与配置匹配的检查点，优先选择支持的GPU上的 bfloat16，以获得良好的速度和内存平衡。如果您切换精度或配置，请在运行之间保持一致，以便优化结果具有可比性。
UltraShapeLoadCoarseMesh (#3)
- 读取网格路径并为优化器生成稳定的粗糙表示。使用它来确保一致的单位、方向和合理的面密度，以便优化。如果您的源网格非常密集或非常稀疏，请在上游准备以便更好地收敛。
UltraShapeRefine (#2)
- 使用加载的模型、粗糙网格和可选的参考图像执行核心形状优化。增加迭代次数以提高质量，但会增加时间成本。使用种子锁定结果，以便您需要确定性时使用。当拓扑模式设置为
fixed时，预计顶点数量和连接性将保持稳定，这对于装配资产和变形目标很重要。
UltraShapeSaveGLB (#4)
- 将优化后的网格导出到磁盘，并返回文件路径以供下游使用。设置文件夹、基本名称和扩展名以组织多个版本。因为查看器监听此路径，您可以通过调整运行之间的名称快速比较输出。
LoadImage (#7)
- 提供可选的2D提示，帮助锚定全局比例或表面提示。使用中性照明，并避免强烈的透视失真，以获得最可靠的指导。如果图像无关，请省略它，而不是注入冲突信号。
Load3D (#8)
- 提供加载器使用的源网格路径。GLB 是此工作流程中最简单的选择。保持变换烘焙，避免非均匀缩放，以防止归一化期间出现意外。
可选附加功能
- 尽可能从防水或接近防水的网格开始，以帮助优化器保持干净的表面。
- 在工具之间保持单位一致性，以便 ComfyUI UltraShape 1.0 在清理期间不需要执行大规模缩放。
- 从中等迭代次数开始，在查看器中查看，然后仅在有回报的地方提高质量。
- 使用不同的种子探索微妙的几何变体，同时在 ComfyUI UltraShape 1.0 中保持其他设置不变。
- 使用不同的文件名保存中间版本，以便在外部DCC中快速A/B比较输出。
致谢
此工作流程实现并基于以下工作和资源构建。我们感谢 jtydhr88 为 ComfyUI-UltraShape1 所做的贡献和维护。有关权威细节，请参阅以下链接的原始文档和存储库。
资源
- jtydhr88/ComfyUI-UltraShape1
- GitHub: jtydhr88/ComfyUI-UltraShape1
- Hugging Face: infinith/UltraShape
- arXiv: 2512.21185
注意：使用所引用的模型、数据集和代码需遵循其作者和维护者提供的相应许可和条款。
