diff --git a/.comfyignore b/.comfyignore index 3c64cef..a9786f9 100644 --- a/.comfyignore +++ b/.comfyignore @@ -44,3 +44,7 @@ examples/workflows/* # Current loader migration instructions. !docs/LOADER_PERSISTENCE_REPAIR.md +!docs/TIMELINE_VIDEO_EXPERIMENTAL.md + +# Local updater receipt; never distribute it as package content. +.h3-timeline-experimental.json diff --git a/AGENTS.md b/AGENTS.md index d6d29a7..806bcd9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -57,16 +57,9 @@ Current release-hygiene baseline: O1 and AUDIO-R1 are PASS; the public surface i - Hi-Res Fix is not part of the new standard workflow. Preserve its historical implementation until cleanup is approved; use Second Pass as the external latent-processor bridge. - Keep P1a First Block Cache and P2 boundary-aware Sol-Attn `Deferred`. Keep A5 and A8b `HOLD` under their recorded release contracts. Issue #13 reporter-exact R3 remains the highest Continuation Quality investigation when its required workflow is available. -## H3 completion review handoff - -- After every implementation or Gate is complete and its local validation report is ready, send that self-contained completion report to the pinned ChatGPT task titled `H3情報チェック` before starting the next phase. -- The fixed current destination is task ID `6a94b91e-af7c-83e8-be18-ddc504f690c4` (pinned index 3). A second older task has the same title; do not send to the unpinned duplicate. -- Wait for and read the review reply, then bring its conclusions and requested corrections back into the active Continuum task as feedback. Treat the reply as review input under the user's authority; preserve the repository rules and request approval where a proposed change expands scope. -- Do not duplicate a handoff that the user explicitly says they already completed manually. If the destination is unavailable or the reply requires user judgment, stop and report that condition instead of silently skipping the review. - ## A8b and A5 HOLD release contracts -- 2026-09-05 explicit user exception ("許可、許可。"): Issue13 R3B may run one isolated Video-only weak tapered context-noise A/B experiment before reporter-exact R3. This waives only the reporter-exact/independence prerequisite for that diagnostic. Keep Production/source runtime unchanged, Audio/masks/depth/Seed/SIGMAS/grouping unchanged, default OFF bit-exact, and pass CPU/Shadow/Replay before GPU. Restore clean exported prefix after the diagnostic perturbation. No combined interventions, A5 work, public controls, or Production promotion are authorized. General A8b and Release HOLD remain; GPU-audit sharing is limited to the fixed H3情報チェック task. +- 2026-09-05 explicit user exception ("許可、許可。"): Issue13 R3B may run one isolated Video-only weak tapered context-noise A/B experiment before reporter-exact R3. This waives only the reporter-exact/independence prerequisite for that diagnostic. Keep Production/source runtime unchanged, Audio/masks/depth/Seed/SIGMAS/grouping unchanged, default OFF bit-exact, and pass CPU/Shadow/Replay before GPU. Restore clean exported prefix after the diagnostic perturbation. No combined interventions, A5 work, public controls, or Production promotion are authorized. General A8b and Release HOLD remain. Do not automatically send cross-task audit reports; sending requires a fresh explicit user request. - A8a is the accepted read-only baseline: full pytest `1041`, Manifest `242/242`, every observer record has `execution_applied=false`, and Production/Sampling/Run Storage/State/Session/Assembly parity is preserved. - Keep A8b execution policy on HOLD until one intervention type is specified and approved. Do not change context, transport, mask, latent, or conditioning in combination. Seed, SIGMAS, and physical grouping remain unchanged unless separately approved. @@ -107,3 +100,9 @@ GPU checks must cover Sage only, Sage+Sol, Sage+Spectrum, and Sage+Sol+Spectrum - Keep H3EasyLoadImage and Enable Image; delegate inherited mode accessors and leave Core widget collections, drawing and serialization intact. - New official workflows use Core LoadAudio and Core LoadVideo -> H3ContinuumVideoAdapter. The adapter has no Enable/file/upload UI and reuses the existing frame-rate conversion. Preserve the original Audio/Video IDs as deprecated compatibility nodes; never infer lost filenames or saved OFF states. - The approved export exception adds H3ContinuumVideoAdapter to the existing nine-node mapping. Do not change Main Sampler, Sampling, external wrappers, Decode Cache or Run Storage semantics for this repair. + +## User-approved Timeline Video experiment (2026-09-22) + +- Append one optional `Video Reference Mode` to V38. Missing mode remains `Repeat Reference`; `Follow Timeline` is opt-in and uses each physical group's visible output range without consuming continuation context twice. +- Preserve grouping, Seed, SIGMAS, Audio, masks, Run Storage schema, Terminal Merge ownership, and the two official V3.8X2 workflow files. Experimental Follow/Repeat templates remain separate comparison assets. +- Local acceptance passed: full CPU `1424 passed / 1 skipped`, browser save/reload, Follow/Repeat GPU functional runs, A/B mode separation, and Manifest integrity. Keep the feature Experimental; do not describe it as exact motion copying or a long-input RAM optimization. diff --git a/CHANGELOG.md b/CHANGELOG.md index fecde9a..efbfb13 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,15 @@ # Changelog +## Experimental on main — Unified Timeline Video (2026-09-22) + +- Renamed the existing V3.8 video IMAGE input to `Timeline Video Frames` while preserving its internal key and saved links. +- Added one appended optional `Video Reference Mode`: `Repeat Reference` remains the compatibility default; `Follow Timeline` selects the source interval belonging to each physical output group. +- Follow mode excludes continuation-prefix frames from source consumption, records each physical slice in the plan, uses slice-specific Video VAE/cache identity, and continues without video reference after source exhaustion. +- Kept Sampling, Seed, SIGMAS, Audio, masks, continuation grouping, Terminal Merge ownership, Run Storage schema, and the two official V3.8X2 workflows unchanged. Added separate Follow/Repeat comparison workflows. +- Synchronized the lightweight runtime verifier and README public-surface wording with the already-exported ten-node V3.8X2 surface, including `H3ContinuumVideoAdapter`. +- Acceptance: full CPU `1424 passed / 1 skipped / 0 failed`; browser save/reload PASS; Follow and Repeat `2 x 5 s` GPU runs PASS at 704x416/24fps with synchronized 10-second audio/video and no OOM, NaN, allocation failure, or crash. +- This remains Experimental: it is soft H3 conditioning, not exact motion copying, and it does not reduce the RAM needed to hold a long decoded IMAGE batch. + ## Unreleased — Loader persistence repair (2026-09-21) - Repair Issue #23 by delegating inherited native mode accessors; preserve Enable Image and remove draw/save-time widget collection replacement. diff --git a/MANIFEST.sha256 b/MANIFEST.sha256 index 6f6beb2..7a88229 100644 --- a/MANIFEST.sha256 +++ b/MANIFEST.sha256 @@ -1,10 +1,10 @@ dca65fb1393e67f59c6f81f9411e3e745eb8f1097e9a2adf7ffc6f4e3901ca9f __init__.py -a9fd5a4c5624e17148656abed0ba41a72c72cac73e7f6f36d2816ad92962f867 .comfyignore +bb6f7d1227f7c0cc4e134ccc0e037c8c4fe4af63d8c990ac00b7af2279695871 .comfyignore 3d681ded5d4c50cc20c2382e29fdc98d8a48e76d552c41ad5a195d941e66e612 .gitattributes 8296f0afc7be47171e439c02fb2988cfeb0df904acbe3fc4f507f426d709157e .github/workflows/tests.yml 0a2f69d4cec89d440f5d5aa1ec68a7c9a741382d313f80dcddf96d13f70b3e68 .gitignore 3e7a1ec3380be2a222c8a3e9b8a6bb184d3a760478957f48186438f15235bdba branch_provenance.py -d70402478f19f6487eed08957a048a8c248a9291be8e62c0e7ade69da82fd393 CHANGELOG.md +ad340adc9506ab069a83f586d954fbd19f44df4e18a5346d5a8923a489d3cb85 CHANGELOG.md c1ed3a0342730450958fb62fd21854a876991f3a4aefb24e5383b0c73cd2312d compatibility.py 4d62508f900af9f93ec320afb900c27cc9a300d1e0c0a94714258498c5ede5fc conditioning.py 294251c40b1be2e296c5e5f627b68091d087bdb39179e3a0c3cebd2ee8a344f5 constants.py @@ -118,12 +118,12 @@ e2b72149b0433e95c13659cc9e742fe38523e67d4f4a2fdb08aed1943fecf653 nodes.py b470819f16fc179654dc1600721a63f0a5a14e777f4c004d574b499da6886ba5 public_api.py 15a3925218e0c5f968795d7d11e4783c3c6868917447274bc700328851b3fbfb pyproject.toml 94fdc2d545b2d4077a4d70229fd22ba3ccac21d49d1097d2873f76d04e9a3c7a pytest.ini -4a0507ce6183e099265d5a34a38e43da89515af8eb680f5a48abc8aecc724d63 README_JA.md -9d4eefcc97e74d4c1c8ab1be612b50eb99a8a4f8db7c2134ca85a9e67bf2568a README.md +6f108a67967dd686011bf031b8176373f6ab80635f7e01e3e935e8585b804fc9 README_JA.md +77cdaadd32f9d722f6b05abc196cbdb9dded32387493664620a30fa405429743 README.md 44127adcfa30ee84bff9cd4b2d0c695355209550e76982d374122008728aa5bc reference_audio.py 5cb9bfd6810d3a93a637451980a4cc5c1436e5b84cfd1c7a111cd192e876351b reference_video.py c7b14ed6f8cfc2a1f0a21db4fe56fba75a93ffcb0be0c22bbd2e691c45cd0e2d reference.py -3157b7b0d307d05d109b940021b0ca09a2ab2680c4c362584399837e9434d728 REGISTRY_MANIFEST.sha256 +ed892d90b644050bdf68f860c3b5bcdef6c59b565257275bbe7b07238ab1f630 REGISTRY_MANIFEST.sha256 467edb2c188d024c2392aafe7423b3f835e16b10f570da76e2f7dda8a962c1c5 requirements.txt 8bfa113a2ec11325619be300b4d2b53a157b1d2c1ef7855057a4b3bbd05aeef3 run_storage.py 6056de6c0a5322a8a51ba5a114538dca2ef67788cd1afba10fedd483b95f6afa state_io.py @@ -228,15 +228,15 @@ e813b5d21af2963a325862acd344b33caa124d0cd3940a940c58118cf27742e0 tests/test_v38 c9577e9b2d430c9435a287bf679a920020192d51f780e02b47f286e2e4b6a615 tests/test_v38_easy_mode.py bb5a1530c890d357dc48ea74039340d746e876e8f85e06d4d9a19369f8ff5961 tests/test_v38_hover_help.py 98eb59407741dd187dc22d94b4f433f341294d05cc38106fde15b580b1465001 tests/test_v38_memory_action_policy.py -4338c932fc8a00328c3145b276e0f58a783c721a683b43aa6c24337b05a878ab tests/test_v38_multi_reference_audio.py +8edaae5f1ca93925e9269c9a4447c97edf5958395f08659e61a09e8d7efa088a tests/test_v38_multi_reference_audio.py 623d528a02b6712cba28c374ba3ad979bc84e2ac5318640692589a04ba6ab15f tests/test_v38_open_integration_contract.py 12337a491fa67b38b32aaeb16e0b209393960dbc46db2a8bf968b8c3902855ef tests/test_v38_packed_row_planner.py -abece11f7efa1f09a4ba4ab729708f460277128ac590c1e16485dd601b1c499c tests/test_v38_public_surface_cleanup.py +71a042353883ec6c86bbab2027c89087d479a419e9d4a1801d6852904c980e04 tests/test_v38_public_surface_cleanup.py 927348e89480b2f3b2fc2dcffa1398931d20e8812d94374ad05b374b453b7814 tests/test_v38_public_workflow.py 14ff6561a127287d0a20887790a978612ef9d291f1d3be7d5e85b37b2c74760e tests/test_v38_ref_encode_cache.py 8b376f45261d045b584f02b4d14cd70c2d6269b9c814d4e62b5c612f6e30e36f tests/test_v38_refine_target.py -a67a52da8828bdff5d349c40d48c102271d7c9e388120565f50e76941b01f91c tests/test_v38_reliability.py -d512b0b277c7f1e53c3512b00055e237468e2f0f904639dfa4307ef28d39665a tests/test_v38_resolution_preset.py +03eb5bf6d845b22334fcc800d81b419f1c8d8593fa65a1e0460144456ff2c8ba tests/test_v38_reliability.py +c7713198c14316d62425f15b4273d5998cc284d32da3babd6b296a496040721b tests/test_v38_resolution_preset.py 2ac395009e49f9554af8d1a251d93fc5d5e7070bf80f5a0b7b3f7e00cde15077 tests/test_v38_review_cache.py 72a0e3cb334049b66dd36f52c826931067c242fa63557933fd667138b38d6e8d tests/test_v38_review_control.py f62daa235117a3041c66ebb17adedb13c0452c3a2fc0acdd51006d7aa0078a9b tests/test_v38_review_execution_cap.py @@ -300,7 +300,7 @@ cc247c01a01efaf594c24c7ce36ca3357c092fc28dd742c7577093ee9d5efdef tools/v38_reso ad8609a45ba818fb74245b30cb0a3a221d6b345c20671092cafd714d8b07aaea tools/v38_review_phase_f_gpu_gate_runner.py 60e9bf2c7c40ef9dd71f08ec2ec8c25f7ae9b08e74c3b7be5964e1138848ae82 tools/v38_review_phase_f_recovery_runner.py a18136a4decfeef344635bbe9bb18502231c2503b034ce1d21cc2e5e77cc5e2f tools/validate.ps1 -087f4f727e9f76bb2b0061e26e0b49065370aa352a1ebebc7f253774b3be22ed tools/verify_runtime.py +deeae570772c1a32dbb356aa30c8ef473b9334a0a36b71c0cccba12203f76415 tools/verify_runtime.py ffd61f3f31c9b6430e1169007ee906c8f5000eba63ee44e2976ad4f5f1112671 v2/__init__.py 2003902c87bba09cfa143f5a9e4248f3a78c0fb544449a75fd40ba2cacb35655 v2/context_diagnostics.py cde27db19b677e318cc4dfb4235be7a11429c19945f4083052a91fe117e74c82 v2/decoder.py @@ -313,7 +313,7 @@ dc2b901789e4b024dbcbc4024c63eb8cbc564d77003ce8c35c0584851ba6dfbd v2/prompts.py 2fd811794c4cc0f2ce050250b80484876454926b9f20fce6af3a97d728e5acdf v2/seam_guard.py be0d8585fa57e0ccd6d02577bbc7299629e5bfe20e186747f571fccc98b67d7e v2/seam_types.py 12cfcc0c71ca087fe39a5ce2922959a62b2bb311bfe664f05c4480affce03708 v2/seeds.py -ff23b9f49b05b1e000110ab4eb211942f0aa0d376f35694e80c5df25047a77c7 v2/sequence.py +fe7df9efea15b157c158046f64328b3dce3cfbd35cf180573ce4ec771ddcea8c v2/sequence.py 13213e7709fd02bb810af3c18e4cd7d010f8cdfb121a4b99866a9f2333331089 v2/session_io.py 3ea23dbce6fcd217b6e81235855479b9b16fed7a21693cf156f9014555c4fe13 v2/session.py 78c830cdf49034c6e3b2cd3da5914d5cfc5638eb63ec6dbd1bab13c50d6d4caf v3/__init__.py @@ -321,7 +321,7 @@ ea2922567df90436dd6fa21696833a49dd0cbfeee142a5fedc3a7c303824d473 v3/adaptive_co b3dc61503d35d9ef0a0dc7fed1c9b2fdc00fcb2072d4e39f64ae0826f9ec7dca v3/assembly_v35.py 7815230e0a9540bc2edeaf818e940b7a1fdd817fd217ba8a4f9cb21aaf6a308e v3/assembly.py 3f62fdb35e804f42d7cbf0828b4e87e69a2b99246c3f7467fe4fa698f1d803c9 v3/conditioning_bridge_nodes.py -aa044669259df440a384b5e839f75fa9665790da0c210a427375fdd5c76af779 v3/driving_nodes.py +82238eff890574fcf977dc3d2bc092287f63710a47bfc0f6692c272814dbd295 v3/driving_nodes.py 147a1d3fc5e09b323a4c3d13d30e432410389bae52b58330462375b9f307b791 v3/easy_audio_nodes.py 64b3e54b42e5156642f9957ccc374fd190d9fc7145637984e702534fb1bf80b4 v3/easy_image_nodes.py ac859cb1a6e23b8ceae300d818c24fe1346b649a0d663017a9b3ac64aa96fca3 v3/easy_nodes.py @@ -365,10 +365,18 @@ fefafd4550511d80bd85ade46a0476f0cf3de13ddb94a908dff6b175f2a0e199 web/easy_bypas 9db0aa94f634578a962d5db49e5c70356040a59df968e3a2e531b327a623081f web/easy_load_image.js 35090816ba7470a7255eb85d003b7e79f8a0065982dacf98a18f41c8ebff655d web/easy_load_video.js 0c68d13a1f8beb7431a32b471f8b0612c42fcc4bf72dd97611a025d158008662 web/easy_v38.js -ec591d1b8f7587594397b995b9584809435f10fa3de6bf8f8df204c34809aa43 web/project_id.js -ecdcd27528f6f1e80f758c608cbc42f747163ea4c39abd77576b91c627423d12 web/reference_audio_ui.js +bb7e29359e1fe26fd70d22f6bc70eb8c8858f68ab954ba39ad3670f2cdeeae7d web/project_id.js +ae59273f163a116ece418957c557c4fd8c3285e3c60814679b9361d2e6e6fa02 web/reference_audio_ui.js 46c9f75c9462bf26300332448f4431cca801f38964ca0a49bc2c50a88a7cc40f web/reference_image_ui.js 26b13614ba0a5fd8b192a106c9503b2f4b6fe7f9268a0fcb0f544979a49cab34 v3/video_adapter_nodes.py a9da2d25e9fc9b87b249274d7bf2ab061d14f5d1e9c482b69d795ba511cdace1 tests/test_loader_store_roundtrip.py 0e02f7db41458fab91e6c3395bdb864d1c033923a3874ff4082d5f85b8230d98 tests/test_video_adapter.py 77c225d1e49e06d00b04acf811177c9a4317e792d4bfe92df539de99420c3563 docs/LOADER_PERSISTENCE_REPAIR.md +b935ad3bb729948bb3890ce967b0ecbef737a5e51ddfc47a0060fc20aa78dcda video_reference_modes.py +bf41bf08dd0504eb753fa5781e6c2b8c1285758ad4bb7309975bb9231d5f8e41 web/video_reference_mode_ui.js +4c33d223a77c78e5c74946aa43f537031fd5aa415388d46fed975f9b07d53c3e docs/TIMELINE_VIDEO_EXPERIMENTAL.md +b07b941082a947d9e938ff399ec8b77fcd29c1a222e0e6b0dedf5d8e7482ce84 tests/test_video_reference_modes_experimental.py +171f0b5596724926d1d89fd12a46434f6010f12e651d19865b9b6160a1e9fff6 examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Follow.json +e61e45f218609a7ec845d2e8762dfd1efed6c51a398061066d1e51fc93556663 examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Follow.zip +7d6754cfc75599e07046b1949c1723a56f57871ecd5abc9543fcf8b34bca8c04 examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Repeat.json +9b60c8495e3d0e32c2bcd609080342ae19d0fd4c7c0662d5fe32e7fad4a9b41c examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Repeat.zip diff --git a/PROJECT_STATE.md b/PROJECT_STATE.md index 0e6185b..69e170d 100644 --- a/PROJECT_STATE.md +++ b/PROJECT_STATE.md @@ -1,5 +1,12 @@ # Project State +## Timeline Video Experimental — local acceptance PASS, main publication candidate (2026-09-22) + +- Based on main `085943ad9cb8023a2042d4d731c83e638361c06e`. The existing `reference_video_1` IMAGE socket is displayed as `Timeline Video Frames`; one optional `video_reference_mode` widget is appended. Missing values default to `Repeat Reference`; `Follow Timeline` is opt-in. +- Follow selects each physical group's visible output interval, excludes continuation-prefix frames, keeps Terminal Merge ownership, and continues without video reference after source exhaustion. Per-slice identity prevents conditioning/VAE cache reuse across different intervals. Sampling, Seed, SIGMAS, Audio, masks, Run Storage schema, and official V3.8X2 workflow bytes remain unchanged. +- Local acceptance: full CPU `1424 passed / 1 skipped / 0 failed`; browser save/reload PASS; Follow and Repeat `2 x 5 s` GPU functional runs PASS at 704x416/24fps with synchronized 10-second AV; A/B diverges in Chunk 2; no OOM, NaN, allocation failure, or crash. Manifest/Registry Manifest matched before publication preparation. +- The feature remains Experimental. It is not exact motion copying, a variable-duration chunk system, or a long-input RAM optimization. Separate Follow/Repeat comparison workflows are source assets; Release/tag and Registry publication remain separate operations. + ## Loader repair full-suite follow-up (2026-09-21) - Main repair `f8eb40d8b44e54386bcf3c5197c48f0f71daf6df` passed the 46 focused tests. Its first full CI returned 1376 passed, 3 skipped, and one stale pre-migration workflow fingerprint failure in `test_v38x2_decode_cache_integration.py`. diff --git a/README.md b/README.md index 29832c1..fbcc8af 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ ## Loader persistence repair on main (2026-09-21, after 3.8.3) -The current paired V3.8X2 workflows now use **Core Load Audio** and **Core Load Video -> H3 Continuum Video Adapter**. The adapter has Force Rate (default 24) and IMAGE/AUDIO outputs, but **no Enable switch or file selector**. Core owns video selection/upload/save; the established duration-preserving frame selection is reused and audio is passed unchanged. To disable Video Guide, bypass the adapter or the whole video-input group; do not bypass only Load Video while leaving its required-input adapter active. +The current paired V3.8X2 workflows now use **Core Load Audio** and **Core Load Video -> H3 Continuum Video Adapter**. The adapter has Force Rate (default 24) and IMAGE/AUDIO outputs, but **no Enable switch or file selector**. Core owns video selection/upload/save; the established duration-preserving frame selection is reused and audio is passed unchanged. To disable Timeline Video guidance, bypass the adapter or the whole video-input group; do not bypass only Load Video while leaving its required-input adapter active. **H3 Continuum Load Image remains**, including Enable Image. Its mode observer now delegates to inherited Core setters (Issue #23), and no longer replaces the widget collection while drawing or saving. Enable is appended after Core's widgets; Core handles the filename and native Bypass persistence. The older Audio/Video node IDs remain loadable as deprecated compatibility nodes, not as the recommended new-workflow loaders. Ten node IDs are registered including these two legacy nodes. Sampler inputs, generation parameters, Decode Cache, Finalize and existing latent/storage contracts are unchanged. @@ -10,8 +10,30 @@ After updating, restart ComfyUI and reload/refresh the frontend. A workflow that Validation details and limits: [Loader repair record](docs/LOADER_PERSISTENCE_REPAIR.md). CPU/store-model regression tests are not a substitute for the pending Windows Core 0.36.0 / frontend 1.53.6 browser tab-switch acceptance. No Release/tag or Registry publication is implied by this main-branch repair. Older loader screenshots below describe the retained legacy nodes. - -> **V3.8X2** is the product and workflow label for package `3.8.3`. It keeps the V3.8 production sampler and adds optional Reference Images 4–9 plus the built-in Decode Cache Helper. The older V3.8.0 package remains available from tag [`v3.8.0`](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/tree/v3.8.0). +## Timeline Video — Experimental on main + +The existing video IMAGE input is now displayed as **`Timeline Video Frames`** and has one appended optional control, **`Video Reference Mode`**. Existing workflows and API calls that do not contain the new setting keep the old behavior through the default **`Repeat Reference`** mode. + +- **`Repeat Reference`** keeps the legacy Video Guide contract: each physical generation group receives the same bounded prefix from the source. It does not loop or stretch a short source. +- **`Follow Timeline`** uses the 24 fps source interval corresponding to each physical output group. Continuation-prefix frames are not consumed twice. If the source ends, the remaining groups continue without video reference; a final usable partial interval may receive only H3's short frame-grid padding. + +This setting is independent of `Prompt Format = Timeline`. It does not add a new socket or loader, does not use the source video's audio automatically, and does not provide frame-perfect motion copying. The complete decoded IMAGE batch is still held in system memory, so this feature is not a long-input RAM optimization. + +Use the existing connection: + +```text +Core Load Video -> H3 Continuum Video Adapter -> Timeline Video Frames +``` + +The two comparison workflows are intentionally separate from the unchanged official V3.8X2 workflows: + +- [Follow Timeline JSON](examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Follow.json) | [ZIP](examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Follow.zip) +- [Repeat Reference JSON](examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Repeat.json) | [ZIP](examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Repeat.zip) + +Local acceptance passed with full CPU `1424 passed / 1 skipped / 0 failed`, browser save/reload, and Follow/Repeat `2 x 5 s` GPU runs at 704x416, 24 fps, 240 frames, and 10-second 32 kHz stereo audio. Follow changed to the later source interval for Chunk 2 while Repeat retained the shared prefix; both completed without OOM, NaN, allocation failure, or crash. Peak observed VRAM was about 15.6–15.7 GiB on the tested RTX 5060 Ti 16 GB system, so 16 GB headroom was small. This is a functional mode-separation result, not a universal speed or subjective-quality guarantee. See [Timeline Video Experimental](docs/TIMELINE_VIDEO_EXPERIMENTAL.md). + + +> **V3.8X2** is the product and workflow label for package `3.8.3`. It keeps the V3.8 production sampler and adds optional Reference Images 4–9 plus the built-in Decode Cache Helper. The older V3.8.0 package remains available from tag [`v3.8.0`](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/tree/v3.8.0). exec-9cfa73b4-c1d3-4416-8950-fa661b946638_2 @@ -34,7 +56,7 @@ When using many references, especially all nine, resize copies of the source ima ### Important: this is not an unconditional new-generation speedup -**Manual cache clear:** normally no action is needed. Press the Helper's "キャッシュをクリア" (Clear cache) button to discard that Helper's cache on the next Queue and run native Decode again. It does not delete immediately or queue automatically. The internal `reset_token` remains serialized for workflow/API compatibility and increments once per click (wrapping to 0 at the INT limit). Creating, loading, or cloning a node does not change it. Without JavaScript, or in API workflows, change `reset_token` through the traditional numeric input. +**Manual cache clear:** normally no action is needed. Press the Helper's **Clear cache** button (Japanese UI: **キャッシュをクリア**) to discard that Helper's cache on the next Queue and run native Decode again. It does not delete immediately or queue automatically. The internal `reset_token` remains serialized for workflow/API compatibility and increments once per click (wrapping to 0 at the INT limit). Creating, loading, or cloning a node does not change it. Without JavaScript, or in API workflows, change `reset_token` through the traditional numeric input. **The Helper saves time only when unchanged latents are decoded again. It does not accelerate Sampling.** A first MISS runs native Decode and stores the result; hashing and storage can make that run slower. Generating different latents with a new random seed each time normally produces MISS, so this feature should not be expected to speed up that usage. @@ -50,7 +72,7 @@ The action names themselves do not enable reuse. **Each Video/Audio entry must m Cache reuse is process-local and does not survive Python restarts. Eviction and VAE identity changes can also cause MISS. Changing mode, RAM/Disk budgets, or `reset_token` clears this implementation's Helper cache. Keeping `reset_token = 0` does not reset it on every Queue. -V3.8X2 ships `H3DecodeCacheHelper` inside this Continuum package. It remains a separate public node under `MiniMax H3/Continuum/Helpers`; no second custom-node addon is needed. The original nine IDs remain registered for compatibility; the loader migration adds H3ContinuumVideoAdapter. Sampler, Finalize, Assembly Plan, Core Decode, and saved Sampler widget/socket contracts are unchanged. +V3.8X2 ships `H3DecodeCacheHelper` inside this Continuum package. It remains a separate public node under `MiniMax H3/Continuum/Helpers`; no second custom-node addon is needed. The package registers ten IDs, including the Video Adapter and the two deprecated loader compatibility IDs. Sampler, Finalize, Assembly Plan, Core Decode, and the pre-existing saved Sampler widget/socket prefix are unchanged; Timeline Video adds only one optional widget at the end. Connect Sampler `video_latents` and `audio_latents` plus their native Video/Audio VAE inputs to the Helper, then connect Helper `images` and `audio` to Finalize. Keep the Sampler `assembly_plan` directly connected to Finalize. The [official V3.8X2 workflow](examples/workflows/MiniMax_H3_Continuum_V38X2.json) preserves its saved graph and settings. It contains no Core VAE Decode nodes, so returning to Core direct Decode requires adding those two Core nodes and reconnecting Finalize, or loading a prior Core-direct V3.8X workflow. Do not simply remove the Helper and expect automatic rewiring. @@ -148,7 +170,7 @@ The Helper delegates cache MISS entries to native Core Video/Audio Decode. A man ## Complete V3.8 UI reference -This section covers every user-facing control and socket on the seven public V3.8 nodes. Names such as `Power Lora Loader (rgthree)`, Spectrum, SageAttention, Core VAE Decode, and Core Save Video belong to ComfyUI or another extension. They may be used in a supplied workflow, but they are not Continuum controls. +This section covers the current ten-node V3.8X2 public surface and the Sampler controls. Names such as `Power Lora Loader (rgthree)`, Spectrum, SageAttention, Core VAE Decode, and Core Save Video belong to ComfyUI or another extension. They may be used in a supplied workflow, but they are not Continuum controls. ### H3 Continuum Sampler V3.8: required graph inputs @@ -171,19 +193,25 @@ The Sampler returns six outputs: a list of `video_latents`, a list of `audio_lat | `last_frame` | Optional final-image constraint for FL2VA | Can trigger a Long Terminal Merge; the final pair may become one atomic review unit | | `reference_image_1`–`reference_image_3` | Ordered appearance, identity, subject, or scene references | They never become the implicit size source | | `Reference Images (Optional)` | Additional images 4–9 bundled by `H3 Continuum Reference Images` | Empty inputs are skipped; encoding remains in the Sampler | -| `Video Guide Frames` | A video loader's IMAGE frame batch, applied as a persistent guide | It does not carry the source video's audio; frames are interpreted at 24 fps | +| `Timeline Video Frames` | The Video Adapter's 24 fps IMAGE frame batch | `Repeat Reference` keeps the legacy shared prefix; experimental `Follow Timeline` selects successive physical output intervals. Source audio is separate. | | `Driving Audio` + `Driving Audio VAE` | Original audio timeline used as native guide conditioning | The selected source audio becomes final audio; generated audio and Audio Seam are bypassed | | `Reference Audio (Optional)` + `Reference Audio VAE (Optional)` | Legacy single conditioning-only audio reference | Generated audio remains final audio | | `Audio References (Optional)` | Ordered bundle from `H3 Continuum Reference Audios` | Do not connect this together with the legacy single Reference Audio path | | `Still Image Guide (Optional)` | Compatibility socket inherited from the V3.7 guide contract | Experimental; not part of the V3.8X2 official workflow | -#### First Image, Last Image, and Reference Images +#### First Image, Last Image, and Reference Images ![First Image enabled and Last Image bypassed](docs/images/v38-manual/first-last-image-bypass.png) - **First Image** establishes the opening image and is the normal visual starting point for I2VA/FL2VA. It is also the only media input that can drive `Size Source = First Image`. - **Last Image** constrains the sequence ending. Leave it `OFF` for T2VA and ordinary I2VA. With a connected Last Image, extending or regenerating the sequence may rebuild the terminal pair. -- **Reference Images 1–9** guide identity or appearance throughout generation. Inputs 1–3 remain on the Sampler; optional inputs 4–9 are on `H3 Continuum Reference Images`, connected to the Sampler's `Reference Images (Optional)` socket. The helper only bundles images: resizing, hashing, and VAE encoding remain in the existing Sampler path. Empty slots are skipped; Picture numbers follow active slot order after any First/Last Image. Existing three-loader templates still work unchanged. +- **Reference Images 1–9** guide identity or appearance throughout generation. Inputs 1–3 remain on the Sampler; optional inputs 4–9 are on `H3 Continuum Reference Images`, connected to the Sampler's `Reference Images (Optional)` socket. The helper only bundles images: resizing, hashing, and VAE encoding remain in the existing Sampler path. Empty slots are skipped; Picture numbers follow active slot order after any First/Last Image. Existing three-loader templates still work unchanged. + +#### Timeline Video Frames and Video Reference Mode + +Connect `Core Load Video` to `H3 Continuum Video Adapter`, then connect Adapter `images` to `Timeline Video Frames`. The Adapter's default `Force Rate = 24` matches the input contract. Connect Adapter `audio` to `Driving Audio` only when that source audio should guide generation and become the final audio. + +`Video Reference Mode` is visible only while Timeline Video Frames is connected. `Repeat Reference` is the compatibility default. `Follow Timeline` advances through the source according to the physical visible frames actually added to the output, including Review, Resume, and Terminal Merge grouping. It does not change `Seconds per Chunk`; all chunks still use the Sampler's common duration. See the [experimental contract and limitations](docs/TIMELINE_VIDEO_EXPERIMENTAL.md). Saved workflows with the earlier direct image 4/5 inputs migrate those links into a bundle after graph loading. Migration preserves the original source links and only removes a legacy input after its new link is verified. If a source is unavailable or its destination is occupied, the legacy link is retained with a warning. Old API prompts remain accepted; supplying both legacy and bundle images for the same slot is an explicit input conflict. @@ -201,7 +229,7 @@ Every `H3 Continuum Load Image` has `Enable Image`. `ON` loads through ComfyUI C ![Continuum Video and Audio loaders with Enable controls](docs/images/v38-manual/input-video-audio-bypass.png) -- `H3 Continuum Load Video`: `Enable Video`, `Video`, and `Force Rate`. `Force Rate = 0` uses source FPS; a positive value drops/duplicates frames to that rate while preserving nominal duration and audio. Connect `images` to `Video Guide Frames` when visual video guidance is wanted. Connect `audio` to `Driving Audio` only when the source audio should guide and become the final output. +- New workflows use Core `Load Video` followed by `H3 Continuum Video Adapter`. The Adapter's positive `Force Rate` drops/duplicates frames while preserving nominal duration and passes audio through unchanged. Connect `images` to `Timeline Video Frames`; connect `audio` to `Driving Audio` only when the source audio should guide and become the final output. The legacy `H3 Continuum Load Video` remains registered for compatibility. - `H3 Continuum Load Audio`: `Enable Audio` and the audio file. Use it for Driving Audio or Reference Audio according to the socket you connect. - The node titled `Audio Switch` in the example image is ComfyUI Core's `If/Else Switch` (`ComfySwitchNode`); `Fast Groups Bypasser (rgthree)` belongs to the rgthree extension. Neither is a Continuum node or a requirement of Continuum. The Continuum loaders already provide their own native ON/OFF controls. @@ -249,7 +277,7 @@ Every `H3 Continuum Load Image` has `Enable Image`. `ON` loads through ComfyUI C ![Manual Size Source with explicit Width and Height](docs/images/v38-manual/size-source-manual-640.png) -If First Image mode is selected but no usable First Image reaches the Sampler, V3.8 uses the stored Manual Width/Height as a safe fallback and reports the dimensions in `status`. Select `Size Source = Manual` to inspect or edit those values; Width/Height are hidden in the First Image facade. Reference Images and Video Guide never become implicit size sources. The historical `Auto / Landscape / Portrait / Square` values are migration/API compatibility values, not current Main choices. +If First Image mode is selected but no usable First Image reaches the Sampler, V3.8 uses the stored Manual Width/Height as a safe fallback and reports the dimensions in `status`. Select `Size Source = Manual` to inspect or edit those values; Width/Height are hidden in the First Image facade. Reference Images and Timeline Video Frames never become implicit size sources. The historical `Auto / Landscape / Portrait / Square` values are migration/API compatibility values, not current Main choices. Size selection is built into the V3.8 Sampler. A separate megapixel, empty-latent, or image-size node is not required for the normal Continuum workflow. @@ -271,7 +299,7 @@ For an audio-only listening diagnostic, use T2VA, `Size Source = Manual`, and a | `Variation Nonce` | Explicit `Regenerate From = Chunk N` | `0`: automatic variation selection with interrupted-run resume; `1` or higher: a fixed variation value. Base Seed and the other generation settings stay unchanged | | `Run Name (Optional Override)` | Advanced open and Progress On | Stable name for resume and Render History; blank uses the Sampler's automatic identity | | `Reference Image Size` | Advanced open and a Reference Image connected | `Match Output` is practical; `Max Identity` preserves more reference detail and may use more memory | -| `Video Guide Size` | Advanced open and Video Guide connected | `Efficient — 0.4 MP`, `Balanced — 0.6 MP`, or `Match Output` | +| `Video Guide Size` | Advanced open and Timeline Video Frames connected | `Efficient — 0.4 MP`, `Balanced — 0.6 MP`, or `Match Output` | Frontend-managed IDs, selected Take IDs, one-shot review actions, diagnostics, preview, and legacy compatibility values are deliberately not editable as ordinary node widgets. The corresponding settings or action buttons below are the supported interface. @@ -355,7 +383,7 @@ The same graph can be used as the quick Turbo path: disable Spectrum, enable exa An experimental prefix-amplitude renormalization produced a strong improvement in one `6 × 5 s` run, but a later frozen `4 × 8 s` A/B/C gate did not reproduce the target drift and therefore applied gains of `1.0`; Standard and the experimental arm were bit-exact. The older Compatibility route did not justify replacing Standard and raised a separate boundary-audio concern. The accurate release statement is therefore: **the issue is not proven fixed, the current Standard path is unchanged, and experimental mitigation stays Default Off**. Report the first and worst affected chunk, workflow JSON, prompt, seed, model/LoRA, Steps/SIGMAS, size, Continuity, and Audio Continuity when reproducing it. -> **Support boundary:** The original V3.8 launch surface had seven nodes; this local package also exports Reference Images and Decode Cache Helper. Some retain earlier IDs, including Finalize (`H3ContinuumAssembleSeamV35`) and Second Pass (`H3ContinuumSecondPassV35`); this does not make all older workflows compatible. Use the matching historical Release/tag for unsupported node IDs. See [V3.8 Release and Migration Policy](docs/V38_RELEASE_AND_MIGRATION.md). +> **Support boundary:** The original V3.8 launch surface had seven nodes. V3.8X2 now exports ten IDs: it adds Reference Images, Decode Cache Helper, and Video Adapter while retaining the deprecated Audio/Video loader IDs for saved-workflow compatibility. Some nodes retain earlier IDs, including Finalize (`H3ContinuumAssembleSeamV35`) and Second Pass (`H3ContinuumSecondPassV35`); this does not make all older workflows compatible. Use the matching historical Release/tag for unsupported node IDs. See [V3.8 Release and Migration Policy](docs/V38_RELEASE_AND_MIGRATION.md). The accepted 16GB GPU gates reached about `15.5-15.6 GiB` in the most complex cases. Actual use varies by GPU, driver, backend, model precision, resolution, and connected nodes; this is not a universal 16GB guarantee. @@ -712,7 +740,7 @@ Prompt/CLIP figures measure only the conditioning subphase, not total generation The measured Sage-only production baselines on the tested RTX 5060 Ti 16 GB / 64 GB system were 168.069 seconds for 1×5-second 576×576 T2VA and 379.765 seconds for 3×5-second 640×640 FL2VA Long Terminal Merge. These are configuration-specific baselines, not universal speed guarantees. Sampling remained the dominant cost; Continuum Assemble + Seam stayed below 1%. -> **V3.8.0 is the historical release baseline.** The current publication target is V3.8X2 / package 3.8.3. Historical implementation modules remain in source because V3.8X2 reuses them internally. Only the nine current public nodes are exported, including the earlier IDs retained for those nodes. Use the matching historical Release/tag for workflows requiring other IDs. Still Image Guide remains Experimental. +> **V3.8.0 is the historical release baseline.** The current publication target is V3.8X2 / package 3.8.3. Historical implementation modules remain in source because V3.8X2 reuses them internally. Only the ten current public node IDs are exported, including the two deprecated loader compatibility IDs. Use the matching historical Release/tag for workflows requiring other IDs. Still Image Guide remains Experimental. ## V3.5.1 Reference Audio & Compatibility Update @@ -723,7 +751,7 @@ V3.5.1 added two focused features without changing the V3.4 Sampling, Conditioni The Reference Audio sockets are permanently defined by Python `INPUT_TYPES`. Dynamic socket changes and the UI-only `Hidden / Show` control were removed to prevent workflow save/reload value shifts. Node IDs, backend keys, Sampling, Conditioning, standard Seed handling, and other widgets are unchanged. -In the historical V3.5.1 package, V3.4 node IDs and backend socket keys remained registered for saved-workflow compatibility. V3.4/V3.5 workflows continued to load there; V3.5.1 clarified the displayed input names without rewriting saved links. V3.8 instead uses the seven-node support boundary above. +In the historical V3.5.1 package, V3.4 node IDs and backend socket keys remained registered for saved-workflow compatibility. V3.4/V3.5 workflows continued to load there; V3.5.1 clarified the displayed input names without rewriting saved links. The original V3.8 launch used a seven-node boundary; current V3.8X2 exports the ten IDs listed in the current guide above. ### Reference inputs at a glance @@ -866,7 +894,7 @@ For the failed 3 x 5s case, First Pass and the 37T Second Pass group completed. ## V3.4 compatibility baseline -The historical V3.5 package retained V3.4 nodes for saved workflows; it did not replace their Node IDs, public sockets, Sampling, Conditioning, Terminal Merge, Assembly, Seam, or Run Storage behavior. Those historical workflows remain available through the corresponding Release/tag. V3.8X2 does not export IDs outside its current nine public nodes, even when their implementation modules remain in source. +The historical V3.5 package retained V3.4 nodes for saved workflows; it did not replace their Node IDs, public sockets, Sampling, Conditioning, Terminal Merge, Assembly, Seam, or Run Storage behavior. Those historical workflows remain available through the corresponding Release/tag. V3.8X2 does not export IDs outside its current ten public nodes, even when their implementation modules remain in source. ![H3 Continuum V3.4 workflow overview](docs/images/v34-workflow-overview.png) @@ -988,7 +1016,7 @@ The public nodes focus on normal production controls. Developer diagnostics and ### Timeline paths -Experimental Timeline Video and earlier timeline-audio paths remain in historical implementation code but are not exported by V3.8. Open V3.3 workflows with their historical package; new V3.8 workflows should use `Driving Audio` and `Video Guide Frames`. +The retired V3.3 Timeline Sampler and earlier timeline-audio paths remain historical and are not exported by V3.8X2. The current experimental implementation instead adds `Follow Timeline` to the existing `Timeline Video Frames` input on Sampler V3.8; it does not restore the old node ID. Open V3.3 workflows with their matching historical package. ## Installation @@ -1005,7 +1033,7 @@ git pull --ff-only origin main Restart ComfyUI after the update. If the node was installed with ComfyUI Manager, use its **Update** action instead of running `git pull` manually. Do not mix Manager updates and a separate Git checkout for the same installation. -After the backend restart, search for `H3 Continuum Sampler V3.8`. The complete V3.8X2 search surface contains the nine nodes listed above. If they are missing, check the startup console for the `H3 Continuum 3.8.3 loaded` message and any `ComfyUI-H3-Continuum` import error. +After the backend restart, search for `H3 Continuum Sampler V3.8`. The complete V3.8X2 search surface contains the ten nodes listed above. If they are missing, check the startup console for the `H3 Continuum 3.8.3 loaded` message and any `ComfyUI-H3-Continuum` import error. Search for H3 Continuum or Continuum in ComfyUI Manager, or install manually: @@ -1315,9 +1343,9 @@ Use a 24 fps source for `Video Guide Frames`. `Load Video (Upload)` may accept f ## Current validation status -The V3.8X2 public-surface suite checks the exact nine-node export, both official workflow names and matching ZIP payloads, declared external dependencies, Registry exclusions, preserved V3.8 widget/socket order, and presentation-only `Show Advanced Settings` / `Hide Advanced Settings` behavior. Registry payload hashes are recorded in `REGISTRY_MANIFEST.sha256`; source integrity is recorded in `MANIFEST.sha256`. +The V3.8X2 public-surface suite checks the exact ten-node export, both unchanged official workflow names and matching ZIP payloads, the separate experimental Follow/Repeat workflows, declared external dependencies, Registry exclusions, the preserved V3.8 widget/socket prefix plus the appended mode widget, and presentation-only `Show Advanced Settings` / `Hide Advanced Settings` behavior. Registry payload hashes are recorded in `REGISTRY_MANIFEST.sha256`; source integrity is recorded in `MANIFEST.sha256`. -**Latest V3.8X2 preparation evidence:** the full CPU suite passed **1,367 passed / 1 skipped / 0 failed**. The prior dedicated GPU Functional Gate passed a `3 × 5 second` Review Each Chunk run: Q1–Q3 generated one physical group at a time, and Q4 reused all three groups with `3 reused / 0 generated`. Q3 and Q4 had identical decoded RGB and PCM SHA-256 values. The separate nine-reference Gate is recorded below. These checks confirm functional execution, prefix reuse, AV reconstruction, and the tested nine-reference path; they are not a full subjective image- or audio-quality rating. +**Latest V3.8X2 preparation evidence:** after the Timeline Video integration, the full CPU suite passed **1,424 passed / 1 skipped / 0 failed**. Browser persistence and Follow/Repeat `2 × 5 second` GPU gates passed; both produced 704×416, 24 fps, 240-frame, 10-second video with 32 kHz stereo audio and no OOM, NaN, allocation failure, or crash. The prior dedicated Review Functional Gate passed a `3 × 5 second` run: Q1–Q3 generated one physical group at a time, and Q4 reused all three groups with `3 reused / 0 generated`; Q3 and Q4 had identical decoded RGB and PCM SHA-256 values. The separate nine-reference Gate is recorded below. These checks confirm functional execution, prefix reuse, AV reconstruction, mode separation, and the tested nine-reference path; they are not a full subjective image- or audio-quality rating. ### Nine-reference input gate (0.3 MP reference images) diff --git a/README_JA.md b/README_JA.md index 8e945a8..9517c3a 100644 --- a/README_JA.md +++ b/README_JA.md @@ -10,6 +10,28 @@ 検証範囲は[Loader修正記録](docs/LOADER_PERSISTENCE_REPAIR.md)を参照してください。CPU回帰テストと実ブラウザ確認は別です。Windows Core 0.36.0 / frontend 1.53.6のタブ切替確認は未実施で、Release/tag・Registry公開も別作業です。以下の旧Loader画像は互換ノードの説明です。 +## Timeline Video — main上のExperimental機能 + +従来の動画IMAGE入力を**`Timeline Video Frames`**と表示し、末尾に省略可能な設定**`Video Reference Mode`**を1項目追加しました。新しい設定を持たない既存Workflow/APIは、初期値の**`Repeat Reference`**で従来動作を維持します。 + +- **`Repeat Reference`**:従来のVideo Guide契約です。各physical生成groupで、同じ先頭側の上限付き参照を使います。短い素材を自動ループ/Stretchしません。 +- **`Follow Timeline`**:各physical出力groupの時間位置に対応する24fps参照区間を使います。Continuationの過去prefixを二重消費しません。素材終了後は動画参照なしで続行し、利用可能な終端区間にはH3 frame-grid整列分だけ短いpaddingを行う場合があります。 + +これは`Prompt Format = Timeline`とは別の設定です。新しいsocketやLoaderは増やさず、元動画のAudioも自動使用しません。参照動画はsoft conditioningであり、motionをframe単位で完全コピーする機能ではありません。また、decode済みIMAGE batch全体をsystem RAMへ保持するため、長尺入力のRAM削減機能ではありません。 + +接続は既存のままです。 + +```text +Core Load Video → H3 Continuum Video Adapter → Timeline Video Frames +``` + +公式V3.8X2 Workflow本体は変更せず、比較用Experimental Workflowを別名で追加しています。 + +- [Follow Timeline JSON](examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Follow.json)/[ZIP](examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Follow.zip) +- [Repeat Reference JSON](examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Repeat.json)/[ZIP](examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Repeat.zip) + +ローカル受入ではFull CPU `1424 passed / 1 skipped / 0 failed`、ブラウザ保存・再読込、Follow/Repeatの`2 × 5秒` GPUテストがPASSしました。両方とも704×416、24fps、240フレーム、映像10秒、32kHz stereo音声10秒で、OOM/NaN/allocation failure/crashはありません。FollowはChunk 2で後半区間へ切り替わり、Repeatは同じ先頭側参照を維持しました。RTX 5060 Ti 16 GBで観測した最大VRAMは約15.6~15.7 GiBで、16 GBの余裕は小さい条件です。これは機能・mode分離の受入結果であり、一般的な速度や主観画質の保証ではありません。詳細は[Timeline Video Experimental](docs/TIMELINE_VIDEO_EXPERIMENTAL.md)を参照してください。 + > **V3.8X2**はpackage `3.8.3`の製品名・Workflow名です。V3.8 Production Samplerを維持し、任意のReference Image 4~9と内蔵Decode Cache Helperを追加しています。旧V3.8.0は[`v3.8.0`タグ](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/tree/v3.8.0)から導入できます。 @@ -48,7 +70,7 @@ Reference Image 1~3はSamplerへ直接接続し、任意の4~9は`H3 Continu キャッシュはPythonプロセス内の利用に限られ、再起動後は再利用しません。上限による退避・破棄やVAE識別情報の変化でもMISSになります。モード、RAM/Disk予算、`reset_token`を変更すると、この実装ではHelperキャッシュをクリアします。`reset_token = 0`を維持することは、毎回リセットする意味ではありません。 -`H3DecodeCacheHelper`をContinuumパッケージ内に収録し、UI上は`MiniMax H3/Continuum/Helpers`の独立公開ノードとして残します。インストール対象はContinuumだけです。公開IDはV3.8Xの7件にReference ImagesとHelperを加えた計9件です。Sampler、Finalize、Assembly Plan、Core Decode、Samplerの保存済みwidget/socket契約は変更しません。 +`H3DecodeCacheHelper`をContinuumパッケージ内に収録し、UI上は`MiniMax H3/Continuum/Helpers`の独立公開ノードとして残します。インストール対象はContinuumだけです。現行パッケージはVideo Adapterと互換用旧Audio/Video Loaderを含む計10 IDを登録します。Sampler、Finalize、Assembly Plan、Core Decode、既存Sampler widget/socketの先頭契約は変更せず、Timeline Videoのmode widgetだけをoptional末尾へ追加します。 Samplerの`video_latents`/`audio_latents`と同じVideo/Audio VAEをHelperへ接続し、Helperの`images`/`audio`をFinalizeへ接続します。Samplerの`assembly_plan`はFinalizeへ直接接続したままです。[公式V3.8X2 Workflow](examples/workflows/MiniMax_H3_Continuum_V38X2.json)は保存済みgraphと設定を維持します。このgraphにはCore VAE Decodeノードがないため、Core直結へ戻すにはCore Video/Audio Decodeを追加してFinalizeへ再配線するか、旧V3.8XのCore直結graphを開いてください。Helperを単に削除しても自動では戻りません。 @@ -99,13 +121,14 @@ V3.8X2 Workflow:[JSON](examples/workflows/MiniMax_H3_Continuum_V38X2.json)/[ H3 Continuumは、長尺映像を最初からやり直さずに生成・確認・部分再生成・再開するProduction Samplerです。V3.8は`Main / Production`と`Advanced`の2層に整理しました。 -このローカル版で検索可能なノードは、元のV3.8の7ノードにReference ImagesとDecode Cache Helperを加えた次の9つです。 +現行V3.8X2で検索可能なノードIDは次の10個です。旧Audio/Video Loaderは保存Workflow互換用で、新規WorkflowはCore LoaderとVideo Adapterを使います。 - `H3 Continuum Sampler V3.8` - `H3 Continuum Finalize` - `H3 Continuum Load Image` - `H3 Continuum Load Audio` - `H3 Continuum Load Video` +- `H3 Continuum Video Adapter` - `H3 Continuum Second Pass` - `H3 Continuum Reference Audios` - `H3 Continuum Reference Images` @@ -119,12 +142,18 @@ V3.8X2公式Workflowの標準経路は`Sampler V3.8 -> Decode Cache Helper -> Fi `H3 Continuum Reference Audios`は、最大3本の単独Reference Audioを1本の`Audio References (Optional)` socketへまとめます。入力は間を空けずに接続し、Promptでは接続順どおりに`