OpenMOSS 仓库提供 MOSS-Image 原生 ComfyUI 插件。本教程依据官方安装说明整理，已核对文档与工作流链接，但尚未在本地 GPU 上运行该流程。首页展示的图片是在官方 Space 生成的。
需要准备什么
准备可正常运行的 ComfyUI、相互兼容的 Python/PyTorch/CUDA 环境，以及能容纳所选权重与内存模式的系统内存、磁盘和显存。5B 主干参数量不等于完整管线的显存要求。目前我们尚无经过实测的最低显卡配置建议。
如果只想先尝试布局，可以使用浏览器编辑器和站内生成器。生成器通过你授权的 HF 免费账号调用官方 Space API，沿用其排队与额度限制。
安装原生插件
官方项目表示可以在 ComfyUI Manager 中搜索 MOSS-Image；仓库同时提供手动安装方法。克隆仓库，然后指定已有的 ComfyUI 路径运行安装器：
git clone https://github.com/OpenMOSS/MOSS-Image.git
cd MOSS-Image
python comfyui/install.py --comfy-root /path/to/ComfyUI
将 /path/to/ComfyUI 换成实际安装目录。也可以把仓库中的 comfyui/moss-image/ 目录复制到 ComfyUI/custom_nodes/moss-image/。完成后重启 ComfyUI。官方 README 仍将合入 ComfyUI 主仓库描述为进行中，当前请按插件方式安装。
下载完整模型目录
可以先使用 MOSS-Image-Base，保留完整目录结构，包括：
MOSS-Image-Base/
transformer/
text_encoder/
tokenizer/
vae/
在 MOSS-Image HF Loader 节点中，把 model_path 指向这个本地目录。它不会根据 Hugging Face 模型 ID 自动下载权重，因此不要只把 OpenMOSS-Team/MOSS-Image-Base 当作本地路径填写。
导入官方工作流
在官方 moss-image.json 工作流页面使用 GitHub 的原始文件下载选项，然后将文件拖入 ComfyUI。设置加载器的 model_path，修改正向、负向提示词，再运行工作流。
官方文档给出的起步设置为：1024 × 1024、50 步、CFG 3、Shift 5、Euler 采样器与 sgm_uniform 调度器，以及负向分支跳层 22。这些是采样建议，不是速度或质量保证。插件使用 ComfyUI 的内存管理；显存不足时，请参考当前官方说明，先降低输出尺寸再考虑增加任务量。
使用本站编辑器的布局
在布局编辑器准备构图，把导出的 JSON 粘贴到工作流的正向提示词中。工作流宽高必须与导出画布匹配。首页案例为 1024 × 1024、seed 42，可下载完整输入。
布局提示词 JSON 与 ComfyUI 工作流 JSON 是两种文件。先导入官方工作流，再将布局 JSON 粘贴到提示词输入框；把布局 JSON 直接拖到工作流画布上，不会自动创建所需节点。
常见问题
- 找不到 MOSS 节点： 确认插件放在当前使用的 ComfyUI 的
custom_nodes中，重启并查看启动报错。 - 找不到模型： 检查本地路径与四个模型子目录。加载器不会自动根据 Hub ID 获取模型。
- 位置与预期不符： 检查输出尺寸是否匹配，坐标是否为中心原点的
yxyx格式，参阅布局坐标指南。 - 与 Space 出图不同： 官方插件文档明确提示，ComfyUI 原生采样与独立管线有差异，相同种子和参数也不保证像素一致。
- 文字错字或多字： 每次使用前检查输出。布局控制属于实验性功能，我们的真实样例也包含模型额外添加的英文。
官方资料
ComfyUI 插件 README、模型用户指南、模型官方项目。说明核对日期为 2026 年 10 月 17 日，后续安装应同时查看上游更新。本站是独立第三方教程。