fix: preserve loader state and migrate audio/video workflow inputs

Refs #23. Keep Image Enable, delegate Core mode accessors, and remove widget-array mutation. Use Core Audio and Core Video with an Enable-free FPS adapter. Legacy loader IDs remain compatible. Focused CPU tests pass; Windows/browser acceptance remains pending.
This commit is contained in:
github-actions[bot]
2026-09-21 03:45:54 +00:00
parent 3d7c2fd692
commit f8eb40d8b4
27 changed files with 576 additions and 316 deletions
+3
View File
@@ -41,3 +41,6 @@ examples/workflows/*
!examples/workflows/MiniMax_H3_Continuum_V38X2.zip
!examples/workflows/MiniMax_H3_Continuum_V38X2+Decode_Cache_Helper.json
!examples/workflows/MiniMax_H3_Continuum_V38X2+Decode_Cache_Helper.zip
# Current loader migration instructions.
!docs/LOADER_PERSISTENCE_REPAIR.md
+6
View File
@@ -101,3 +101,9 @@ GPU checks must cover Sage only, Sage+Sol, Sage+Spectrum, and Sage+Sol+Spectrum
- Read this file before each task. Record durable project decisions, paths, commands, failure causes, and validation methods here so later work reuses them instead of restarting from zero.
- GitHub authentication for this repository is already configured. Do not request a new login or token unless an actual authentication command fails.
- Commit and push only when the user explicitly requests publication.
## User-approved loader migration (2026-09-21)
- 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.
+8
View File
@@ -1,5 +1,13 @@
# Changelog
## 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.
- Switch the two paired official V3.8X2 workflows to Core Load Audio and Core Load Video plus an Enable-free H3 Continuum Video Adapter using the existing FPS converter.
- Keep old Audio/Video IDs as deprecated compatibility nodes. Preserve other workflow nodes, settings and output contracts; regenerate matching ZIPs and integrity hashes.
- Add store-backed loader and converter regressions. Windows/browser acceptance remains a separate pending check; no Release/tag/Registry publication.
## 3.8.3 — V3.8X2 release preparation (2026-09-19)
- Vendor the previously standalone Decode Cache Helper implementation into Continuum as a separate `H3DecodeCacheHelper` public node. Preserve its node ID, inputs, outputs, list behavior, native Core Decode delegation, and process-local cache behavior.
+23 -19
View File
@@ -1,10 +1,10 @@
dca65fb1393e67f59c6f81f9411e3e745eb8f1097e9a2adf7ffc6f4e3901ca9f __init__.py
04900f7a7a89fc3c4f75dc4020c1e16ea353da2b24a959ae628e3f49ddae4ef3 .comfyignore
a9fd5a4c5624e17148656abed0ba41a72c72cac73e7f6f36d2816ad92962f867 .comfyignore
3d681ded5d4c50cc20c2382e29fdc98d8a48e76d552c41ad5a195d941e66e612 .gitattributes
8296f0afc7be47171e439c02fb2988cfeb0df904acbe3fc4f507f426d709157e .github/workflows/tests.yml
0a2f69d4cec89d440f5d5aa1ec68a7c9a741382d313f80dcddf96d13f70b3e68 .gitignore
3e7a1ec3380be2a222c8a3e9b8a6bb184d3a760478957f48186438f15235bdba branch_provenance.py
0daa15310d98160261e3ff1fe689cc7a6db9e453891cd73e2a392da643ab576a CHANGELOG.md
d70402478f19f6487eed08957a048a8c248a9291be8e62c0e7ade69da82fd393 CHANGELOG.md
c1ed3a0342730450958fb62fd21854a876991f3a4aefb24e5383b0c73cd2312d compatibility.py
4d62508f900af9f93ec320afb900c27cc9a300d1e0c0a94714258498c5ede5fc conditioning.py
294251c40b1be2e296c5e5f627b68091d087bdb39179e3a0c3cebd2ee8a344f5 constants.py
@@ -94,10 +94,10 @@ b8275c8cecde12aee0418cea456d1e7f4b875cbb1bce32f1f3d9e06a44dd0be1 examples/v2_pr
0e59ea821081cb93165aa3f88c6949736dd225837fe1cdcf1173aa5cd54c6d29 examples/v2_prompt_timeline_example.txt
26bbca92b5f7cac4cbde89290b3f801b7a895df76a07493ca6f65c18d5b1154a examples/workflows/MiniMax_H3_Continuum_V38x.json
df4e0e355020d2e731932cff86a4b00932b4f193ec7ed513be0db994ec0e71bb examples/workflows/MiniMax_H3_Continuum_V38x.zip
6c445d62979632bc1a801b1c28dbd639c23b51cc156ebae18837baaa757e592b examples/workflows/MiniMax_H3_Continuum_V38X2.json
29e8ea19cf7c7e8a8a5e98577905d8fd01fc800bb8edb4f4218a638fe39e69d0 examples/workflows/MiniMax_H3_Continuum_V38X2.zip
6c445d62979632bc1a801b1c28dbd639c23b51cc156ebae18837baaa757e592b examples/workflows/MiniMax_H3_Continuum_V38X2+Decode_Cache_Helper.json
f770bcc7de63851ab32f8d8fea23e5df9f7c44b8e3c0115a555b57ea82a28550 examples/workflows/MiniMax_H3_Continuum_V38X2+Decode_Cache_Helper.zip
1b2212b7511fac0b63dfa6e9f006cd8644c72d08c6945ab0e4ed0e722c97a730 examples/workflows/MiniMax_H3_Continuum_V38X2.json
8f839a955859bffa0d9cf0b15e91ee484dd911aca5ae31f1787debd56afdc7da examples/workflows/MiniMax_H3_Continuum_V38X2.zip
1b2212b7511fac0b63dfa6e9f006cd8644c72d08c6945ab0e4ed0e722c97a730 examples/workflows/MiniMax_H3_Continuum_V38X2+Decode_Cache_Helper.json
4fa8680037595f55f97715f9a2f63d28f11328a87f5c33c316cc4b0ae817e668 examples/workflows/MiniMax_H3_Continuum_V38X2+Decode_Cache_Helper.zip
7861fac4c8fe82372c5459aa574d35ea003bdb4fd846d567bd891c2e38571b3d graph_contract.py
bf0556b076dbaca67c3405a7d86c333ca7fdf3d4381529b0a9edc906519943e9 guide_timeline.py
6e889c42490ccb5f376694b5944c693a84e7febedf38e631d687e96bc1e76376 H3-Continuum-LLM-System-Prompt-v1.zip
@@ -112,18 +112,18 @@ d3e213005670e94dee33a240349a4d245cf9a3b6602099f11ed30cf5a32e2c21 media.py
1970342c93f0189ade437cbfc278900713f043882933789cb8c54f35cf2ec96b metadata.ini
fd23c7f32810788aaaf1709c4959c40ec72303aecc6f6afa5fa68d824cca97a8 minimax-h3-continuum-dance-director.zip
2d611f7201889851eac6459f8aa2b37baf342b345241979ca6042b61b252dff9 model_patch.py
11ea3942e460d8b4ec729611371b52ec5ad202c894c5e9ec7b151b906559bfd8 nodes.py
e2b72149b0433e95c13659cc9e742fe38523e67d4f4a2fdb08aed1943fecf653 nodes.py
2b8c19f9474beabfebe1802cdf4a89780dce3c351c48d65e1ce8bb77d2fb9ba9 PACKAGE_INFO_JA.txt
4852ad216f85c22f008abe18464eab2c913bd88baa7db35764df2de9cf401d6d PACKAGE_VALIDATION.txt
b470819f16fc179654dc1600721a63f0a5a14e777f4c004d574b499da6886ba5 public_api.py
15a3925218e0c5f968795d7d11e4783c3c6868917447274bc700328851b3fbfb pyproject.toml
94fdc2d545b2d4077a4d70229fd22ba3ccac21d49d1097d2873f76d04e9a3c7a pytest.ini
8f06f56597185fcb24331b038b20e921c02557da42f5ef5ba79fb7e768766974 README_JA.md
4e44ff1e28f2f408c41631eb76922bfbe31147bb6d36846a1b73e05279f5dda3 README.md
4a0507ce6183e099265d5a34a38e43da89515af8eb680f5a48abc8aecc724d63 README_JA.md
9d4eefcc97e74d4c1c8ab1be612b50eb99a8a4f8db7c2134ca85a9e67bf2568a README.md
44127adcfa30ee84bff9cd4b2d0c695355209550e76982d374122008728aa5bc reference_audio.py
5cb9bfd6810d3a93a637451980a4cc5c1436e5b84cfd1c7a111cd192e876351b reference_video.py
c7b14ed6f8cfc2a1f0a21db4fe56fba75a93ffcb0be0c22bbd2e691c45cd0e2d reference.py
6f4e873fd1b25141b0d0b4bd2bbb83dca1591d753609c7f0ccbb2106828ef3bf REGISTRY_MANIFEST.sha256
e7b767eeda996529035f2615c846349983ce18b46269b6511e5ddfa0c299eb25 REGISTRY_MANIFEST.sha256
467edb2c188d024c2392aafe7423b3f835e16b10f570da76e2f7dda8a962c1c5 requirements.txt
8bfa113a2ec11325619be300b4d2b53a157b1d2c1ef7855057a4b3bbd05aeef3 run_storage.py
6056de6c0a5322a8a51ba5a114538dca2ef67788cd1afba10fedd483b95f6afa state_io.py
@@ -145,9 +145,9 @@ fe23752312d62ddc8c23a3c598ed2f92f2d46e2e4460f06aea91921659092451 tests/test_aud
041289556cc621ea1857cbb8931ae41d817f69e084b2e8a7622e184a3197b61b tests/test_compatibility.py
875ac33b5458ec5e8d845850ed495707c394436aaadb668a44f36f6a1b73764d tests/test_conditioning_modes.py
2be669b6d21ec40a8b0e172b8ab431f82681f3c97c7de0935d87ad43b0ae8b4e tests/test_context_diagnostics.py
61484ca0552e8341301a481a87e12e44279dbeed68d4b841f4301a4f87ce4a29 tests/test_easy_load_audio.py
4405c94cf190534fdabf5af3fd2ae9cc7cd1b2af6eb8b0d4ab73327cbcd455b9 tests/test_easy_load_image.py
8ba1b07a4d2cdb21aba16a6c05791ec3e35ec7f4f3651e6de5e961be464b7074 tests/test_easy_load_video.py
0b06a5af3420a7157eebcca369521c8146ad546e54f85719b49562555f8f17fb tests/test_easy_load_audio.py
7a46da28616cc9fc355ae9b6a9753dadb3201932d759c086df7513ea790f3f6d tests/test_easy_load_image.py
bfcfd77e70711830d087878d78021b754cd7e1ea324d50af0caa72f041b298fc tests/test_easy_load_video.py
326a97499ffe51935dd3259dbab4ed71fb02955cd3ddb5a52b5c6558a7efc872 tests/test_gpu_diagnostic_runner.py
4926706cb171e4e36e8d7ed46b592b0ed6c9c2e100072feeba497b651e52653b tests/test_issue13_r2_tools.py
aaed0385281e1782edc96f1d084fa84bc4e7ec9e0055ec35aaf9a9f8b6e5bfce tests/test_issue13_r25_tools.py
@@ -231,8 +231,8 @@ bb5a1530c890d357dc48ea74039340d746e876e8f85e06d4d9a19369f8ff5961 tests/test_v38
4338c932fc8a00328c3145b276e0f58a783c721a683b43aa6c24337b05a878ab tests/test_v38_multi_reference_audio.py
623d528a02b6712cba28c374ba3ad979bc84e2ac5318640692589a04ba6ab15f tests/test_v38_open_integration_contract.py
12337a491fa67b38b32aaeb16e0b209393960dbc46db2a8bf968b8c3902855ef tests/test_v38_packed_row_planner.py
8968588b0a999c6443f60da999be99db59ca3b6cf321bfc45c0a5b754d3ee954 tests/test_v38_public_surface_cleanup.py
ac59e1c021dd2b4e617fd87eb5de3e199d31136884754556ba46e6a1a0c5e03d tests/test_v38_public_workflow.py
abece11f7efa1f09a4ba4ab729708f460277128ac590c1e16485dd601b1c499c 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
@@ -322,10 +322,10 @@ b3dc61503d35d9ef0a0dc7fed1c9b2fdc00fcb2072d4e39f64ae0826f9ec7dca v3/assembly_v3
7815230e0a9540bc2edeaf818e940b7a1fdd817fd217ba8a4f9cb21aaf6a308e v3/assembly.py
3f62fdb35e804f42d7cbf0828b4e87e69a2b99246c3f7467fe4fa698f1d803c9 v3/conditioning_bridge_nodes.py
aa044669259df440a384b5e839f75fa9665790da0c210a427375fdd5c76af779 v3/driving_nodes.py
2f395da6a41981713f99ba40b73d14f2274b8ca34a73cf2b275a444993765b99 v3/easy_audio_nodes.py
147a1d3fc5e09b323a4c3d13d30e432410389bae52b58330462375b9f307b791 v3/easy_audio_nodes.py
64b3e54b42e5156642f9957ccc374fd190d9fc7145637984e702534fb1bf80b4 v3/easy_image_nodes.py
ac859cb1a6e23b8ceae300d818c24fe1346b649a0d663017a9b3ac64aa96fca3 v3/easy_nodes.py
bf6bae0c9e14883728860470af86e14395dba40a7377cd874d4dc4548ae53c65 v3/easy_video_nodes.py
11e9daa45237392ac84ac1b54b3e8d5e980e77102779831824794a2a6675500b v3/easy_video_nodes.py
fe03ae0aa0dbbbe5f950bb7da34c18a078d841547992c374ea8beda5e3ad4715 v3/execution_planner.py
6cc7ed74666084c55beb9075304e92a9defafd81b9c6678239ca3859a08cddd7 v3/file_backed_buffer.py
cb53e1b104415032ec79b7e7aa1c99848e63da3eedaa251eeba102970e4172b5 v3/hires_fix_nodes.py
@@ -360,11 +360,15 @@ d0a004aa3030c8adaa5ea788f9acc758fcb4a556f203f9a3f63fa4e4b5772063 v3/sampling_en
2f07ace1462644f0bee553827b3571535de4d0c2d9ef847bd9e0ca73a4eed5cb v3/video_seam.py
453c98485ec55cca959aa5863ac35ae3b86c4781ae95c9e52ac9f1d9115c9eed version.py
685df8e0fa23e3663ab31da1e4470cd19bdaa0dc16362cb606e874d9d6153c2c web/decode_cache_helper.js
c2883272b05a9a9146b5c6cf614ddae8a3e6893cd910902023aae61360195289 web/easy_bypass_toggle.js
fefafd4550511d80bd85ade46a0476f0cf3de13ddb94a908dff6b175f2a0e199 web/easy_bypass_toggle.js
092088096307d33ac016b82b4774ca38845a2ff2f63b97ac6da8c5aca4fea413 web/easy_load_audio.js
9db0aa94f634578a962d5db49e5c70356040a59df968e3a2e531b327a623081f web/easy_load_image.js
873efcbd15c2d9fa10c9d5fc51a796ad3a18c0c6acceecf499c4b956aa845c6c web/easy_load_video.js
35090816ba7470a7255eb85d003b7e79f8a0065982dacf98a18f41c8ebff655d web/easy_load_video.js
0c68d13a1f8beb7431a32b471f8b0612c42fcc4bf72dd97611a025d158008662 web/easy_v38.js
ec591d1b8f7587594397b995b9584809435f10fa3de6bf8f8df204c34809aa43 web/project_id.js
ecdcd27528f6f1e80f758c608cbc42f747163ea4c39abd77576b91c627423d12 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
9876c21624aad1a9fd5b31408e7484995bb42b94c697bb8e26206cbd698b4779 docs/LOADER_PERSISTENCE_REPAIR.md
+7
View File
@@ -1,5 +1,12 @@
# Project State
## Loader persistence repair (2026-09-21)
- User approved Image Enable repair, Core Audio workflow replacement, and Core Video plus Enable-free 24fps adapter, including commit/push. Legacy Audio/Video IDs remain deprecated/loadable. Main Sampler, Sampling and stored generation contracts are unchanged.
- Source baseline 3d7c2fd6928a545b12b84968b09dc455e7f9da65. Real source was snapshotted using tools/snapshot.ps1 before edits on an isolated Actions runner. Original-code regression exposed 3 failures; focused CPU/Node suite 46 PASS. See docs/LOADER_PERSISTENCE_REPAIR.md.
- Windows worktree/runtime/browser and GPU were not accessed. Live frontend 1.53.6 tab switching/save/reopen and fixed H3情報チェック handoff remain PENDING. No Release/tag/Registry publication.
## Issue #20 workflow persistence hotfix (2026-09-10)
- User authorized repair and publication to main from pinned 6b453fe. The only runtime change is `serialize: false` on the read-only Render History widget in `web/project_id.js`; existing `options.serialize: false` is retained. Backend widget order, Sampling, Audio, Run Storage, public workflow/ZIP bytes, and Easy Loader Bypass behavior are unchanged.
+16 -4
View File
@@ -1,4 +1,15 @@
# ComfyUI-H3-Continuum 3.8.3 — V3.8X2
## 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.
**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.
After updating, restart ComfyUI and reload/refresh the frontend. A workflow that already omitted its filename or saved an incorrect mode cannot recover those missing values: reselect the intended file and Bypass state, then save once. Existing user workflows and saved Takes are not automatically rewritten. Changing upstream node types can legitimately create a new Run Storage revision; preserve the original workflow when resuming accepted runs.
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).
<img width="1536" height="1024" alt="exec-9cfa73b4-c1d3-4416-8950-fa661b946638_2" src="https://github.com/user-attachments/assets/8df15764-6db6-4d4c-9eb5-0d2c7b0668f0" />
@@ -39,7 +50,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 nine public node IDs are the seven V3.8X IDs plus Reference Images and this helper. 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 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.
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.
@@ -108,13 +119,14 @@ AI products, plans, and repository-reading behavior change frequently. If a URL
## V3.8 supported surface
This local package exposes nine searchable nodes: the original seven V3.8 nodes plus Decode Cache Helper and Reference Images.
The package registers ten node IDs, including two deprecated loader compatibility IDs. Current workflows use Core Load Audio and Core Load Video plus the Video Adapter.
- **H3 Continuum Sampler V3.8** — the Main sampler
- **H3 Continuum Finalize** — decoded Video/Audio assembly with optional seam handling
- **H3 Continuum Load Image**
- **H3 Continuum Load Audio**
- **H3 Continuum Load Video**
- **H3 Continuum Load Audio** (legacy compatibility; new workflows use Core Load Audio)
- **H3 Continuum Load Video** (legacy compatibility; new workflows use Core Load Video + Video Adapter)
- **H3 Continuum Video Adapter** — Core VIDEO to H3 IMAGE/AUDIO, default 24fps, no Enable
- **H3 Continuum Second Pass** — the Advanced bridge for external latent processing or upscaling
- **H3 Continuum Reference Audios** — an ordered Reference Audio 1/2/3 bundle helper
- **H3 Continuum Reference Images** — optional additional Reference Images 4–9
+11
View File
@@ -1,5 +1,16 @@
# ComfyUI-H3-Continuum 3.8.3 — V3.8X2
## mainのLoader保存・復元修正(2026-09-21、3.8.3以降)
現行V3.8X2ワークフローは、音声を **Core Load Audio**、動画を **Core Load Video → H3 Continuum Video Adapter** に変更しました。Video Adapterは24fpsへの変換(Force Rate初期値24)とIMAGE/AUDIO出力だけを担当し、**Enableやファイル選択UIはありません**。動画を使わない場合はAdapter、または動画入力グループ全体をBypassしてください。Load VideoだけをBypassして必須入力のAdapterをONに残す構成は避けてください。
画像は **H3 Continuum Load ImageとEnable Imageを維持**します。Issue #23の継承されたmode setterへの委譲と、描画・保存中のwidget配列差し替え廃止を適用します。EnableはCoreの欄の後ろに配置し、画像ファイルとBypassの保存はCoreに委ねます。旧Audio/VideoノードIDは既存workflow用の非推奨互換ノードとして残します。登録IDは互換用2個を含め10個で、Sampler設定・Sampling・Decode Cache・Finalize・既存Run Storage契約は変更しません。
更新後はComfyUI再起動と画面の再読み込みが必要です。既に保存JSONから消えたファイル名やOFF状態は推測で復元できないため、一度選び直して保存してください。既存ユーザーworkflowや保存済みTakeは自動変更しません。上流ノードの種類変更でRun Storageが新revisionになることはあるため、過去Runの再開には元workflowを保管してください。
検証範囲は[Loader修正記録](docs/LOADER_PERSISTENCE_REPAIR.md)を参照してください。CPU回帰テストと実ブラウザ確認は別です。Windows Core 0.36.0 / frontend 1.53.6のタブ切替確認は未実施で、Release/tag・Registry公開も別作業です。以下の旧Loader画像は互換ノードの説明です。
> **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)から導入できます。
## V3.8X2 公式Workflow
+15 -13
View File
@@ -1,7 +1,7 @@
dca65fb1393e67f59c6f81f9411e3e745eb8f1097e9a2adf7ffc6f4e3901ca9f __init__.py
04900f7a7a89fc3c4f75dc4020c1e16ea353da2b24a959ae628e3f49ddae4ef3 .comfyignore
a9fd5a4c5624e17148656abed0ba41a72c72cac73e7f6f36d2816ad92962f867 .comfyignore
3e7a1ec3380be2a222c8a3e9b8a6bb184d3a760478957f48186438f15235bdba branch_provenance.py
0daa15310d98160261e3ff1fe689cc7a6db9e453891cd73e2a392da643ab576a CHANGELOG.md
d70402478f19f6487eed08957a048a8c248a9291be8e62c0e7ade69da82fd393 CHANGELOG.md
c1ed3a0342730450958fb62fd21854a876991f3a4aefb24e5383b0c73cd2312d compatibility.py
4d62508f900af9f93ec320afb900c27cc9a300d1e0c0a94714258498c5ede5fc conditioning.py
294251c40b1be2e296c5e5f627b68091d087bdb39179e3a0c3cebd2ee8a344f5 constants.py
@@ -15,10 +15,10 @@ b30fe4640359bebfcdeeb94dbeec94cb346c8e3646509e1dcdb87d7021ba04ff docs/N2B_BRANC
717577efdec5e61600504b77bc2a099ef022c4fe2333e936c3310c7182d8f2a0 docs/V38_OPEN_INTEGRATION_CONTRACT.md
b08159178c999c4c97df6aed67c6cf48b5032548a1d370dc4a0cf7e293ab8031 docs/V38_RELEASE_AND_MIGRATION.md
cedd7b07901d6065079ef37380f0062d535a39c98c8f614e1b26582f549d7183 driving_audio.py
6c445d62979632bc1a801b1c28dbd639c23b51cc156ebae18837baaa757e592b examples/workflows/MiniMax_H3_Continuum_V38X2.json
29e8ea19cf7c7e8a8a5e98577905d8fd01fc800bb8edb4f4218a638fe39e69d0 examples/workflows/MiniMax_H3_Continuum_V38X2.zip
6c445d62979632bc1a801b1c28dbd639c23b51cc156ebae18837baaa757e592b examples/workflows/MiniMax_H3_Continuum_V38X2+Decode_Cache_Helper.json
f770bcc7de63851ab32f8d8fea23e5df9f7c44b8e3c0115a555b57ea82a28550 examples/workflows/MiniMax_H3_Continuum_V38X2+Decode_Cache_Helper.zip
1b2212b7511fac0b63dfa6e9f006cd8644c72d08c6945ab0e4ed0e722c97a730 examples/workflows/MiniMax_H3_Continuum_V38X2.json
8f839a955859bffa0d9cf0b15e91ee484dd911aca5ae31f1787debd56afdc7da examples/workflows/MiniMax_H3_Continuum_V38X2.zip
1b2212b7511fac0b63dfa6e9f006cd8644c72d08c6945ab0e4ed0e722c97a730 examples/workflows/MiniMax_H3_Continuum_V38X2+Decode_Cache_Helper.json
4fa8680037595f55f97715f9a2f63d28f11328a87f5c33c316cc4b0ae817e668 examples/workflows/MiniMax_H3_Continuum_V38X2+Decode_Cache_Helper.zip
7861fac4c8fe82372c5459aa574d35ea003bdb4fd846d567bd891c2e38571b3d graph_contract.py
bf0556b076dbaca67c3405a7d86c333ca7fdf3d4381529b0a9edc906519943e9 guide_timeline.py
1473c384082700f422f2cf9141e0d012d87d2b43ac8a8a433edc7172e6ca7bf6 hardening.py
@@ -30,13 +30,13 @@ c44abbd789091bbead01250dbd5453e60539d2665c69f162335fdbd2936019c2 LICENSE
d3e213005670e94dee33a240349a4d245cf9a3b6602099f11ed30cf5a32e2c21 media.py
1970342c93f0189ade437cbfc278900713f043882933789cb8c54f35cf2ec96b metadata.ini
2d611f7201889851eac6459f8aa2b37baf342b345241979ca6042b61b252dff9 model_patch.py
11ea3942e460d8b4ec729611371b52ec5ad202c894c5e9ec7b151b906559bfd8 nodes.py
e2b72149b0433e95c13659cc9e742fe38523e67d4f4a2fdb08aed1943fecf653 nodes.py
2b8c19f9474beabfebe1802cdf4a89780dce3c351c48d65e1ce8bb77d2fb9ba9 PACKAGE_INFO_JA.txt
4852ad216f85c22f008abe18464eab2c913bd88baa7db35764df2de9cf401d6d PACKAGE_VALIDATION.txt
b470819f16fc179654dc1600721a63f0a5a14e777f4c004d574b499da6886ba5 public_api.py
15a3925218e0c5f968795d7d11e4783c3c6868917447274bc700328851b3fbfb pyproject.toml
8f06f56597185fcb24331b038b20e921c02557da42f5ef5ba79fb7e768766974 README_JA.md
4e44ff1e28f2f408c41631eb76922bfbe31147bb6d36846a1b73e05279f5dda3 README.md
4a0507ce6183e099265d5a34a38e43da89515af8eb680f5a48abc8aecc724d63 README_JA.md
9d4eefcc97e74d4c1c8ab1be612b50eb99a8a4f8db7c2134ca85a9e67bf2568a README.md
44127adcfa30ee84bff9cd4b2d0c695355209550e76982d374122008728aa5bc reference_audio.py
5cb9bfd6810d3a93a637451980a4cc5c1436e5b84cfd1c7a111cd192e876351b reference_video.py
c7b14ed6f8cfc2a1f0a21db4fe56fba75a93ffcb0be0c22bbd2e691c45cd0e2d reference.py
@@ -71,10 +71,10 @@ b3dc61503d35d9ef0a0dc7fed1c9b2fdc00fcb2072d4e39f64ae0826f9ec7dca v3/assembly_v3
7815230e0a9540bc2edeaf818e940b7a1fdd817fd217ba8a4f9cb21aaf6a308e v3/assembly.py
3f62fdb35e804f42d7cbf0828b4e87e69a2b99246c3f7467fe4fa698f1d803c9 v3/conditioning_bridge_nodes.py
aa044669259df440a384b5e839f75fa9665790da0c210a427375fdd5c76af779 v3/driving_nodes.py
2f395da6a41981713f99ba40b73d14f2274b8ca34a73cf2b275a444993765b99 v3/easy_audio_nodes.py
147a1d3fc5e09b323a4c3d13d30e432410389bae52b58330462375b9f307b791 v3/easy_audio_nodes.py
64b3e54b42e5156642f9957ccc374fd190d9fc7145637984e702534fb1bf80b4 v3/easy_image_nodes.py
ac859cb1a6e23b8ceae300d818c24fe1346b649a0d663017a9b3ac64aa96fca3 v3/easy_nodes.py
bf6bae0c9e14883728860470af86e14395dba40a7377cd874d4dc4548ae53c65 v3/easy_video_nodes.py
11e9daa45237392ac84ac1b54b3e8d5e980e77102779831824794a2a6675500b v3/easy_video_nodes.py
fe03ae0aa0dbbbe5f950bb7da34c18a078d841547992c374ea8beda5e3ad4715 v3/execution_planner.py
6cc7ed74666084c55beb9075304e92a9defafd81b9c6678239ca3859a08cddd7 v3/file_backed_buffer.py
cb53e1b104415032ec79b7e7aa1c99848e63da3eedaa251eeba102970e4172b5 v3/hires_fix_nodes.py
@@ -109,11 +109,13 @@ d0a004aa3030c8adaa5ea788f9acc758fcb4a556f203f9a3f63fa4e4b5772063 v3/sampling_en
2f07ace1462644f0bee553827b3571535de4d0c2d9ef847bd9e0ca73a4eed5cb v3/video_seam.py
453c98485ec55cca959aa5863ac35ae3b86c4781ae95c9e52ac9f1d9115c9eed version.py
685df8e0fa23e3663ab31da1e4470cd19bdaa0dc16362cb606e874d9d6153c2c web/decode_cache_helper.js
c2883272b05a9a9146b5c6cf614ddae8a3e6893cd910902023aae61360195289 web/easy_bypass_toggle.js
fefafd4550511d80bd85ade46a0476f0cf3de13ddb94a908dff6b175f2a0e199 web/easy_bypass_toggle.js
092088096307d33ac016b82b4774ca38845a2ff2f63b97ac6da8c5aca4fea413 web/easy_load_audio.js
9db0aa94f634578a962d5db49e5c70356040a59df968e3a2e531b327a623081f web/easy_load_image.js
873efcbd15c2d9fa10c9d5fc51a796ad3a18c0c6acceecf499c4b956aa845c6c web/easy_load_video.js
35090816ba7470a7255eb85d003b7e79f8a0065982dacf98a18f41c8ebff655d web/easy_load_video.js
0c68d13a1f8beb7431a32b471f8b0612c42fcc4bf72dd97611a025d158008662 web/easy_v38.js
ec591d1b8f7587594397b995b9584809435f10fa3de6bf8f8df204c34809aa43 web/project_id.js
ecdcd27528f6f1e80f758c608cbc42f747163ea4c39abd77576b91c627423d12 web/reference_audio_ui.js
46c9f75c9462bf26300332448f4431cca801f38964ca0a49bc2c50a88a7cc40f web/reference_image_ui.js
26b13614ba0a5fd8b192a106c9503b2f4b6fe7f9268a0fcb0f544979a49cab34 v3/video_adapter_nodes.py
9876c21624aad1a9fd5b31408e7484995bb42b94c697bb8e26206cbd698b4779 docs/LOADER_PERSISTENCE_REPAIR.md
+14
View File
@@ -1853,3 +1853,17 @@ D:\Codex\_snapshots\ComfyUI-H3-Continuum\pre-rollback-after-00038-fail-20260821_
- Updated repository-root `H3-Continuum-Skill-v1.zip` without changing runtime code or workflows. Promoted the standalone Timeline-header rule into `SKILL.md`, refreshed `references/continuum-contract.md` to the current V3.8 parser baseline `bd12073c4322a88ce666fe062b7bb265f5de131a`, added simple `3x5`, `3x10`, and `2x15` Timeline examples plus inline-input normalization to `references/examples.md`, and added the same critical syntax note to `README_JA.md`.
- Validation: `tools/snapshot.ps1` completed before modification; ZIP retained exactly seven entries and passed ZIP integrity validation; targeted `tests/test_v2_prompts.py` passed 52/52. New ZIP SHA-256: `144324850D4BA086938DA5F4ED7B02FF0668DEC554F092695328240E43FEC3EC`. This is documentation/prompt-skill only; Sampling, Run Storage, public node schema, workflows, and runtime tensors are unchanged. H3情報チェック handoff remains pending because that cross-task destination is unavailable from this GitHub Actions job.
## Loader persistence repair (2026-09-21)
- User approved Image Enable repair, Core Audio workflow replacement, and Core Video plus Enable-free 24fps adapter, including commit/push. Legacy Audio/Video IDs remain deprecated/loadable. Main Sampler, Sampling and stored generation contracts are unchanged.
- Source baseline 3d7c2fd6928a545b12b84968b09dc455e7f9da65. Real source was snapshotted using tools/snapshot.ps1 before edits on an isolated Actions runner. Original-code regression exposed 3 failures; focused CPU/Node suite 46 PASS. See docs/LOADER_PERSISTENCE_REPAIR.md.
- Windows worktree/runtime/browser and GPU were not accessed. Live frontend 1.53.6 tab switching/save/reopen and fixed H3情報チェック handoff remain PENDING. No Release/tag/Registry publication.
## Validation result
- Original-code regression: 6 cases; 3 expected failures and 0 collection/runtime errors.
- Focused CPU/Node suite: 46 passed, zero failures/errors/skips.
- JavaScript module syntax, changed Python compilation, workflow JSON/ZIP parity, endpoint consistency and git diff whitespace checks passed.
- Official workflow structural guard preserved every non-loader node, each original link, and non-layout workflow metadata.
- Scope: isolated GitHub Actions CPU runner, not Windows deployment or a real-browser/GPU test.
+21
View File
@@ -0,0 +1,21 @@
# Loader persistence repair — 2026-09-21
Base: `3d7c2fd6928a545b12b84968b09dc455e7f9da65`.
Image keeps its Core-backed implementation and Enable convenience toggle. The mode descriptor lookup walks the prototype chain; a tracked Core accessor is called rather than shadowed by a detached closure. Draw/serialize/configure functions and widget collections are not replaced. The former drawing swap could truncate a stable Core widget view, separately from Issue #23's mode-store divergence. New regression models both failures.
The current paired official V3.8X2 workflows replace H3EasyLoadAudio with Core LoadAudio and H3ContinuumLoadVideo with Core LoadVideo + H3ContinuumVideoAdapter. Core titles, original media names, disabled input branches, video 24fps setting, and all unrelated node values and original links are preserved. Video/audio outputs remain wired through the old output node ID. Core LoadVideo and the converter are kept in the video input group. Disable the converter or entire group, not only the Core input while its adapter remains active.
Legacy H3EasyLoadAudio/H3ContinuumLoadVideo remain registered/deprecated. Their old backend input contracts remain intact. The new converter has no Enable, file selector, upload handler or custom JavaScript. It uses the established _resample_video_frames() and passes existing audio through without resampling. Source rate 24 is a frame-object no-op; 30/29.97 to 24 uses the existing duration-preserving selection. This does not claim VFR timestamp-aware conversion or motion interpolation.
No user Windows worktree, installed runtime, GPU, queue, saved workflow, Run Storage or Takes were accessed. A Core 0.36.0/frontend 1.53.6 live-browser save/reopen, A->B->A, direct/right-click Bypass and upload check remains pending. The fixed H3情報チェック handoff is PENDING: cross-task transport is unavailable in this session. No Release/tag or Registry publication.
Files already saved without their selection/OFF state require one explicit user reselection; never reconstruct them from defaults. Upstream graph replacement may correctly create a new Run Storage revision, so retain an old workflow for resuming its saved run.
## Validation result
- Original-code regression: 6 cases; 3 expected failures and 0 collection/runtime errors.
- Focused CPU/Node suite: 46 passed, zero failures/errors/skips.
- JavaScript module syntax, changed Python compilation, workflow JSON/ZIP parity, endpoint consistency and git diff whitespace checks passed.
- Official workflow structural guard preserved every non-loader node, each original link, and non-layout workflow metadata.
- Scope: isolated GitHub Actions CPU runner, not Windows deployment or a real-browser/GPU test.
@@ -1,8 +1,8 @@
{
"id": "735ad332-ca97-474f-b53f-7c44f6b6c383",
"revision": 0,
"last_node_id": 354,
"last_link_id": 398,
"last_node_id": 355,
"last_link_id": 399,
"nodes": [
{
"id": 142,
@@ -81,7 +81,7 @@
},
{
"id": 315,
"type": "H3EasyLoadAudio",
"type": "LoadAudio",
"pos": [
990,
2360
@@ -104,18 +104,15 @@
}
],
"properties": {
"aux_id": "ukr8b3g-cmyk/ComfyUI-H3-Continuum",
"Node name for S&R": "H3EasyLoadAudio",
"ver": "ddaedfd401b171651b48059285a44897e84fce70"
"cnr_id": "comfy-core",
"Node name for S&R": "LoadAudio",
"ver": "0.30.0"
},
"widgets_values": [
"prnas_.mp3",
null,
null
"prnas_.mp3"
],
"widgets_values_named": {
"audio": "prnas_.mp3",
"upload": null
"audio": "prnas_.mp3"
},
"color": "#232",
"bgcolor": "#353"
@@ -174,19 +171,25 @@
},
{
"id": 320,
"type": "H3ContinuumLoadVideo",
"type": "H3ContinuumVideoAdapter",
"pos": [
440,
2350
2590
],
"size": [
480,
630
480.0,
115
],
"flags": {},
"order": 3,
"mode": 4,
"inputs": [],
"inputs": [
{
"name": "video",
"type": "VIDEO",
"link": 399
}
],
"outputs": [
{
"name": "images",
@@ -204,21 +207,13 @@
}
],
"properties": {
"aux_id": "ukr8b3g-cmyk/ComfyUI-H3-Continuum",
"Node name for S&R": "H3ContinuumLoadVideo",
"ver": "ddaedfd401b171651b48059285a44897e84fce70"
"Node name for S&R": "H3ContinuumVideoAdapter"
},
"widgets_values": [
false,
"MiniMax_H3_00001_.mp4",
24,
"image"
24
],
"widgets_values_named": {
"enable_video": false,
"file": "MiniMax_H3_00001_.mp4",
"force_rate": 24,
"upload": "image"
"force_rate": 24
},
"color": "#232",
"bgcolor": "#353"
@@ -1829,6 +1824,43 @@
"widgets_values_named": {
"value": ""
}
},
{
"id": 355,
"type": "LoadVideo",
"pos": [
440,
2350
],
"size": [
480.0,
210
],
"flags": {},
"order": 3,
"mode": 4,
"inputs": [],
"outputs": [
{
"name": "VIDEO",
"type": "VIDEO",
"slot_index": 0,
"links": [
399
]
}
],
"properties": {
"cnr_id": "comfy-core",
"Node name for S&R": "LoadVideo",
"ver": "0.30.0"
},
"widgets_values": [
"MiniMax_H3_00001_.mp4"
],
"widgets_values_named": {
"file": "MiniMax_H3_00001_.mp4"
}
}
],
"links": [
@@ -2135,6 +2167,14 @@
348,
2,
"IMAGE"
],
[
399,
355,
0,
320,
0,
"VIDEO"
]
],
"groups": [
@@ -2276,4 +2316,4 @@
"k2cf_state_id": "k2cf_1788454341712_tkpfmvwyg3b"
},
"version": 0.4
}
}
@@ -1,8 +1,8 @@
{
"id": "735ad332-ca97-474f-b53f-7c44f6b6c383",
"revision": 0,
"last_node_id": 354,
"last_link_id": 398,
"last_node_id": 355,
"last_link_id": 399,
"nodes": [
{
"id": 142,
@@ -81,7 +81,7 @@
},
{
"id": 315,
"type": "H3EasyLoadAudio",
"type": "LoadAudio",
"pos": [
990,
2360
@@ -104,18 +104,15 @@
}
],
"properties": {
"aux_id": "ukr8b3g-cmyk/ComfyUI-H3-Continuum",
"Node name for S&R": "H3EasyLoadAudio",
"ver": "ddaedfd401b171651b48059285a44897e84fce70"
"cnr_id": "comfy-core",
"Node name for S&R": "LoadAudio",
"ver": "0.30.0"
},
"widgets_values": [
"prnas_.mp3",
null,
null
"prnas_.mp3"
],
"widgets_values_named": {
"audio": "prnas_.mp3",
"upload": null
"audio": "prnas_.mp3"
},
"color": "#232",
"bgcolor": "#353"
@@ -174,19 +171,25 @@
},
{
"id": 320,
"type": "H3ContinuumLoadVideo",
"type": "H3ContinuumVideoAdapter",
"pos": [
440,
2350
2590
],
"size": [
480,
630
480.0,
115
],
"flags": {},
"order": 3,
"mode": 4,
"inputs": [],
"inputs": [
{
"name": "video",
"type": "VIDEO",
"link": 399
}
],
"outputs": [
{
"name": "images",
@@ -204,21 +207,13 @@
}
],
"properties": {
"aux_id": "ukr8b3g-cmyk/ComfyUI-H3-Continuum",
"Node name for S&R": "H3ContinuumLoadVideo",
"ver": "ddaedfd401b171651b48059285a44897e84fce70"
"Node name for S&R": "H3ContinuumVideoAdapter"
},
"widgets_values": [
false,
"MiniMax_H3_00001_.mp4",
24,
"image"
24
],
"widgets_values_named": {
"enable_video": false,
"file": "MiniMax_H3_00001_.mp4",
"force_rate": 24,
"upload": "image"
"force_rate": 24
},
"color": "#232",
"bgcolor": "#353"
@@ -1829,6 +1824,43 @@
"widgets_values_named": {
"value": ""
}
},
{
"id": 355,
"type": "LoadVideo",
"pos": [
440,
2350
],
"size": [
480.0,
210
],
"flags": {},
"order": 3,
"mode": 4,
"inputs": [],
"outputs": [
{
"name": "VIDEO",
"type": "VIDEO",
"slot_index": 0,
"links": [
399
]
}
],
"properties": {
"cnr_id": "comfy-core",
"Node name for S&R": "LoadVideo",
"ver": "0.30.0"
},
"widgets_values": [
"MiniMax_H3_00001_.mp4"
],
"widgets_values_named": {
"file": "MiniMax_H3_00001_.mp4"
}
}
],
"links": [
@@ -2135,6 +2167,14 @@
348,
2,
"IMAGE"
],
[
399,
355,
0,
320,
0,
"VIDEO"
]
],
"groups": [
@@ -2276,4 +2316,4 @@
"k2cf_state_id": "k2cf_1788454341712_tkpfmvwyg3b"
},
"version": 0.4
}
}
Binary file not shown.
+5
View File
@@ -448,6 +448,10 @@ from .v3.hires_fix_nodes import (
NODE_CLASS_MAPPINGS.update(V35_HIRES_FIX_NODE_CLASS_MAPPINGS)
NODE_DISPLAY_NAME_MAPPINGS.update(V35_HIRES_FIX_NODE_DISPLAY_NAME_MAPPINGS)
from .v3.video_adapter_nodes import H3ContinuumVideoAdapter
NODE_CLASS_MAPPINGS["H3ContinuumVideoAdapter"] = H3ContinuumVideoAdapter
from .decode_cache.nodes import H3DecodeCacheHelper
NODE_CLASS_MAPPINGS["H3DecodeCacheHelper"] = H3DecodeCacheHelper
@@ -464,6 +468,7 @@ _PUBLIC_NODE_DISPLAY_NAMES = {
"H3EasyLoadImage": "H3 Continuum Load Image",
"H3EasyLoadAudio": "H3 Continuum Load Audio",
"H3ContinuumLoadVideo": "H3 Continuum Load Video",
"H3ContinuumVideoAdapter": "H3 Continuum Video Adapter",
"H3ContinuumSecondPassV35": "H3 Continuum Second Pass",
"H3DecodeCacheHelper": "Decode Cache Helper",
}
+2 -2
View File
@@ -164,7 +164,7 @@ console.log(JSON.stringify({{ initial, off, onAgain, externalBypass, reloaded }}
observed = json.loads(result.stdout)
assert observed == {
"initial": {
"names": ["Enable Audio", "audio", "audioUI"],
"names": ["audio", "audioUI", "Enable Audio"],
"saved": {
"mode": 0,
"widgets_values": [
@@ -201,7 +201,7 @@ console.log(JSON.stringify({{ initial, off, onAgain, externalBypass, reloaded }}
"toggle": False,
"audio": "reloaded.wav",
"player": {"position": 2.5, "volume": 0.6},
"names": ["Enable Audio", "audio", "audioUI"],
"names": ["audio", "audioUI", "Enable Audio"],
},
}
+9 -40
View File
@@ -150,7 +150,7 @@ console.log(JSON.stringify({{ initial, toggledOff, externalUnbypass, externalByp
observed = json.loads(result.stdout)
assert observed == {
"initial": {
"names": ["Enable Image", "image", "upload"],
"names": ["image", "upload", "Enable Image"],
"toggle": True,
"saved": {"mode": 0, "widgets_values": ["first.png", "image"]},
},
@@ -166,12 +166,12 @@ console.log(JSON.stringify({{ initial, toggledOff, externalUnbypass, externalByp
"toggle": False,
"image": "reloaded.png",
"upload": "image",
"names": ["Enable Image", "image", "upload"],
"names": ["image", "upload", "Enable Image"],
},
}
def test_shared_bypass_helper_redraws_only_enable_row_at_full_opacity(tmp_path):
def test_shared_bypass_helper_preserves_core_widget_collection_when_drawing(tmp_path):
node_executable = shutil.which("node")
if node_executable is None:
pytest.skip("Node.js is required for the frontend drawing regression")
@@ -246,47 +246,16 @@ console.log(JSON.stringify({{
text=True,
)
observed = json.loads(result.stdout)
assert observed == {
"image": {
"bypassCalls": [
{"names": ["Enable Image", "file"], "alpha": 0.2},
{"names": ["Enable Image"], "alpha": 1},
],
"enabledCalls": [
{"names": ["Enable Image", "file"], "alpha": 1}
],
for kind, result in observed.items():
names = ["enable_video", "file"] if kind == "video" else ["file", f"Enable {kind.title()}"]
assert result == {
"bypassCalls": [{"names": names, "alpha": 0.2}],
"enabledCalls": [{"names": names, "alpha": 1}],
"mode": 0,
"toggle": True,
"clickable": True,
"visible": True,
},
"audio": {
"bypassCalls": [
{"names": ["Enable Audio", "file"], "alpha": 0.2},
{"names": ["Enable Audio"], "alpha": 1},
],
"enabledCalls": [
{"names": ["Enable Audio", "file"], "alpha": 1}
],
"mode": 0,
"toggle": True,
"clickable": True,
"visible": True,
},
"video": {
"bypassCalls": [
{"names": ["enable_video", "file"], "alpha": 0.2},
{"names": ["enable_video"], "alpha": 1},
],
"enabledCalls": [
{"names": ["enable_video", "file"], "alpha": 1}
],
"mode": 0,
"toggle": True,
"clickable": True,
"visible": True,
},
}
}
def test_easy_load_image_frontend_has_no_backend_boolean_or_polling():
+4 -4
View File
@@ -332,12 +332,12 @@ console.log(JSON.stringify({{ initial, enabled, externalBypass, externalUnbypass
}
def test_video_bypass_appearance_uses_native_mode_without_hardcoded_color():
def test_legacy_video_has_no_frontend_enable_bridge():
source = FRONTEND_PATH.read_text(encoding="utf-8")
common = COMMON_FRONTEND_PATH.read_text(encoding="utf-8")
assert 'from "./easy_bypass_toggle.js"' in source
assert "configureExistingEasyBypassWidgetNode" in source
assert 'widgetNames: ["enable_video", "Enable Video"]' in source
assert 'from "./easy_bypass_toggle.js"' not in source
assert "configureExistingEasyBypassWidgetNode" not in source
assert 'widgetNames: ["enable_video", "Enable Video"]' not in source
assert "NODE_MODE_BYPASS" in common
assert "node.color" not in source
assert "node.bgcolor" not in source
+116
View File
@@ -0,0 +1,116 @@
"""Regressions for Core's prototype mode accessor and stable widgets view.
This models the persistence boundary; it is not a real-browser acceptance test.
"""
from __future__ import annotations
import json
from pathlib import Path
import shutil
import subprocess
import pytest
ROOT = Path(__file__).resolve().parents[1]
@pytest.mark.parametrize("store_backed", [False, True], ids=["legacy", "store"])
@pytest.mark.parametrize("kind", ["image", "audio", "video"])
def test_loader_state_survives_draw_save_and_workflow_roundtrip(tmp_path, kind, store_backed):
node = shutil.which("node")
if node is None:
pytest.skip("Node.js is required for frontend regression tests")
source = (ROOT / "web/easy_bypass_toggle.js").read_text(encoding="utf-8").replace("export ", "")
script = source + "\n" + r'''
const storeBacked = STORE_BACKED;
const kind = KIND;
const nodeClass = {image: "H3EasyLoadImage", audio: "H3EasyLoadAudio", video: "H3ContinuumLoadVideo"}[kind];
const enableName = {image: "Enable Image", audio: "Enable Audio", video: "enable_video"}[kind];
const fileName = {image: "image", audio: "audio", video: "file"}[kind];
const selectedFile = {image: "selected-b.png", audio: "selected-b.wav", video: "selected-b.mp4"}[kind];
function plainWidget(name, value) { return {name, value, options: {}, serialize: true}; }
class StoreNode {
constructor() {
this.comfyClass = nodeClass;
this._state = {mode: 0};
this.drawCalls = 0;
const widgets = [];
// Like Core widgetsView: assignment mutates the same array/view.
Object.defineProperty(this, "widgets", {
configurable: true,
get() { return widgets; },
set(value) { widgets.splice(0, widgets.length, ...value); },
});
if (!storeBacked) {
Object.defineProperty(this, "mode", {value: 0, writable: true, configurable: true});
Object.defineProperty(this, "widgets", {value: [], writable: true, configurable: true});
}
if (kind === "video") this.widgets.push(plainWidget(enableName, true));
this.widgets.push(plainWidget(fileName, "default-file"));
if (kind === "video") this.widgets.push(plainWidget("force_rate", 30));
}
get mode() { return this._state.mode; }
set mode(value) { this._state.mode = value; }
setDirtyCanvas() {}
addWidget(type, name, value, callback, options) {
const w = {type, name, value, callback, options}; this.widgets.push(w); return w;
}
drawWidgets() { this.drawCalls++; }
serializeFromStoreState(state) {
const ws = this.widgets.filter(w => w.serialize !== false);
return {mode: state.mode, widgets_values: ws.map(w => w.value),
widgets_values_named: Object.fromEntries(ws.map(w => [w.name, w.value]))};
}
serialize() { return this.serializeFromStoreState(storeBacked ? this._state : {mode:this.mode}); }
configure(info) {
this.mode = info.mode;
for (const w of this.widgets) {
if (w.serialize !== false && Object.hasOwn(info.widgets_values_named, w.name))
w.value = info.widgets_values_named[w.name];
}
}
}
function configure(n) {
if (kind === "video") configureExistingEasyBypassWidgetNode(n, {nodeClass, widgetNames:[enableName]});
else configureEasyBypassToggleNode(n, {nodeClass, widgetName:enableName, tooltip:"test"});
}
function saveGraph(n) {
// Core 1.53 may bypass node.serialize() and use the store directly.
return storeBacked ? n.serializeFromStoreState(n._state) : n.serialize();
}
const a = new StoreNode(); configure(a); configure(a);
a.widgets.find(w => w.name === fileName).value = selectedFile;
findEasyBypassWidget(a).callback(false);
const beforeDraw = a.widgets.map(w => w.name);
for (let i=0; i<4; i++) a.drawWidgets({}, {editorAlpha:0.2});
const afterDraw = a.widgets.map(w => w.name);
const saved = saveGraph(a);
const b = new StoreNode(); configure(b); b.configure(saved); configure(b);
const reopened = saveGraph(b);
b.mode = 0;
const externalOn = findEasyBypassWidget(b).value;
b.mode = 4;
const externalOff = findEasyBypassWidget(b).value;
console.log(JSON.stringify({beforeDraw, afterDraw, liveMode:a.mode, storeMode:a._state.mode,
saved, reopened, reopenedEnable:findEasyBypassWidget(b).value, externalOn, externalOff,
selectedFile, fileName, kind, drawCalls:a.drawCalls}));
'''
script = script.replace("STORE_BACKED", str(store_backed).lower()).replace("KIND", json.dumps(kind))
file = tmp_path / "loader-store.js"
file.write_text(script, encoding="utf-8")
result = subprocess.run([node, str(file)], capture_output=True, text=True, check=True)
observed = json.loads(result.stdout)
assert observed["beforeDraw"] == observed["afterDraw"], observed
assert observed["liveMode"] == observed["saved"]["mode"] == 4, observed
if store_backed:
assert observed["storeMode"] == 4, observed
assert observed["saved"]["widgets_values_named"][observed["fileName"]] == observed["selectedFile"]
if kind == "video":
assert observed["saved"]["widgets_values_named"]["force_rate"] == 30
assert observed["saved"]["widgets_values_named"]["enable_video"] is False
else:
assert not any(name.startswith("Enable") for name in observed["saved"]["widgets_values_named"])
assert observed["reopened"] == observed["saved"]
assert observed["reopenedEnable"] is False
assert observed["externalOn"] is True
assert observed["externalOff"] is False
+2 -1
View File
@@ -22,13 +22,14 @@ PUBLIC_DISPLAY_NAMES = {
"H3EasyLoadImage": "H3 Continuum Load Image",
"H3EasyLoadAudio": "H3 Continuum Load Audio",
"H3ContinuumLoadVideo": "H3 Continuum Load Video",
"H3ContinuumVideoAdapter": "H3 Continuum Video Adapter",
"H3ContinuumSecondPassV35": "H3 Continuum Second Pass",
"H3ContinuumReferenceImages": "H3 Continuum Reference Images",
"H3DecodeCacheHelper": "Decode Cache Helper",
}
def test_public_export_is_exactly_the_v38x2_nine_node_allowlist():
def test_public_export_keeps_legacy_loaders_and_adds_video_adapter():
assert set(root_nodes.NODE_CLASS_MAPPINGS) == set(PUBLIC_DISPLAY_NAMES)
assert root_nodes.NODE_DISPLAY_NAME_MAPPINGS == PUBLIC_DISPLAY_NAMES
+29 -5
View File
@@ -9,9 +9,9 @@ from zipfile import ZipFile
ROOT = Path(__file__).resolve().parents[1]
WORKFLOW_PATH = ROOT / "examples" / "workflows" / "MiniMax_H3_Continuum_V38X2.json"
# User-approved final distribution. Do not sanitize or reserialize this graph.
WORKFLOW_SHA256 = "6c445d62979632bc1a801b1c28dbd639c23b51cc156ebae18837baaa757e592b"
ZIP_SHA256 = "29e8ea19cf7c7e8a8a5e98577905d8fd01fc800bb8edb4f4218a638fe39e69d0"
# User-approved loader migration (2026-09-21); non-loader graph values are protected.
WORKFLOW_SHA256 = "1b2212b7511fac0b63dfa6e9f006cd8644c72d08c6945ab0e4ed0e722c97a730"
ZIP_SHA256 = "8f839a955859bffa0d9cf0b15e91ee484dd911aca5ae31f1787debd56afdc7da"
ZIP_WORKFLOW_NAME = "MiniMax_H3_Continuum_V38X2.json"
EXTERNAL_PACKAGES = {
"comfyui-spectrum-minimax-h3",
@@ -53,8 +53,8 @@ def _graph(workflow: dict) -> tuple[dict[int, dict], dict[int, list]]:
def test_v38_public_workflow_declares_external_dependencies_and_is_reloadable():
workflow = _workflow()
assert len(workflow["nodes"]) == 32
assert len(workflow["links"]) == 38
assert len(workflow["nodes"]) == 33
assert len(workflow["links"]) == 39
packages = {
node.get("properties", {}).get("cnr_id") for node in workflow["nodes"]
} - {None, "", "comfy-core"}
@@ -243,3 +243,27 @@ def test_v38x2_public_workflow_keeps_helper_finalize_create_save_chain():
"audio_samples": "H3ContinuumSamplerV38",
"audio_vae": "VAELoader",
}
def test_current_workflow_uses_core_audio_and_enable_free_video_adapter():
workflow = _workflow()
nodes, links = _graph(workflow)
types = {node["type"] for node in workflow["nodes"]}
assert "H3EasyLoadAudio" not in types
assert "H3ContinuumLoadVideo" not in types
audio = _one_node(workflow, "LoadAudio")
video = _one_node(workflow, "LoadVideo")
adapter = _one_node(workflow, "H3ContinuumVideoAdapter")
for core, title in ((audio, "Load Audio"), (video, "Load Video")):
assert core.get("title", title) == title
assert core["properties"]["cnr_id"] == "comfy-core"
assert core["mode"] == 4
assert audio["widgets_values_named"]["audio"] == "prnas_.mp3"
assert video["widgets_values_named"]["file"] == "MiniMax_H3_00001_.mp4"
assert adapter["widgets_values_named"] == {"force_rate": 24}
assert adapter["widgets_values"] == [24]
assert adapter["mode"] == 4
assert links[adapter["inputs"][0]["link"]][1:3] == [video["id"], 0]
sampler = _one_node(workflow, "H3ContinuumSamplerV38")
guide = next(x for x in sampler["inputs"] if x["name"] == "reference_video_1")
assert nodes[links[guide["link"]][1]]["type"] == "H3ContinuumVideoAdapter"
+49
View File
@@ -0,0 +1,49 @@
from __future__ import annotations
from fractions import Fraction
from types import SimpleNamespace
import pytest
import torch
from ComfyUI_H3_Continuum_Join import nodes as root_nodes
from ComfyUI_H3_Continuum_Join.v3.easy_video_nodes import ExecutionBlocker, _resample_video_frames
from ComfyUI_H3_Continuum_Join.v3.video_adapter_nodes import H3ContinuumVideoAdapter
def _outputs(output):
return output.args if hasattr(output, "args") else output.result
def test_video_adapter_is_registered_without_file_upload_or_enable():
assert root_nodes.NODE_CLASS_MAPPINGS["H3ContinuumVideoAdapter"] is H3ContinuumVideoAdapter
schema = H3ContinuumVideoAdapter.define_schema()
assert [x.id for x in schema.inputs] == ["video", "force_rate"]
assert schema.inputs[1].default == 24.0
assert len(schema.outputs) == 2
@pytest.mark.parametrize("source_rate,count", [(Fraction(24),240), (Fraction(30),300), (Fraction(30000,1001),300)])
def test_adapter_keeps_existing_resampling_and_exact_audio(source_rate, count):
images = torch.arange(count, dtype=torch.float32).view(count, 1, 1, 1).expand(-1, 2, 2, 3).clone()
audio = {"waveform": torch.arange(64, dtype=torch.float32).reshape(1, 1, 64), "sample_rate":32000}
calls = []
class Video:
def get_components(self):
calls.append(True)
return SimpleNamespace(images=images, audio=audio, frame_rate=source_rate)
output_images, output_audio = _outputs(H3ContinuumVideoAdapter.execute(Video(), 24.0))
assert len(calls) == 1
assert torch.equal(output_images, _resample_video_frames(images, source_rate, 24.0))
assert output_images.shape[0] == 240
assert output_audio is audio
if source_rate == 24:
assert output_images is images
def test_adapter_source_rate_and_silent_video_contract():
images = torch.zeros(30, 2, 2, 3)
video = SimpleNamespace(get_components=lambda: SimpleNamespace(images=images, audio=None, frame_rate=Fraction(30)))
out_images, audio = _outputs(H3ContinuumVideoAdapter.execute(video, 0))
assert out_images is images
assert isinstance(audio, ExecutionBlocker)
+1
View File
@@ -37,6 +37,7 @@ class H3EasyLoadAudio(CoreLoadAudio):
def define_schema(cls):
schema = super().define_schema()
schema.node_id = "H3EasyLoadAudio"
schema.is_deprecated = True # Kept for saved workflows; new graphs use Core LoadAudio.
schema.display_name = "H3 Continuum Load Audio"
schema.category = "MiniMax H3/Continuum"
schema.description = (
+2
View File
@@ -74,6 +74,7 @@ except ImportError: # pragma: no cover - standalone unit tests
Boolean = _InputFactory
Combo = _InputFactory
Float = _InputFactory
Video = _InputFactory
Image = _OutputFactory
Audio = _OutputFactory
UploadType = _UploadType
@@ -191,6 +192,7 @@ class H3ContinuumLoadVideo(io.ComfyNode):
files = folder_paths.filter_files_content_types(files, ["video"])
return io.Schema(
node_id="H3ContinuumLoadVideo",
is_deprecated=True,
display_name="H3 Continuum Load Video",
category=CATEGORY,
description=(
+56
View File
@@ -0,0 +1,56 @@
"""Core VIDEO to H3 frame batches, with no file/upload/Enable frontend."""
from __future__ import annotations
from fractions import Fraction
from .easy_video_nodes import ExecutionBlocker, _resample_video_frames, io
class H3ContinuumVideoAdapter(io.ComfyNode):
"""Reuse the established frame-rate conversion; audio is passed unchanged."""
@classmethod
def define_schema(cls):
return io.Schema(
node_id="H3ContinuumVideoAdapter",
display_name="H3 Continuum Video Adapter",
category="MiniMax H3/Continuum/Input",
description=(
"Converts Core Load Video's VIDEO to IMAGE frames and AUDIO. "
"Use Force Rate 24 for H3 Video Guide. No file selector or Enable. "
"Disable the whole video-input group, or bypass this adapter, "
"to disconnect its optional Sampler inputs."
),
inputs=[
io.Video.Input("video"),
io.Float.Input(
"force_rate", default=24.0, min=0.0, max=120.0, step=0.01,
display_name="Force Rate",
tooltip=(
"24 resamples to H3's expected FPS without changing nominal "
"duration or audio. 0 keeps source frames (not normally for H3)."
),
),
],
outputs=[
io.Image.Output(display_name="images"),
io.Audio.Output(display_name="audio"),
],
)
@classmethod
def execute(cls, video, force_rate: float = 24.0):
components = video.get_components()
images = _resample_video_frames(
components.images, Fraction(components.frame_rate), float(force_rate)
)
audio = components.audio
if audio is None:
audio = ExecutionBlocker(None)
return io.NodeOutput(images, audio)
NODE_CLASS_MAPPINGS = {"H3ContinuumVideoAdapter": H3ContinuumVideoAdapter}
NODE_DISPLAY_NAME_MAPPINGS = {
"H3ContinuumVideoAdapter": "H3 Continuum Video Adapter",
}
+38 -131
View File
@@ -1,16 +1,10 @@
// Shared native-Bypass control for Easy workflow loader nodes.
// ComfyUI Frontend 1.49.6 defines LGraphEventMode.ALWAYS=0 and BYPASS=4.
// Prefer exported LiteGraph constants when available and keep the audited
// numeric values only as compatibility fallbacks.
// Convenience toggles delegate to Core node.mode; Core owns persistence/drawing.
const NODE_MODE_ALWAYS =
typeof LiteGraph !== "undefined" && Number.isInteger(LiteGraph.ALWAYS)
? LiteGraph.ALWAYS
: 0;
? LiteGraph.ALWAYS : 0;
const NODE_MODE_BYPASS =
typeof LiteGraph !== "undefined" && Number.isInteger(LiteGraph.BYPASS)
? LiteGraph.BYPASS
: 4;
? LiteGraph.BYPASS : 4;
function isConfiguredNode(node, nodeClass) {
return node?.comfyClass === nodeClass || node?.type === nodeClass;
@@ -23,28 +17,36 @@ export function findEasyBypassWidget(node) {
function syncWidgetFromMode(node) {
const widget = findEasyBypassWidget(node);
if (!widget) return;
widget.value = node.mode === NODE_MODE_ALWAYS;
if (widget) widget.value = node.mode === NODE_MODE_ALWAYS;
}
function findModeDescriptor(node) {
for (let owner = node; owner; owner = Object.getPrototypeOf(owner)) {
const descriptor = Object.getOwnPropertyDescriptor(owner, "mode");
if (descriptor) return descriptor;
}
return undefined;
}
function installModeSourceOfTruth(node) {
if (node.__h3EasyBypassModeObserved) return true;
const descriptor = Object.getOwnPropertyDescriptor(node, "mode");
if (descriptor && descriptor.configurable === false) return false;
const own = Object.getOwnPropertyDescriptor(node, "mode");
if (own?.configurable === false) return false;
const descriptor = findModeDescriptor(node);
const accessor = descriptor && ("get" in descriptor || "set" in descriptor);
// Never replace a read-only property or manufacture a second store value.
if (accessor && (!descriptor.get || !descriptor.set)) return false;
if (descriptor && !accessor && descriptor.writable === false) return false;
let currentMode = Number(node.mode ?? NODE_MODE_ALWAYS);
Object.defineProperty(node, "mode", {
configurable: true,
enumerable: descriptor?.enumerable ?? true,
enumerable: own?.enumerable ?? descriptor?.enumerable ?? true,
get() {
return descriptor?.get ? descriptor.get.call(this) : currentMode;
return accessor ? descriptor.get.call(this) : currentMode;
},
set(value) {
if (descriptor?.set) {
descriptor.set.call(this, value);
} else {
currentMode = Number(value);
}
if (accessor) descriptor.set.call(this, value);
else currentMode = Number(value);
syncWidgetFromMode(this);
},
});
@@ -52,132 +54,48 @@ function installModeSourceOfTruth(node) {
return true;
}
function installWidgetSerializationGuard(node, widget) {
if (node.__h3EasyBypassSerializationGuard) return;
const originalSerialize = node.serialize;
if (typeof originalSerialize === "function") {
node.serialize = function (...args) {
const index = this.widgets?.indexOf(widget) ?? -1;
if (index >= 0) this.widgets.splice(index, 1);
try {
return originalSerialize.apply(this, args);
} finally {
if (index >= 0) this.widgets.splice(index, 0, widget);
}
};
}
const originalConfigure = node.configure;
if (typeof originalConfigure === "function") {
node.configure = function (...args) {
const index = this.widgets?.indexOf(widget) ?? -1;
if (index >= 0) this.widgets.splice(index, 1);
try {
return originalConfigure.apply(this, args);
} finally {
if (index >= 0) this.widgets.splice(index, 0, widget);
syncWidgetFromMode(this);
}
};
}
node.__h3EasyBypassSerializationGuard = true;
}
function installBypassToggleForeground(node) {
if (node.__h3EasyBypassForegroundInstalled) return;
const originalDrawWidgets = node.drawWidgets;
if (typeof originalDrawWidgets !== "function") return;
node.drawWidgets = function (ctx, options = {}) {
const result = originalDrawWidgets.call(this, ctx, options);
if (this.mode !== NODE_MODE_BYPASS) return result;
const widget = findEasyBypassWidget(this);
const widgets = this.widgets;
if (!widget || widget.hidden || !Array.isArray(widgets)) return result;
if (!widgets.includes(widget)) return result;
// ComfyUI draws every widget at the node's Bypass alpha. Redraw only
// the Enable row afterwards at full opacity so it remains readable and
// uses the unchanged native widget hit area/click handling.
this.widgets = [widget];
try {
originalDrawWidgets.call(this, ctx, {
...(options ?? {}),
editorAlpha: 1,
});
} finally {
this.widgets = widgets;
}
return result;
};
node.__h3EasyBypassForegroundInstalled = true;
}
function setModeFromToggle(node, enabled) {
node.mode = enabled ? NODE_MODE_ALWAYS : NODE_MODE_BYPASS;
syncWidgetFromMode(node);
node.graph?.change?.();
node.setDirtyCanvas?.(true, true);
}
export function configureEasyBypassToggleNode(
node,
{ nodeClass, widgetName, tooltip },
node, { nodeClass, widgetName, tooltip },
) {
if (!isConfiguredNode(node, nodeClass)) return;
node.__h3EasyBypassToggle = { nodeClass, widgetName };
let widget = findEasyBypassWidget(node);
if (!widget) {
widget = node.addWidget(
"toggle",
widgetName,
node.mode === NODE_MODE_ALWAYS,
"toggle", widgetName, node.mode === NODE_MODE_ALWAYS,
(value) => setModeFromToggle(node, Boolean(value)),
{
on: "ON",
off: "OFF",
serialize: false,
},
{ on: "ON", off: "OFF", serialize: false },
);
widget.serialize = false;
widget.serialize = false; // Workflow persistence.
widget.options ||= {};
widget.options.serialize = false;
widget.options.serialize = false; // API prompt serialization.
widget.tooltip = tooltip;
const currentIndex = node.widgets?.indexOf(widget) ?? -1;
if (currentIndex > 0) {
node.widgets.splice(currentIndex, 1);
node.widgets.unshift(widget);
}
installWidgetSerializationGuard(node, widget);
// Append only. Never splice/reassign widgets in draw/serialize/configure:
// newer Core uses a stable mutation view backed by its widget store.
}
if (!installModeSourceOfTruth(node)) {
console.warn(
`${nodeClass} could not observe node.mode; external Bypass changes may require a workflow reload.`,
);
console.warn(`${nodeClass}: native mode could not be observed; use Core Bypass.`);
}
installBypassToggleForeground(node);
syncWidgetFromMode(node);
node.setDirtyCanvas?.(true, true);
}
// Retained for existing callers; new Video Adapter has no Enable widget.
export function configureExistingEasyBypassWidgetNode(
node,
{ nodeClass, widgetNames },
node, { nodeClass, widgetNames },
) {
if (!isConfiguredNode(node, nodeClass)) return;
const names = Array.isArray(widgetNames) ? widgetNames : [widgetNames];
const widget = node.widgets?.find((item) => names.includes(item.name));
if (!widget) return;
node.__h3EasyBypassToggle = {
nodeClass,
widgetName: widget.name,
};
node.__h3EasyBypassToggle = { nodeClass, widgetName: widget.name };
if (!widget.__h3EasyBypassCallbackObserved) {
const originalCallback = widget.callback;
widget.callback = function (value, ...args) {
@@ -187,18 +105,7 @@ export function configureExistingEasyBypassWidgetNode(
};
widget.__h3EasyBypassCallbackObserved = true;
}
if (!installModeSourceOfTruth(node)) {
console.warn(
`${nodeClass} could not observe node.mode; external Bypass changes may require a workflow reload.`,
);
}
installBypassToggleForeground(node);
if (node.mode === NODE_MODE_BYPASS) {
syncWidgetFromMode(node);
} else {
setModeFromToggle(node, Boolean(widget.value));
}
node.setDirtyCanvas?.(true, true);
installModeSourceOfTruth(node);
if (node.mode === NODE_MODE_BYPASS) syncWidgetFromMode(node);
else setModeFromToggle(node, Boolean(widget.value));
}
+3 -41
View File
@@ -1,41 +1,3 @@
import { app } from "../../scripts/app.js";
import { configureExistingEasyBypassWidgetNode } from "./easy_bypass_toggle.js";
const EASY_LOAD_VIDEO_CLASS = "H3ContinuumLoadVideo";
function configureEasyLoadVideoNode(node) {
if (
node?.comfyClass !== EASY_LOAD_VIDEO_CLASS &&
node?.type !== EASY_LOAD_VIDEO_CLASS
) {
return;
}
try {
configureExistingEasyBypassWidgetNode(node, {
nodeClass: EASY_LOAD_VIDEO_CLASS,
widgetNames: ["enable_video", "Enable Video"],
});
} catch (error) {
console.warn(
"H3 Continuum Load Video bypass appearance synchronization was skipped; backend blocking remains available.",
error,
);
}
}
app.registerExtension({
name: "H3Continuum.EasyLoadVideo",
nodeCreated(node) {
configureEasyLoadVideoNode(node);
},
loadedGraphNode(node) {
configureEasyLoadVideoNode(node);
},
afterConfigureGraph() {
for (const node of app.graph?._nodes || []) configureEasyLoadVideoNode(node);
},
});
// Legacy H3ContinuumLoadVideo keeps its saved backend enable_video input.
// Do not mirror it into node.mode or alter Core widget arrays/drawing.
// New workflows use Core LoadVideo -> H3ContinuumVideoAdapter (no Enable).