Chenkin-x / ComfyUI-Moss-Image-Edit

# MOSS Image Edit for ComfyUI
English · 编辑效果
> [!IMPORTANT]
> **ComfyUI 官方已支持 MOSS-Image Edit**，详见已合并的 ComfyUI #17296。
> 请将 **ComfyUI 本体**更新到包含该改动的最新版本，重启并刷新页面后使用官方节点。在 **Text Encode MOSS-Image Edit** 中，将 `edit_format` 设为 **Moss-Image-Edit**。
**训练代码：** Chenkin-x/Moss-Image-Edit · 训练入口 `train.py` · 训练配置 `configs/train.json`。
以下是本仓库自定义节点与示例工作流的使用说明。
通过官方加载器和 KSampler 使用 MOSS Edit。**Apply MOSS Edit** 集中接收模型、补丁、VAE、正负条件、待编辑原图和可选的多张附加参考图，输出 `MODEL / positive / negative`，无需手动复制参考 latent 连线。
## 标准工作流：下载 JSON / 查看完整连线
**首次使用推荐 SFT 单图编辑。** 下载 JSON 后拖入 ComfyUI；导入前先完成下方环境检查，导入后选择自己的四类模型并上传输入图。
| 示例 | 可导入的工作流 JSON | 完整画布 PNG |
|---|---|---|
| **SFT 单图编辑（推荐起点）** | 下载 JSON | 查看 / 下载图片 |
| Base BF16 对照（效果需评估） | 下载 JSON | 查看 / 下载图片 |
| 多图编辑（已接入推理，当前 LoRA 效果需评估） | 下载 JSON | 查看 / 下载图片 |
**打开示例目录：三套大图、输入图片和使用步骤 →**
JSON 页面点击 **Download raw file** 保存，不要保存 GitHub 网页。PNG 同时内嵌对应工作流，也可下载原图后拖入 ComfyUI；`.api.json` 供 API 调用，不是画布导入文件。这些示例需要本分支配套的原生节点实现。
## 安装
先使用已经原生支持 **MOSS Image、Qwen3.5 TE 和对应量化格式**的 ComfyUI，底模应先能在官方工作流中正常加载。原生 MOSS 于 2026-10-16 合入，核心至少需包含 `e087d8f6`；`v0.41.3` 尚不包含支持，见 官方说明。**本插件实际验证基线为官方 v0.42.3**；合入提交只是 MOSS 的起点，不代表所有早期版本都已验证 Edit 接口。预检还会检查本插件使用的原生接口。
| 项目 | 要求与验证范围 |
|---|---|
| ComfyUI 核心 | 原生 MOSS、Qwen3.5 TE、MODEL_PATCH、ModelPatcher、预取接口及标准工作流节点齐全；推荐以已验证的 v0.42.3 为起点 |
| Python | 遵循所用核心的要求；v0.42.3 声明 `>=3.10`，本机验证 3.12.10，不将所有 Python 版本视为已测试 |
| Python 包 | 采用**本机当前核心**的 `requirements.txt`，不复制一份容易过期的插件版本锁。该基线声明 Transformers `>=4.50.3`、safetensors `>=0.4.2`，这不是对所有旧版本组合的实测承诺 |
| PyTorch / GPU | 沿用能运行原生 MOSS 的环境；本机验证 Torch 2.9.1+cu130。插件不负责替换 Torch、CUDA、驱动或量化后端 |
| 模型 | 事先准备下表四类权重；文件格式需受所用核心支持。安装检查不加载模型，不证明文件正确或显存够用 |
2026-10-23 跨机器实测（均为核心 v0.42.3）：
| 环境 | 模型与验证 |
|---|---|
| Windows / RTX 4060 Laptop 8GB / Python 3.12.10 / Torch 2.9.1+cu130 / Transformers 5.5.3 | SFT INT8 + TE INT8，单图与双图均实际出图；Edge 桌面画布拖线、动态端口增删通过 |
| Linux / RTX 5090 32GB / Python 3.14.6 / Torch 2.11.0+cu130 / Transformers 4.57.1 | SFT BF16 + TE BF16，512 单图、512 双图、1024×1024/30步双图均实际出图 |
这些是已验证组合，不表示所有中间版本都已测试；**至少在上述原生环境中无需 Transformers 5.x**。远端旧核心 v0.35.0 被预检明确拒绝；测试使用独立核心和隔离依赖目录，共享环境包清单前后未变。
 [code] 
克隆后，在插件目录双击 **`install.cmd`** 检查。它只查找相邻的秋叶/便携 Python 或 `.venv` / `venv`；找不到或找到多个时会停止，不回退到系统 Python。启动器使用自定义 Python 时，请显式指定实际解释器：
 [code] 
Linux/macOS、源码安装或需要保存诊断报告时，用**启动 ComfyUI 的同一个 Python**运行：
 [code] 
路径仅为示例。ComfyUI-Manager 的常规安装流程会调用 `install.py`；不同管理器、跳过依赖模式和手动克隆不保证执行，必要时手动运行。当前版有意不附空的 `requirements.txt`：本机 Manager 即使读到空依赖文件也会进入包修复分支，去掉它可避免这条不必要的触发路径。Manager 或启动器自身其他依赖修复策略不由本插件控制。
检查通过后，重启 ComfyUI 并刷新页面、导入标准工作流。这一原生实现**没有插件专属 Python 依赖**，正常安装不需要下载或升级包，不另建环境，不要求额外安装 Diffusers、Accelerate、Optimum Quanto 或指定 Transformers 5.x。
### 安装诊断与环境保护
`install.py` 是只读预检，不在启动时执行 pip，不修改核心、现有包或模型文件。因此没有“先覆盖再尝试退回”的步骤，检查失败时原环境保持不变。
1. 打印实际 Python 路径、Python 和核心版本；检查原生 MOSS 及工作流接口。
2. 对照当前核心声明，逐项列出**缺失包、已安装版本和所需版本范围**。核心标为非必要的依赖单独警告。
3. 列出当前环境已存在的包依赖声明冲突。其他插件的历史冲突不自动修复，也不单独作为 MOSS 不可用的结论。
4. 在独立 CPU 进程导入所需原生模块，不加载模型、不执行其他自定义节点。导入失败会显示具体异常。
5. 返回 `0` 表示预检通过（仍可能有历史警告），`2` 表示依赖/接口不充分，`3` 表示检查未完成。CMD 窗口保留结果，