MMnode/skills/easy-media-multitrack-workflow/references/template-workflow.md
turtle89431 4ea8431cd0
Some checks are pending
Publish to Comfy registry / Publish Custom Node to registry (push) Waiting to run
init
2026-09-26 11:11:23 -07:00

3.4 KiB
Raw Blame History

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;优先使用同语义的原位替换。