Release H3 Continuum V3.2.2

This commit is contained in:
ukr8b3g-cmyk
2026-08-14 03:24:00 +09:00
parent a908e4884f
commit 85c626cd3d
9 changed files with 71 additions and 37 deletions
+8
View File
@@ -1,5 +1,13 @@
# Changelog # Changelog
## 3.2.2
- Added a third ordered Reference Image input to the production sampler.
- Required Reference Images to be connected contiguously from Image 1.
- Allowed Ref2VA, FL2VA, and unverified checkpoints with Reference conditioning.
- Kept checkpoint classification as diagnostics without automatic MODEL switching.
- Kept Strict Compatibility for genuinely unsafe or unsupported H3 contracts.
## 3.2.1 ## 3.2.1
- Declared V3.2.1 stable after GitHub Actions, Windows Ref2VA generation, Spectrum Actual Prefix 2, chunk integrity and complete Auto Resume passed. - Declared V3.2.1 stable after GitHub Actions, Windows Ref2VA generation, Spectrum Actual Prefix 2, chunk integrity and complete Auto Resume passed.
+2 -2
View File
@@ -2,7 +2,7 @@
Native long-form MiniMax H3 video and audio continuation for ComfyUI. Native long-form MiniMax H3 video and audio continuation for ComfyUI.
**Stable release:** V3.2.1. The production path has passed local syntax and pytest checks, GitHub Actions, Windows generation, Ref2VA Reference + Continuation, Spectrum Actual Prefix 2, and complete Run Storage resume. **Current package:** V3.2.2. It extends the validated V3.2.1 baseline with a third ordered Reference Image and diagnostic-only Ref2VA/FL2VA checkpoint classification.
https://github.com/user-attachments/assets/bfa8c683-fc9d-48f1-9cdb-477ca110cdf2 https://github.com/user-attachments/assets/bfa8c683-fc9d-48f1-9cdb-477ca110cdf2
@@ -80,7 +80,7 @@ The sampler selects the mode from connected image inputs.
Reference images and First/Last Frame are mutually exclusive. `Reference 2` cannot be used without `Reference 1`. Reference images and First/Last Frame are mutually exclusive. `Reference 2` cannot be used without `Reference 1`.
For the formally supported Reference path, connect a MiniMax H3 **Ref2VA** MODEL upstream. With **Strict Compatibility** enabled (the default), Reference generation stops unless the upstream base checkpoint can be verified as Ref2VA. FL2VA MODEL + Reference conditioning has also worked in local testing, but requires Strict Compatibility to be disabled and remains experimental. Reference Image 1, 1+2, or 1+2+3 may be connected. Gaps are rejected. **Ref2VA** is the reference-specialized checkpoint and may provide stronger reference fidelity, while **FL2VA + Reference** is also allowed. Checkpoint classification is diagnostic only; the sampler never switches MODELs automatically. **Strict Compatibility** remains reserved for H3 contracts that are actually unsafe or unsupported.
Reference prompts should identify the images explicitly: Reference prompts should identify the images explicitly:
+1 -1
View File
@@ -1,4 +1,4 @@
[project] [project]
name = H3 Continuum name = H3 Continuum
version = 3.2.1 version = 3.2.2
description = Native MiniMax H3 continuation with Core VAE decode, Reference conditioning and crash-safe Run Storage. description = Native MiniMax H3 continuation with Core VAE decode, Reference conditioning and crash-safe Run Storage.
+3 -3
View File
@@ -1,10 +1,10 @@
[project] [project]
name = "comfyui-h3-continuum" name = "comfyui-h3-continuum"
version = "3.2.1" version = "3.2.2"
description = "Integrated N-chunk continuation for ComfyUI native MiniMax H3 video and audio" description = "Integrated N-chunk continuation for ComfyUI native MiniMax H3 video and audio"
readme = "README.md" readme = "README.md"
requires-python = ">=3.10" requires-python = ">=3.10"
license = { text = "MIT" } license = { file = "LICENSE" }
authors = [{ name = "ukr8b3g-cmyk" }] authors = [{ name = "ukr8b3g-cmyk" }]
dependencies = [] dependencies = []
keywords = ["comfyui", "minimax-h3", "video", "audio", "continuation"] keywords = ["comfyui", "minimax-h3", "video", "audio", "continuation"]
@@ -15,4 +15,4 @@ Repository = "https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum"
[tool.comfy] [tool.comfy]
PublisherId = "ukr8b3g-cmyk" PublisherId = "ukr8b3g-cmyk"
DisplayName = "H3 Continuum" DisplayName = "H3 Continuum"
Icon = "" requires-comfyui = ">=0.32.0"
+11
View File
@@ -133,16 +133,27 @@ def prepare_reference_assets(
output_width: int, output_width: int,
output_height: int, output_height: int,
size_mode: str, size_mode: str,
reference_image_3: torch.Tensor | None = None,
) -> ReferenceAssets | None: ) -> ReferenceAssets | None:
if reference_image_1 is None: if reference_image_1 is None:
if reference_image_2 is not None: if reference_image_2 is not None:
raise ReferenceConditioningError( raise ReferenceConditioningError(
"Reference Image 2 requires Reference Image 1" "Reference Image 2 requires Reference Image 1"
) )
if reference_image_3 is not None:
raise ReferenceConditioningError(
"Reference Image 3 requires Reference Images 1 and 2"
)
return None return None
if reference_image_3 is not None and reference_image_2 is None:
raise ReferenceConditioningError(
"Reference Image 3 requires Reference Image 2"
)
inputs = [reference_image_1] inputs = [reference_image_1]
if reference_image_2 is not None: if reference_image_2 is not None:
inputs.append(reference_image_2) inputs.append(reference_image_2)
if reference_image_3 is not None:
inputs.append(reference_image_3)
images = tuple( images = tuple(
_resize_reference( _resize_reference(
_validate_image(f"Reference Image {index}", image), _validate_image(f"Reference Image {index}", image),
+1 -1
View File
@@ -139,4 +139,4 @@ def test_v217_result_pack_expands_legacy_outputs():
def test_v217_has_no_frontend_display_controller(): def test_v217_has_no_frontend_display_controller():
assert not (ROOT / "web" / "h3_continuum_v2.js").exists() assert not (ROOT / "web" / "h3_continuum_v2.js").exists()
version_source = (ROOT / "version.py").read_text(encoding="utf-8") version_source = (ROOT / "version.py").read_text(encoding="utf-8")
assert 'PACKAGE_VERSION = "3.2.1"' in version_source assert 'PACKAGE_VERSION = "3.2.2"' in version_source
+33 -8
View File
@@ -66,6 +66,32 @@ def test_reference_socket_rejects_image_batches():
) )
def test_three_reference_images_are_ordered_and_contiguous():
assets = prepare_reference_assets(
reference_image_1=torch.zeros((1, 32, 32, 3)),
reference_image_2=torch.ones((1, 32, 32, 3)),
reference_image_3=torch.full((1, 32, 32, 3), 0.5),
output_width=32,
output_height=32,
size_mode=REFERENCE_SIZE_MATCH_OUTPUT,
)
assert assets is not None
assert assets.count == 3
assert validate_reference_prompts(["Use <Picture 1>, <Picture 2>, and <Picture 3>."], 3) == ""
def test_reference_image_3_rejects_gaps():
with pytest.raises(ReferenceConditioningError, match="requires Reference Image 2"):
prepare_reference_assets(
reference_image_1=torch.zeros((1, 32, 32, 3)),
reference_image_2=None,
reference_image_3=torch.zeros((1, 32, 32, 3)),
output_width=32,
output_height=32,
size_mode=REFERENCE_SIZE_MATCH_OUTPUT,
)
def _reference_prompt(checkpoint_name: str) -> dict: def _reference_prompt(checkpoint_name: str) -> dict:
return { return {
"1": { "1": {
@@ -79,20 +105,19 @@ def _reference_prompt(checkpoint_name: str) -> dict:
} }
def test_strict_reference_requires_ref2va_checkpoint(): def test_reference_checkpoint_classification_is_diagnostic_only():
assert _validate_reference_checkpoint( assert _validate_reference_checkpoint(
_reference_prompt("minimax_h3_ref2va_pruned_int8.safetensors"), _reference_prompt("minimax_h3_ref2va_pruned_int8.safetensors"),
"2", "2",
strict_compatibility=True, strict_compatibility=True,
) == "ref2va" ) == "ref2va"
with pytest.raises(ValueError, match="FL2VA checkpoint"):
_validate_reference_checkpoint(
_reference_prompt("minimax_h3_fl2va_pruned_int8.safetensors"),
"2",
strict_compatibility=True,
)
assert _validate_reference_checkpoint( assert _validate_reference_checkpoint(
_reference_prompt("minimax_h3_fl2va_pruned_int8.safetensors"), _reference_prompt("minimax_h3_fl2va_pruned_int8.safetensors"),
"2", "2",
strict_compatibility=False, strict_compatibility=True,
) == "fl2va" ) == "fl2va"
assert _validate_reference_checkpoint(
_reference_prompt("minimax_h3_unknown.safetensors"),
"2",
strict_compatibility=True,
) == "unknown"
+11 -21
View File
@@ -53,24 +53,12 @@ def _validate_regenerate_storage(run_storage: str, regenerate_from: int) -> None
def _validate_reference_checkpoint( def _validate_reference_checkpoint(
prompt, unique_id, *, strict_compatibility: bool prompt, unique_id, *, strict_compatibility: bool
) -> str: ) -> str:
from ..graph_contract import ( from ..graph_contract import classify_h3_checkpoint
CHECKPOINT_FL2VA,
CHECKPOINT_REF2VA,
classify_h3_checkpoint,
)
classification = classify_h3_checkpoint(prompt, unique_id) # Checkpoint choice is diagnostic only. Strict Compatibility remains
if strict_compatibility and classification != CHECKPOINT_REF2VA: # reserved for H3 contracts that are actually unsafe or unsupported.
if classification == CHECKPOINT_FL2VA: _ = strict_compatibility
detail = "an FL2VA checkpoint is connected" return classify_h3_checkpoint(prompt, unique_id)
else:
detail = "the base checkpoint cannot be verified as Ref2VA"
raise ValueError(
"Reference Images require a verified MiniMax H3 Ref2VA MODEL when "
f"Strict Compatibility is enabled; {detail}. Disable Strict "
"Compatibility only for experimental FL2VA/unknown combinations."
)
return classification
class H3ContinuumAdvancedV3: class H3ContinuumAdvancedV3:
@@ -539,6 +527,7 @@ class H3ContinuumSamplerProduction(H3ContinuumSamplerV3):
"last_frame": ("IMAGE",), "last_frame": ("IMAGE",),
"reference_image_1": ("IMAGE",), "reference_image_1": ("IMAGE",),
"reference_image_2": ("IMAGE",), "reference_image_2": ("IMAGE",),
"reference_image_3": ("IMAGE",),
}, },
"hidden": { "hidden": {
"prompt": "PROMPT", "prompt": "PROMPT",
@@ -579,6 +568,7 @@ class H3ContinuumSamplerProduction(H3ContinuumSamplerV3):
prompt_overrides=None, prompt_overrides=None,
prompt=None, prompt=None,
unique_id=None, unique_id=None,
reference_image_3=None,
): ):
from ..reference import prepare_reference_assets from ..reference import prepare_reference_assets
regenerate_from = _regenerate_from_value( regenerate_from = _regenerate_from_value(
@@ -591,6 +581,7 @@ class H3ContinuumSamplerProduction(H3ContinuumSamplerV3):
output_width=int(width), output_width=int(width),
output_height=int(height), output_height=int(height),
size_mode=reference_size, size_mode=reference_size,
reference_image_3=reference_image_3,
) )
if reference_assets is not None and (first_frame is not None or last_frame is not None): if reference_assets is not None and (first_frame is not None or last_frame is not None):
raise ValueError( raise ValueError(
@@ -609,11 +600,10 @@ class H3ContinuumSamplerProduction(H3ContinuumSamplerV3):
return str(report) return str(report)
if reference_checkpoint == "ref2va": if reference_checkpoint == "ref2va":
status = "Ref2VA verified." status = "Ref2VA verified."
elif reference_checkpoint == "fl2va":
status = "FL2VA; allowed, but reference fidelity may differ from Ref2VA."
else: else:
status = ( status = "unverified; execution allowed, Core contract errors remain fatal."
f"{reference_checkpoint}; Experimental because Strict "
"Compatibility is disabled."
)
return str(report) + "\nReference MODEL: " + status return str(report) + "\nReference MODEL: " + status
def execute(): def execute():
+1 -1
View File
@@ -1,6 +1,6 @@
"""Package version and public schema identifiers.""" """Package version and public schema identifiers."""
PACKAGE_VERSION = "3.2.1" PACKAGE_VERSION = "3.2.2"
STATE_SCHEMA_VERSION = 1 STATE_SCHEMA_VERSION = 1
PLAN_SCHEMA_VERSION = 1 PLAN_SCHEMA_VERSION = 1
PUBLIC_API_VERSION = 3 PUBLIC_API_VERSION = 3