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

81 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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