From d3be65a76cd1a13d07167618e692fcb07bffb423 Mon Sep 17 00:00:00 2001 From: tzhouam Date: Sat, 24 Oct 2026 19:10:58 +0000 Subject: [PATCH] knowledge(vllm-omni): 1 change(s) from intake --- .../vllm-omni/models/minimax-h3/_index.md | 1 + .../rules-comfyui-workflow-schema.md | 19 +++++++++++++++++++ 2 files changed, 20 insertions(+) create mode 100644 knowledge/repos/vllm-omni/models/minimax-h3/rules-comfyui-workflow-schema.md diff --git a/knowledge/repos/vllm-omni/models/minimax-h3/_index.md b/knowledge/repos/vllm-omni/models/minimax-h3/_index.md index b1eba2b9..c80b9b34 100644 --- a/knowledge/repos/vllm-omni/models/minimax-h3/_index.md +++ b/knowledge/repos/vllm-omni/models/minimax-h3/_index.md @@ -173,3 +173,4 @@ CPU-only validation limit 见 [encoder state rules](rules-encoder-state.md)。 - [MiniMax-H3 VDNH3 checkpoint 与请求合同](rules-vdnh3.md)。 - [MiniMax-H3 audio VAE 确定性规则](rules-audio-vae-determinism.md) - [MiniMax-H3 ComfyUI audio_mode 与 supplied-audio MV 规则](rules-comfyui-audio.md) +- [MiniMax-H3 ComfyUI 工作流 Schema 规则](rules-comfyui-workflow-schema.md) diff --git a/knowledge/repos/vllm-omni/models/minimax-h3/rules-comfyui-workflow-schema.md b/knowledge/repos/vllm-omni/models/minimax-h3/rules-comfyui-workflow-schema.md new file mode 100644 index 00000000..9d9ab5a7 --- /dev/null +++ b/knowledge/repos/vllm-omni/models/minimax-h3/rules-comfyui-workflow-schema.md @@ -0,0 +1,19 @@ +--- +title: "MiniMax-H3 ComfyUI 工作流 Schema 规则" +created: 2026-10-24 +updated: 2026-10-24 +type: rule +tags: [vllm-omni, models, diffusion] +sources: ["PR #9337"] +--- + +# MiniMax-H3 ComfyUI 工作流 Schema 规则 + +## VLLM-OMNI-PR9337-H3-COMFY-SCHEMA — ComfyUI 节点契约变更必须同步重存 bundled 工作流并区分 legacy 图 + +- 触发：修改 `apps/ComfyUI-vLLM-Omni` 节点的 `INPUT_TYPES()`（如 `VLLMOmniGenerateVideo` 新增 optional 输入口、`VLLMOmniMiniMaxH3Params` 新增 required widget）、`example_workflows/` 下保存的 MiniMax-H3 工作流 JSON，或 `tests/e2e/features/comfyui/test_timeline_guides.py` 的 saved-workflow audit。 +- 强制：节点新增 optional 输入口后，schema-complete 的 bundled 工作流（All-in-One、Music Video、Timeline Guides）里 Generate Video node 的保存 inputs 必须包含该口（本例 `timeline_guides`：type `H3_TIMELINE_GUIDES`、shape 7、`link: null`），并把既有 link 的 target slot 重指到当前位置（新口插入后 url/model/duration 由 9/10/16 变为 10/11/17）。节点新增 required widget（`audio_mode`）时，保存的 inputs 须带对应 COMBO widget entry，`widgets_values` 追加默认值（`VLLMOmniMiniMaxH3Params` 保存 `[3.0, 12.0, "native"]`）。audit 必须以显式集合区分两类图：断言某图包含 `timeline_guides` 当且仅当它属于 schema-complete 集合，legacy 图按 append-only 兼容省略该口；Generate Video 的 optional sockets 须按 `INPUT_TYPES()` 的 optional 顺序保存，`widgets_values` 数量等于 required 数量。比较 `input["type"]` 与 schema 声明时，list 声明的输入按序列化值 `"COMBO"` 匹配。 +- 禁止：让保存的 link 继续指向新口插入前的旧 slot 索引；把 schema-complete 工作流当作可省略新口的 legacy 图（或反之）；只对单个工作流断言新口存在而不参数化覆盖全部 `example_workflows/*.json`；在节点契约已被其他 PR（#9226）改动的 stale base 上合并而不在合并结果上重跑 saved-workflow audit；把 list 声明与序列化 type 直接做相等比较。 +- 验收：`test_saved_workflows_keep_generate_video_slots` 对全部 `example_workflows/*.json` 通过，断言 schema-complete 集合内外的新口存在性、socket 顺序与 widget 数量；`test_h3_timeline_guides_workflow.py` 断言 `VLLMOmniMiniMaxH3Params` 的 `widgets_values == [3.0, 12.0, "native"]` 且 COMBO 类型解析正确；legacy 工作流按 append-only 兼容语义继续通过。^[PR #9337] + +