diff --git a/.comfyignore b/.comfyignore index 5ea2674..c6c11e7 100644 --- a/.comfyignore +++ b/.comfyignore @@ -31,6 +31,16 @@ docs/* !docs/V38_OPEN_INTEGRATION_CONTRACT.md !docs/V38_RELEASE_AND_MIGRATION.md +# README launch illustrations: include only the current V3.9 guide assets. +!docs/images/ +docs/images/* +!docs/images/v39/ +docs/images/v39/* +!docs/images/v39/v38x2-feature-summary-historical.png +!docs/images/v39/v39-feature-summary.png +!docs/images/v39/v39-reference-images-node.png +!docs/images/v39/v39-sampler-node.png + # Ship the separate V3.9 and V3.8X2 workflows. The V3.8X2 standard ZIP also # contains V3.9; its helper-explicit ZIP remains the V3.8X2-only alias. # External custom-node dependencies are documented, not bundled. diff --git a/MANIFEST.sha256 b/MANIFEST.sha256 index 8af000f..0cc10f9 100644 --- a/MANIFEST.sha256 +++ b/MANIFEST.sha256 @@ -1,5 +1,5 @@ dca65fb1393e67f59c6f81f9411e3e745eb8f1097e9a2adf7ffc6f4e3901ca9f __init__.py -32a0b0b45442edb97fe151faaa1a03a84bc4ee63b4a2ab6066a80c9f50629f1b .comfyignore +54ba2a58388c42063d24335aa2737e86bd4c15fe9632dcc9ffba18c328e04641 .comfyignore 3d681ded5d4c50cc20c2382e29fdc98d8a48e76d552c41ad5a195d941e66e612 .gitattributes 8296f0afc7be47171e439c02fb2988cfeb0df904acbe3fc4f507f426d709157e .github/workflows/tests.yml 0a2f69d4cec89d440f5d5aa1ec68a7c9a741382d313f80dcddf96d13f70b3e68 .gitignore @@ -69,6 +69,10 @@ c12bd55db2a25092e7c29d6d3a43d8a69452373c13e9a7559ad61c87ed4025ba docs/images/v3 04d935d4f183b14f2d25dfc7e22c2647ab47aef7826320c127dab2c1952e0de0 docs/images/v38-manual/size-source-first-image-tooltip.png 552dba25b13788d1202047b8504b8ee6447f5d99608c62741109e4f6914a46e2 docs/images/v38-manual/size-source-manual-640.png b2b5a0736a07b9825df58fa3bc3b18f210679d16f041b1b40d984d325074c68d docs/images/v38-manual/turbo-lora-choices.png +a4705ae4b5730d2b43e29fe125a64196a031f14bcfa8702663a17aa89f683d89 docs/images/v39/v38x2-feature-summary-historical.png +ae3338f720fc22c05ab4a661c68f9c5dcb20d751a835f0e60d4738333be48e63 docs/images/v39/v39-feature-summary.png +84304d318eea6db3921d366647c6fff9ad488e8c4cfef6ca00988bfd2a6504bc docs/images/v39/v39-reference-images-node.png +b765b37502b012b462606c4d2dcef43f13950e5fd682824fb18cdb19d542c121 docs/images/v39/v39-sampler-node.png b30fe4640359bebfcdeeb94dbeec94cb346c8e3646509e1dcdb87d7021ba04ff docs/N2B_BRANCH_PROVENANCE_CONTRACT_V1.md a884c0bb08fca1f3a2f2b8f0e607f5d2c9ea27feec902fdce720743026fae019 docs/R0_RUNTIME_CHARACTERIZATION.md e6b8cc3250776868f473357cd97ce299fcea31ae18b879ec6e6466f47dbf704e docs/R6_NODE_FACADE_DELTA.md @@ -118,12 +122,12 @@ ea64b8e0aa0dda828047c9c12818be8554429774049b9e8c0482c84b9c4f4071 PACKAGE_VALIDA b470819f16fc179654dc1600721a63f0a5a14e777f4c004d574b499da6886ba5 public_api.py 667f2646e82362d472d91a7cf5dc9a86c95f6637f3bc8c672dd516800b1a598c pyproject.toml 94fdc2d545b2d4077a4d70229fd22ba3ccac21d49d1097d2873f76d04e9a3c7a pytest.ini -a6927e8ecbbf3997317c918a200a815f84de2bef8ba5fe863fa9589c07fcfa7c README_JA.md -7a2269cad66c13ef335c9905b0e8cabf09c0e1685ffab574c07386f0e01c33a3 README.md +5d1302baa84564055c60020f158b0a6ff70cd255b6b4678be7fa03f52bbbcdd3 README_JA.md +7fe3bf8d946a4ee75452757212701b4979fbc77656823b8901d0ed6f4120a1d1 README.md 44127adcfa30ee84bff9cd4b2d0c695355209550e76982d374122008728aa5bc reference_audio.py 5cb9bfd6810d3a93a637451980a4cc5c1436e5b84cfd1c7a111cd192e876351b reference_video.py caa572ea65dafc86850db99f52433d360ac9c4ab36b854292a3dccd5ba32dc76 reference.py -d06af0a69b9d33f598407ad0ba3a583f2d3a744ae6254b127d834bb34e5bf574 REGISTRY_MANIFEST.sha256 +4ea6ad5b2613d1da775bb7c6e9af015586322c5cfe152991188dbc7839cf1025 REGISTRY_MANIFEST.sha256 467edb2c188d024c2392aafe7423b3f835e16b10f570da76e2f7dda8a962c1c5 requirements.txt 53827c94b3f588f35bb8eacb404e1bd5e233d25f4ee0fdd286efc7d8ddb52b6f run_storage.py 6056de6c0a5322a8a51ba5a114538dca2ef67788cd1afba10fedd483b95f6afa state_io.py diff --git a/README.md b/README.md index 4c8ba80..dd63909 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,13 @@ # ComfyUI-H3-Continuum 3.9.0 — V3.9 +![H3 Continuum V3.9: fixed Reference Image slots, per-chunk assignments, and one Sampler input](docs/images/v39/v39-feature-summary.png) + +*V3.9 is current on `main`: fixed Image 1–9 slots, per-chunk Reference selection, and one Reference Images connection to the V3.9 Sampler.* + +![H3 Continuum V3.8X2 feature card from its original release](docs/images/v39/v38x2-feature-summary-historical.png) + +*This V3.8X2 card is retained for comparison. Its “CURRENT MAIN” label describes the time it was made; V3.9 is current now. The V3.8 Sampler and V3.8X2 workflow remain available, but their Reference wiring is not automatically converted to V3.9.* + ## Start here: V3.9 and the retained V3.8X2 workflow The ComfyUI **Templates → ComfyUI-H3-Continuum** gallery offers two separate entries: the user-selected [V3.9 workflow](examples/workflows/MiniMax_H3_Continuum_V39.json) and [V3.8X2 workflow](examples/workflows/MiniMax_H3_Continuum_V38X2.json). The [V3.8X2 workflow ZIP](examples/workflows/MiniMax_H3_Continuum_V38X2.zip) contains **both unchanged JSON workflows** for one-download setup; the [V3.9 ZIP](examples/workflows/MiniMax_H3_Continuum_V39.zip) contains only V3.9. These are workflow archives, not custom-node installers. The V3.8 Sampler remains available, so existing V3.8X2 workflows still load. V3.9 does not automatically convert their Reference connections or saved Runs/Takes: preserve the old workflow and open the dedicated V3.9 graph for new work. @@ -14,6 +22,18 @@ V3.9.0 is the current source version on `main`. This source update is **not** a ## V3.9 Reference Images +### Reference Images node: choose the image for each chunk + +![H3 Continuum Reference Images V3.9 node with fixed image slots and a per-chunk assignment table](docs/images/v39/v39-reference-images-node.png) + +*Example UI, not the downloadable workflow's default assignments.* Image 1–9 are fixed slots: Image 1 is always `@R1`, even when other slots are empty. With `Reference Use = Per chunk`, tick the image/chunk intersections you want; each row's `All` / `Off` buttons select or clear that image across chunks. In this screenshot, Image 1 is assigned to Chunks 1 and 2, while other images have different assignments. The official V3.9 workflow starts with its image loaders bypassed and every assignment unchecked; choose real image files, enable their loaders, then tick the intended chunks. + +### Sampler V3.9: connect the helper once + +![H3 Continuum Sampler V3.9 with one Reference Images Optional input](docs/images/v39/v39-sampler-node.png) + +Connect the helper's green `reference_images` output to the Sampler's single `Reference Images (Optional)` input. The V3.8X2 workflow uses its own V3.8 Sampler and older Reference sockets; opening it does not convert those connections to V3.9. This screenshot shows a **Manual 480×640 example**, not the official V3.9 workflow's saved **First Image + Draft 0.30 MP** setting. `Reference Image Size = Match Output` controls Reference conditioning size after image loading; it does not pre-resize source files or set output resolution. + V3.9 now connects all nine fixed Reference Images through one **H3 Continuum Reference Images V3.9** node. Its in-node table selects All chunks or specific chunks. The V3.9 Sampler has one typed Reference Images connection and keeps Sequence Prompt, First/Last, Review and the rest of its generation controls. Use `@R1` for Image 1; the backend converts active tags to the group's actual ``. Both modes use the same group-routing engine. Prompt parsing never blocks generation. If an explicit Timeline cannot be parsed, the original text falls back to Fixed with diagnostic `H3C-P100`. An uncovered Timeline chunk reuses the previous prompt and reports `H3C-P101`. Select the image for each chunk in the Reference Images node; `@R1`–`@R9` in Sequence Prompt refer to those fixed image numbers. diff --git a/README_JA.md b/README_JA.md index a22b37b..d933440 100644 --- a/README_JA.md +++ b/README_JA.md @@ -1,5 +1,13 @@ # ComfyUI-H3-Continuum 3.9.0 — V3.9 +![H3 Continuum V3.9:固定の参照画像番号、チャンク別割り当て、Samplerへの1本の接続](docs/images/v39/v39-feature-summary.png) + +*現在の`main`はV3.9です。Image 1~9の固定番号、チャンク別のReference選択、V3.9 Samplerへの1本の接続が新しい操作です。* + +![公開当時のH3 Continuum V3.8X2機能紹介画像](docs/images/v39/v38x2-feature-summary-historical.png) + +*V3.8X2の画像も比較用に残しています。画像内の「CURRENT MAIN」は作成当時の表記で、現在の`main`はV3.9です。V3.8 SamplerとV3.8X2 Workflowは利用できますが、Reference配線はV3.9へ自動変換されません。* + ## 最初に:V3.9とV3.8X2 ComfyUIの **Templates → ComfyUI-H3-Continuum** には、今回選んだ[V3.9公式Workflow](examples/workflows/MiniMax_H3_Continuum_V39.json)と、別の[V3.8X2 Workflow](examples/workflows/MiniMax_H3_Continuum_V38X2.json)を2件表示します。[V3.8X2 Workflow ZIP](examples/workflows/MiniMax_H3_Continuum_V38X2.zip)には、**V3.8X2とV3.9の両JSON**を同梱しました。[V3.9単独ZIP](examples/workflows/MiniMax_H3_Continuum_V39.zip)も残します。いずれもWorkflow用ZIPで、カスタムノード本体のインストーラーではありません。V3.8 Samplerは残るので既存のV3.8X2 Workflowは使えます。ただしV3.9へReference配線や保存済みRun/Takeは自動移行しません。旧Workflowを保存しておき、新しい作業ではV3.9専用Workflowを開いてください。 @@ -14,6 +22,18 @@ V3.9.0は`main`の現行ソースです。今回のmain更新は新しいGitHub ## V3.9 Reference Images +### Reference Imagesノード:画像とチャンクを選ぶ + +![H3 Continuum Reference Images V3.9ノードの固定スロットとチャンク別割り当て表](docs/images/v39/v39-reference-images-node.png) + +*この画像は操作例で、配布Workflowの初期割り当てではありません。* Image 1~9は固定スロットで、途中が空でもImage 1は常に`@R1`です。`Reference Use = Per chunk`にすると、使いたい画像とチャンクの交点をチェックできます。各行の`All`/`Off`は、その画像を全チャンクで選択/解除します。画像ではImage 1をChunk 1・2に割り当て、ほかの画像は別のチャンクに割り当てています。公式V3.9 Workflowは画像Loaderが初期Bypass、割り当てが全OFFです。実ファイルを選び、Loaderを有効化してから、使うチャンクにチェックしてください。 + +### Sampler V3.9:ヘルパーから1本で接続 + +![Reference Images Optional入力を1本持つH3 Continuum Sampler V3.9](docs/images/v39/v39-sampler-node.png) + +ヘルパーの緑色の`reference_images`出力を、Samplerの`Reference Images (Optional)`入力へ1本つなぎます。V3.8X2 Workflowは旧V3.8 Samplerと従来のReference接続を使用し、開くだけでV3.9配線へ変換されるわけではありません。この画像のサイズ設定は**Manual 480×640の操作例**で、公式V3.9 Workflowの保存値は**First Image+Draft 0.30 MP**です。`Reference Image Size = Match Output`は画像読込後のReference conditioningサイズを決め、元ファイルを事前縮小したり、動画の出力解像度を直接決めたりはしません。 + V3.9では、固定番号の参照画像1~9を新しい **H3 Continuum Reference Images V3.9** ノードにまとめます。ノード内の表で「All chunks」またはチャンク別のチェックを選び、Samplerへは1本だけ接続します。`Sequence Prompt`で`@R1`と書けば固定の画像1を指します。有効なタグは各生成groupの実際の``へ変換されます。両モードとも同じチャンク別処理を通ります。 Promptは実行を止めません。明示的なTimelineでも解析できなければ元の入力をFixedとして扱い、診断`H3C-P100`を出します。Timelineで指定のないチャンクは前のPromptを再利用し、`H3C-P101`で知らせます。どの画像を各チャンクに使うかはReference Imagesノードで選び、Prompt中の`@R1`~`@R9`は接続画像の固定番号に対応させてください。 diff --git a/REGISTRY_MANIFEST.sha256 b/REGISTRY_MANIFEST.sha256 index e5e4346..9842ca2 100644 --- a/REGISTRY_MANIFEST.sha256 +++ b/REGISTRY_MANIFEST.sha256 @@ -1,5 +1,5 @@ dca65fb1393e67f59c6f81f9411e3e745eb8f1097e9a2adf7ffc6f4e3901ca9f __init__.py -32a0b0b45442edb97fe151faaa1a03a84bc4ee63b4a2ab6066a80c9f50629f1b .comfyignore +54ba2a58388c42063d24335aa2737e86bd4c15fe9632dcc9ffba18c328e04641 .comfyignore 3e7a1ec3380be2a222c8a3e9b8a6bb184d3a760478957f48186438f15235bdba branch_provenance.py 593ec5bafb8e506cc7b326bdc7e3f024a142569f24f8d39c1aaa3b5acfd0beca CHANGELOG.md c1ed3a0342730450958fb62fd21854a876991f3a4aefb24e5383b0c73cd2312d compatibility.py @@ -35,8 +35,8 @@ ecb65a5dbf9e1683c5a3cadd82daaea3a90a2b776f6ebabfbe8b07aa93177422 nodes.py ea64b8e0aa0dda828047c9c12818be8554429774049b9e8c0482c84b9c4f4071 PACKAGE_VALIDATION.txt b470819f16fc179654dc1600721a63f0a5a14e777f4c004d574b499da6886ba5 public_api.py 667f2646e82362d472d91a7cf5dc9a86c95f6637f3bc8c672dd516800b1a598c pyproject.toml -a6927e8ecbbf3997317c918a200a815f84de2bef8ba5fe863fa9589c07fcfa7c README_JA.md -7a2269cad66c13ef335c9905b0e8cabf09c0e1685ffab574c07386f0e01c33a3 README.md +5d1302baa84564055c60020f158b0a6ff70cd255b6b4678be7fa03f52bbbcdd3 README_JA.md +7fe3bf8d946a4ee75452757212701b4979fbc77656823b8901d0ed6f4120a1d1 README.md 44127adcfa30ee84bff9cd4b2d0c695355209550e76982d374122008728aa5bc reference_audio.py 5cb9bfd6810d3a93a637451980a4cc5c1436e5b84cfd1c7a111cd192e876351b reference_video.py caa572ea65dafc86850db99f52433d360ac9c4ab36b854292a3dccd5ba32dc76 reference.py @@ -130,6 +130,10 @@ bf41bf08dd0504eb753fa5781e6c2b8c1285758ad4bb7309975bb9231d5f8e41 web/video_refe b64f4d3d9547ac00f8edb2155109476df5b8baea730fb94e8b5bfca6d11564e6 v3/reference_images_v39.py e9d7753f313ebbe3d13e477f5b4e4767a735b0619b52ba54bcc5218f3eb7eb7c web/reference_images_v39.js 4d17d74107e78404b190fec9494b443249e5aff4f58670c50d54dfdfb064334b docs/V39_REFERENCE_INLINE.md +a4705ae4b5730d2b43e29fe125a64196a031f14bcfa8702663a17aa89f683d89 docs/images/v39/v38x2-feature-summary-historical.png +ae3338f720fc22c05ab4a661c68f9c5dcb20d751a835f0e60d4738333be48e63 docs/images/v39/v39-feature-summary.png +84304d318eea6db3921d366647c6fff9ad488e8c4cfef6ca00988bfd2a6504bc docs/images/v39/v39-reference-images-node.png +b765b37502b012b462606c4d2dcef43f13950e5fd682824fb18cdb19d542c121 docs/images/v39/v39-sampler-node.png 67e81fbdd4c21a8d64fb3bedb5e495698fc8df5cdd9540c8ef5476caa76119c0 examples/workflows/MiniMax_H3_Continuum_V39_Reference_Inline.json 65689fd800a60ab6939bea020d630616b03a453cf6d48022cd1361992a765abc examples/workflows/MiniMax_H3_Continuum_V39_Reference_Inline.zip 40199d2500174ba51c040d6983f88d74c4bfbaf19191e728818e6b969b869b0f examples/workflows/MiniMax_H3_Continuum_V39.json diff --git a/docs/images/v39/v38x2-feature-summary-historical.png b/docs/images/v39/v38x2-feature-summary-historical.png new file mode 100644 index 0000000..2fff17d Binary files /dev/null and b/docs/images/v39/v38x2-feature-summary-historical.png differ diff --git a/docs/images/v39/v39-feature-summary.png b/docs/images/v39/v39-feature-summary.png new file mode 100644 index 0000000..edf63a1 Binary files /dev/null and b/docs/images/v39/v39-feature-summary.png differ diff --git a/docs/images/v39/v39-reference-images-node.png b/docs/images/v39/v39-reference-images-node.png new file mode 100644 index 0000000..ad4d1b9 Binary files /dev/null and b/docs/images/v39/v39-reference-images-node.png differ diff --git a/docs/images/v39/v39-sampler-node.png b/docs/images/v39/v39-sampler-node.png new file mode 100644 index 0000000..41adc92 Binary files /dev/null and b/docs/images/v39/v39-sampler-node.png differ