ComfyUI 部署 MOSS 图像模型的隐性坑

MOSS-Image 的吸引力是用边界框或 JSON 指定画面布局，但作者折腾一晚，时间主要花在文件放置、工作流兼容和节点加载上。他的核心提醒是：生成噪声不一定说明模型不好，也可能是安装缺项，或权重与采样设置不匹配。

这篇经验值得读的地方，是把几种看起来像「模型失效」的问题拆开了。对准备在 ComfyUI 中尝试布局生成的程序员来说，先验证最小出图链路，再接复杂布局，能让排查更有方向。

能运行、没报错，为什么还是生成噪声

按原文介绍，OpenMOSS 于 2026 年 10 月 16 日发布了 MOSS-Image：一个采用 Apache 2.0 许可、参数量为 5B 的文生图模型，架构是单流扩散 Transformer。

作者遇到的第一个坑，是它不能按「下载一个 checkpoint 就完事」来理解。两个文本编码器分别提供，而且都必须齐全。作者称，编码器缺失或不匹配时，ComfyUI 仍可能运行，最后输出噪声，没有明确提示缺了文件。

这会误导排查顺序：先改提示词，再换采样器，接着调步数，最后才发现文件没有放对。作者形容，明确报错可能两分钟就能处理，静默失败却让他耗掉一个小时。

下面是原文给出的目录结构，用来区分不同权重的放置位置：

├── diffusion_models/ ← MOSS-Image checkpoint

├── text_encoders/ ← text encoder files

└── vae/ ← VAE, if distributed separately

重点看 text_encoders/：两个编码器都要检查；vae/ 则取决于 VAE 是否单独分发。原文没有列出具体文件名，也没说明如何校验版本，不能把这棵目录树当作完整安装清单。

作者给了两条路径：使用 Comfy-Org 按目录结构整理的相同权重重打包版本，减少手动放置工作；或者从官方 OpenMOSS 仓库获取最新、未经修改的文件，再自行安排位置。

工作流和权重必须一起核对

第二个坑来自工作流复用。MOSS-Image 使用 DiT，并非 UNet。作者尝试拿 SDXL 工作流替换加载器，结果遇到了难以理解的报错。他的结论是，要使用模型对应的加载器，不能默认旧图直接兼容。

这里实用的部分是兼容性提醒。原文还把它与 SD 1.5、SDXL 的处理方式作了架构比较，但没有展开技术细节，也没有给出节点名称和依赖版本，无法据此还原具体失败原因。

第三个坑是节点包装好后没有重启。通过管理器安装，或克隆到 custom_nodes/ 后，都要重启 ComfyUI。作者遇到的情况是，节点包尚未被加载，与完全没安装时一样，都提示「节点不存在」。

之后还要核对模型变体：

• SFT 是基础版本，作者建议使用 20–30 步，认为它的保真度更好。
• Turbo 是 LoRA，作者称约 4–8 步即可使用，适合快速迭代。

作者曾为了速度先选 Turbo，后来忘记自己安装的版本。按他的经历，用 Turbo 工作流运行 SFT 权重，同样会生成噪声，很容易被误判成安装损坏。

看到噪声时，先检查文件和变体，再调整提示词。

布局控制要等基础出图通过以后再接

MOSS-Image 的关键能力，是通过边界框或 JSON 布局指定对象位置。相比仅用文字描述构图，它允许先安排区域，再描述各区域的内容。

但作者建议，第一次运行先别接布局工作流。先搭最小文生图链路：模型 checkpoint、编码器、简短提示词，输出设为 1024×1024，确认能够生成图片，再加入布局约束。

这样排查时就少一组变量。基础链路没通过时，复杂布局图里的故障可能来自安装，也可能来自提示结构，两者混在一起很难判断。

出图成功后，作者推荐「先布局，后描述」：先规划对象放在哪里，再写每个区域里有什么。他观察到，先写完整描述再强加位置，容易让两类约束互相冲突。

至于速度，作者认为 5B 参数在这个分辨率下足以支持快速迭代，但没有提供显卡型号、显存占用或单张耗时。

我的判断

这篇最有价值的是排查顺序。把文件、节点加载、工作流和变体逐项核对，比盯着生成结果猜测更可执行。最小出图通过后再增加布局约束，也符合控制变量的调试习惯。

不过，它是一份个人踩坑记录。编码器缺失时是否总会静默失败、不同加载器会报什么错，都可能受 ComfyUI 和节点包版本影响，原文没有交代这些环境信息。

SFT 保真度更好、Turbo 适合快速迭代，以及先布局再描述的效果，也没有对照数据，应当视为作者的经验。相较纯文本描述，结构化布局确实提供了更明确的位置表达方式；但它的位置遵循程度、画质代价，原文没有量化。

能拿来做什么

• 第一次安装时，先核对 checkpoint、两个文本编码器及单独分发的 VAE，再用简短提示词跑通 1024×1024 文生图。
• 保存工作流时，把 SFT 或 Turbo 写进名称，同时记录权重文件和步数设置，减少下次打开时混用配置的机会。
• 安装节点包后重启 ComfyUI，再检查节点是否出现；遇到「节点不存在」时，先确认加载状态。
• 基础出图通过后，再添加边界框或 JSON 布局，并尝试先安排区域、后补内容描述，每次只增加一类约束。