3.4 KiB
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:
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。
模型加载器替换
模板主模型链为:
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 的模型文件。
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:
python3 scripts/customize_template.py SOURCE.json \
--output CUSTOMIZED.json \
--attention-backend pathch-sage \
--attention-node-id 13 \
--sage-attention auto
使用 MiniMax H3 省显存 patch:
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;优先使用同语义的原位替换。