Trellis 2 ComfyUI 工作流下载：读懂 JSON、修好报错的节点图，以及四种常见变体

从节点包的 examples 目录、模型仓库或者社区站点下载来的 TRELLIS 2 工作流，落地就是一个 .json 文件。里面没有权重、没有代码、也没有贴图，只有一张节点图的描述：画布上有哪些节点类型、接口之间怎么连、每个参数控件里填了什么值。把它拖到画布上就会重建出这张图，所以在点排队之前先读懂文件是值得的。

大多数“下载问题”其实是“对不上”的问题。图期待某个节点包提供的节点类，期待权重文件躺在固定目录里、文件名一字不差，也期待前端足够新、认识塞给它的那些控件。这几件事里随便哪一件不对，画布上就会出现红框、加载器会拒绝文件名，或者任务跑完了但参数悄悄变了样。

ComfyUI 工作流 JSON 里到底装了什么

同一张节点图，ComfyUI 会保存成两种形状的 JSON。File → Save 写出的是保存格式，带版面信息：nodes 数组里每一项有 id、LoadImage 或 SaveGLB 这样的 type、描述接口的 inputs 与 outputs，以及一个 widgets_values 数组；旁边还有 links，把输出槽接到输入槽，以及 groups，那些让大型节点图还能看懂的分组框。File → Export Workflow (API) 把这些全部丢掉，只按节点 id 保留 class_type 与 inputs，因为 /prompt 接口要的就是这个。

• 前端版本：新版前端保存的图，控件元数据的写法跟 2023 年前后的老文件不同，特别老的文件加载后节点可能全叠在一个角上。
• 自定义节点类：type 字符串就是 Python 类名，没装对应的 TRELLIS 2 包装包，它的每个节点都会变成红色占位框。
• 参数值：widgets_values 按位置排列而不是按名字对应，节点包新增一个控件，排在后面的值就整体错位一格。
• 权重文件名：加载器控件里存的是文件名而不是路径，图期待某个确切的名字出现在某个确切的目录里。

加载下载来的图：按正确的顺序修

1. 把 .json 拖到画布上。来自渲染图的 PNG 也能拖，因为 SaveImage 会把工作流写进图片元数据。
2. 先看 Missing Node Types 对话框，它列出了这份文件需要的类名。ComfyUI Manager 能按包名解决大部分问题，但要看清它推荐的仓库。
3. 装完会注册新节点类、或者带 CUDA 扩展的包之后，重启 ComfyUI 服务端；只刷新浏览器是不够的。
4. 从左往右修控件：把被翻转的勾选框重新选回来，把采样步数重填一遍，并把每个加载器重新指向真实存在的权重文件。
5. 先用小分辨率、少步数排一次任务，盯住第一个失败的节点；它上面几行的控制台输出通常才说出了原因。

参数错位值得单独说一段，因为上表里只有它是无声的：画布上没有红色，图也跑得完，只是网格变差了。一个包装节点如果在步数前面多出一个勾选框，后面所有值就整体右移一格，原本的随机种子 12345 可能落进 dropout 字段里。做法很简单：拿一个从节点搜索里新拖出来的同类节点对一下控件个数，第一次跑陌生图时把每个控件都悬停看一遍说明。

四种 TRELLIS 2 变体各自改了什么

图生 3D：基础链路的分组走查

图生 3D 的图可以分成五组节点。加载与预处理组里有图像加载器，通常还有一步去背景，因为 TRELLIS 2 以这张图为条件，杂乱的背景最后会变成不属于主体的几何。条件编码组把它编码成流模型要读的特征。采样组里是两段流匹配模型：一段决定稀疏结构出现在哪里，另一段在结构内部补全形状与外观潜变量，分辨率、随机种子和步数都在这一组设置。解码组把稀疏 3D VAE 的输出交给网格阶段：颜色或 PBR 通道、简化目标面数、可选的重新网格化、写出 GLB，最后用 Preview3D 收尾。

文生 3D：前面接一个图像模型

TRELLIS 2 以图像为条件，所以文生 3D 工作流就是在同一条链路前面接一个渲染器：权重加载器、CLIP 文本编码、空潜变量节点加一个采样器产出一张图，交给条件编码节点。这里有两件事值得注意。图的水平取决于那个 2D 模型，提示词含糊，出来的就是扁平、对称的主体，而 TRELLIS 2 会忠实地把它重建出来。两个阶段还要抢同一块显卡，所以更常见的做法是先渲一批候选图，跑 3D 之前再把文本分支静音。

多视图：2–4 张图对应一个物体

多视图的图给条件加了一个视角维度：每张输入图会跟视图序号或相机参数配对，采样时同时关注所有视图。正是这层额外条件让物体的背面被推断出来。它同时带来新的失败方式：各视图必须在比例、朝向和光照上保持一致，更不能是四个微妙不同的物体，否则模型只会把这些分歧平均成一个臃肿的轮廓。两张角度相对的照片，通常比同一侧拍的四张近似图更有用。

低显存 GGUF：同一张图，更轻的权重

GGUF 变体没有改变图的形状，改的只是采样组里的东西。大型流模型的量化副本以 GGUF 文件存放，常见取舍是 Q4_K_M 与 Q5_K_M，显存有富余时用 Q8_0，GGUF 加载器节点会代替全精度权重来读取它们。代价是占用更小、采样更慢，因为反量化要在送往显卡的路上完成。内存也是会累积的：稀疏 3D VAE、图像编码器，以及文生 3D 里的文本编码器都会常驻，而 ComfyUI 在清缓存之前会把模型跨任务留在显存里。

这些图一般从哪里来，跑之前该核对什么

• 内置模板：前端的 Templates 浏览器带一套挑选过的模板，和你当前安装的核心节点版本是匹配的。
• 模型仓库：TRELLIS 2 项目会在权重旁边放出示例节点图，接近参考实现。
• 节点包仓库：包装包自己的 examples 目录最可靠，作者是拿它对着自己发布的版本测的。
• 社区站点：方便但质量参差。看一下权重附带的许可、这张图第一次运行会不会自动下载东西，以及它依赖的包还有没有人维护。

什么时候节点图本身并不是重点

当你需要可复现、需要某一个具体的研究权重，或者要跨几十个随机种子做参数扫描时，节点图值得那套安装成本。可如果目标更窄——一张照片进去，一个带贴图的网格出来，格式能让引擎或切片软件直接接受——那这张图就成了一件没有回报的维护工作。Open3DAI 针对的正是这个缺口：同一个提示词或同一张图可以交给可用的引擎，在导出之前并排比较结果，再导出为 GLB、glTF、OBJ、STL、PLY 或 3MF，另外提供 48 个格式转换器、12 个浏览器工具和用于脚本化调用的 REST API。它不会替你运行 TRELLIS 2，不训练也不托管第三方模型，不做重拓扑、UV 展开和绑定。需要指定权重和节点级控制就继续用 ComfyUI，需要今天拿到文件就走在线那条路。

常见问题

在 Open3DAI 中试一下

把同一份提示词或图片交给多个引擎，并排对比网格，然后导出 GLB、glTF、OBJ、STL、PLY 或 3MF。注册即赠免费积分，无需信用卡。