Skip to content

knowledge(vllm-omni): 1 change(s) from intake #412

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tzhouam merged 1 commit into from
Oct 24, 2026
Merged

knowledge(vllm-omni): 1 change(s) from intake #412

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions knowledge/repos/vllm-omni/models/minimax-h3/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)
19 changes: 19 additions & 0 deletions knowledge/repos/vllm-omni/models/minimax-h3/rules-comfyui-workflow-schema.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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]

<!-- kb:rule status=active since=v0.30.0 -->
Loading