Some checks are pending
Publish to Comfy registry / Publish Custom Node to registry (push) Waiting to run
81 lines
3.4 KiB
Markdown
81 lines
3.4 KiB
Markdown
# v1.3.0 工作流模板与节点替换
|
||
|
||
模板资产位于 `assets/templates/v1.3.0-blank-workflow.json`。它保留 v1.3.0 的完整节点、连线、分组和布局,用于用户明确要求“新建工作流”或没有可编辑工作流时。
|
||
|
||
模板校验信息:ComfyUI workflow version `0.4`,21 个节点,26 条 links,SHA-256 `6ac8498b5a60689f1919387cec960550bdadb4d9bc9459f4be264cfc3c52a470`。
|
||
|
||
## 从空模板生成
|
||
|
||
模板的任务轨道和视频轨道均为空。仅在 SKILL.md 选择“空模板生成”路径时使用;通过 `patch_workflow.py` 写入完整目标 TRACK_DATA,不直接修改模板资产。已有工作流路径不得使用本模板覆盖用户文件。
|
||
|
||
如果不需要替换模型节点,直接以模板为输入应用多轨 plan:
|
||
|
||
```bash
|
||
python3 scripts/patch_workflow.py apply \
|
||
assets/templates/v1.3.0-blank-workflow.json \
|
||
--plan PLAN.json \
|
||
--output NEW-WORKFLOW.json \
|
||
--write
|
||
```
|
||
|
||
根据用户环境替换 loader 或 attention 时,先生成定制模板,再应用多轨 plan。
|
||
|
||
## 模型加载器替换
|
||
|
||
模板主模型链为:
|
||
|
||
```text
|
||
MiniMaxH3HybridLoader (11)
|
||
→ ModelAttentionBackend (13)
|
||
→ LoraLoaderModelOnly (6)
|
||
→ ModelPreviewOverrideKJ (21)
|
||
→ easy modelLoaderPack (16)
|
||
→ easy multitrackProject.model_loader (15)
|
||
```
|
||
|
||
当用户没有 `MiniMaxH3HybridLoader`、明确不想使用它,或要求使用 ComfyUI 默认加载器时,可以把节点 11 原位替换为 `UNETLoader`。节点 ID、位置和现有 MODEL 输出 links 保持不变。模型文件名必须来自用户明确指定或当前 ComfyUI 可用模型列表;不要盲用模板二阶段节点 19 的模型文件。
|
||
|
||
```bash
|
||
python3 scripts/customize_template.py SOURCE.json \
|
||
--output CUSTOMIZED.json \
|
||
--replace-loader \
|
||
--loader-node-id 11 \
|
||
--unet-name minimax_h3_fl2va_pruned_int8_convrot.safetensors \
|
||
--weight-dtype default
|
||
```
|
||
|
||
`UNETLoader` 仍需通过后续 VAE、CLIP 和 `easy modelLoaderPack` 组成 `FAST_MODEL_LOADER`;不要直接把 MODEL 接到 MultiTrack Project 的 `model_loader`。
|
||
|
||
## Attention 后端替换
|
||
|
||
`PathchSageAttentionKJ` 与 `MiniMaxH3MemoryEfficientSageAttentionPatch` 都接收并输出 MODEL,因此可在节点 13 原位替换,同时保持输入 link 51 和输出 link 56。
|
||
|
||
使用通用 Sage Attention:
|
||
|
||
```bash
|
||
python3 scripts/customize_template.py SOURCE.json \
|
||
--output CUSTOMIZED.json \
|
||
--attention-backend pathch-sage \
|
||
--attention-node-id 13 \
|
||
--sage-attention auto
|
||
```
|
||
|
||
使用 MiniMax H3 省显存 patch:
|
||
|
||
```bash
|
||
python3 scripts/customize_template.py SOURCE.json \
|
||
--output CUSTOMIZED.json \
|
||
--attention-backend minimax-memory-efficient \
|
||
--attention-node-id 13
|
||
```
|
||
|
||
两个替换可以在同一次命令中组合。`customize_template.py` 只修改指定节点,拒绝覆盖源文件,并检查顶层 links、节点数量及其他节点内容保持不变。
|
||
|
||
## 选择原则
|
||
|
||
- 用户明确指定节点类型时遵循用户选择。
|
||
- 目标自定义节点缺失时,选择用户环境中已安装且兼容的替代项;无法确认可用节点时先询问。
|
||
- 不因模板提供某个模型、精度或 attention 后端就默认用户环境也有它。
|
||
- 替换后检查 MODEL 链完整,且 `easy modelLoaderPack` 仍收到 model、clip、video VAE 和 audio VAE。
|
||
- 只删除节点会留下断链。若用户要求移除而不是替换,必须重接生产者与消费者,并同步节点 input/output links;优先使用同语义的原位替换。
|