[diffusion] docs: update ComfyUI sections, trimmed examples, and the RTX 5090 DiT-resident recipe (1.42x) for Qwen-Image-2.1 cookbook (#40573)
Co-authored-by: Mick Qian <mickqian@users.noreply.github.com> Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Mick Qian
Claude Opus 5
parent
69d1e5cfe0
commit
50ec9702d0
@@ -169,6 +169,27 @@ least one real deployment or capability boundary. Put orthogonal runtime feature
|
||||
variant/quant/strategy needs its own image), `multiNodeHints` only for fabric-specific hw
|
||||
(e.g. gb200).
|
||||
|
||||
5. **Diffusion pages: add the ComfyUI section.** Every diffusion cookbook page ends with
|
||||
a `## <n>. Run in ComfyUI` section so a reader never has to guess whether the model is
|
||||
reachable from ComfyUI. It is one component; the per-model facts live in the component,
|
||||
not the page:
|
||||
|
||||
```mdx
|
||||
## <n>. Run in ComfyUI
|
||||
|
||||
import { ComfyUISupport } from '/src/snippets/diffusion/comfyui-support.jsx';
|
||||
|
||||
<ComfyUISupport model="<key>" />
|
||||
```
|
||||
|
||||
Pick `model` from the table in
|
||||
`docs/src/snippets/diffusion/comfyui-support.jsx`. Use the model's own key when it has
|
||||
an entry (its executor or dedicated node differs); otherwise use the generic `image` or
|
||||
`video`. A model gets its own key only when the plugin actually treats it specially —
|
||||
an entry in `executor_class_dict`
|
||||
(`python/sglang/multimodal_gen/apps/ComfyUI_SGLDiffusion/core/generator.py`) or a
|
||||
dedicated node. Adding a key without the matching plugin support makes the page lie.
|
||||
|
||||
### Site-wiring (do all three)
|
||||
|
||||
- **`docs/docs.json`** — add the page under Cookbook → `<category>` → `<Vendor>`, at
|
||||
|
||||
@@ -147,6 +147,18 @@ than restating.
|
||||
equal what the engine emits from the corresponding cell — same flags, same order. Drift
|
||||
here is the most common review miss.
|
||||
|
||||
### 5b. ComfyUI section (diffusion pages)
|
||||
- A diffusion page ends with `## <n>. Run in ComfyUI` rendering `<ComfyUISupport />`. A
|
||||
reader must not have to guess whether the model is reachable from ComfyUI.
|
||||
- The `model` prop is a key that exists in `docs/src/snippets/diffusion/comfyui-support.jsx`.
|
||||
A model-specific key is only correct when the plugin really treats it specially — an entry
|
||||
in `executor_class_dict`
|
||||
(`python/sglang/multimodal_gen/apps/ComfyUI_SGLDiffusion/core/generator.py`) or a dedicated
|
||||
node. Otherwise the generic `image` / `video` key is the honest one; a model-specific key
|
||||
without matching plugin support makes the page claim support that does not exist.
|
||||
- Prose describing ComfyUI support inline instead of using the component is a finding: the
|
||||
facts drift from the plugin.
|
||||
|
||||
### 6. Commands / port
|
||||
- Launch uses `sglang serve` — flag any `python -m sglang.launch_server` /
|
||||
`python3 -m sglang.launch_server` (deprecated). The engine already emits `sglang serve`;
|
||||
|
||||
Reference in New Issue
Block a user