Release H3 Continuum V3.2.2
This commit is contained in:
@@ -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,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
@@ -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
@@ -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"
|
||||||
|
|||||||
@@ -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),
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
@@ -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
@@ -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
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user