diff --git a/AGENTS.md b/AGENTS.md index a970c95..2612cc7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,7 +1,7 @@ # AGENTS.md ## Scope -MiniMax H3 Continuum V3.5.2 for ComfyUI. Treat V3.5.2 as the current public baseline; preserve V3.4 node IDs, public contracts, and saved-workflow loading without letting legacy controls change current behavior. +MiniMax H3 Continuum V3.5.3 for ComfyUI. Treat V3.5.3 as the current maintenance baseline; preserve V3.4 node IDs, public contracts, and saved-workflow loading without letting legacy controls change current behavior. ## Non-negotiable rules - Follow ComfyUI Core behavior for user-facing validation. Continuum-only prompt restrictions, model allowlists, compatibility gates, and policy-based execution stops are prohibited. diff --git a/CHANGELOG.md b/CHANGELOG.md index 162deba..196b1b9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,13 @@ # Changelog +## 3.5.3 + +- Repaired the public Conditioning Bridge workflow's Width/Height input slots and added serialization-integrity checks for every published workflow. +- Removed stale orphan link IDs from the public V3.4, V3.4 Turbo, and V3.5 workflow files. +- Corrected Hybrid First/Last + Reference warning messages so public `` numbering remains absolute and matches the accepted runtime behavior. +- Losslessly re-encoded one unreferenced legacy PNG that strict image decoders could not read. +- Preserved all V3.5.2 generation, Sampling, Conditioning, Terminal Merge, Assembly, Seam, Run Storage, Prompt/CLIP cache, Video Guide optimization, and V3.4 compatibility contracts. + ## 3.5.2 - Added a conservative V3.5-only Prompt/CLIP cross-run LRU cache for unchanged T2VA, I2VA, and FL2VA conditioning. Reference, scheduled, tokenizer-option, and hook-modified CLIP paths bypass the cache; V3.4 is unchanged. diff --git a/MANIFEST.sha256 b/MANIFEST.sha256 index ccf7d22..7d43098 100644 --- a/MANIFEST.sha256 +++ b/MANIFEST.sha256 @@ -1,8 +1,8 @@ dca65fb1393e67f59c6f81f9411e3e745eb8f1097e9a2adf7ffc6f4e3901ca9f __init__.py 4f6feeb2f63a9285b0e76fb2e2618058c7d7c279af1632e1a6ccabcc9ec9a45a .github/workflows/tests.yml 0a2f69d4cec89d440f5d5aa1ec68a7c9a741382d313f80dcddf96d13f70b3e68 .gitignore -a7cfeb430af9d510110b5e2fb6c024a954fa83b856f985ce27da608fc508bab6 AGENTS.md -7f0a4b24a14abae40a98bbc9f66112e74fd4b80a8820f7f15ec6a9dd1ab5455e CHANGELOG.md +46cc7e0f2a5d04d01de4962165b0623966b303839911779c9c31ef9f541fe519 AGENTS.md +6d2fc05374d2a352fda63133d0754d19b532b6663a21e799087ebaa60acb3d9e CHANGELOG.md e97e47c7585e81d9ec5fd32c0ca0b64699fd4610cd03e9d6575a91c30a10ca4e compatibility.py 4d62508f900af9f93ec320afb900c27cc9a300d1e0c0a94714258498c5ede5fc conditioning.py 71e3df269e226b1ecad597f9831c2a10b2215c8a3783652e9e9f536e99ce46c9 constants.py @@ -17,7 +17,7 @@ de5f8fbce6bc423817acf7dc86bb0c8805a1fd962afdb2722cde7395f117eb56 docs/images/h3 a384e26f3b088607c616be1a2b038365147d92da0961d8f47060fed09f795062 docs/images/h3-continuum-sampler.png 46c52e21c8f99a75c678e7abf20e381c8140860be2662bad528a6cbfc5f3295d docs/images/h3-continuum-v33-settings.png 321311da5d2c30953dc2061ca8fdd6e10b84511a15a9bc87704f000dd687cd0a docs/images/h3-continuum-v33-streamlined-ui.png -759d18e15e0cf139630259db38123a824be565ec844a3d7ac020b74ff8537b25 docs/images/v31b-auto-resume.png +e93b6f4f8da5b2191f2d7715476eff1ab6c44fd96db689618a4bc0aa307c7b5d docs/images/v31b-auto-resume.png c9573d4393236276d032c4503f8ed8bd19c6ef24e84eec6f64f8a4c47aabc718 docs/images/v34-driving-audio-connection.png 1b9bff0d32ab1928dd85d04700be563458484748a7bfafe4db293c4950ce6bc8 docs/images/v34-regenerate-from.png 65efc844c3f116e0a46bc35390bb46e3968df44fd44ea65a63629a3953371605 docs/images/v34-sampler-spectrum-assemble.png @@ -54,10 +54,10 @@ b8275c8cecde12aee0418cea456d1e7f4b875cbb1bce32f1f3d9e06a44dd0be1 examples/v2_pr 4e410aed8d7f6ebf11c98d4f71571e46855e4619c2bcbec921df70f29189b6b1 examples/workflows/MiniMax_H3_Continuum_V32.json 55bc60447d6cd783b9df049d04b6cebb6e4a633981434ac2b28e5a1527d4f4b4 examples/workflows/MiniMax_H3_Continuum_V33_turbo.json 4e410aed8d7f6ebf11c98d4f71571e46855e4619c2bcbec921df70f29189b6b1 examples/workflows/MiniMax_H3_Continuum_V33.json -5eab33c110e07ec08ac66f289f20c295a90ca026ea5231ad6121755a28a2ded8 examples/workflows/MiniMax_H3_Continuum_V34_turbo.json -660e955c983e41947f5abfd89e66fbe5759ffda01e6c1a7164d580b0c41b2120 examples/workflows/MiniMax_H3_Continuum_V34.json -ed31ddd3d0af5e6f8dbd609e5ef51872322dbe52eaad8cae35e16342ac53dbfa examples/workflows/MiniMax_H3_Continuum_V35.json -03bcfd11087c82e89ddb70773432dd08baaf2ab119632e88ee1948bcc6686fd3 examples/workflows/MiniMax_H3_Continuum_V351_LBH_Conditioning_Bridge.json +3d57fa510f98e0874b73ae74c9402f14611c167ef99269dc9ba025ffcaa34973 examples/workflows/MiniMax_H3_Continuum_V34_turbo.json +a8460ca5092511f6d22da3363331ba8bff4feab01c569e539811049ea1add051 examples/workflows/MiniMax_H3_Continuum_V34.json +ea8c245d36909672710bc9f535f37195e48d7151b0cb2217bcaaca5fcc6d02c0 examples/workflows/MiniMax_H3_Continuum_V35.json +9f1a0766b97ead788989fb6eb69a6b36ad236d7a924eea4a88e4a1696e2db6d8 examples/workflows/MiniMax_H3_Continuum_V351_LBH_Conditioning_Bridge.json e8f41dee2240f1fcc6e8fd12448856513483ff3ae0427b2c554bb351f9ae8047 graph_contract.py 3d14acac341c63207995e2bd45cd407fdb3e2308273b1c90605adfe6f2e0bd8f hardening.py 6abdbc29472c7f9d447085b189fc47b69e110b94ef83192f9689d04000408843 INSTALL_JA.txt @@ -66,19 +66,19 @@ d74073e7ee292ebeba913af4288284f9f197cd91fceed6c62bf6c66b784c7cec install_window 6aa3f5780baa7bb0c0672b5f01a2f77e5f209da93f6373468cb274ea2f643d4b layout_adapter.py c44abbd789091bbead01250dbd5453e60539d2665c69f162335fdbd2936019c2 LICENSE d3e213005670e94dee33a240349a4d245cf9a3b6602099f11ed30cf5a32e2c21 media.py -73d8520121ae6e22c58e8455d09c6e9dd09949469f8b2a5485d200c7ee3244f8 metadata.ini +18bea054b11cc97ba5774b35a9367ddafc3ab9678c824f48f4deb354005fb1ba metadata.ini ef705a476e3f5bbd05559e7a0e7d3dfb9275badef0f8f65fb1a36ce27fbcb537 model_patch.py 420f00c8193d527017720b26d6f7011d69c8f68a157b21c0102246cc98ad3a13 nodes.py -7f1869c2eac19f79b1aae6a65362b4eb84dba8b812028abf7d3d29d780cac4c2 PACKAGE_INFO_JA.txt -9a52ebfe476c666633c3dac690a1cb4e0e4d34b2591f23e05fe1100a997c668a PACKAGE_VALIDATION.txt +13fc76ef7422d369a915b6e29bab0c76833e25ea7671ab3efcb8287042a8545a PACKAGE_INFO_JA.txt +ce593d6d23f049152181c46c84f7801b29cdceab0106dac6b27f156d8f2cde1c PACKAGE_VALIDATION.txt b470819f16fc179654dc1600721a63f0a5a14e777f4c004d574b499da6886ba5 public_api.py -5ee4d404553ea773c58aee9714e29ab4f23f01a9281911c8ef5b59bb323eb12f pyproject.toml +aa95491a3959ad3c2218cb0bb711fe88fc687b726f710473c3bafd783a34202e pyproject.toml 94fdc2d545b2d4077a4d70229fd22ba3ccac21d49d1097d2873f76d04e9a3c7a pytest.ini -5eccc59d235902f0c8b26e155cb012132d29c8a13ec9f10c444ccca9f08b0128 README_JA.md -436e388894537812c9a478286332f864efaa04728e694011b4cf878016e54da6 README.md +a6d2f4bb803fe68f99df400cf2bb8d43ad4003af2ae69c67c7a77f0829d404df README_JA.md +a83046936584194eb3df9a534755ec723e95d2a91c9cfce5455effb6a71fac36 README.md 5d89c366b4f076fa73a2695557e0af749bf95df1dad0d55dbb2fe5b1c2519ad7 reference_audio.py a0266ab4434b8e9844219d2b6dd8a168d198dd8f142775be01a39b81dc196b91 reference_video.py -2995924fcb7bac27b548b01187d8276d2ab103c6f43416cf85400de3846c6297 reference.py +564f5f2bf29665059845a98b9ca3e9a1309566aab73bcaa96f95fab8251ab06c reference.py 467edb2c188d024c2392aafe7423b3f835e16b10f570da76e2f7dda8a962c1c5 requirements.txt e02b523b5b1c1272c912c16d547050cc9bb9feb6c348743015bb5d059a4ead06 run_storage.py 6056de6c0a5322a8a51ba5a114538dca2ef67788cd1afba10fedd483b95f6afa state_io.py @@ -99,7 +99,8 @@ d2a02c120e01d360ddca17a92d5bc53b12c9f0734d06440b3fc2fad2e754e549 tests/test_p23 114530f8bc4b0a6cd416581636c85d494a07e5dcca93afe9c82f4a5aaaed9dc7 tests/test_p31_prompt_conditioning_cache.py 403a0ff300330ac1f97642bf0681e80b83eec18e8911c03952ddf203ce794e5a tests/test_p46a_reference_video_memory.py 1ae0369943ba2fb13f21ad0cf56ee58621ba09bf20174379595e157a1775c7fd tests/test_public_api.py -bc66ab71ea7dcb81aa856fcf254841f402ab150964f6133a6de765a3ff5c9f65 tests/test_release_metadata.py +892d3e3e022a527652dd995508c8bbb650c370caf9ee66fa3eb1f7fd288bba38 tests/test_public_workflow_integrity.py +da7f883fb0ab8ea740bd2f9b578ad254a093b6778572e5698fc83797b3673022 tests/test_release_metadata.py d4c53d2c260b635d70fa211029d608f63776e0a56c20253475fa47c58363f8a7 tests/test_state_io.py 98a33c75b33ff0c10a68e04bd856e4e43b3e70b6ae1ea458a2b21b4e4d74f46d tests/test_state.py 58c06925ccf06c4feee19b927b3515c540c0536aa5f3f8d29be35b8e919915a7 tests/test_temporal.py @@ -112,7 +113,7 @@ d4c53d2c260b635d70fa211029d608f63776e0a56c20253475fa47c58363f8a7 tests/test_sta b42bcc0983147462d96c6b71cc4a38e846995dafa6eebefc3ae0d9bb36caf359 tests/test_v2_sequence_orchestration.py 0b5b20a8318862d167f135720e0489b8d4f93406d67c6646e052e35b03dcb876 tests/test_v2_session.py 58438c3ed814adf40cefde098a37cae00ddcb703b7e5548bbbb295e54bed5a6d tests/test_v2_widget_migration.py -419c358962225d7c8893bb426b653d1dc175197d2567b0af60b38bdbb549e011 tests/test_v217_stable_facade.py +f8d585eb4f31bc315b64294213fa25b52ca0d2ba8da2ff02ab571fb1b6db01e4 tests/test_v217_stable_facade.py 78bc478a5e4edda902c80849c911782a99e75c06dfb04127391b6cc5b27b28e1 tests/test_v3_hardening.py eb5b27f8f0d79529c56ef344a5601703642c3cba5388c9768116223e2ed58a36 tests/test_v3_video_seam.py 1f5310587d05eb5058ec94d9985138d25aa22b22fb0dd5c68518f2f2053116a4 tests/test_v31_run_storage.py @@ -167,6 +168,6 @@ da5edf3b4392c41e12ef73a0cd21799be42a327b18bd5a6989447b75163dcab1 v3/second_pass 23a412ce55797cbe6ea19c4379053855ff21bca233e3c373577225b761cc03d0 v3/second_pass.py 4178dcfa442abdb06ce276e05bd7bcbaa6da28469ba5e57d3da3c663de4e4a9d v3/video_seam_v35.py 2f07ace1462644f0bee553827b3571535de4d0c2d9ef847bd9e0ca73a4eed5cb v3/video_seam.py -631055f46ad8be92f560c51aa33c6278ff2ce368a69293f6f510714b53ef1acc version.py +070b70636a92548ec75250fa75dae59f66fb72771cd4f70dc6dcfa619dd0d39e version.py 96b2f9aa1d20677433c46d225b8da26ab5379e4f0419e6d5e091a5c821898bb3 web/project_id.js 0cf8d49bcb71b30437dc893f6218dc4cfb1cd244b647e4fbc2861dea2271a33a web/reference_audio_ui.js diff --git a/PACKAGE_INFO_JA.txt b/PACKAGE_INFO_JA.txt index 588f8b9..526a9a1 100644 --- a/PACKAGE_INFO_JA.txt +++ b/PACKAGE_INFO_JA.txt @@ -1,7 +1,13 @@ -ComfyUI-H3-Continuum V3.5.2 +ComfyUI-H3-Continuum V3.5.3 MiniMax H3の5秒ChunkをAV latent contextで継続し、長尺映像として組み立てるComfyUIカスタムノードです。 +V3.5.3: +- 公開Conditioning Bridge WorkflowのWidth/Height接続を修正 +- 公開V3.4/V3.5 Workflowの孤立link IDを清掃し、全配布Workflowのserialization整合性テストを追加 +- Hybrid First/Last+Referenceの``警告を公開番号のまま表示 +- 生成契約、Node/socket、V3.5.2最適化、V3.4互換性は不変 + V3.5.2: - 同一Prompt / CLIP条件の繰り返し生成でCPU conditioning結果を再利用 - Referenceや特殊CLIP経路は安全側でcache bypass diff --git a/PACKAGE_VALIDATION.txt b/PACKAGE_VALIDATION.txt index 15111cb..9b60b0c 100644 --- a/PACKAGE_VALIDATION.txt +++ b/PACKAGE_VALIDATION.txt @@ -1,6 +1,6 @@ -ComfyUI-H3-Continuum V3.5.2 package validation +ComfyUI-H3-Continuum V3.5.3 package validation -Status: V3.5.2 stabilization and optimization release. Stable V3.5 paths, Conditioning Bridge, Reference Audio, Prompt/CLIP cache reuse, and Video Guide memory optimization are validated. Seed widgets use standard ComfyUI behavior. Integrated Hi-Res Fix remains Experimental. +Status: V3.5.3 distribution-integrity maintenance hotfix. V3.5.2 generation behavior and optimization contracts are unchanged. Stable V3.5 paths, Conditioning Bridge, Reference Audio, Prompt/CLIP cache reuse, and Video Guide memory optimization remain validated. Seed widgets use standard ComfyUI behavior. Integrated Hi-Res Fix remains Experimental. Required automated checks: - python -m compileall -q . @@ -30,7 +30,7 @@ Validated runtime paths include: - Audio Seam Auto - Video Seam Auto guarded transient and micro-flash correction -Latest verified automated result: 485 passed. +Latest verified automated result: 495 passed. Hi-Res Fix and Auto 2 remain experimental. Main 3x5 2x is not accepted on the tested RTX 5060 Ti 16 GiB because the terminal 77T Second Pass group exceeded VRAM; longer Reference/Hybrid acceptance remains pending. diff --git a/PROJECT_STATE.md b/PROJECT_STATE.md index a425555..88e726f 100644 --- a/PROJECT_STATE.md +++ b/PROJECT_STATE.md @@ -12,6 +12,17 @@ Updated: 2026-08-26 +## V3.5.3 maintenance hotfix (2026-08-26) + +- V3.5.3 is a distribution-integrity maintenance hotfix over published V3.5.2. Sampling, Conditioning payloads, Terminal Merge, Assembly, Seam, Run Storage, Prompt/CLIP caching, Video Guide optimization, V3.4 compatibility, node IDs, and backend socket keys are unchanged. +- Repaired the public Conditioning Bridge workflow links `349`/`350` so the shared Width/Height controls target Sampler V3.5 input slots `16`/`17`; removed stale output link IDs `171`/`172`/`173` from the public V3.4, V3.4 Turbo, and V3.5 workflows. +- `validate_reference_prompts()` now preserves absolute public `` numbers for Hybrid First/Last + Reference warnings. This matches the previously accepted ComfyUI_W behavior and changes report text only. +- Re-encoded the unreferenced legacy `docs/images/v31b-auto-resume.png` without changing any displayed pixel. All 19 packaged PNG files pass strict Pillow verification. +- Added regressions for all eight public workflow graphs and the Hybrid warning numbers. Focused validation is `30 passed`; canonical full pytest is `495 passed`, and the source/runtime V3.5.3 verifier passes native PackedLayout, Fixed 3x5 planning, and complete node registration. +- The release Manifest now contains 173 files and verifies every recorded SHA-256, including the new public-workflow integrity regression. +- Production files `reference.py`, `version.py`, and `metadata.ini` are synchronized to ComfyUI_W with exact SHA-256 equality. ComfyUI_WAN is excluded because that secondary runtime is an incomplete older copy and must not be partially relabeled as V3.5.3. +- Accepted snapshots are `pre-v353-maintenance-hotfix-source-accepted-20260826_030732` (199 tracked files, revision `70cbbcd`) and `pre-v353-maintenance-hotfix-comfyui-w-accepted-20260826_030731` (14 present target files). Commit and push have not been performed. + ## V3.5.2 final release gate (2026-08-26) - V3.5.2 is the release-candidate baseline for the Stabilization & Optimization Update. It adds no generation mode and preserves all V3.5.x workflow contracts plus V3.4 Node IDs/backend socket keys. @@ -131,7 +142,7 @@ Updated: 2026-08-26 ## Baseline -- Release-candidate baseline: V3.5.2 (published baseline remains V3.5.1 until commit/push) +- Release-candidate baseline: V3.5.3 maintenance hotfix (published baseline remains V3.5.2 until commit/push) - Authoritative working repository: `D:\Codex\_git_push_work\ComfyUI-H3-Continuum` - Primary tested runtime: `D:\StabilityMatrix\Data\Packages\ComfyUI_W\custom_nodes\ComfyUI-H3-Continuum` - Secondary runtime: `D:\StabilityMatrix\Data\Packages\ComfyUI_WAN\custom_nodes\ComfyUI-H3-Continuum` diff --git a/README.md b/README.md index 31937a8..b88e9ea 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,13 @@ -# ComfyUI-H3-Continuum 3.5.2 +# ComfyUI-H3-Continuum 3.5.3 Long-form MiniMax H3 video generation for ComfyUI with Continuum-aware Second Pass refinement, optional Hi-Res Fix, low-memory disk-backed assembly, restartable chunks, persistent references, and optional Spectrum interoperability. +## V3.5.3 Maintenance Hotfix + +V3.5.3 is a distribution-integrity maintenance release. It repairs the public Conditioning Bridge workflow's Width/Height links, removes stale orphan link IDs from the published V3.4/V3.5 templates, corrects Hybrid `` warning numbering, and repairs one legacy PNG for strict image decoders. + +There are no changes to generation behavior, nodes, sockets, Sampling, Conditioning payloads, Terminal Merge, Assembly, Seam, Run Storage, Prompt/CLIP caching, Video Guide optimization, or V3.4 compatibility. Existing V3.5.x workflows continue to load unchanged. + ## V3.5.2 Stabilization & Optimization Update V3.5.2 adds no new generation mode. It stabilizes the V3.5.x release, removes repeated Prompt/CLIP work when safe, and lowers temporary memory for long Video Guide inputs while preserving existing workflow and generation contracts. @@ -29,7 +35,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.5.2 is the current release.** V3.4 node IDs, backend socket keys, and saved-workflow loading remain intentionally supported. Sampling, Conditioning, Terminal Merge, Assembly, Seam, Run Storage, and standard ComfyUI seed behavior are unchanged. The withdrawn experimental Last Queued Seed override is not included. +> **V3.5.3 is the current maintenance release.** V3.5.2 remains the accepted Stabilization & Optimization baseline. V3.4 node IDs, backend socket keys, and saved-workflow loading remain intentionally supported. Sampling, Conditioning, Terminal Merge, Assembly, Seam, Run Storage, and standard ComfyUI seed behavior are unchanged. The withdrawn experimental Last Queued Seed override is not included. ## V3.5.1 Reference Audio & Compatibility Update @@ -601,7 +607,7 @@ Use a 24 fps source for `Video Guide Frames`. `Load Video (Upload)` may accept f ## Current validation status -The V3.5.2 release passes `485` automated tests, source/runtime registration verification, native PackedLayout, Fixed 3x5 prompt planning, JavaScript UI harnesses, release metadata consistency, Prompt/CLIP MISS-to-HIT output equality, and Video Guide bit-exact GPU A/B acceptance. Earlier representative GPU acceptance also covers the V3.5 Conditioning Bridge path, Reference Audio/Image retention, Second Pass/Hi-Res paths, and accepted 3x5 FL2VA Long Terminal Merge latents through Core Video/Audio VAE Decode and Assemble V3.5 Auto. +The V3.5.3 maintenance gate passes `495` automated tests, including all published-workflow link integrity and Hybrid public-picture warning regressions. Source/runtime registration verification, native PackedLayout, Fixed 3x5 prompt planning, JavaScript UI harnesses, release metadata consistency, Prompt/CLIP MISS-to-HIT output equality, and Video Guide bit-exact GPU A/B acceptance remain valid. Earlier representative GPU acceptance also covers the V3.5 Conditioning Bridge path, Reference Audio/Image retention, Second Pass/Hi-Res paths, and accepted 3x5 FL2VA Long Terminal Merge latents through Core Video/Audio VAE Decode and Assemble V3.5 Auto. V3.4 compatibility paths have been exercised locally with: diff --git a/README_JA.md b/README_JA.md index 8f28901..285bfed 100644 --- a/README_JA.md +++ b/README_JA.md @@ -1,7 +1,13 @@ -# ComfyUI-H3-Continuum 3.5.2 +# ComfyUI-H3-Continuum 3.5.3 MiniMax H3を複数チャンクで連続生成し、直前チャンク末尾の**映像latent / 音声latentを直接**次チャンクへ継承するComfyUIカスタムノードです。チャンク間でVideo/Audio VAEのDecode→Encodeは行いません。 +## V3.5.3 Maintenance Hotfix + +V3.5.3は配布整合性だけを修正するメンテナンス版です。公開Conditioning Bridge WorkflowのWidth/Height接続、V3.4/V3.5テンプレート内の孤立link ID、Hybridの``警告番号、厳密な画像decoderで読めなかった旧PNG 1件を修正しました。 + +生成動作、Node、socket、Sampling、Conditioning payload、Terminal Merge、Assembly、Seam、Run Storage、Prompt/CLIP cache、Video Guide最適化、V3.4互換性は変更していません。既存V3.5.x Workflowはそのまま読み込めます。 + ## V3.5.2 Stabilization & Optimization Update V3.5.2は新しい生成モードを追加する版ではありません。V3.5.xを安定化し、安全な条件で繰り返しPrompt/CLIP処理を省略し、長いVideo Guide入力の一時メモリを削減します。既存Workflowと生成契約は維持します。 @@ -29,7 +35,7 @@ Prompt/CLIPの数値はconditioning区間だけで、総生成時間ではあり RTX 5060 Ti 16 GB/RAM 64 GBの検証環境で測定したSage-only Production baselineは、576×576 T2VA 1×5秒が168.069秒、640×640 FL2VA Long Terminal Merge 3×5秒が379.765秒です。環境・設定固有の測定値であり、すべての環境に対する速度保証ではありません。Samplingが最大コストで、Continuum Assemble + Seamは1%未満でした。 -**V3.5.2が現在の正式版です。** V3.4 Node ID、backend socket key、保存済みWorkflow読込は維持します。Sampling、Conditioning、Terminal Merge、Assembly、Seam、Run Storage、ComfyUI標準Seed動作は変更していません。撤回済みの実験的Last Queued Seed overrideは含まれていません。 +**V3.5.3が現在のメンテナンス版です。** V3.5.2は受入済みStabilization & Optimization baselineとして維持します。V3.4 Node ID、backend socket key、保存済みWorkflow読込は維持します。Sampling、Conditioning、Terminal Merge、Assembly、Seam、Run Storage、ComfyUI標準Seed動作は変更していません。撤回済みの実験的Last Queued Seed overrideは含まれていません。 ## V3.5.1 Reference Audio/互換性更新 @@ -250,7 +256,7 @@ ZIPを展開して、`ComfyUI-H3-Continuum`フォルダーを`ComfyUI/custom_nod ## 検査 -V3.5.2正式版は全`485 passed`、source/runtime登録検証、PackedLayout、Fixed 3×5 Prompt Plan、JavaScript UI harness、release metadata、Prompt/CLIP MISS→HIT出力一致、Video Guide bit-exact GPU A/Bを通過しています。以前の代表GPU受入にはConditioning Bridge、Reference Audio/Image保持、Second Pass/Hi-Res経路、3×5秒FL2VA Long Terminal MergeからCore Video/Audio VAE Decode、Assemble V3.5 Autoまでを含みます。 +V3.5.3 maintenance gateは全`495 passed`で、全公開Workflowのlink整合性とHybrid公開Picture番号の警告回帰を含みます。source/runtime登録検証、PackedLayout、Fixed 3×5 Prompt Plan、JavaScript UI harness、release metadata、Prompt/CLIP MISS→HIT出力一致、Video Guide bit-exact GPU A/Bも引き続き有効です。以前の代表GPU受入にはConditioning Bridge、Reference Audio/Image保持、Second Pass/Hi-Res経路、3×5秒FL2VA Long Terminal MergeからCore Video/Audio VAE Decode、Assemble V3.5 Autoまでを含みます。 Main Hi-Res Fixの3×5秒2xは、RTX 5060 Ti 16 GiBで37T groupの1152×1152 Second Pass完了後、Terminal Mergeの77T group最初の推論時にCUDA OOMとなり未受入です。Reference/Hybrid固有の1×5秒Second Passは受入済みですが、長尺Reference/Hybridは未確認です。Disk-backedが保証する低メモリ範囲はContinuum Assemblyであり、Core Decodeや下流ノードが別の全量copyを作る可能性は残ります。 diff --git a/WORKLOG.md b/WORKLOG.md index d0f8ee1..e88b019 100644 --- a/WORKLOG.md +++ b/WORKLOG.md @@ -1,5 +1,17 @@ # Work Log +## 2026-08-26 - V3.5.3 distribution-integrity maintenance hotfix + +- Kept published V3.5.2 generation and optimization behavior frozen; no Sampling, Conditioning payload, Terminal Merge, Assembly, Seam, Run Storage, Prompt/CLIP cache, Video Guide, V3.4, node, or socket contract was changed. +- Created accepted source/runtime snapshots `pre-v353-maintenance-hotfix-source-accepted-20260826_030732` and `pre-v353-maintenance-hotfix-comfyui-w-accepted-20260826_030731` after the standard full snapshot stopped only on the known inaccessible `.pytest_cache`. +- Repaired Conditioning Bridge workflow links `349`/`350` from stale Sampler input slots `14`/`15` to Width/Height slots `16`/`17`; removed orphan output links `171`/`172`/`173` from the public V3.4, V3.4 Turbo, and V3.5 workflows. +- Replaced source-only Hybrid warning renumbering with the accepted absolute public `` behavior already present in ComfyUI_W. Added two regressions covering unavailable and missing Hybrid references. +- Added an eight-workflow serialization-integrity regression covering node/link uniqueness, endpoints, slot bounds, reciprocal input/output references, and types. The focused release/hotfix result is `30 passed`; canonical full pytest is `495 passed` with only the known `pynvml` FutureWarning. +- Regenerated the release Manifest with 173 entries, added the public-workflow integrity regression, and verified every recorded SHA-256. +- Losslessly re-encoded the unreferenced legacy `v31b-auto-resume.png`; strict Pillow verification passes all 19 packaged PNGs and an independent pixel comparison found zero changed pixels. +- Synchronized only `reference.py`, `version.py`, and `metadata.ini` to the primary ComfyUI_W runtime and verified exact source/runtime SHA-256 equality. Runtime verification reports V3.5.3, native PackedLayout PASS, Fixed 3x5 planning PASS, and complete node registration. The incomplete ComfyUI_WAN copy was intentionally not modified. +- No GPU generation was rerun because the only Python behavior change is report warning text and the remaining changes are package/workflow metadata. Commit and push were not performed. + ## 2026-08-26 - V3.5.2 README final audit and publication authorization - Re-audited English/Japanese README chapter order, historical/current-version wording, withdrawn controls, local links, image references, and validation claims before publication. diff --git a/docs/images/v31b-auto-resume.png b/docs/images/v31b-auto-resume.png index af5f9d2..22323ff 100644 Binary files a/docs/images/v31b-auto-resume.png and b/docs/images/v31b-auto-resume.png differ diff --git a/examples/workflows/MiniMax_H3_Continuum_V34.json b/examples/workflows/MiniMax_H3_Continuum_V34.json index 061c30f..df1682f 100644 --- a/examples/workflows/MiniMax_H3_Continuum_V34.json +++ b/examples/workflows/MiniMax_H3_Continuum_V34.json @@ -648,7 +648,6 @@ "name": "IMAGE", "type": "IMAGE", "links": [ - 171, 208 ] }, @@ -693,7 +692,6 @@ "name": "IMAGE", "type": "IMAGE", "links": [ - 172, 207 ] }, @@ -838,7 +836,6 @@ "name": "IMAGE", "type": "IMAGE", "links": [ - 173, 206 ] }, @@ -2401,4 +2398,4 @@ "VHS_KeepIntermediate": true }, "version": 0.4 -} \ No newline at end of file +} diff --git a/examples/workflows/MiniMax_H3_Continuum_V34_turbo.json b/examples/workflows/MiniMax_H3_Continuum_V34_turbo.json index 98c8210..4455f66 100644 --- a/examples/workflows/MiniMax_H3_Continuum_V34_turbo.json +++ b/examples/workflows/MiniMax_H3_Continuum_V34_turbo.json @@ -648,7 +648,6 @@ "name": "IMAGE", "type": "IMAGE", "links": [ - 171, 208 ] }, @@ -693,7 +692,6 @@ "name": "IMAGE", "type": "IMAGE", "links": [ - 172, 207 ] }, @@ -838,7 +836,6 @@ "name": "IMAGE", "type": "IMAGE", "links": [ - 173, 206 ] }, @@ -2436,4 +2433,4 @@ "VHS_KeepIntermediate": true }, "version": 0.4 -} \ No newline at end of file +} diff --git a/examples/workflows/MiniMax_H3_Continuum_V35.json b/examples/workflows/MiniMax_H3_Continuum_V35.json index 3eaaac1..9bd647a 100644 --- a/examples/workflows/MiniMax_H3_Continuum_V35.json +++ b/examples/workflows/MiniMax_H3_Continuum_V35.json @@ -1664,7 +1664,6 @@ "name": "IMAGE", "type": "IMAGE", "links": [ - 171, 315 ] }, @@ -1709,7 +1708,6 @@ "name": "IMAGE", "type": "IMAGE", "links": [ - 172, 316 ] }, @@ -1754,7 +1752,6 @@ "name": "IMAGE", "type": "IMAGE", "links": [ - 173, 317 ] }, @@ -3234,4 +3231,4 @@ ] }, "version": 0.4 -} \ No newline at end of file +} diff --git a/examples/workflows/MiniMax_H3_Continuum_V351_LBH_Conditioning_Bridge.json b/examples/workflows/MiniMax_H3_Continuum_V351_LBH_Conditioning_Bridge.json index 9d13cc1..8e181a8 100644 --- a/examples/workflows/MiniMax_H3_Continuum_V351_LBH_Conditioning_Bridge.json +++ b/examples/workflows/MiniMax_H3_Continuum_V351_LBH_Conditioning_Bridge.json @@ -2726,7 +2726,7 @@ 120, 0, 305, - 14, + 16, "INT" ], [ @@ -2734,7 +2734,7 @@ 120, 1, 305, - 15, + 17, "INT" ] ], diff --git a/metadata.ini b/metadata.ini index 3f21d1d..2ea7e1e 100644 --- a/metadata.ini +++ b/metadata.ini @@ -1,4 +1,4 @@ [project] name = H3 Continuum -version = 3.5.2 +version = 3.5.3 description = Native MiniMax H3 continuation with Second Pass, experimental Hi-Res Fix, and disk-backed assembly. diff --git a/pyproject.toml b/pyproject.toml index 5610cfd..bb2650d 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "comfyui-h3-continuum" -version = "3.5.2" +version = "3.5.3" description = "Integrated N-chunk continuation for ComfyUI native MiniMax H3 video and audio" readme = "README.md" requires-python = ">=3.10" diff --git a/reference.py b/reference.py index 48711eb..b7fcad0 100644 --- a/reference.py +++ b/reference.py @@ -236,20 +236,18 @@ def validate_reference_prompts( reference_count: int, picture_offset: int = 0, ) -> str: - if picture_offset > 0: - def _shift_picture_tag(match: re.Match[str]) -> str: - number = int(match.group(1)) - if number <= picture_offset: - return "" - return f"" - - shifted = [_PICTURE_TAG.sub(_shift_picture_tag, str(prompt)) for prompt in prompts] - return validate_reference_prompts(shifted, reference_count) - + reference_count = max(0, int(reference_count)) + picture_offset = max(0, int(picture_offset)) found: set[int] = set() for prompt in prompts: found.update(int(value) for value in _PICTURE_TAG.findall(str(prompt))) - invalid = sorted(value for value in found if value < 1 or value > reference_count) + + first_reference = picture_offset + 1 + last_reference = picture_offset + reference_count + found_references = { + value for value in found if first_reference <= value <= last_reference + } + invalid = sorted(value for value in found if value < 1 or value > last_reference) warnings: list[str] = [] if invalid: unavailable = ", ".join(f"" for value in invalid) @@ -260,12 +258,14 @@ def validate_reference_prompts( "unavailable reference may be ignored or hallucinated. Enable the " "corresponding Reference Image input or remove the unavailable tag." ) - missing = sorted(set(range(1, reference_count + 1)) - found) + + expected_references = set(range(first_reference, last_reference + 1)) + missing = sorted(expected_references - found_references) if missing: labels = ", ".join(f"" for value in missing) detail = ( "the prompt contains no tag" - if not found + if picture_offset == 0 and not found else f"connected reference {labels} is not explicitly mentioned in the prompt" ) warnings.append( diff --git a/tests/test_public_workflow_integrity.py b/tests/test_public_workflow_integrity.py new file mode 100644 index 0000000..e25f1d8 --- /dev/null +++ b/tests/test_public_workflow_integrity.py @@ -0,0 +1,61 @@ +from __future__ import annotations + +import json +from pathlib import Path + +import pytest + + +ROOT = Path(__file__).resolve().parents[1] +WORKFLOW_DIR = ROOT / "examples" / "workflows" +WORKFLOWS = sorted(WORKFLOW_DIR.glob("*.json")) + + +@pytest.mark.parametrize("workflow_path", WORKFLOWS, ids=lambda path: path.name) +def test_public_workflow_links_are_serialization_consistent(workflow_path: Path) -> None: + workflow = json.loads(workflow_path.read_text(encoding="utf-8")) + workflow = json.loads(json.dumps(workflow, ensure_ascii=False)) + nodes = {int(node["id"]): node for node in workflow["nodes"]} + links = {int(link[0]): link for link in workflow["links"]} + + assert len(nodes) == len(workflow["nodes"]), "duplicate node ID" + assert len(links) == len(workflow["links"]), "duplicate link ID" + + for link_id, link in links.items(): + _, source_id, source_slot, target_id, target_slot, link_type = link + source = nodes[int(source_id)] + target = nodes[int(target_id)] + outputs = source.get("outputs") or [] + inputs = target.get("inputs") or [] + + assert 0 <= int(source_slot) < len(outputs), f"link {link_id}: invalid source slot" + assert 0 <= int(target_slot) < len(inputs), f"link {link_id}: invalid target slot" + assert link_id in (outputs[int(source_slot)].get("links") or []), ( + f"link {link_id}: source output does not reference the link" + ) + assert inputs[int(target_slot)].get("link") == link_id, ( + f"link {link_id}: target input does not reference the link" + ) + + endpoint_types = { + value + for value in ( + outputs[int(source_slot)].get("type"), + inputs[int(target_slot)].get("type"), + link_type, + ) + if value not in (None, "*") + } + assert len(endpoint_types) <= 1, f"link {link_id}: endpoint type mismatch" + + for node in nodes.values(): + for output in node.get("outputs") or []: + for link_id in output.get("links") or []: + assert int(link_id) in links, f"node {node['id']}: dangling output link {link_id}" + for input_ in node.get("inputs") or []: + link_id = input_.get("link") + if link_id is not None: + assert int(link_id) in links, f"node {node['id']}: dangling input link {link_id}" + + if links: + assert int(workflow["last_link_id"]) >= max(links) diff --git a/tests/test_release_metadata.py b/tests/test_release_metadata.py index fb3fcbe..e8257fc 100644 --- a/tests/test_release_metadata.py +++ b/tests/test_release_metadata.py @@ -6,7 +6,7 @@ import tomllib ROOT = Path(__file__).resolve().parents[1] -EXPECTED_VERSION = "3.5.2" +EXPECTED_VERSION = "3.5.3" def test_v35_release_metadata_is_consistent(): diff --git a/tests/test_v217_stable_facade.py b/tests/test_v217_stable_facade.py index 12c71b5..9f3e65e 100644 --- a/tests/test_v217_stable_facade.py +++ b/tests/test_v217_stable_facade.py @@ -145,4 +145,4 @@ def test_v217_result_pack_expands_legacy_outputs(): def test_v217_has_no_frontend_display_controller(): assert not (ROOT / "web" / "h3_continuum_v2.js").exists() version_source = (ROOT / "version.py").read_text(encoding="utf-8") - assert 'PACKAGE_VERSION = "3.5.2"' in version_source + assert 'PACKAGE_VERSION = "3.5.3"' in version_source diff --git a/tests/test_v34_hybrid_reference.py b/tests/test_v34_hybrid_reference.py index 3b63dff..2fbd396 100644 --- a/tests/test_v34_hybrid_reference.py +++ b/tests/test_v34_hybrid_reference.py @@ -57,6 +57,27 @@ def test_hybrid_prompt_validation_offsets_reference_numbers() -> None: ) == "" +def test_hybrid_prompt_validation_keeps_public_picture_numbers_in_warnings() -> None: + warning = validate_reference_prompts( + [" starts the shot and is unavailable."], + 1, + picture_offset=2, + ) + assert "unavailable " in warning + assert "connected reference " in warning + assert "unavailable " not in warning + + +def test_hybrid_prompt_validation_reports_the_missing_reference_number() -> None: + warning = validate_reference_prompts( + [" starts the shot."], + 1, + picture_offset=2, + ) + assert "connected reference " in warning + assert "the prompt contains no tag" not in warning + + def test_pure_fl_identity_is_unchanged() -> None: assert combine_hybrid_visual_identity( keyframe_identity_hash="fl-identity", diff --git a/version.py b/version.py index e8732d3..207381b 100644 --- a/version.py +++ b/version.py @@ -1,6 +1,6 @@ """Package version and public schema identifiers.""" -PACKAGE_VERSION = "3.5.2" +PACKAGE_VERSION = "3.5.3" STATE_SCHEMA_VERSION = 1 PLAN_SCHEMA_VERSION = 1 PUBLIC_API_VERSION = 3