Refine V3.3 interface and diagnostics

This commit is contained in:
ukr8b3g-cmyk
2026-08-17 21:47:13 +09:00
parent 161e17bddf
commit 9753fdf49d
7 changed files with 355 additions and 96 deletions
+81 -15
View File
@@ -156,14 +156,15 @@ Recommended safe defaults:
| Continuity | Balanced - 22 frames |
| Audio Continuity | On |
| Audio Seam | Auto |
| Report Detail | Basic |
| Regenerate From | Auto |
| Run Storage | Off for short tests; Save + Auto Resume for long runs |
| SageAttention | Auto when backend compatibility is unknown |
## H3 Continuum Sampler UI
The production node keeps normal generation controls visible and marks infrequent controls as native ComfyUI **Advanced** widgets. Most users only need the main controls.
The V3.3 production node keeps normal generation controls visible and moves developer-only options to ComfyUI Settings. Connection-specific controls appear only when the related input or Run Storage mode is active.
![H3 Continuum V3.3 streamlined sampler and assembler](docs/images/h3-continuum-v33-streamlined-ui.png)
### Main inputs and controls
@@ -187,15 +188,26 @@ Reference images and First/Last Frame are mutually exclusive. Reference Audio ca
| --- | --- | --- |
| Prompt Format | Auto | Detect Fixed, List, or Timeline prompts. |
| Audio Continuity | On | Carry raw audio context between chunks. |
| Report Detail | Basic | Select the amount of status and diagnostic text. |
| Regenerate From | Auto | Resume normally, or regenerate from a selected saved chunk. |
| `reroll_nonce` | 0 | Automatic Revision behavior. Positive values provide explicit legacy branch selection. |
| Strict Compatibility | On | Stop only on H3 contracts that are actually unsafe or unsupported. |
| Debug | Off | Enable additional troubleshooting output. |
| Show Preview | On | Show normal progress and preview information. |
| Run Storage | Off | Use `Save + Auto Resume` for long or interruptible runs. |
| Run Name | blank | Optional manual storage-name override. Automatic identification is used when blank. |
| Reference Size | Match Output | Choose practical output-area matching or larger identity preservation. |
| Run Name | blank | Appears with `Save + Auto Resume`; optionally overrides the automatic storage identity. |
| Regenerate From | Auto | Appears with `Save + Auto Resume`; reuse normally or regenerate from a selected saved chunk. |
| Variation Nonce | 0 | Appears only for explicit chunk regeneration and creates a deliberate alternate revision. |
| Reference Size | Match Output | Appears when a Reference Image is connected. |
| Timeline Video Size | Efficient - 0.4 MP | Appears when Timeline Video is connected. |
### ComfyUI settings
The following package-wide options are available in ComfyUI Settings instead of occupying every sampler and assembler node:
![H3 Continuum settings](docs/images/h3-continuum-v33-settings.png)
| Setting | Default | Use |
| --- | --- | --- |
| H3 Continuum: Sampling Preview | On | Show normal sampling preview/progress information. |
| H3 Continuum: Developer Diagnostics | Off | Enable developer-oriented diagnostics when troubleshooting. |
| H3 Continuum: Detailed Report | Off | Expand sampler and assembly status text. Normal generation does not require it. |
These settings are applied when the workflow is queued. Hidden legacy widgets remain compatible with older saved workflows, while unknown or merged MODEL filenames are not rejected by name.
### Outputs
@@ -246,6 +258,60 @@ Natural ending.
`Prompt Format = Auto` detects Fixed, List, or Timeline syntax.
### Local LLM / Qwen prompt generation
MiniMax provides the official [H3 prompt-writing skill](https://github.com/MiniMax-AI/MiniMax-H3/tree/main/skills/h3-prompt-writing) for T2VA, I2VA, FL2VA, L2VA, and Ref2VA. Give a local agent the complete `h3-prompt-writing` folder, not only `SKILL.md`, because the detailed formats and examples are stored under `references/`.
The official skill defines the H3 prompt fields and reference-label rules. H3 Continuum adds one routing requirement: divide the visual progression into one prompt section per Continuum chunk. The currently validated workflow uses 5-second chunks.
For reliable output, use `Prompt Format = Timeline` or `Auto` and require:
- exactly one non-empty section per configured chunk;
- sequential ranges such as `[0-5s]`, `[5-10s]`, and `[10-15s]`;
- shared Ref2VA subject and reference definitions only once, before the first timeline section;
- only labels for active connected inputs, using compact Core numbering;
- a different action, camera, and scene progression for each section;
- no explanatory text outside the final H3 prompt.
If fewer usable sections are produced, Continuum may reuse the previous available section. Matching the requested chunk count is therefore strongly recommended.
Copy-paste system instruction for a local LLM:
```text
You write production prompts for ComfyUI-H3-Continuum V3.3.
Use the complete official MiniMax H3 prompt-writing skill as the authority for
T2VA, I2VA, FL2VA, L2VA, and Ref2VA field order, syntax, and reference labels.
The user will provide:
- generation mode;
- chunk count;
- seconds per chunk;
- active image, video, and audio inputs;
- scene requirements.
Output rules:
1. Output only the final H3 prompt. Do not add explanations or Markdown fences.
2. Produce exactly one non-empty Timeline section per requested chunk.
3. Use sequential headers calculated from the supplied chunk duration. For three
5-second chunks, use exactly [0-5s], [5-10s], and [10-15s].
4. Every section must describe the action, camera movement, scene progression,
and relevant sound for that interval. Continue naturally from the previous
section; do not repeat the first section.
5. Mention only active connected references. Number Picture, Video, and Audio
labels compactly in ComfyUI Core order. Never mention bypassed, missing, or
unconnected inputs.
6. For Ref2VA, write subject_definitions, summary, and retention_analysis once
before the first Timeline header. In each Timeline section, provide that
chunk's detailed_description, overall_soundscape, and non_diegetic_music.
7. For T2VA, I2VA, FL2VA, and L2VA, each Timeline section must contain the
official integrated_multimodal_description, overall_soundscape, and
non_diegetic_music structure for that chunk.
8. Preserve requested dialogue, lyrics, and visible text verbatim and in their
requested language. Follow the official H3 dialogue and reference syntax.
9. Do not claim guaranteed frame-perfect continuity or exact audio copying.
```
## Run Storage and automatic resume
For long generations:
@@ -295,7 +361,7 @@ Select `Chunk N` in `Regenerate From` to reuse chunks before N and regenerate N
## Spectrum-aware continuation
With a compatible [ComfyUI Spectrum MiniMax H3](https://github.com/xmarre/ComfyUI-Spectrum-MiniMax-H3), Continuum requests **Actual Prefix 2** for continuation chunks through Interop API v1. Upstream integration is currently pending in [PR #52](https://github.com/xmarre/ComfyUI-Spectrum-MiniMax-H3/pull/52); until it is merged, use the validated PR/Fork receiver and confirm the acceptance log below.
With [ComfyUI Spectrum MiniMax H3](https://github.com/xmarre/ComfyUI-Spectrum-MiniMax-H3), Continuum requests **Actual Prefix 2** for continuation chunks through Interop API v1. First-class H3 Continuum API v1 interoperability is included upstream in Spectrum v0.2.15 and later, so a current standard Spectrum installation can receive this request without a separate fork. Confirm the acceptance log below during runtime validation.
```text
Chunk 1: normal path
@@ -314,9 +380,9 @@ Spectrum H3: accepted H3 Continuum API v1, actual prefix=2
Actual Prefix 2 is active only when the Spectrum log reports that the Continuum API request was accepted. Older or incompatible Spectrum versions continue without that receiver behavior.
### Benefits after the Spectrum upstream merge
### Benefits of the upstream Spectrum integration
Once the Continuum receiver is included in an official Spectrum release, users no longer need a Continuum-specific Spectrum fork or local patch. Installing or updating Spectrum through its normal distribution path will preserve the integration.
The Continuum receiver is included in the official Spectrum release, so users no longer need a Continuum-specific Spectrum fork or local patch. Installing or updating Spectrum through its normal distribution path preserves the integration.
- **Automatic handshake:** Continuum emits the request only for continuation chunks, and Spectrum applies Actual Prefix 2 when it recognizes Interop API v1.
- **Safer chunk transitions:** the first two Transformer evaluations after a new raw AV Context are evaluated normally before Spectrum forecasting resumes. This is intended to reduce forecast instability immediately after a chunk boundary; it does not guarantee that every visible seam or flicker will disappear.
@@ -359,7 +425,7 @@ Turbo LoRA files are available from [LightX2V MiniMax H3 Turbo](https://huggingf
Connect decoded chunk images, audio, and `assembly_plan` to `H3 Continuum Assemble + Seam`.
- Default: `Audio Seam = Auto`, `Video Seam = Auto`, `Report Detail = Basic`.
- Default: `Audio Seam = Auto`, `Video Seam = Auto`.
- Video modes: `Auto`, `Auto 2`, `Analyze Only`, `Off`.
- `Auto` applies guarded transient and micro-flash correction without frame deletion.
- `Auto 2` additionally enables guarded exposure-ramp correction and remains experimental.
@@ -394,7 +460,7 @@ resume=complete
`accelerator markers not detected (informational only)` is not an error. It only means the optional accelerator marker was not observable.
Use `Report Detail = Basic` normally. Enable detailed diagnostics and `debug` only when troubleshooting.
Keep **Detailed Report** and **Developer Diagnostics** disabled normally. Enable them in ComfyUI Settings only when troubleshooting or collecting a diagnostic report.
## Compatibility and scope