docs: add V3.9 feature and node illustrations to README
This commit is contained in:
@@ -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.
|
||||
|
||||
+8
-4
@@ -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
|
||||
|
||||
@@ -1,5 +1,13 @@
|
||||
# ComfyUI-H3-Continuum 3.9.0 — V3.9
|
||||
|
||||

|
||||
|
||||
*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.*
|
||||
|
||||

|
||||
|
||||
*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
|
||||
|
||||

|
||||
|
||||
*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
|
||||
|
||||

|
||||
|
||||
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 `<Picture N>`. 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.
|
||||
|
||||
@@ -1,5 +1,13 @@
|
||||
# ComfyUI-H3-Continuum 3.9.0 — V3.9
|
||||
|
||||

|
||||
|
||||
*現在の`main`はV3.9です。Image 1~9の固定番号、チャンク別のReference選択、V3.9 Samplerへの1本の接続が新しい操作です。*
|
||||
|
||||

|
||||
|
||||
*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ノード:画像とチャンクを選ぶ
|
||||
|
||||

|
||||
|
||||
*この画像は操作例で、配布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`出力を、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の実際の`<Picture N>`へ変換されます。両モードとも同じチャンク別処理を通ります。
|
||||
|
||||
Promptは実行を止めません。明示的なTimelineでも解析できなければ元の入力をFixedとして扱い、診断`H3C-P100`を出します。Timelineで指定のないチャンクは前のPromptを再利用し、`H3C-P101`で知らせます。どの画像を各チャンクに使うかはReference Imagesノードで選び、Prompt中の`@R1`~`@R9`は接続画像の固定番号に対応させてください。
|
||||
|
||||
@@ -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
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 577 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 1.4 MiB |
Binary file not shown.
|
After Width: | Height: | Size: 114 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 112 KiB |
Reference in New Issue
Block a user