diff --git a/.comfyignore b/.comfyignore index 40fc895..8d3a535 100644 --- a/.comfyignore +++ b/.comfyignore @@ -56,6 +56,10 @@ examples/workflows/* !examples/workflows/MiniMax_H3_Continuum_V39.json !examples/workflows/MiniMax_H3_Continuum_V39.zip !examples/MiniMax_H3_Continuum_V39.json +!examples/MiniMax_H3_Continuum_V39_Turbo_Sample.json +!examples/workflows/MiniMax_H3_Continuum_V39_Turbo_Sample.json +!examples/workflows/MiniMax_H3_Continuum_V39_Turbo_Sample.zip +!docs/TURBO_SAMPLE.md !examples/MiniMax_H3_Continuum_V38X2.json # Current loader migration instructions. @@ -70,3 +74,26 @@ examples/workflows/* # Keep the Registry payload aligned with its declared Manifest. !docs/REVIEW_RESTORATION_REPAIR.md write-h3-v39-reference-prompts/ + +# Current Issue #31 compatibility and update guidance. +!docs/ISSUE31_SAMPLING_SIGNATURES.md + +# Current regeneration intent and automatic variation guide. +!docs/REGENERATE_INTENT_V396.md + +# Current audited KJ Preview Override compatibility guide. +!docs/KJ_PREVIEW_OVERRIDE_V398.md + +# Keep the condensed README and its moved text references together. +!docs/USER_GUIDE.md +!docs/README_HISTORY.md + +# Japanese detailed references retained by the condensed README. +!docs/USER_GUIDE_JA.md +!docs/README_HISTORY_JA.md + +# Current 3.9.9 update and verification notes. +!docs/RELEASE_NOTES_V399.md + +# Current 3.9.10 repair/update notes. +!docs/RELEASE_NOTES_V3910.md diff --git a/.github/workflows/publish_registry.yml b/.github/workflows/publish_registry.yml index a9dcf57..38a78fc 100644 --- a/.github/workflows/publish_registry.yml +++ b/.github/workflows/publish_registry.yml @@ -7,7 +7,7 @@ permissions: contents: read concurrency: - group: publish-comfy-registry-v3.9.4 + group: publish-comfy-registry-v3.9.10 cancel-in-progress: false jobs: @@ -15,10 +15,10 @@ jobs: runs-on: ubuntu-latest timeout-minutes: 15 steps: - - name: Check out v3.9.4 release + - name: Check out v3.9.10 release uses: actions/checkout@v4 with: - ref: v3.9.4 + ref: v3.9.10 persist-credentials: false - name: Set up Python uses: actions/setup-python@v5 @@ -27,14 +27,14 @@ jobs: - name: Verify release identity and source hashes shell: bash run: | - test "$(git describe --tags --exact-match HEAD)" = "v3.9.4" + test "$(git describe --tags --exact-match HEAD)" = "v3.9.10" python - <<'PY' import hashlib import pathlib import tomllib root = pathlib.Path(".") metadata = tomllib.loads((root / "pyproject.toml").read_text()) - assert metadata["project"]["version"] == "3.9.4" + assert metadata["project"]["version"] == "3.9.10" assert metadata["tool"]["comfy"]["PublisherId"] == "ukr8b3g-cmyk" for name in ("REGISTRY_MANIFEST.sha256", "MANIFEST.sha256"): rows = (root / name).read_text().splitlines() diff --git a/.github/workflows/publish_release.yml b/.github/workflows/publish_release.yml new file mode 100644 index 0000000..23c1f1c --- /dev/null +++ b/.github/workflows/publish_release.yml @@ -0,0 +1,154 @@ +name: Publish verified v3.9.10 + +on: + workflow_run: + workflows: [tests] + types: [completed] + +permissions: + contents: read + +concurrency: + group: publish-v3.9.10 + cancel-in-progress: false + +jobs: + tag: + if: github.event.workflow_run.conclusion == 'success' && github.event.workflow_run.head_branch == 'main' && github.event.workflow_run.head_repository.full_name == github.repository + runs-on: ubuntu-latest + permissions: + contents: write + outputs: + publish: ${{ steps.tag.outputs.publish }} + steps: + - uses: actions/checkout@v4 + with: + ref: ${{ github.event.workflow_run.head_sha }} + - id: tag + env: + GH_TOKEN: ${{ github.token }} + RELEASE_SHA: ${{ github.event.workflow_run.head_sha }} + run: | + test "$(python -c 'import tomllib;print(tomllib.load(open("pyproject.toml","rb"))["project"]["version"])')" = 3.9.10 + test "$(gh api repos/$GITHUB_REPOSITORY/branches/main --jq .commit.sha)" = "$RELEASE_SHA" + if gh release view v3.9.10 --json isDraft --jq .isDraft 2>/dev/null | grep -qx false; then + echo 'publish=false' >> "$GITHUB_OUTPUT" + exit 0 + fi + if EXISTING=$(gh api repos/$GITHUB_REPOSITORY/git/ref/tags/v3.9.10 --jq .object.sha 2>/dev/null); then + echo "Existing tag: $EXISTING" + test "$EXISTING" = "$RELEASE_SHA" + else + echo "Creating v3.9.10 at $RELEASE_SHA" + gh api repos/$GITHUB_REPOSITORY/git/refs -f ref=refs/tags/v3.9.10 -f sha="$RELEASE_SHA" + fi + echo 'publish=true' >> "$GITHUB_OUTPUT" + tag-tests: + needs: tag + if: needs.tag.outputs.publish == 'true' + strategy: + fail-fast: false + matrix: + os: [ubuntu-latest, windows-latest] + runs-on: ${{ matrix.os }} + steps: + - uses: actions/checkout@v4 + with: + ref: v3.9.10 + - uses: actions/setup-python@v5 + with: + python-version: '3.11' + - name: Install CPU test dependencies + run: | + python -m pip install --index-url https://download.pytorch.org/whl/cpu torch + python -m pip install -r requirements.txt numpy safetensors pytest psutil opencv-python-headless Pillow aiohttp + - name: Compile tag + run: python -m compileall -q . + - name: Linux full regression on published tag + if: runner.os == 'Linux' + run: python -m pytest -q -p no:cacheprovider + - name: Windows storage regression on published tag + if: runner.os == 'Windows' + run: python -m pytest -q -p no:cacheprovider tests/test_temporary_storage.py tests/test_storage_api.py tests/test_p20_file_backed_tensor_poc.py tests/test_p22_file_backed_buffer.py tests/decode_cache + publish: + needs: [tag, tag-tests] + if: needs.tag.outputs.publish == 'true' + runs-on: ubuntu-latest + permissions: + contents: write + steps: + - uses: actions/checkout@v4 + with: + ref: v3.9.10 + persist-credentials: false + - uses: actions/setup-python@v5 + with: + python-version: '3.11' + - name: Build GitHub ZIP and verify source manifests + run: | + python - <<'PY' + import hashlib,pathlib,subprocess,zipfile,tomllib + root=pathlib.Path('.') + assert tomllib.loads((root/'pyproject.toml').read_text())['project']['version']=='3.9.10' + for name in ['MANIFEST.sha256','REGISTRY_MANIFEST.sha256']: + rows=(root/name).read_text().splitlines() + for row in rows: + h,p=row.split(' ',1);assert hashlib.sha256((root/p).read_bytes()).hexdigest()==h,p + print(name,len(rows),'matched') + files=subprocess.check_output(['git','ls-tree','-r','--name-only','HEAD'],text=True).splitlines() + target=root/'ComfyUI-H3-Continuum-v3.9.10.zip' + with zipfile.ZipFile(target,'w',zipfile.ZIP_DEFLATED,compresslevel=9) as z: + for p in files:z.write(root/p,'ComfyUI-H3-Continuum/'+p) + with zipfile.ZipFile(target) as z: + assert z.testzip() is None + assert set(z.namelist())=={'ComfyUI-H3-Continuum/'+p for p in files} + assert all(z.read('ComfyUI-H3-Continuum/'+p)==(root/p).read_bytes() for p in files) + pathlib.Path('SHA256SUMS.txt').write_text(hashlib.sha256(target.read_bytes()).hexdigest()+' '+target.name+'\n') + print('GitHub ZIP exact:',len(files),'files') + PY + - name: Install pinned Registry CLI + run: python -m pip install comfy-cli==1.22.0 + - name: Build and verify Registry archive + run: | + comfy --skip-prompt --no-enable-telemetry env + comfy node pack + python - <<'PY' + import hashlib,pathlib,zipfile + root=pathlib.Path('.') + declared={p:h for h,p in (r.split(' ',1) for r in (root/'REGISTRY_MANIFEST.sha256').read_text().splitlines())} + with zipfile.ZipFile('node.zip') as z: + assert z.testzip() is None + assert {i.filename for i in z.infolist() if not i.is_dir()}==set(declared)|{'REGISTRY_MANIFEST.sha256'} + assert all(hashlib.sha256(z.read(p)).hexdigest()==h for p,h in declared.items()) + assert z.read('REGISTRY_MANIFEST.sha256')==(root/'REGISTRY_MANIFEST.sha256').read_bytes() + print('Registry ZIP exact:',len(declared),'payload hashes matched') + PY + - name: Publish GitHub Release + env: + GH_TOKEN: ${{ github.token }} + run: gh release create v3.9.10 ComfyUI-H3-Continuum-v3.9.10.zip SHA256SUMS.txt --verify-tag --title 'v3.9.10 — Spectrum reuse and Reference assignment display' --notes-file docs/RELEASE_NOTES_V3910.md --latest + - name: Download and verify public GitHub assets + env: + GH_TOKEN: ${{ github.token }} + run: | + gh release download v3.9.10 --dir public-download --pattern 'ComfyUI-H3-Continuum-v3.9.10.zip' --pattern SHA256SUMS.txt + python - <<'PY' + import pathlib,hashlib + for name in ['ComfyUI-H3-Continuum-v3.9.10.zip','SHA256SUMS.txt']: + assert pathlib.Path(name).read_bytes()==(pathlib.Path('public-download')/name).read_bytes(),name + print('Public GitHub assets match verified local ZIP and checksum') + PY + - name: Publish verified Registry package + env: + REGISTRY_ACCESS_TOKEN: ${{ secrets.REGISTRY_ACCESS_TOKEN }} + run: | + test -n "$REGISTRY_ACCESS_TOKEN" + comfy node publish --token "$REGISTRY_ACCESS_TOKEN" + - uses: actions/upload-artifact@v4 + if: always() + with: + name: publication-v3.9.10 + path: | + ComfyUI-H3-Continuum-v3.9.10.zip + SHA256SUMS.txt + node.zip diff --git a/AGENTS.md b/AGENTS.md index eb4af4d..55d3ffc 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,7 +2,7 @@ ## Scope -MiniMax H3 Continuum for ComfyUI. Package 3.9.4 provides the V3.9 Sampler and Reference Images helper, while retaining the separate V3.8X2 workflow. Source publication does not imply a GitHub Release or Registry package publication. +MiniMax H3 Continuum for ComfyUI. Package 3.9.10 provides the V3.9 Sampler and Reference Images helper, while retaining the separate V3.8X2 workflow. Source publication does not imply a GitHub Release or Registry package publication. Sampling Contract v6 and Graph Contract v4 apply to new generation. Keep original v5 history readable, without reusing its Takes in v6 generation or rewriting stored manifests. Public node IDs, socket/widget order, official workflows, Run Storage v3 and State/Session formats remain unchanged. diff --git a/CHANGELOG.md b/CHANGELOG.md index 2ecd97e..4966baa 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,15 +1,67 @@ # Changelog -## Unreleased +## 3.9.10 — Spectrum reuse and Reference assignment display (2026-10-20) -- Make Second Pass tiled-upscale schedule precedence explicit: a connected - dedicated upscale SIGMAS socket wins, followed by the existing main SIGMAS - socket, while the other tiled controls use their node widgets when their - sockets are not connected. The status report now identifies the sigma source. -- Add the DUMAS H3 Sequence Prompt Builder with clip tabs, local timeline - slots, and one canonical absolute Timeline prompt output. -- Refine its UI around the CSGlide shot-timeline pattern: one multiline shot - editor, coloured shot bands, and shared boundary sliders. +- Normalize CRLF source line endings in both Spectrum file and module-closure audits. Keep the pinned source identities and existing Python 3.13 profile bytes unchanged. +- Add separate audited Python 3.12 profiles for the supported local and upstream 0.2.29 implementations. Keep unknown source/runtime state non-reusable, preserve old unsafe/v5 Takes, and require a new Run for newly supported configurations. Sampling v6, Graph v4, public nodes and workflow bytes are unchanged. No new GPU acceptance is claimed for this repair. + +## Unreleased — external Chunks Reference assignment table + +- Treat externally connected Chunks as unresolved in the V3.9 Reference Images + helper. Display assignment range 1–16 with the reason and explicit All/Off + range labels; retain direct-count tables and saved future assignments. +- Keep existing selectors, backend routing, Sampling/Run Storage contracts, + public inputs and official workflows unchanged. Loading or refreshing does + not automatically expand old selections. + +## 3.9.9 — upstream KJ Preview Override / Review continuation (2026-10-20) + +Fix new-Run v6 read-only with the separately audited upstream KJ profile, and +show saved reasons when reuse is unavailable. Keep the original local profile, +Sampling v6 guards, old Takes and official workflow bytes. + +CPU: **2,075 passed / 2 skipped / 2 known expected failures**, plus overlapping +90-case JS coverage. Upstream KJ GPU and normal-ComfyUI browser Continue both +passed: **Chunk 1 preserved, Chunk 2 generated, one reused / one new**; all four +AV outputs fully decoded. Browser checks used the existing local KJ profile. +These are targeted repair checks, not general quality or all-provider acceptance. + +Restart ComfyUI and hard-refresh after updating. On Preview Override, disconnect +optional VAE/Audio VAE and set Tiny VAE `none`; retain generation VAEs. Correct +unsupported settings before starting a new Run. Old unsafe/v5 Takes remain +readable and are not automatically made reusable. No workflow rewiring or Take +deletion is required. [Full release notes](docs/RELEASE_NOTES_V399.md). + +## Unreleased — V3.9 Turbo Sample (2026-10-16) + +- Add a separate user-supplied Auto / 2 x 8s Turbo dance and Thai rap sample, gallery copy, ZIP and setup notes. Preserve standard workflows, saved Takes and product code. This source-only sample has no new GPU acceptance and does not replace v3.9.8 release assets. + + +## 3.9.8 — Issue #31 Preview Override Phase A (2026-10-16) + +- Post-release documentation: after installing and restarting published tag `58fbd855`, both PyTorch/KJ and Kitchen + audited local Spectrum/KJ passed new-Run, separate-Queue Chunk 1 to 2 continuation with retained previews, unchanged prefix/contracts and four fully decoded AV outputs. Record the limited audited profile and unverified browser/quality/performance scope. Keep the original tag/assets and existing Takes/workflows. + +- Add a finite KJ Model Preview Override signature for the explicitly audited source profile. Preserve fixed preview settings, loaded implementation identity and cross-key/list wrapper execution order; omit only the reviewed builtin `frames` list. +- Limit reuse support to VAE/Audio VAE disconnected, KJ Tiny VAE `none`, and Core NoPreviews/Auto/Latent2RGB. Unknown source, altered helpers, additional state and approximate-VAE preview remain non-reusable. Generation itself retains the existing fallback. +- Keep unaffected MODEL signatures, Sampling v6 guards, old unsafe/v5 history and official Workflow bytes unchanged. Full real-Core CPU gate: 1,995 passed / 3 skipped / 2 existing Inspector expected failures / zero unexpected failures and CUDA initialization attempts; the 48 dedicated KJ tests passed without skips. Normal ComfyUI GPU acceptance passed four Core-API Queues: PyTorch and Comfy Kitchen INT8 + the audited local Spectrum implementation, each with separate-Queue Chunk 1 to 2 continuation and held preview images. Both second Queues reused one chunk and generated one; original Chunk 1 bytes and contracts were unchanged. All four video/audio outputs fully decoded. See docs/KJ_PREVIEW_OVERRIDE_V398.md for exact support and limits. + +## 3.9.7 — external-input regeneration cache (2026-10-15) + +- Fix automatic Full Run variations when Chunks or Variation Nonce come from external nodes. Unresolved linked inputs no longer let Core skip an explicitly requested regeneration. Earlier accepted chunks, existing Takes, public inputs and official workflows are preserved. Update the custom nodes, restart ComfyUI and refresh the browser; no workflow changes or history deletion are required. +- CPU: 1,948 passed / 2 skipped / 2 known Inspector expected failures; zero unexpected failures and zero CUDA initialization attempts. Targeted Core-API GPU queues verified external Chunks=2 / Nonce=0, repeated identical automatic variations 1 then 2, and 1 reused / 1 generated chunk per variation. Browser save/reload and Run-button submissions were checked separately. GPU scope: PyTorch attention, Spectrum OFF, 512x512, 8-step Turbo, two 5-second chunks. This is a targeted cache repair, not general image-quality or all-accelerator acceptance. + +## 3.9.6 — regeneration intent and automatic variation cache (2026-10-15) + +- Preserve explicit Regenerate From and Variation Nonce across V3.8/V3.9 workflow restoration and Queue submission. Persist only the selected intent as workflow metadata; keep the legacy unowned Chunk 1 / nonce 0 cleanup and one-shot restart behavior. +- Execute Full Run explicit regeneration with automatic nonce 0 through Run Storage on every Queue. Ordinary Full Run and fixed positive nonces retain Core caching. Sampling v6 safety, accepted Takes, public inputs and official workflow files are unchanged. +- Full CPU gate: 1,908 passed / 2 skipped / 2 known Inspector expected failures; zero unexpected failures and CUDA initialization attempts. Normal ComfyUI browser save/reload retained Chunk 2 / nonce 5 and Chunk 1 / nonce 0 after history loading. Five new-Run GPU queues passed continuation, Chunk 2 regeneration and two identical Full Run / nonce 0 submissions; earlier Chunk 1 bytes were preserved. GPU scope: PyTorch, Spectrum OFF, 512x512, 8-step Turbo; all five media outputs fully decoded. See docs/REGENERATE_INTENT_V396.md. + +## 3.9.5 — Issue #31 Attention and Spectrum reuse signatures (2026-10-15) + +- Observe the loaded Core PyTorch and Comfy Kitchen INT8 attention overrides with a finite local descriptor, including the verified wrapper self-reference, implementations, defaults, closure, both container dispatch paths, numerical helpers and provider state. +- Keep Sampling v6, runtime signature v1 and Graph v4 unchanged. Overrides outside this adapter retain their existing observation policy; unrelated incomplete MODEL/CFG observations still disable reuse. +- Add a dedicated Spectrum binding identity for explicit audited provider implementations, including upstream Spectrum 0.2.29. Include every effective immutable config value and verified loaded functions/wrappers; exclude reviewed execution-local history and counters. Unknown provider sources, extra runtime state or altered callables remain non-reusable. +- Preserve original unsafe Takes and v5 history. Only new correctly identified runs can gain reusable prefixes. Public nodes, workflow bytes and storage schemas are unchanged. See the versioned validation record for CPU/GPU coverage and remaining limits. ## 3.9.4 — Registry packaging repair (2026-10-14) diff --git a/FORK_NOTICE.md b/FORK_NOTICE.md index 7f7a476..a659cd5 100644 --- a/FORK_NOTICE.md +++ b/FORK_NOTICE.md @@ -1,10 +1,15 @@ -# DUMAS H3 Continuum Tiled fork notice +# Repository notice -This repository is a personal fork of -`ukr8b3g-cmyk/ComfyUI-H3-Continuum`, retaining its upstream license and -attribution. The fork adds the `H3 Continuum Tiled Latent Upscale (Per Clip)` -node and changes package metadata to identify the Dumas repository. +This repository is now an upstream-compatible mirror of +`ukr8b3g-cmyk/ComfyUI-H3-Continuum`. -The added node is intentionally an adapter around ComfyUI's installed native -`MMH3UltimateUpscale` node. It does not redistribute model weights or copy the -upstream model implementation. +The former DUMAS fork experiments remain available in git history, but are no +longer installed from this branch. Install the maintained upstream repository +and the separate DUMAS custom-node repository when you need the additional +MiniMax H3 nodes: + +- Upstream: `https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum` +- DUMAS nodes: `https://git.dumas.ddns.net/chris.dumas/DumasNodes` + +DUMAS H3 nodes are grouped under `Dumas/MiniMax H3/...` and use unique node +IDs, so they do not replace or shadow upstream Continuum nodes. diff --git a/INSTALL_JA.txt b/INSTALL_JA.txt index 31a7ef7..3953997 100644 --- a/INSTALL_JA.txt +++ b/INSTALL_JA.txt @@ -1,16 +1,28 @@ -ComfyUI-H3-Continuum 3.9.4 — V3.9 / V3.8X2 インストール +ComfyUI-H3-Continuum 3.9.9 — public KJ / Review continuation +CPU 2075 passed / 2 skipped / 2 known xfailed; upstream KJ GPU and installed local-KJ browser Continue PASS. +既存Take・Workflowは維持。更新後は再起動・ブラウザー再読込。旧unsafe/v5は自動変換しません。 +対応条件と検証範囲: docs/RELEASE_NOTES_V399.md / docs/KJ_PREVIEW_OVERRIDE_V398.md -**最新版パッケージは3.9.4です。** 固定版のGitHub配布は下表を参照してください。Registryの公開状態は別に確認します。 +--- Historical package record (unchanged) --- +3.9.8: 監査済みKJ Model Preview Overrideの画像保持後のChunk継続を修正。対応条件・検証範囲:docs/KJ_PREVIEW_OVERRIDE_V398.md + +ComfyUI-H3-Continuum 3.9.8 — V3.9 / V3.8X2 インストール + +**最新版パッケージは3.9.8です。** 固定版のGitHub配布は下表を参照してください。Registryの公開状態は別に確認します。 | バージョン | Release | カスタムノード本体ZIP | SHA-256チェックサム | | --- | --- | --- | --- | +| 3.9.8 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.8) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.8/ComfyUI-H3-Continuum-v3.9.8.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.8/SHA256SUMS.txt) | +| 3.9.7 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.7) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.7/ComfyUI-H3-Continuum-v3.9.7.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.7/SHA256SUMS.txt) | +| 3.9.6 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.6) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.6/ComfyUI-H3-Continuum-v3.9.6.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.6/SHA256SUMS.txt) | +| 3.9.5 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.5) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.5/ComfyUI-H3-Continuum-v3.9.5.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.5/SHA256SUMS.txt) | | 3.9.4 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.4) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.4/ComfyUI-H3-Continuum-v3.9.4.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.4/SHA256SUMS.txt) | | 3.9.3 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.3) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.3/ComfyUI-H3-Continuum-v3.9.3.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.3/SHA256SUMS.txt) | | 3.9.2 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.2) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.2/ComfyUI-H3-Continuum-v3.9.2.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.2/SHA256SUMS.txt) | 元の[3.9.2 Source ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/archive/refs/tags/v3.9.2.zip)は従来のタグから取得できます。本体ZIPと公式Workflow ZIPは別の配布物です。 -3.9.4はRegistry配布の梱包修正版です。ManagerでH3 Continuumを検索し、3.9.4を選択するか、comfy-cliで `comfy node install comfyui-h3-continuum@3.9.4` を使用できます。Registryの検査状態とManagerの一覧反映は別に確認してください。生成・保存動作は3.9.3と共通です。 +3.9.8は監査済みKJ Preview Overrideの画像保持後の継続を修正します。VAE/Audio VAE未接続・Tiny VAE noneが条件で、KJNodes全般への対応ではありません。更新後は新Runを作成してください。ManagerでH3 Continuumを検索し、Registryの検査・一覧反映を確認して3.9.8を選択するか、`comfy node install comfyui-h3-continuum@3.9.8`を使用します。更新後はComfyUIを再起動し、ブラウザーも再読込してください。既存Run/Takeの削除は不要です。旧markerなしChunk 1/Nonce 0は選び直して保存してください。旧unsafe履歴は引き続き再利用不可です。 3.9.3は一時ストレージの保存先設定と状態表示・未使用削除を追加した版です。V3.9ノードと3.9.1/3.9.2のWorkflowはそのまま使用できます。旧v5 Takeと履歴は読めますが、新しいv6生成の前半には再利用できません。新規Full VideoまたはStart again from Chunk 1で開始してください。新しいGitHub Release/Registry公開は別工程で、過去のRelease/tagは残します。V3.8X2 WorkflowをV3.9へ自動変換せず、別々のWorkflowとして保存してください。保存済みRun/Takeも自動移行しません。 diff --git a/MANIFEST.sha256 b/MANIFEST.sha256 index 9814e1b..529d05f 100644 --- a/MANIFEST.sha256 +++ b/MANIFEST.sha256 @@ -1,10 +1,23 @@ -02ea0951ce2e7ac2d5f3bbf02c596a9f9ea8adcdf2a113dca4c8db3cc19c36b3 __init__.py -48c25e689d401e4764fea0084100cdd43f8ff524410d10a9be49d3befb8b7202 .comfyignore +ce319f06573b0b53709bae56d9b9ee0b3f4180eba961d7cbbac9e01e403a589e .comfyignore 3d681ded5d4c50cc20c2382e29fdc98d8a48e76d552c41ad5a195d941e66e612 .gitattributes +c3fc30c17dc92c4c772f25392f3f63385ccd5de025798d13dcea51c03f1f81e8 .github/workflows/publish_registry.yml +60392b0310924b7abcffbfa8070f0180e531a1fb1c030d85496a62b46291064e .github/workflows/publish_release.yml 3e22b441fe96bb6d099f0fcb92265f7a986c444f6c45be263c7905898aea4ac7 .github/workflows/tests.yml a28c4c592d56c57e0967f0adce5655313b942b8cc04f77766c0db1bec96c13e0 .gitignore +fa9c99303d1a960db12ae2191cffcfbffe82e25e144eb6d16775c840fec4d573 CHANGELOG.md +6e889c42490ccb5f376694b5944c693a84e7febedf38e631d687e96bc1e76376 H3-Continuum-LLM-System-Prompt-v1.zip +144324850d4ba086938da5f4ed7b02ff0668dec554f092695328240e43fec3ec H3-Continuum-Skill-v1.zip +fe29dafce4a6c5229e7e3aef1f946afba2346015702ed8cdda9927a80b6e65f3 INSTALL_JA.txt +c44abbd789091bbead01250dbd5453e60539d2665c69f162335fdbd2936019c2 LICENSE +656e417909695c5dcabf134b6f3240c44bd02bb2e33881b5247efd345cb932c2 PACKAGE_INFO_JA.txt +57fa9ad77ab5b1d2da6ec43f7ba19118e253cb4a959b758b246755471df15591 PACKAGE_VALIDATION.txt +da45eeb9f4950777bb63974cbf1d77856b287b05e3466be63571f2ad4561f12e README.md +eed26374c7de5e9e19396836e0270fb46f37f3302dfd6f5533c8d703741cbf0f README_JA.md +9a84b03b89f5889f2ed59bcb969711bc1de367ac109b14596483283d3ffa1174 REGISTRY_MANIFEST.sha256 +0dbe8a5f71c92f3523942343b40787104c8b96781461ba3ba82934a6bdbe5834 THIRD_PARTY_NOTICES.md +02ea0951ce2e7ac2d5f3bbf02c596a9f9ea8adcdf2a113dca4c8db3cc19c36b3 __init__.py +7fd122ff08232e114a6ef32171217ea6324e980eb7257d560c466b8177a3d3ec audio_compat.py 3e7a1ec3380be2a222c8a3e9b8a6bb184d3a760478957f48186438f15235bdba branch_provenance.py -1358bcdd91ba8c4ee29c92c203bcdea9c34fd0ad7437bc0f00b657ce0ae32c72 CHANGELOG.md c1ed3a0342730450958fb62fd21854a876991f3a4aefb24e5383b0c73cd2312d compatibility.py 4d62508f900af9f93ec320afb900c27cc9a300d1e0c0a94714258498c5ede5fc conditioning.py 294251c40b1be2e296c5e5f627b68091d087bdb39179e3a0c3cebd2ee8a344f5 constants.py @@ -19,6 +32,39 @@ c93a3e52e4deabe5ef0db7f34a7605856a543089574ba17227e697e9a2c0139a docs/ARCHITECT 1d60cf5d4ef9c45885d4f90289c3b17aa70a6a2752c6b288288322a5e0568050 docs/FAILURE_SEMANTICS_BASELINE.md c6ea788a03c5f29f32fb6a4fd62db92f108e604493d818b9729e9d7fb967526e docs/FAILURE_SEMANTICS_DELTA_R5.md 7660570840229b6fcbe62f0fbb52966d0099d64d7e6f01a739fbf9899293c8e4 docs/FUTURE_ROADMAP.md +44377cbac9131daa3d1c88ccc154c325257767f4c52f3181f61525c7eae00531 docs/ISSUE31_SAMPLING_SIGNATURES.md +b7ecd069d803cae7f86ad0ab89df144b5a5b157c168c73ee2962b47234d4ec0c docs/KJ_PREVIEW_OVERRIDE_V398.md +77c225d1e49e06d00b04acf811177c9a4317e792d4bfe92df539de99420c3563 docs/LOADER_PERSISTENCE_REPAIR.md +b30fe4640359bebfcdeeb94dbeec94cb346c8e3646509e1dcdb87d7021ba04ff docs/N2B_BRANCH_PROVENANCE_CONTRACT_V1.md +994b0b969089247921ca21306496cc1e8e6f729b587a8206b6403e0b7a11734c docs/R0_RUNTIME_CHARACTERIZATION.md +e6b8cc3250776868f473357cd97ce299fcea31ae18b879ec6e6466f47dbf704e docs/R6_NODE_FACADE_DELTA.md +bce0337cce903938b6b8df7f52c5c67e2d0ee14599c693687e4180debc606db2 docs/README_HISTORY.md +9ee92cdd3783e61e3bc71b99d5c0df7dd0a9f129c8a6b37701d7001a4f745e77 docs/README_HISTORY_JA.md +cebf8462681796df807987d8afef2c78abb0953b54b2f5dcd12d583bde0ec806 docs/REGENERATE_INTENT_V396.md +bbe74f802339b758d8874900e2617dd1a46844a58e0f872d95f34b9b40ba20ed docs/RELEASE_NOTES_V3910.md +1e3156127e570f7eeda696cf1143f42a4b3144f3ab3a32c6e2deee2ed9e8e3be docs/RELEASE_NOTES_V395.md +6de7daf79d0cf8e8bf03d01d030bc0db43df454b644c7fb277c4caa53bf0dae4 docs/RELEASE_NOTES_V396.md +8b6f43df28d660e44e6d4bdecd161157091e8f30bd2305c686918d288c9a9f1e docs/RELEASE_NOTES_V397.md +2e1885630db223593acf95c4e6ba0d6db55cf5806601fab94fe3b146307aa89f docs/RELEASE_NOTES_V398.md +49d02b7650d4a542307c9d4189dc217ba1db54c4eac959cc2e2a1ce57b501ae3 docs/RELEASE_NOTES_V399.md +91ee4adf828415e84e2f413e3a4e20dc16356f139e8ef1f6756f584cad04f3c8 docs/REVIEW_RESTORATION_REPAIR.md +93f07aa727b34802bce3d333426b8ba2af522500882a6d222d00cf577ca82e49 docs/SEAM_TEST_SOURCE_JA.md +4546ffb0cbaf270c52d1900908e46bfa2d3c0e2d0035ae5694680890e89aedd8 docs/TEMPORARY_STORAGE_JA.md +4c33d223a77c78e5c74946aa43f537031fd5aa415388d46fed975f9b07d53c3e docs/TIMELINE_VIDEO_EXPERIMENTAL.md +00f88cb57be5e79d9c881671bd13fa154d91843f4c1ae2f2451ee2a73841271d docs/TURBO_SAMPLE.md +92bee3f3c0c340356abdd06b4993fbf2e98cbe57e931f85cbfd11da0f7f87809 docs/USER_GUIDE.md +c3f0753bdae1c54044a6e9ad5770c45e85a306ac9c15cd363790f8625c865f94 docs/USER_GUIDE_JA.md +2c13aefd137db92a3dbf5576e9442d58012b1f0de1240c07d039ceeb702e7c1f docs/V2_1_4_UI_SIMPLIFICATION.md +b08022df068576c759c8bf80ac6b6519693f3c65c917f1822aeb06ea359aa5b1 docs/V2_1_5_UI_SERIALIZATION_STABILITY.md +a032738b0bc5acb136e92d8bf7694643a5f518b9c7fc0fc878d66d81ba8b1b04 docs/V2_1_6_UNIFIED_UI.md +384e3841603f7c6c8286ef147e93aaf7d056a286503a2a4fc21f397e4dec4876 docs/V34_DRIVING_AUDIO_VALIDATION.md +1840c81b4090ff3c86c0c1b0acc2cc10d3d9839e383c81f262a5c59a67504cd6 docs/V35_HIRES_FIX.md +ca9f1aecd1032f0f0b237948c7fc1e4e693440dff35f5f17fd5e6d5ca4dab7f9 docs/V38_BEGINNER_MANUAL_PLAN_AND_CAPTURE_SCRIPT_JA.md +717577efdec5e61600504b77bc2a099ef022c4fe2333e936c3310c7182d8f2a0 docs/V38_OPEN_INTEGRATION_CONTRACT.md +3496636f645b39336fd95a4f21a562810c56f8e1d92fa6eeb1e4b0786ad11b37 docs/V38_RELEASE_AND_MIGRATION.md +4d17d74107e78404b190fec9494b443249e5aff4f58670c50d54dfdfb064334b docs/V39_REFERENCE_INLINE.md +79bf8886f91eb3e8e7e8db8a8093eaa12fbb012b156e8d478de14f089f7c19f4 docs/VALIDATION_JA.md +3fec541a675c1e4e5e287cc8e498036001f34f7a62460321e16f9ba27b5e4c18 docs/VALIDATION_RESULTS.md 9a634b4ff6c9ca98285f6b250402a3d0e67d29f031e134d9bfcab54c119ed337 docs/images/comfyui-manager-h3-continuum.png 6c72d9a9e35648355c4dd4c8f060a6b7667e322f4b6c86690df9d6769ba182b7 docs/images/h3-continuum-advanced.png b9f1dca35706a1cd963ba892d218568ea30173c6cf6a3bdc896f7a2266eb9407 docs/images/h3-continuum-detailed-report.png @@ -73,92 +119,88 @@ a4705ae4b5730d2b43e29fe125a64196a031f14bcfa8702663a17aa89f683d89 docs/images/v3 ae3338f720fc22c05ab4a661c68f9c5dcb20d751a835f0e60d4738333be48e63 docs/images/v39/v39-feature-summary.png 84304d318eea6db3921d366647c6fff9ad488e8c4cfef6ca00988bfd2a6504bc docs/images/v39/v39-reference-images-node.png b765b37502b012b462606c4d2dcef43f13950e5fd682824fb18cdb19d542c121 docs/images/v39/v39-sampler-node.png -77c225d1e49e06d00b04acf811177c9a4317e792d4bfe92df539de99420c3563 docs/LOADER_PERSISTENCE_REPAIR.md -b30fe4640359bebfcdeeb94dbeec94cb346c8e3646509e1dcdb87d7021ba04ff docs/N2B_BRANCH_PROVENANCE_CONTRACT_V1.md -994b0b969089247921ca21306496cc1e8e6f729b587a8206b6403e0b7a11734c docs/R0_RUNTIME_CHARACTERIZATION.md -e6b8cc3250776868f473357cd97ce299fcea31ae18b879ec6e6466f47dbf704e docs/R6_NODE_FACADE_DELTA.md -91ee4adf828415e84e2f413e3a4e20dc16356f139e8ef1f6756f584cad04f3c8 docs/REVIEW_RESTORATION_REPAIR.md -93f07aa727b34802bce3d333426b8ba2af522500882a6d222d00cf577ca82e49 docs/SEAM_TEST_SOURCE_JA.md -4c33d223a77c78e5c74946aa43f537031fd5aa415388d46fed975f9b07d53c3e docs/TIMELINE_VIDEO_EXPERIMENTAL.md -2c13aefd137db92a3dbf5576e9442d58012b1f0de1240c07d039ceeb702e7c1f docs/V2_1_4_UI_SIMPLIFICATION.md -b08022df068576c759c8bf80ac6b6519693f3c65c917f1822aeb06ea359aa5b1 docs/V2_1_5_UI_SERIALIZATION_STABILITY.md -a032738b0bc5acb136e92d8bf7694643a5f518b9c7fc0fc878d66d81ba8b1b04 docs/V2_1_6_UNIFIED_UI.md -384e3841603f7c6c8286ef147e93aaf7d056a286503a2a4fc21f397e4dec4876 docs/V34_DRIVING_AUDIO_VALIDATION.md -1840c81b4090ff3c86c0c1b0acc2cc10d3d9839e383c81f262a5c59a67504cd6 docs/V35_HIRES_FIX.md -ca9f1aecd1032f0f0b237948c7fc1e4e693440dff35f5f17fd5e6d5ca4dab7f9 docs/V38_BEGINNER_MANUAL_PLAN_AND_CAPTURE_SCRIPT_JA.md -717577efdec5e61600504b77bc2a099ef022c4fe2333e936c3310c7182d8f2a0 docs/V38_OPEN_INTEGRATION_CONTRACT.md -3496636f645b39336fd95a4f21a562810c56f8e1d92fa6eeb1e4b0786ad11b37 docs/V38_RELEASE_AND_MIGRATION.md -4d17d74107e78404b190fec9494b443249e5aff4f58670c50d54dfdfb064334b docs/V39_REFERENCE_INLINE.md -79bf8886f91eb3e8e7e8db8a8093eaa12fbb012b156e8d478de14f089f7c19f4 docs/VALIDATION_JA.md -3fec541a675c1e4e5e287cc8e498036001f34f7a62460321e16f9ba27b5e4c18 docs/VALIDATION_RESULTS.md a8c56379abe23b98c8ceed6ea5e60a02ecc3c6d9636232d7371615f4eb306e81 driving_audio.py 6771c9905d35666121c4892d2ec26202505f96d244ce814ad9a87a02878952cd examples/H3_CONTINUUM_V1_WIRING.md +c3cefcdf50df9d6609f583a008453b587c011a0fb41e290d5f1196ce62f58877 examples/H3_CONTINUUM_V2_WIRING_JA.md be419d6c773784823af7b58a3423ef2e21d3cc3e23c40e60e274560895ca034b examples/H3_Continuum_V2_README.txt 4b94f779a98bfc555f6999113a694da07746cc3cf400bfc70ebc580592034d52 examples/H3_Continuum_V2_reference.webp -c3cefcdf50df9d6609f583a008453b587c011a0fb41e290d5f1196ce62f58877 examples/H3_CONTINUUM_V2_WIRING_JA.md 1b2212b7511fac0b63dfa6e9f006cd8644c72d08c6945ab0e4ed0e722c97a730 examples/MiniMax_H3_Continuum_V38X2.json 40199d2500174ba51c040d6983f88d74c4bfbaf19191e728818e6b969b869b0f examples/MiniMax_H3_Continuum_V39.json +705d1141842863b82abe26a8bb015d45eff3bc81ca5bdc53e58b464b743173c0 examples/MiniMax_H3_Continuum_V39_Turbo_Sample.json 68e1a724d3b99458b86b8f643dcb916183e7e8dd12d7b4b3850991feb8077694 examples/settings/recommended_settings_v1.json 5a26408c770381cdb259cb710de7dab12d7ddecca262bdbf35ba1566056050f5 examples/settings/recommended_settings_v2.json b8275c8cecde12aee0418cea456d1e7f4b875cbb1bce32f1f3d9e06a44dd0be1 examples/v2_prompt_list_example.txt 0e59ea821081cb93165aa3f88c6949736dd225837fe1cdcf1173aa5cd54c6d29 examples/v2_prompt_timeline_example.txt -26bbca92b5f7cac4cbde89290b3f801b7a895df76a07493ca6f65c18d5b1154a examples/workflows/MiniMax_H3_Continuum_V38x.json -df4e0e355020d2e731932cff86a4b00932b4f193ec7ed513be0db994ec0e71bb examples/workflows/MiniMax_H3_Continuum_V38x.zip +1b2212b7511fac0b63dfa6e9f006cd8644c72d08c6945ab0e4ed0e722c97a730 examples/workflows/MiniMax_H3_Continuum_V38X2+Decode_Cache_Helper.json +4fa8680037595f55f97715f9a2f63d28f11328a87f5c33c316cc4b0ae817e668 examples/workflows/MiniMax_H3_Continuum_V38X2+Decode_Cache_Helper.zip +1b2212b7511fac0b63dfa6e9f006cd8644c72d08c6945ab0e4ed0e722c97a730 examples/workflows/MiniMax_H3_Continuum_V38X2.json +f3d8dd0f0872afdd97fe24e58b5cb74190d03e3583a66a5d013fee41f6894cda examples/workflows/MiniMax_H3_Continuum_V38X2.zip 171f0b5596724926d1d89fd12a46434f6010f12e651d19865b9b6160a1e9fff6 examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Follow.json e61e45f218609a7ec845d2e8762dfd1efed6c51a398061066d1e51fc93556663 examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Follow.zip 7d6754cfc75599e07046b1949c1723a56f57871ecd5abc9543fcf8b34bca8c04 examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Repeat.json 9b60c8495e3d0e32c2bcd609080342ae19d0fd4c7c0662d5fe32e7fad4a9b41c examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Repeat.zip -1b2212b7511fac0b63dfa6e9f006cd8644c72d08c6945ab0e4ed0e722c97a730 examples/workflows/MiniMax_H3_Continuum_V38X2.json -f3d8dd0f0872afdd97fe24e58b5cb74190d03e3583a66a5d013fee41f6894cda 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 -67e81fbdd4c21a8d64fb3bedb5e495698fc8df5cdd9540c8ef5476caa76119c0 examples/workflows/MiniMax_H3_Continuum_V39_Reference_Inline.json -65689fd800a60ab6939bea020d630616b03a453cf6d48022cd1361992a765abc examples/workflows/MiniMax_H3_Continuum_V39_Reference_Inline.zip +26bbca92b5f7cac4cbde89290b3f801b7a895df76a07493ca6f65c18d5b1154a examples/workflows/MiniMax_H3_Continuum_V38x.json +df4e0e355020d2e731932cff86a4b00932b4f193ec7ed513be0db994ec0e71bb examples/workflows/MiniMax_H3_Continuum_V38x.zip 40199d2500174ba51c040d6983f88d74c4bfbaf19191e728818e6b969b869b0f examples/workflows/MiniMax_H3_Continuum_V39.json f69b734b5bf19fb6db78bbe4737db0bef69c2a6cef2710f28767882ef35ec847 examples/workflows/MiniMax_H3_Continuum_V39.zip +67e81fbdd4c21a8d64fb3bedb5e495698fc8df5cdd9540c8ef5476caa76119c0 examples/workflows/MiniMax_H3_Continuum_V39_Reference_Inline.json +65689fd800a60ab6939bea020d630616b03a453cf6d48022cd1361992a765abc examples/workflows/MiniMax_H3_Continuum_V39_Reference_Inline.zip +705d1141842863b82abe26a8bb015d45eff3bc81ca5bdc53e58b464b743173c0 examples/workflows/MiniMax_H3_Continuum_V39_Turbo_Sample.json +2096e583c6805c0f6f54f76a81e0ed1246325a16d189afba0423fa05e2c19599 examples/workflows/MiniMax_H3_Continuum_V39_Turbo_Sample.zip a344da581b3c2d77558a460d2b5256e6c9a63b5008c98b52999ceda2e0b2b767 graph_contract.py bf0556b076dbaca67c3405a7d86c333ca7fdf3d4381529b0a9edc906519943e9 guide_timeline.py -6e889c42490ccb5f376694b5944c693a84e7febedf38e631d687e96bc1e76376 H3-Continuum-LLM-System-Prompt-v1.zip -144324850d4ba086938da5f4ed7b02ff0668dec554f092695328240e43fec3ec H3-Continuum-Skill-v1.zip 1473c384082700f422f2cf9141e0d012d87d2b43ac8a8a433edc7172e6ca7bf6 hardening.py -33bfd17df1c51c5730ee8007ca3a52e0221d5424b2e86398c50003b9a8f4102c INSTALL_JA.txt 23bddc5a41d2e997f4fbf789c7128e32f4f197f1405b2aef1c76794f57482446 install_windows.bat 12bf572a65d57bbc9a72b459f29691c2057768f4fb7a74f9db87f4775e995bda install_windows.ps1 139546ec1ff459945aa89b50f74b5ee69f62a0e07bbddfcae06936091a409a83 layout_adapter.py -c44abbd789091bbead01250dbd5453e60539d2665c69f162335fdbd2936019c2 LICENSE d3e213005670e94dee33a240349a4d245cf9a3b6602099f11ed30cf5a32e2c21 media.py -52cec83cfffa8d2504c1f64a9614fb59e56b62c4b1f3106fd3b4fa73870ba6e1 metadata.ini +7ad8ea8859b666cb2771f19795ca8c04ab7aafb5c20cff4e80ad17295429ded3 metadata.ini fd23c7f32810788aaaf1709c4959c40ec72303aecc6f6afa5fa68d824cca97a8 minimax-h3-continuum-dance-director.zip d7e613e2cc24110213b477bdd1d390234a41f2af3b1ed006a809066d71d658eb model_patch.py ecb65a5dbf9e1683c5a3cadd82daaea3a90a2b776f6ebabfbe8b07aa93177422 nodes.py -4decb6e44ee6d172352f223abca4c7a8cba2c8ac6ab0f325b8645f60609f60f1 PACKAGE_INFO_JA.txt -069bf25bd44e7b119c285740adf698bbf30d722a9ca636cd78fe06f026b07d67 PACKAGE_VALIDATION.txt +6ba95639b52219fc37b4f51d52cf6879f75c7418a8d8815b3725b3f201a4f1e6 preview_override_provider_public_v1.json +d4cf474cbd1a98867075c45b53b2ab4d47752bb11611c916bac2a6831ca82c0b preview_override_provider_v1.json +3b7e18bd2ba50fd6c8fe71c58ca79a0bf752f362ed78b7357ce1998efc934b4b preview_override_signature.py b470819f16fc179654dc1600721a63f0a5a14e777f4c004d574b499da6886ba5 public_api.py -7ff970c9f50192030a302e4967f1747b373dcf5584e823883ec2cc5f8c1b46a2 pyproject.toml +dc56e02aa94561076bee8a836c268c0e45a8b5248f3b40108bcb740252965ec6 pyproject.toml 94fdc2d545b2d4077a4d70229fd22ba3ccac21d49d1097d2873f76d04e9a3c7a pytest.ini -4adbf81a12fa7c99dc748b4275aeefaa098596bee67eca2d118b15d034fcc211 README_JA.md -6b1732f58c2eb300cd1493b7ecdc450ce23910676793d834453abc1aba39bf7c README.md +caa572ea65dafc86850db99f52433d360ac9c4ab36b854292a3dccd5ba32dc76 reference.py 9539f5cb9fb695841073fa58d9246d5a7410bc372f6cd340378185004dfaf978 reference_audio.py 5cb9bfd6810d3a93a637451980a4cc5c1436e5b84cfd1c7a111cd192e876351b reference_video.py -caa572ea65dafc86850db99f52433d360ac9c4ab36b854292a3dccd5ba32dc76 reference.py -b47df4eb7084237aed3cee27d00704f8349035c6659943adf7cbcc7b86d62832 REGISTRY_MANIFEST.sha256 467edb2c188d024c2392aafe7423b3f835e16b10f570da76e2f7dda8a962c1c5 requirements.txt -1845cbf7ba4d3b35afd087a15f5a4d92dc73d4858e61982f8ccf431a836a22b1 run_storage.py -6056de6c0a5322a8a51ba5a114538dca2ef67788cd1afba10fedd483b95f6afa state_io.py +985e7647bd2626af5df68ca702cf6ebb38cc09f3ffe0e239d3e8ef256352a5d8 run_storage.py +8f786989af6339be8cec8f2bf602da89344cf96202d29c980af5c07175eea3d3 spectrum_provider_v029.json +8cdf37b165eb68462dd7accf4a1fd63043f02479f9c377778fb9d4b6feaddcc6 spectrum_provider_v029_py312.json +0efc8d65cb6f59042457ad843fe1b77a4bee45e59d3732f5c83fbc75a31ae77b spectrum_provider_v1.json +71801234f6d2e08b660803194653821ca648e5b9a0d0c3f138bc7ccc6fe9d8c6 spectrum_provider_v1_py312.json +448213ae7670a6e231f833ca1901ca295eb5f6bfb8983ca37703bdb3fdf15f99 spectrum_signature.py 3a359a0467725cc292ccb4c86cf0c3d30bb6a114d01f5345792b09ea3d45441d state.py +6056de6c0a5322a8a51ba5a114538dca2ef67788cd1afba10fedd483b95f6afa state_io.py +660a9df28c7d62ad383cda5514c48c7efcb3576f435af023040116d533a56563 storage_api.py +517662b104ab1507bb927a39f25b8503f092c2ba4c39bc277379ba9d9e31b334 storage_fs.py +daeda14d9f5338835661e6738e074a3897d936cd847fe3e78519efabbcdfd0ef storage_memory.py +53da3ac42f4a66e8adc4560049c7c8e7ada82599be8c61f0573c234342ca36ed storage_settings.py 43ec4023dc06c941e5d7a04db4b8a89fb58d744ceb986f6eb9bf534d4fdcb87b temporal.py -8a50f5ad8a7f100eb029d74999999270eb52fbffa1be43625150c3b11bf1a72c tests/conftest.py +b2435d87944c3ba8669c81d729e670f1ae78a210114ed864d2acca860529787a tests/conftest.py 7f34c43ea74c43cfc4f9453848c69c8ed7546de5b78c7c7d063d643f2c483c36 tests/decode_cache/conftest.py 8d0cced8c945c4333ef78688b51a988d7e1d560e5f9e6cceec8310b17c98ad53 tests/decode_cache/helpers/cache_process_worker.py a41a4de12e6fe5690845f9f0795fa82c4907f0afe2551034fa2a4c95617ac39c tests/decode_cache/test_adapter_nodes.py 19d47f94ed2bc56d79b4345f820de3cbb3191e47a5034363a141dd7af500408e tests/decode_cache/test_identity.py 549698d35918b611adc4e8f3aa2f0568c19291b4825cc3c593f3f63e77ec5844 tests/decode_cache/test_process_isolation.py 7e627131904dc6d6f58021fad396185c531858b62dd6febf12c3f95fd1391138 tests/decode_cache/test_store.py +38c2dbf1481d6db0afe8554a4b7c9a27c774ce8fbffcc1fcd001d35709695159 tests/fixtures/issue31_local_spectrum_signature.py.txt +cd9f3f070ab8d4486aecb28c9cf51691b02d4dad4ebf0ecb872469b180eccfa7 tests/fixtures/issue31_phase1_model_options.py.txt db08ce77cc5c5835f2403d4d589394090fa5d25ff3b1840312b2808e1bc203b7 tests/fixtures/v38_a3c_selective_refine_saved_workflow.json +82efab13baacb9a229671eda5f4a2d24bb839b160b2bfb40591df51a5ddf80a4 tests/fixtures/v39_sampling_v5/project.json +8b8ca1b0c802d024c6915d903747d8722bea25628369997ab008ff896462b96a tests/fixtures/v39_sampling_v5/revisions/d8352287737286e5/chunks/rev-d8352287737286e5-txn-008f52b93a88461481ead25f91627af0-chunk-0002.safetensors +26e771cffc57f171f4cc4c6859876350bdf717d1e8213fc005343006a34f002f tests/fixtures/v39_sampling_v5/revisions/d8352287737286e5/chunks/rev-d8352287737286e5-txn-9bb0a584b7344342b114bd31b175225c-chunk-0001.safetensors +7bf0cf46f049e072a68e71cf8bbab10aef695f0931b16842a890c084021f5a11 tests/fixtures/v39_sampling_v5/revisions/d8352287737286e5/manifest.json 606b3985f2b644fac40c84de3e08d1453e87a988acca51ce9595516a7c60a577 tests/frontend_decode_cache_helper.mjs 868c613654467c2c739e07de5dd9b4679b36f98cd96d631d91e1d4afe5698cf5 tests/frontend_external_int_size.cjs -a328953818ef9bf43e411331d2289ccf98a7bdd31dd9e1c1af449b4a1b632c9d tests/frontend_reference_images_v39.cjs -751f38be4351d459145beb3a533530e0c667552fe148de2f732efbb04494b660 tests/frontend_review_queue.cjs +8d0ccf5711e1be0bf63b4e02fecb0b37cd88979894d27b89337cda4a6d1c4ec5 tests/frontend_issue30_ui.cjs +d84bc6c8f119de1c06257d1c85f135fbea74dfa075b3b9ac8d86daefcf332490 tests/frontend_reference_images_v39.cjs +c4563a9002cc17310226a27790e0ec8c1770b6525b899f398d44fe93e2b56fc6 tests/frontend_review_queue.cjs +ea47f51abe07e9b2af840272939c0f363369636af30f4c6dffb0bb696b752c8a tests/frontend_storage_settings.mjs 36f74c03a40c4b62b90eede070d976bcd1b7f0ea828983d1e61a6cb6d80a0ea8 tests/helpers/r5_process_crash_worker.py 706029af8c8d979b2b700f5bc2b96a3064fe7c728f487698d9f079abb02e9409 tests/terminal_merge_diagnostics.py 02e6286857353b76080b73928c0d1e7ec48b1ed16339231a4a450743f193315b tests/test_audit_boundary_repairs.py @@ -170,9 +212,13 @@ a328953818ef9bf43e411331d2289ccf98a7bdd31dd9e1c1af449b4a1b632c9d tests/frontend bfcfd77e70711830d087878d78021b754cd7e1ea324d50af0caa72f041b298fc tests/test_easy_load_video.py 72c7a2ce36d8589f1de386805dba9ef1c12a3f99f9cf818e4752d5d26b39d428 tests/test_external_int_size.py 326a97499ffe51935dd3259dbab4ed71fb02955cd3ddb5a52b5c6558a7efc872 tests/test_gpu_diagnostic_runner.py -4926706cb171e4e36e8d7ed46b592b0ed6c9c2e100072feeba497b651e52653b tests/test_issue13_r2_tools.py aaed0385281e1782edc96f1d084fa84bc4e7ec9e0055ec35aaf9a9f8b6e5bfce tests/test_issue13_r25_tools.py ff2e865fb49f0c9f73f3f82eff78ff15373ce8e843514d610b73231dd6217a93 tests/test_issue13_r28_tools.py +4926706cb171e4e36e8d7ed46b592b0ed6c9c2e100072feeba497b651e52653b tests/test_issue13_r2_tools.py +d6b5b969a0c02f1b282da990db3e503e0768747cfac8a4edd32cf8677550e024 tests/test_issue30_frontend.py +6b75fc849ded1b155547b7c371f99f8928bfb180044aa0e98f46e64b1d14d805 tests/test_issue31_attention_signature.py +25683f1e109604807520b85d778947e435aefe68805ce5a1d67c30a3e51dabd8 tests/test_issue31_preview_override_signature.py +0e54b7656568ad01d06251e36b793ce912210b94c7e02f183584461f58a48de1 tests/test_issue31_spectrum_signature.py c058f189d8e58fd48a80c20c0a857969737a8b13960eee60e5c17db2b9288bc1 tests/test_layout_adapter.py a9da2d25e9fc9b87b249274d7bf2ab061d14f5d1e9c482b69d795ba511cdace1 tests/test_loader_store_roundtrip.py ab1ea95e363ad0effb9459bcbe713838f12e3501515871203672ea91e7fd4c32 tests/test_m3_conditioning_display.py @@ -191,9 +237,11 @@ c2560cbafc5962bce5f063e262cf6a173dd8df18f7b58035ec326f616617d61c tests/test_p25 701cb4c8b43719fac054536fc110b82dcb46939d2135d0a99313993abfc5635d tests/test_p32_profile_server_static.py 403a0ff300330ac1f97642bf0681e80b83eec18e8911c03952ddf203ce794e5a tests/test_p46a_reference_video_memory.py 2d16f6de7bcaf1f92718d3719654a746438f6218bba8d25b3632c318a1ab9c98 tests/test_packed_layout_preflight.py +cd53a068ce0df4aa4c242d5ada4609beac0d90d0b9633ada766607ea684c08fc tests/test_preview_reuse_diagnostics.py +3b9f938de680bc8abd61d1373472589df96112c50f2d46eb0f47e26c46c9f49f tests/test_preview_reuse_frontend.py 1ae0369943ba2fb13f21ad0cf56ee58621ba09bf20174379595e157a1775c7fd tests/test_public_api.py 892d3e3e022a527652dd995508c8bbb650c370caf9ee66fa3eb1f7fd288bba38 tests/test_public_workflow_integrity.py -c9ee25a2f188b59f949c27b95a29a467d583a2dfe92d15f17e9961b6ef696380 tests/test_release_metadata.py +988d4f4973410d387ef66f11619021f8548b0447759ae0dae3f559ed5c65f11f tests/test_release_metadata.py 5f6caf1814052798f20571ebb863c098bec23d8f2e091fc1f30ce1ef9c58675a tests/test_review_identity_lifecycle.py 5f7d3e01bc78fa076ecb17f8532b6d3f3137545da4028032ad6769407d80be07 tests/test_review_provenance_reroll.py d5e255a5fdd06ea18e70f4077f855ed2f02664f91caf79b66bfbdf7df44ad07b tests/test_review_rehydration.py @@ -203,11 +251,16 @@ cda09feb111efb8961e56c5f378f7925d63d0143b084c8248a9bc8be7f33ce6f tests/test_run 5f701a84f43a04c85d6f68627defd958e7dc9a1c0023632265dd2b1d19635b87 tests/test_runtime_redesign_r4_coordinator.py 4b03e1a9140ba32b3c24e1a2567ccbe90ecbe54f1b4e1ed760bc45da5fe9fb5b tests/test_runtime_redesign_r5_transactions.py fdaf52fbcaea3f85f4e568f4fbb217d33069d6de8b5537bd97d53fcbc3e169a0 tests/test_runtime_redesign_r6_node_facade.py -d4c53d2c260b635d70fa211029d608f63776e0a56c20253475fa47c58363f8a7 tests/test_state_io.py +dc2f919e8540ad20272cc0bb45072e301a6d7b59e1aca22a5df9d6cf6f5cd720 tests/test_spectrum_portability.py 5af6a16a2337e3483bb0f9197fe04756decd309e4737520c5557b527d68d51bb tests/test_state.py +d4c53d2c260b635d70fa211029d608f63776e0a56c20253475fa47c58363f8a7 tests/test_state_io.py +1bbc7e5755f71d6fdfddcc6dc8337444febee87cb86773835ca6ac6c79d89357 tests/test_storage_api.py +82f049d7e51c8d6c43322ac4e0043d3fee6323c7989a2c446b86a936bd5ce790 tests/test_storage_frontend.py a1f60f01e9d86c1f2a010752612e373e85112c7054ffc31185b9b459eb2b34a5 tests/test_temporal.py +8a512b3afdf394af043a4d6bd7c4fca0c9326e1207930bf5d96b4d0bd7205b4e tests/test_temporary_storage.py 7f518caa4d95fefd9794b7dafdb8b747963c98dad8473be73a00dff65f3c8ea4 tests/test_terminal_merge_diagnostics.py f175e9ebf39d6fcaac578b640422676d7f7a54bfdf0f77ec44a3da6aafefd7cd tests/test_timeline_video.py +9388d33683b63dae2b51955f154d962237ddc93483437fa7c4e3c3165f17dde4 tests/test_v217_stable_facade.py dc8b9cf0e77b4983ee4eecc60f4acde7d0e063f3b7569402feca8a56165107fd tests/test_v2_decoder.py 3cc94a6a7957ef285f58d373fbab001d926d2b43a754d60bb00bfce98675f32d tests/test_v2_prompts.py 424a4b34fb391ff3729b38a9b202e36f5bc8b9689a2a9bbf9589254c6261d9c6 tests/test_v2_registration.py @@ -217,15 +270,13 @@ b42bcc0983147462d96c6b71cc4a38e846995dafa6eebefc3ae0d9bb36caf359 tests/test_v2_ 0b5b20a8318862d167f135720e0489b8d4f93406d67c6646e052e35b03dcb876 tests/test_v2_session.py b5c320279fd38d2038e39951a3d016aa9b80741523d2816e01ceda1bdecb71b8 tests/test_v2_terminal_merge.py e22486ac62c53132c275614e4e161c78e6dce09dd0d1a7cf64f641a3b7052b99 tests/test_v2_widget_migration.py -c5b91ce02d46697be97920883f8c04b73871144210419f84b9c097c91bf41585 tests/test_v217_stable_facade.py -473abac48a57aa5f297c6e141a94de17ddcb9424a8744bae1c46e6a6a734a0ab tests/test_v3_hardening.py -9242f74663ccb04020ad2fb1199990c84433c9b4c5cf0560e93416c7b15e1913 tests/test_v3_physical_decode_groups.py -35b26c8cade7acb2eec35375d7dfa9a4a112f67a5cec6a842d61c69039de0d84 tests/test_v3_video_seam.py 1c84723b0c14f3169760fe1ae95d230416f6e947ada7d97ee890a2da33e9c988 tests/test_v31_run_storage.py 3af78ab85c8e19dee8d0a98bfd11a2c0e88c30d87256da1f9699c49a19a684e9 tests/test_v32_reference.py 43aef01fc587c9f9e87baf312eb4d588975aaaacab161a36bfcb638a4c11e31c tests/test_v34_driving_audio.py aa1f36601489c360d2f1f989c10c5424bd85bd2115df2427afe696758eefd239 tests/test_v34_hybrid_reference.py -f457c3956fc804816783005a2349889796aeb5a6b930f09db0c3f43e051c6e2e tests/test_v35_compact_ui_frontend.py +3e9a79079823bd85b0e8848c8421a71ae7aa6ad2e5d47c05c7a5cc12ef9b2101 tests/test_v351_reference_audio.py +1c317c3443435e71bc3d874d1f1ef80aca6c50263ad5e9e393923ccadd3758f7 tests/test_v351_reference_audio_ui.py +3caacf5234d96b42d708c9a742d1a7f3b4318e208358058156f97cb21b5506ed tests/test_v35_compact_ui_frontend.py 75dbdd0d9694d82fab7da23f5cc03bc118c024abc865f6c282799aa8c57427fc tests/test_v35_conditioning_bridge.py f9e191b2262030f988b6230e2a1f32484df03568fa43ac46d2c34adb61b6dffa tests/test_v35_context_sampler.py 7380c2ea1eeb4fb212ef51ffdf6d14a33132d3ae6d4c7ed5015f28bba6b7e75b tests/test_v35_hires_fix.py @@ -235,8 +286,6 @@ f9e191b2262030f988b6230e2a1f32484df03568fa43ac46d2c34adb61b6dffa tests/test_v35 8ae5173eaec35adf9efcde2c464c95651c848248bdbdd6396ed2e3c3c1ac7965 tests/test_v35_refine_sampling.py 98a9006ebc4cab2b61b38904e0043fab24e088a25b28ffd38012c29991b8550c tests/test_v35_second_pass_contract.py a11956a22f373d96f13b395971f39187d6bb12cdc153ce794b4729d258ce9725 tests/test_v35_second_pass_sampling.py -1c317c3443435e71bc3d874d1f1ef80aca6c50263ad5e9e393923ccadd3758f7 tests/test_v351_reference_audio_ui.py -3e9a79079823bd85b0e8848c8421a71ae7aa6ad2e5d47c05c7a5cc12ef9b2101 tests/test_v351_reference_audio.py 5f70cf8bd5248120ffcbe75ff3a54e23030fa6eb318ab0de6e0b08ee20e25a87 tests/test_v36_chunk_duration.py bf69d1ac3fc30f963b6fed6cbd661f273593904b03275467427a954fbdc0a03f tests/test_v36_masked_video_prefix.py 19631b4abfdf2bd3c187ba4febbd23dd2bc6a0c5027f22c4adb8c1c4f1328926 tests/test_v36_public_sampler.py @@ -255,33 +304,41 @@ bb5a1530c890d357dc48ea74039340d746e876e8f85e06d4d9a19369f8ff5961 tests/test_v38 8fb637f1d61389a86ef545adf35a518a5ae44322655a38fe598fd3b3c8e0a4a9 tests/test_v38_multi_reference_audio.py 623d528a02b6712cba28c374ba3ad979bc84e2ac5318640692589a04ba6ab15f tests/test_v38_open_integration_contract.py 12337a491fa67b38b32aaeb16e0b209393960dbc46db2a8bf968b8c3902855ef tests/test_v38_packed_row_planner.py -94eb249f407bf6858d936721d4a8752c5a95be6fa00dfc7f828b944e53ab1bc7 tests/test_v38_public_surface_cleanup.py +188ec8e125b16d0bec30b63324d23501a3b89578b434f8e7b24a9d8cc43f1640 tests/test_v38_public_surface_cleanup.py 7aebd3668e04233f34c2d94e75d4708cadd64d6882cf77ec59afa0a394dcb006 tests/test_v38_public_workflow.py 14ff6561a127287d0a20887790a978612ef9d291f1d3be7d5e85b37b2c74760e tests/test_v38_ref_encode_cache.py 8b376f45261d045b584f02b4d14cd70c2d6269b9c814d4e62b5c612f6e30e36f tests/test_v38_refine_target.py 03eb5bf6d845b22334fcc800d81b419f1c8d8593fa65a1e0460144456ff2c8ba tests/test_v38_reliability.py aa72293fe5ba6f4499e1ec95aace3b2e94813fa35cf987a767e77bbf2ae525b1 tests/test_v38_resolution_preset.py -2ac395009e49f9554af8d1a251d93fc5d5e7070bf80f5a0b7b3f7e00cde15077 tests/test_v38_review_cache.py +975af1d6dd34e3403b80d3e89d8fc658baa67a34086d40cd05ac10fd92611c51 tests/test_v38_review_cache.py 72a0e3cb334049b66dd36f52c826931067c242fa63557933fd667138b38d6e8d tests/test_v38_review_control.py f62daa235117a3041c66ebb17adedb13c0452c3a2fc0acdd51006d7aa0078a9b tests/test_v38_review_execution_cap.py 3a5e298bc9b0d46e9560e397576352117d6353dd03977ad54fe41e4881c58287 tests/test_v38_review_run_storage.py -2d8b74a56da4c15509ef9ef082f87321182d9d97ca6c417d5a6c055d67a4ee8e tests/test_v38_review_ui.py +259142da88241424afb61228b24306c88c1f99f0924e81595824ba09527e1847 tests/test_v38_review_ui.py 75697036f361a9b8ea74f69b15e408670f686c8c0e8a6c1d48fe059cc837d12a tests/test_v38_selective_second_pass_node.py 8026a241301dfc4de518649305458a538ef17a0b1567b113877a2af377738528 tests/test_v38_temporal_window_refine.py 0b2b1280a1217816984a99c0f948a52a8e2e6fdf924b5c4f2f578719b12b01ed tests/test_v38_video_audio_refine.py 68426689006a4bcdf3ae5b01589abf95c7fd3bf7f541904240412b24c0783fb0 tests/test_v38x2_decode_cache_integration.py -37107bbefa1a8c92abfc286b873efddd9a5feda2d0455e97149cc35a611cabfe tests/test_v39_official_workflow.py +20aff5243985a16550d1084ce20bb35cbb91150290a3514773defc1572a6c3f1 tests/test_v39_official_workflow.py d33a6b53e3d074d5c8a076395b050fa2b6f00e25f222c32bd78e89d3e0d2635e tests/test_v39_r0_fixed_prompt_cache.py +319258798ca198312cf684f369990924657d1af168a148ad34303af31c06a350 tests/test_v39_review_refine_scope.py 68e5ee459f87724712d450d063bb4409cb26dd112b3b62602f1b43c88a3c08fb tests/test_v39_rr_r1_fixed_identity.py 4a97449504c720b0b4846293beb857b48986b3d175215509c144ee1b52c34f23 tests/test_v39_rr_r2_reference_routing.py 32e25a0f4815f954ba3e64e2445309babc83b78a964e2a6a5287b1c7accb275e tests/test_v39_rr_r3_effective_plan.py 6ec7852560f4e0588fc0b5d34743195554475167b46606d3166fdb5fb97f9c4e tests/test_v39_rr_r4_reference_runtime.py ddeb44c42fb3543945d908a66b0557260ce719c002afd5bae0d37794219a8841 tests/test_v39_rr_r4_sequence_integration.py 307993ea60e2265a77ddf709350f51a134fceff6e2b26dcffd893af62162262e tests/test_v39_rr_r5_reference_storage_contract.py -62843c5c4d6150f66f4b232d9ec3c121fef984adfd8f316660be751c7c99ebe7 tests/test_v39_rr_r6_public.py +efe2cc9452f25dfc92f0cbe062d034c74d6121e9671a2ef0a9bb7852aa6a2652 tests/test_v39_rr_r6_public.py +49e525a86e23b26afd1008193aac510812cd2ba330d6b5b52023ab93d662ae27 tests/test_v39_stability_r1.py +b27004f82a3c551926e7e8f5bfa140af1eb2a1cf39ee5660f1d5b2495cf474ed tests/test_v39_stability_r2.py +d2e59eae0a724626b0a4e361921643dd31cb3612ae1f0d1b8b355c9d42c06174 tests/test_v39_stability_r3.py +072091309b35ff5c204c49ed478d9cdcc39d316df15a6209f687b33d13bbf790 tests/test_v39_stability_r4_r5.py +6e3f8a8a0480cc0a87a0ba7d5f79fdc1407233b155d90ff4e4b75aa57988ad49 tests/test_v39_turbo_sample.py +473abac48a57aa5f297c6e141a94de17ddcb9424a8744bae1c46e6a6a734a0ab tests/test_v3_hardening.py +9242f74663ccb04020ad2fb1199990c84433c9b4c5cf0560e93416c7b15e1913 tests/test_v3_physical_decode_groups.py +35b26c8cade7acb2eec35375d7dfa9a4a112f67a5cec6a842d61c69039de0d84 tests/test_v3_video_seam.py 0e02f7db41458fab91e6c3395bdb864d1c033923a3874ff4082d5f85b8230d98 tests/test_video_adapter.py b07b941082a947d9e938ff399ec8b77fcd29c1a222e0e6b0dedf5d8e7482ce84 tests/test_video_reference_modes_experimental.py -0dbe8a5f71c92f3523942343b40787104c8b96781461ba3ba82934a6bdbe5834 THIRD_PARTY_NOTICES.md f218e1a93c42467c6057c5c1d04d57cc82f6331b97ec9257e4e2dfb9c831876a timeline_video.py 0bc369ee428b8a5bc8e370a81fbab427262a1fdb7805a78c442c91698d65efba tools/__init__.py 3d5f29d1e446b94eb16bb02fea98a171c1b29248cbb4de66339030e3a7cea1c3 tools/a2_audio_only_canary_node/__init__.py @@ -290,20 +347,20 @@ f218e1a93c42467c6057c5c1d04d57cc82f6331b97ec9257e4e2dfb9c831876a timeline_video ea0040b510f748bc69f0c8aa4cc6aa1893e292af620ddd6e76e7847dccac1f8c tools/audio_continuity_research_runner.py 2876dc0f2760d6bffb0138ab4d6ef84da6f2db2d726cc442d7a6f732b7bc2061 tools/g4_sampling_diagnostic_node/__init__.py 9062a3b9e2d03551c8e230a34779ccd74b7e9e38aa18d19939900f0072919f82 tools/g4_sampling_diagnostic_node/node.py +0184162bf563e15b2681096732064e265c83696294e248c8a6981beb8255b568 tools/gpu_diagnostic_node/README.md 3c17d031c7f5c2a2449a0fa1e4b955b71663b043f072455350d3d25ee8e1c779 tools/gpu_diagnostic_node/__init__.py 3f9a6fb0d2f78d9b5d771b400d02c1c111a65e55ca6991da0b9dbf641a474aec tools/gpu_diagnostic_node/capture.py f6dcddedf39be823e58dcd034e0fd583116d81f2f827860f714cb11356b9a1a4 tools/gpu_diagnostic_node/continuation_policy.py 92be5f45e1b4b3acf466d2cff24dfa119f64cdbbd5d0e22972c0a7ea9a4e4822 tools/gpu_diagnostic_node/nodes.py -0184162bf563e15b2681096732064e265c83696294e248c8a6981beb8255b568 tools/gpu_diagnostic_node/README.md 5021c682783be19007ecb63775413a1272a246c128c26f314fdaff8acc2bc748 tools/gpu_diagnostic_node/soft_reanchor.py 892804c81c18249348775d233c08508c298edecabc9ff151883053f350c44906 tools/install_gpu_diagnostic_node.ps1 68e3862e52bae7e98ee0db29f9c138db3e21007bbf4e27f1e8407c900a172df4 tools/issue13_drift_analyze.py e922c8737c8e4a1d62299d27391c0496ecec83c0e9f26600b2039f83b8272b18 tools/issue13_drift_gate_runner.py -653d7204e48edef6caec14b57a539b54fe6fd32cb5659c0d7c43726b711a4487 tools/issue13_r2_analyze.py -55caa8df2cd57289bf39c0b9a9a43440e7c3aa2e5bb89176cb5238c15884bd8d tools/issue13_r2_gate_runner.py c315aacb3fbe6dc8a38c50cfb336760ee2fd3c293d80617360c3f3b639ae2053 tools/issue13_r25_gate_runner.py f03916a76a1c1489fd7a23d234a04d0f26fa8afb49a409e0fea779b9fac71a11 tools/issue13_r28_analyze.py ab4b007df62fc09a6d346dcb8c5171c8ea8b6e56e487720ef9fb91ddf19014d3 tools/issue13_r28_gate_runner.py +653d7204e48edef6caec14b57a539b54fe6fd32cb5659c0d7c43726b711a4487 tools/issue13_r2_analyze.py +55caa8df2cd57289bf39c0b9a9a43440e7c3aa2e5bb89176cb5238c15884bd8d tools/issue13_r2_gate_runner.py 2743597d289d9eb12334d1f5cdd630497e237814ddf48b17f6f68da299c01150 tools/p20_file_backed_tensor_poc.py 3bf6dfddb9a0e5276613e505465d0f01442035940c0806a3ca64daf7753a8592 tools/p24_comfy_integration_probe.py 6277e2aad67ddc9b446c9883a33e72b5194a053e5b814a9a935ce7a7770d8793 tools/p25_gpu_acceptance_probe.py @@ -349,14 +406,14 @@ dc2b901789e4b024dbcbc4024c63eb8cbc564d77003ce8c35c0584851ba6dfbd v2/prompts.py be0d8585fa57e0ccd6d02577bbc7299629e5bfe20e186747f571fccc98b67d7e v2/seam_types.py 12cfcc0c71ca087fe39a5ce2922959a62b2bb311bfe664f05c4480affce03708 v2/seeds.py 0de733c55bb61e69d48918eb5bc91318fc7cf3af383fb8937522ced9df018c47 v2/sequence.py -13213e7709fd02bb810af3c18e4cd7d010f8cdfb121a4b99866a9f2333331089 v2/session_io.py 3ea23dbce6fcd217b6e81235855479b9b16fed7a21693cf156f9014555c4fe13 v2/session.py +13213e7709fd02bb810af3c18e4cd7d010f8cdfb121a4b99866a9f2333331089 v2/session_io.py 78c830cdf49034c6e3b2cd3da5914d5cfc5638eb63ec6dbd1bab13c50d6d4caf v3/__init__.py ea2922567df90436dd6fa21696833a49dd0cbfeee142a5fedc3a7c303824d473 v3/adaptive_continuity.py -70bec17d0dce1873b9bb4a51b09daf76833722ce89f005a22b029533a367e62b v3/assembly_v35.py 7815230e0a9540bc2edeaf818e940b7a1fdd817fd217ba8a4f9cb21aaf6a308e v3/assembly.py +70bec17d0dce1873b9bb4a51b09daf76833722ce89f005a22b029533a367e62b v3/assembly_v35.py 3f62fdb35e804f42d7cbf0828b4e87e69a2b99246c3f7467fe4fa698f1d803c9 v3/conditioning_bridge_nodes.py -fa7a355e52fbcfe1f53b16fa1c37af5d839215b49412adb41c90129ae4e9d9f7 v3/driving_nodes.py +6403c2bde3fc0b8cddef78567f663fddb48130628f4c9258fcd679c28fd0cf13 v3/driving_nodes.py 147a1d3fc5e09b323a4c3d13d30e432410389bae52b58330462375b9f307b791 v3/easy_audio_nodes.py 64b3e54b42e5156642f9957ccc374fd190d9fc7145637984e702534fb1bf80b4 v3/easy_image_nodes.py ac859cb1a6e23b8ceae300d818c24fe1346b649a0d663017a9b3ac64aa96fca3 v3/easy_nodes.py @@ -393,14 +450,14 @@ ae909b43ad17934c85881d3b0bea81e7b45c215eeb4d1f9f6a9ea72faf633ddf v3/reliability 3f03d8659305d2def41939205d21cdc6f35e32943274e87afe539d15b9635f9b v3/review_control.py be6610fb9427546d9485a17015cfbdc8786715e6a0967f3e4c1dee35d8768385 v3/runtime_coordinator.py d0a004aa3030c8adaa5ea788f9acc758fcb4a556f203f9a3f63fa4e4b5772063 v3/sampling_engine.py -452022107cea233aa84d5366ec4943ac5aadbd5fcf786113f1d542a641eac8f7 v3/second_pass_nodes.py 97fcb293e0714c3a74b89f08e11c21dce45d25a3010948be1af9dc059d288187 v3/second_pass.py +452022107cea233aa84d5366ec4943ac5aadbd5fcf786113f1d542a641eac8f7 v3/second_pass_nodes.py 6e71e944313339f14e14e11cec682593159ca5542aa5d38095371da781d60224 v3/targeted_refine_sampling.py 5a044bdd70c546e4446e0c26af92aae88049ffa2e0e2d01b52033a83a3152d0e v3/targeted_second_pass.py 26b13614ba0a5fd8b192a106c9503b2f4b6fe7f9268a0fcb0f544979a49cab34 v3/video_adapter_nodes.py -4178dcfa442abdb06ce276e05bd7bcbaa6da28469ba5e57d3da3c663de4e4a9d v3/video_seam_v35.py 2f07ace1462644f0bee553827b3571535de4d0c2d9ef847bd9e0ca73a4eed5cb v3/video_seam.py -c9e03d72565bac7639576474c258ba6fcb0fc73047bd9adb1292bb6ae6db8495 version.py +4178dcfa442abdb06ce276e05bd7bcbaa6da28469ba5e57d3da3c663de4e4a9d v3/video_seam_v35.py +e124ded4bc8ddbf7b432c80d9900e40ee34214327bc6d83bd9fcf95cb55e7169 version.py b935ad3bb729948bb3890ce967b0ecbef737a5e51ddfc47a0060fc20aa78dcda video_reference_modes.py 685df8e0fa23e3663ab31da1e4470cd19bdaa0dc16362cb606e874d9d6153c2c web/decode_cache_helper.js fefafd4550511d80bd85ade46a0476f0cf3de13ddb94a908dff6b175f2a0e199 web/easy_bypass_toggle.js @@ -408,35 +465,13 @@ fefafd4550511d80bd85ade46a0476f0cf3de13ddb94a908dff6b175f2a0e199 web/easy_bypas 9db0aa94f634578a962d5db49e5c70356040a59df968e3a2e531b327a623081f web/easy_load_image.js 35090816ba7470a7255eb85d003b7e79f8a0065982dacf98a18f41c8ebff655d web/easy_load_video.js 0c68d13a1f8beb7431a32b471f8b0612c42fcc4bf72dd97611a025d158008662 web/easy_v38.js -90bef8b7628106fffa95ac1e27e345fa3ccc7203bd2f608497f46b751f9bb850 web/project_id.js +933b5c675294a20ccec263916a1f4453d5b06a530d660ad8e56389d02d7f3023 web/project_id.js ae59273f163a116ece418957c557c4fd8c3285e3c60814679b9361d2e6e6fa02 web/reference_audio_ui.js 46c9f75c9462bf26300332448f4431cca801f38964ca0a49bc2c50a88a7cc40f web/reference_image_ui.js -beea70f6e25e1366aba5e2689c31733478472f207dc50cad1562cd877152e4f9 web/reference_images_v39.js +e99c74b78da1aa18be61cb053fa05e5abd106caa5eb5c814cf585786aae1e7f8 web/reference_images_v39.js +42afab2241d39c1b07ff33d8b1370d4b0f729d81e53b4c99f4bc54c6a96b8800 web/storage_settings.js bf41bf08dd0504eb753fa5781e6c2b8c1285758ad4bb7309975bb9231d5f8e41 web/video_reference_mode_ui.js 2bcf455b4ece8b1861e327f6f9f8a79170e7c77470155aacada52e18438543dd write-h3-v39-reference-prompts.zip +3dfd0e7042070f62b9e78239c0e75d82a7df32098db10832465f3049b7f0b38f write-h3-v39-reference-prompts/SKILL.md a9f7b67bd65a9beda622aa5fdc5f8a2ecae1b58b18690d91fb0107a16a3e384e write-h3-v39-reference-prompts/references/simple-3x5.txt 81d7b4f4da797339b46911bc96d0a3736d70df29e092715c6684bb1786908593 write-h3-v39-reference-prompts/references/structured.md -3dfd0e7042070f62b9e78239c0e75d82a7df32098db10832465f3049b7f0b38f write-h3-v39-reference-prompts/SKILL.md -7fd122ff08232e114a6ef32171217ea6324e980eb7257d560c466b8177a3d3ec audio_compat.py -82efab13baacb9a229671eda5f4a2d24bb839b160b2bfb40591df51a5ddf80a4 tests/fixtures/v39_sampling_v5/project.json -8b8ca1b0c802d024c6915d903747d8722bea25628369997ab008ff896462b96a tests/fixtures/v39_sampling_v5/revisions/d8352287737286e5/chunks/rev-d8352287737286e5-txn-008f52b93a88461481ead25f91627af0-chunk-0002.safetensors -26e771cffc57f171f4cc4c6859876350bdf717d1e8213fc005343006a34f002f tests/fixtures/v39_sampling_v5/revisions/d8352287737286e5/chunks/rev-d8352287737286e5-txn-9bb0a584b7344342b114bd31b175225c-chunk-0001.safetensors -7bf0cf46f049e072a68e71cf8bbab10aef695f0931b16842a890c084021f5a11 tests/fixtures/v39_sampling_v5/revisions/d8352287737286e5/manifest.json -49e525a86e23b26afd1008193aac510812cd2ba330d6b5b52023ab93d662ae27 tests/test_v39_stability_r1.py -b27004f82a3c551926e7e8f5bfa140af1eb2a1cf39ee5660f1d5b2495cf474ed tests/test_v39_stability_r2.py -d2e59eae0a724626b0a4e361921643dd31cb3612ae1f0d1b8b355c9d42c06174 tests/test_v39_stability_r3.py -072091309b35ff5c204c49ed478d9cdcc39d316df15a6209f687b33d13bbf790 tests/test_v39_stability_r4_r5.py -319258798ca198312cf684f369990924657d1af168a148ad34303af31c06a350 tests/test_v39_review_refine_scope.py -8d0ccf5711e1be0bf63b4e02fecb0b37cd88979894d27b89337cda4a6d1c4ec5 tests/frontend_issue30_ui.cjs -d6b5b969a0c02f1b282da990db3e503e0768747cfac8a4edd32cf8677550e024 tests/test_issue30_frontend.py -4546ffb0cbaf270c52d1900908e46bfa2d3c0e2d0035ae5694680890e89aedd8 docs/TEMPORARY_STORAGE_JA.md -660a9df28c7d62ad383cda5514c48c7efcb3576f435af023040116d533a56563 storage_api.py -517662b104ab1507bb927a39f25b8503f092c2ba4c39bc277379ba9d9e31b334 storage_fs.py -daeda14d9f5338835661e6738e074a3897d936cd847fe3e78519efabbcdfd0ef storage_memory.py -53da3ac42f4a66e8adc4560049c7c8e7ada82599be8c61f0573c234342ca36ed storage_settings.py -ea47f51abe07e9b2af840272939c0f363369636af30f4c6dffb0bb696b752c8a tests/frontend_storage_settings.mjs -1bbc7e5755f71d6fdfddcc6dc8337444febee87cb86773835ca6ac6c79d89357 tests/test_storage_api.py -82f049d7e51c8d6c43322ac4e0043d3fee6323c7989a2c446b86a936bd5ce790 tests/test_storage_frontend.py -8a512b3afdf394af043a4d6bd7c4fca0c9326e1207930bf5d96b4d0bd7205b4e tests/test_temporary_storage.py -42afab2241d39c1b07ff33d8b1370d4b0f729d81e53b4c99f4bc54c6a96b8800 web/storage_settings.js -3b45e4b58290504366030988fc4e0294ab6428205d520405c9fd1cb9243efa4f .github/workflows/publish_registry.yml diff --git a/PACKAGE_INFO_JA.txt b/PACKAGE_INFO_JA.txt index 5a7c362..6c410c3 100644 --- a/PACKAGE_INFO_JA.txt +++ b/PACKAGE_INFO_JA.txt @@ -1,10 +1,31 @@ -ComfyUI-H3-Continuum 3.9.4 / 一時ストレージ設定 -パッケージmetadata: 3.9.4(2026-10-13)。公開登録は12ノード。 +ComfyUI-H3-Continuum 3.9.9 — public KJ / Review continuation +CPU 2075 passed / 2 skipped / 2 known xfailed; upstream KJ GPU and installed local-KJ browser Continue PASS. +既存Take・Workflowは維持。更新後は再起動・ブラウザー再読込。旧unsafe/v5は自動変換しません。 +対応条件と検証範囲: docs/RELEASE_NOTES_V399.md / docs/KJ_PREVIEW_OVERRIDE_V398.md -**最新版パッケージは3.9.4です。** 固定版のGitHub配布は下表を参照してください。Registryの公開状態は別に確認します。 +--- Historical package record (unchanged) --- +ComfyUI-H3-Continuum 3.9.8 / KJ Model Preview Override continuation +Full real-Core CPU gate: 1,995 passed / 3 skipped / 2 existing Inspector expected failures / zero unexpected failures and CUDA initialization attempts; the 48 dedicated KJ tests passed without skips. Normal ComfyUI GPU acceptance passed four Core-API Queues: PyTorch and Comfy Kitchen INT8 + the audited local Spectrum implementation, each with separate-Queue Chunk 1 to 2 continuation and held preview images. Both second Queues reused one chunk and generated one; original Chunk 1 bytes and contracts were unchanged. All four video/audio outputs fully decoded. See docs/KJ_PREVIEW_OVERRIDE_V398.md for exact support and limits. +Support: explicitly audited provider only; Preview Override VAE/Audio VAE disconnected, Tiny VAE none, Core NoPreviews/Auto/Latent2RGB. Restart and start a new Run. Old unsafe/v5 Takes and workflow bytes remain protected. + +--- Earlier package validation records (historical) --- + +ComfyUI-H3-Continuum 3.9.6 / Regeneration intent and automatic variations +Full CPU gate: 1,908 passed / 2 skipped / 2 known Inspector expected failures; zero unexpected failures and CUDA initialization attempts. Normal ComfyUI browser save/reload retained Chunk 2 / nonce 5 and Chunk 1 / nonce 0 after history loading. Five new-Run GPU queues passed continuation, Chunk 2 regeneration and two identical Full Run / nonce 0 submissions; earlier Chunk 1 bytes were preserved. GPU scope: PyTorch, Spectrum OFF, 512x512, 8-step Turbo; all five media outputs fully decoded. See docs/REGENERATE_INTENT_V396.md. +Update: restart ComfyUI and refresh the browser; select and save old unmarked Chunk 1 / nonce 0 again. Do not delete Runs/Takes. GitHub Release/Registry upload, service scan approval and Manager installation are separate publication checks. + +--- Previous 3.9.5 package record (historical) --- + +Previous 3.9.5 validation: 1,893 CPU passed / 2 skipped / 2 existing Inspector xfailed / failures 0; CUDA initialization 0. Public Spectrum 0.2.29 PyTorch/Kitchen Chunk 1→2 GPU continuation and full 10-second AV decode PASS. Details: docs/ISSUE31_SAMPLING_SIGNATURES.md + +ComfyUI-H3-Continuum 3.9.5 / Issue #31 保存Take継続 +パッケージmetadata: 3.9.5(2026-10-15)。公開登録は12ノード。 + +**最新版パッケージは3.9.5です。** 固定版のGitHub配布は下表を参照してください。Registryの公開状態は別に確認します。 | バージョン | Release | カスタムノード本体ZIP | SHA-256チェックサム | | --- | --- | --- | --- | +| 3.9.5 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.5) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.5/ComfyUI-H3-Continuum-v3.9.5.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.5/SHA256SUMS.txt) | | 3.9.4 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.4) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.4/ComfyUI-H3-Continuum-v3.9.4.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.4/SHA256SUMS.txt) | | 3.9.3 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.3) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.3/ComfyUI-H3-Continuum-v3.9.3.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.3/SHA256SUMS.txt) | | 3.9.2 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.2) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.2/ComfyUI-H3-Continuum-v3.9.2.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.2/SHA256SUMS.txt) | diff --git a/PACKAGE_VALIDATION.txt b/PACKAGE_VALIDATION.txt index fbd13b8..f0f72d3 100644 --- a/PACKAGE_VALIDATION.txt +++ b/PACKAGE_VALIDATION.txt @@ -1,13 +1,40 @@ -ComfyUI-H3-Continuum 3.9.4 / Registry packaging repair - 2026-10-14 +ComfyUI-H3-Continuum 3.9.9 — public KJ / Review continuation +CPU 2075 passed / 2 skipped / 2 known xfailed; upstream KJ GPU and installed local-KJ browser Continue PASS. +既存Take・Workflowは維持。更新後は再起動・ブラウザー再読込。旧unsafe/v5は自動変換しません。 +対応条件と検証範囲: docs/RELEASE_NOTES_V399.md / docs/KJ_PREVIEW_OVERRIDE_V398.md -Package metadata: 3.9.4. Public registration: twelve nodes. Existing V3.9 +--- Historical package record (unchanged) --- +ComfyUI-H3-Continuum 3.9.8 / KJ Model Preview Override continuation +Full real-Core CPU gate: 1,995 passed / 3 skipped / 2 existing Inspector expected failures / zero unexpected failures and CUDA initialization attempts; the 48 dedicated KJ tests passed without skips. Normal ComfyUI GPU acceptance passed four Core-API Queues: PyTorch and Comfy Kitchen INT8 + the audited local Spectrum implementation, each with separate-Queue Chunk 1 to 2 continuation and held preview images. Both second Queues reused one chunk and generated one; original Chunk 1 bytes and contracts were unchanged. All four video/audio outputs fully decoded. See docs/KJ_PREVIEW_OVERRIDE_V398.md for exact support and limits. +Support: explicitly audited provider only; Preview Override VAE/Audio VAE disconnected, Tiny VAE none, Core NoPreviews/Auto/Latent2RGB. Restart and start a new Run. Old unsafe/v5 Takes and workflow bytes remain protected. + +--- Earlier package validation records (historical) --- + +ComfyUI-H3-Continuum 3.9.7 / External-input regeneration cache +CPU: 1,948 passed / 2 skipped / 2 known Inspector expected failures; zero unexpected failures and zero CUDA initialization attempts. Targeted Core-API GPU queues verified external Chunks=2 / Nonce=0, repeated identical automatic variations 1 then 2, and 1 reused / 1 generated chunk per variation. Browser save/reload and Run-button submissions were checked separately. GPU scope: PyTorch attention, Spectrum OFF, 512x512, 8-step Turbo, two 5-second chunks. This is a targeted cache repair, not general image-quality or all-accelerator acceptance. +Existing workflow and Take files were hash-protected. No storage/schema migration. + +--- Previous 3.9.6 package record (historical) --- + +ComfyUI-H3-Continuum 3.9.6 / Regeneration intent and automatic variations +Full CPU gate: 1,908 passed / 2 skipped / 2 known Inspector expected failures; zero unexpected failures and CUDA initialization attempts. Normal ComfyUI browser save/reload retained Chunk 2 / nonce 5 and Chunk 1 / nonce 0 after history loading. Five new-Run GPU queues passed continuation, Chunk 2 regeneration and two identical Full Run / nonce 0 submissions; earlier Chunk 1 bytes were preserved. GPU scope: PyTorch, Spectrum OFF, 512x512, 8-step Turbo; all five media outputs fully decoded. See docs/REGENERATE_INTENT_V396.md. +Update: restart ComfyUI and refresh the browser; select and save old unmarked Chunk 1 / nonce 0 again. Do not delete Runs/Takes. GitHub Release/Registry upload, service scan approval and Manager installation are separate publication checks. + +--- Previous 3.9.5 package record (historical) --- + +Previous 3.9.5 validation: 1,893 CPU passed / 2 skipped / 2 existing Inspector xfailed / failures 0; CUDA initialization 0. Public Spectrum 0.2.29 PyTorch/Kitchen Chunk 1→2 GPU continuation and full 10-second AV decode PASS. Details: docs/ISSUE31_SAMPLING_SIGNATURES.md + +ComfyUI-H3-Continuum 3.9.5 / Issue #31 Attention and Spectrum identity - 2026-10-15 + +Package metadata: 3.9.5. Public registration: twelve nodes. Existing V3.9 and separate V3.8X2 workflows remain supported without schema migration. Release artifacts and integrity (2026-10-13) -**Latest package: 3.9.4.** Use the fixed-version GitHub downloads below. Registry publication is verified separately. +**Latest package: 3.9.5.** Use the fixed-version GitHub downloads below. Registry publication is verified separately. | Version | Release | Custom-node ZIP | SHA-256 checksum | | --- | --- | --- | --- | +| 3.9.5 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.5) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.5/ComfyUI-H3-Continuum-v3.9.5.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.5/SHA256SUMS.txt) | | 3.9.4 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.4) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.4/ComfyUI-H3-Continuum-v3.9.4.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.4/SHA256SUMS.txt) | | 3.9.3 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.3) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.3/ComfyUI-H3-Continuum-v3.9.3.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.3/SHA256SUMS.txt) | | 3.9.2 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.2) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.2/ComfyUI-H3-Continuum-v3.9.2.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.2/SHA256SUMS.txt) | diff --git a/PROJECT_STATE.md b/PROJECT_STATE.md index a813449..750a9ac 100644 --- a/PROJECT_STATE.md +++ b/PROJECT_STATE.md @@ -1,13 +1,94 @@ # Public source status -Updated: 2026-10-14 (Japan time). +## 3.9.10 — Spectrum reuse and Reference assignment display + +Normalize Spectrum CRLF source auditing and add fixed Python 3.12 profiles while +preserving the existing 3.13 profiles, valid Sampling v6 identities, old Takes +and official workflows. Correct the Reference assignment display for externally +connected Chunks without changing generation count or saved selectors. + +Full local CPU/JS: 2,096 passed / 2 skipped / 2 known expected Inspector failures. +Python 3.12 component: 112 passed / 1 skip; 24 independent storage cases and +actual-JS checks passed. Reference browser checks passed. No new GPU acceptance +is claimed. Restart ComfyUI and refresh the browser; use a new Run for newly +supported configurations. See docs/RELEASE_NOTES_V3910.md. + +## 3.9.9 — KJ Preview Override / Review continuation + +Fix new-Run v6 read-only with the separately audited upstream KJ profile, and +show saved reasons when reuse is unavailable. Keep the original local profile, +Sampling v6 guards, old Takes and official workflow bytes. + +CPU: **2,075 passed / 2 skipped / 2 known expected failures**, plus overlapping +90-case JS coverage. Upstream KJ GPU and normal-ComfyUI browser Continue both +passed: **Chunk 1 preserved, Chunk 2 generated, one reused / one new**; all four +AV outputs fully decoded. Browser checks used the existing local KJ profile. +These are targeted repair checks, not general quality or all-provider acceptance. + +Restart ComfyUI and hard-refresh after updating. On Preview Override, disconnect +optional VAE/Audio VAE and set Tiny VAE `none`; retain generation VAEs. Correct +unsupported settings before starting a new Run. Old unsafe/v5 Takes remain +readable and are not automatically made reusable. No workflow rewiring or Take +deletion is required. [Full release notes](docs/RELEASE_NOTES_V399.md). + + +## V3.9 Turbo Sample on main + +Add the user-supplied sample separately: Auto, 2 x 8s, multiline image-anchored +dance prompt, fixed background/camera, Thai rap and one enabled Turbo LoRA. +Preserve the supplied 6-step/Draft settings and document their unverified pairing +with the 4-step/768p LoRA. Fresh workflow/project IDs avoid user Run identity reuse; +remove misleading auto-download metadata for the saved custom model. Standard +workflows, existing Takes and runtime code stay unchanged. No new GPU validation, +runtime deployment, release or Registry publication is included. + +Updated: 2026-10-16 (Japan time). + +## Japanese README organization (documentation only) + +The Japanese README follows the English quick-start structure. Japanese detail +and images remain in docs/USER_GUIDE_JA.md and docs/README_HISTORY_JA.md. +Downloads, model folders, provider links, history safety and limited acceptance +scope are retained. English documentation, runtime and published assets are unchanged. + +## README organization (documentation only) + +The English README is a compact entry point. Detailed operating instructions and +screenshots remain in docs/USER_GUIDE.md; release and older implementation notes +remain in docs/README_HISTORY.md. Version-specific acceptance statements retain +their historical context. Japanese README, product code, official workflows and +published v3.9.8 assets are unchanged; this is not a new runtime or release version. + +## Published v3.9.8 GPU recheck (2026-10-16) + +The exact published tag `58fbd855` was deployed and restarted in normal ComfyUI; all 464 release files and the live startup/adapter identity matched. Two new Runs / four Core-API Queues passed PyTorch/KJ and Kitchen INT8 + audited local Spectrum/KJ Chunk 1 to 2 continuation, unchanged prefix/contracts and complete AV decoding. Existing Takes/workflows stayed hash-identical. README and docs/RELEASE_NOTES_V398.md record conditions and unverified scope. The later documentation-only main commit does not replace the release tag, GitHub assets or Registry package. + +## 3.9.8 — KJ Preview Override Phase A (2026-10-16) + +A bounded adapter identifies the audited KJ Preview Override source and loaded helpers, preserves fixed settings and wrapper execution order, and excludes its reviewed transient image list. VAE/Audio VAE must be disconnected, KJ Tiny VAE must be `none`, and Core approximate-VAE preview is outside this phase. Unknown implementations remain non-reusable. Sampling v6, old Takes and official workflows are unchanged. Full real-Core CPU gate: 1,995 passed / 3 skipped / 2 existing Inspector expected failures / zero unexpected failures and CUDA initialization attempts; the 48 dedicated KJ tests passed without skips. Normal ComfyUI GPU acceptance passed four Core-API Queues: PyTorch and Comfy Kitchen INT8 + the audited local Spectrum implementation, each with separate-Queue Chunk 1 to 2 continuation and held preview images. Both second Queues reused one chunk and generated one; original Chunk 1 bytes and contracts were unchanged. All four video/audio outputs fully decoded. See docs/KJ_PREVIEW_OVERRIDE_V398.md for exact support and limits. Release and Registry state are verified separately. + +## 3.9.7 — external-input regeneration cache + +Fix automatic Full Run variations when Chunks or Variation Nonce come from external nodes. Unresolved linked inputs no longer let Core skip an explicitly requested regeneration. Earlier accepted chunks, existing Takes, public inputs and official workflows are preserved. Update the custom nodes, restart ComfyUI and refresh the browser; no workflow changes or history deletion are required. See docs/RELEASE_NOTES_V397.md for targeted validation and limits. + +## 3.9.6 — regeneration selection and automatic variations + +Package 3.9.6 preserves saved regeneration selections and routes explicit Full Run automatic variations through Run Storage on every Queue. The full CPU gate and targeted normal-runtime browser/GPU acceptance passed; scope and update steps are in docs/REGENERATE_INTENT_V396.md. Sampling v6 safety, public inputs, official workflows and stored Takes are preserved. Release assets and Registry service status are verified separately. + +## 3.9.5 — Issue #31 Attention and Spectrum identity repair + +Finite loaded-implementation signatures identify the Core PyTorch/Kitchen attention overrides and explicit Spectrum profiles, including upstream 0.2.29. Existing normal v6 contracts without the targeted override remain unchanged; original unsafe/v5 history and official workflows are preserved. Validation and compatibility limits are recorded in docs/ISSUE31_SAMPLING_SIGNATURES.md. GitHub assets and Registry service status are verified separately. ## GitHub and Registry publication status -**Latest package: 3.9.4.** Use the fixed-version GitHub downloads below. Registry publication is verified separately. +**Latest package: 3.9.8.** Use the fixed-version GitHub downloads below. Registry publication is verified separately. | Version | Release | Custom-node ZIP | SHA-256 checksum | | --- | --- | --- | --- | +| 3.9.8 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.8) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.8/ComfyUI-H3-Continuum-v3.9.8.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.8/SHA256SUMS.txt) | +| 3.9.7 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.7) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.7/ComfyUI-H3-Continuum-v3.9.7.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.7/SHA256SUMS.txt) | +| 3.9.6 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.6) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.6/ComfyUI-H3-Continuum-v3.9.6.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.6/SHA256SUMS.txt) | +| 3.9.5 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.5) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.5/ComfyUI-H3-Continuum-v3.9.5.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.5/SHA256SUMS.txt) | | 3.9.4 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.4) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.4/ComfyUI-H3-Continuum-v3.9.4.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.4/SHA256SUMS.txt) | | 3.9.3 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.3) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.3/ComfyUI-H3-Continuum-v3.9.3.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.3/SHA256SUMS.txt) | | 3.9.2 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.2) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.2/ComfyUI-H3-Continuum-v3.9.2.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.2/SHA256SUMS.txt) | diff --git a/README.md b/README.md index 6451014..7d03b76 100644 --- a/README.md +++ b/README.md @@ -1,1631 +1,306 @@ -# DUMAS H3 Continuum Tiled 3.9.4.post1 — V3.9 fork +# ComfyUI-H3-Continuum 3.9.10 — V3.9 -## DUMAS H3 Sequence Prompt Builder +Generate long-form MiniMax H3 video and audio in chunks, review each result, +retry a section, and continue from compatible saved Takes. +**V3.9 is the current workflow; V3.8X2 remains available separately.** -`DUMAS H3 Sequence Prompt Builder` creates the single multiline `STRING` -prompt expected by the Continuum sampler. Its editor provides one tab per -clip and editable local time slots inside each clip. Clip-local times are -flattened to absolute timeline positions when the node executes, so it can be -connected directly to `Sequence Prompt` with `Prompt Format = Timeline` (or -`Auto`). +[Download v3.9.10](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.10/ComfyUI-H3-Continuum-v3.9.10.zip) · +[Release notes](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.10) · +[Checksums](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.10/SHA256SUMS.txt) · +[日本語](README_JA.md) -The node also outputs the project `chunk_count` as an `INT` and the shared -`chunk_duration` in seconds as a `FLOAT`, so downstream nodes can use the same -project dimensions without duplicating the controls. +## 3.9.10 — Spectrum reuse and Reference assignments -All clip tabs use the single `Default chunk duration` control. There is no -per-clip duration because Continuum multi-clip projects are intentionally -uniform; resizing a shot boundary updates its timestamp in the visible prompt -editor immediately. -The final shot is always extended to the end of the track, so adding or -resizing shots cannot leave an unintended unassigned tail. +Fix false Sampling v6 read-only caused by Spectrum source CRLF line endings, +and add separate audited Python 3.12 profiles for the two supported Spectrum +implementations. Existing Python 3.13 profiles and valid Take identities stay exact. +Unknown code or runtime state remains non-reusable. -The editor follows the CSGlide shot-timeline model: one prompt editor per -clip, coloured shot bands, and draggable boundary sliders between shots. Use -the `@ Add shot` button, or type `@` at the start of a new line in the prompt -editor, to create the following timed section quickly. +With external Chunks inputs, the V3.9 Reference Images table shows an assignment +range of 1–16 instead of a stale widget count. This does not change the number +of generated chunks or expand saved selections automatically. -The node keeps the shared visual directive, soundscape, and non-diegetic music -outside the clip tabs. The editor state is stored in a serializable JSON -widget, making saved workflows portable even when the optional browser panel -is unavailable. +CPU/JS: **2,096 passed / 2 skipped / 2 known expected failures**. Separate +Python 3.12 component, storage and actual-JS checks passed. Reference table +browser acceptance passed. **No new GPU acceptance is claimed for 3.9.10.** -The node can also accept up to nine optional reference-image inputs. Each -input has a fixed identity (`Reference Image 1` is always `@R1`, through -`@R9`; the editor displays these as CSGlide-style `@image1`–`@image9` pills). -When an image is connected, the pill includes a thumbnail and inserts the -canonical `@R#` tag at the current caret position. The fourth output is the same typed -`H3_CONTINUUM_REFERENCE_IMAGES_V39` bundle used by the V3.9 sampler. It is -automatically set to `Per chunk`, and only references explicitly mentioned in -each chunk's prompt are assigned to that chunk. References that are connected -but not mentioned remain off for that chunk. Connect this output directly to -the sampler's `Reference Images (Optional)` input instead of adding a separate -Reference Images helper node. +Restart ComfyUI and refresh the browser after updating. Keep existing workflows +and Takes. Start a new Run for a newly supported configuration; old unsafe/v5 +Takes remain readable and are not automatically made reusable. +[Release notes and limits](docs/RELEASE_NOTES_V3910.md). -Example output: +## 3.9.9 — KJ Preview Override / Review continuation -```text -[0-4s] -Preserve the same character and environment. -0-2s: The character walks forward and looks toward the light. -2-4s: The character stops and looks toward the light. -overall_soundscape: Quiet room tone and footsteps. -non_diegetic_music: Low cinematic pulse. +Fix new-Run v6 read-only with the separately audited upstream KJ profile, and +show saved reasons when reuse is unavailable. Keep the original local profile, +Sampling v6 guards, old Takes and official workflow bytes. -[4-8s] -Preserve the same character and environment. -0-2s: Continue seamlessly as the character raises one hand. -2-4s: The character looks toward the camera. -overall_soundscape: Quiet room tone and footsteps. -non_diegetic_music: Low cinematic pulse. +CPU: **2,075 passed / 2 skipped / 2 known expected failures**, plus overlapping +90-case JS coverage. Upstream KJ GPU and normal-ComfyUI browser Continue both +passed: **Chunk 1 preserved, Chunk 2 generated, one reused / one new**; all four +AV outputs fully decoded. Browser checks used the existing local KJ profile. +These are targeted repair checks, not general quality or all-provider acceptance. + +Restart ComfyUI and hard-refresh after updating. On Preview Override, disconnect +optional VAE/Audio VAE and set Tiny VAE `none`; retain generation VAEs. Correct +unsupported settings before starting a new Run. Old unsafe/v5 Takes remain +readable and are not automatically made reusable. No workflow rewiring or Take +deletion is required. [Full release notes](docs/RELEASE_NOTES_V399.md). + +## Getting started video + +[Watch: H3 Continuum V3.9 — Chunks, Prompts & Reference Images](https://youtu.be/AKJxBXaiG6Q) — **12:26**, with English narration, subtitles and chapters. + +The video covers First Image setup, chunk settings, Review/Take retries, +Timeline prompts and Reference Images. For screenshots and every control, +open the [illustrated user guide](docs/USER_GUIDE.md). + +## Install or update + +Use one Continuum installation in `ComfyUI/custom_nodes`. +Models and third-party custom nodes are not bundled. + +### Fixed-version ZIP + +1. Download the **custom-node ZIP** above and optionally verify its checksum. +2. Extract its package folder into `ComfyUI/custom_nodes`. + When updating, replace the existing package; do not leave duplicate copies. +3. Restart ComfyUI and hard-refresh the browser (**Ctrl+F5**). +4. Open a V3.9 workflow below and select your installed models and input files. + +Keep your saved workflows, Run/Take folders and settings when updating. +**Workflow ZIPs contain graphs, not the custom-node installer.** + +### Git or ComfyUI-Manager + +For a new Git installation: + +```bash +cd ComfyUI/custom_nodes +git clone https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum.git ``` -## Dumas per-clip tiled latent upscale +For an existing Git installation: -This fork adds **H3 Continuum Tiled Latent Upscale (Per Clip)**. Connect the -`video_latents`, `assembly_plan`, and `refine_context` outputs from the -Continuum sampler, plus its `model` and `CLIP`, and connect the native -`MMH3 Latent Upscale` and `MMH3 Spatial Split Params` nodes. -Each physical clip is sent through `MMH3UltimateUpscale` independently, with -its own upscale sampler, scheduler, steps, denoise, CFG and seed controls. -The result remains a LATENT list, so clips do not get concatenated into one -larger VRAM allocation before the tiled pass. Temporal length is validated and -cannot silently change. +```bash +cd ComfyUI/custom_nodes/ComfyUI-H3-Continuum +git pull --ff-only origin main +``` -The node consumes `refine_context` directly and internally performs the same -context-to-conditioning adaptation as **H3 Continuum Conditioning Bridge V3.5**. -The separate `conditioning` input is optional for advanced legacy graphs; it is -not needed in the normal Continuum wiring. +If Manager owns your installation, update that copy through Manager. +Restart ComfyUI and refresh the browser after updating. +Registry review, Manager's selected version and GitHub Releases are separate; +the fixed-version links above identify the exact v3.9.9 package. -The recommended production wiring is now the **H3 Continuum Second Pass V3.5** -node with `tiled_upscale = true`. That node receives the main sampler's video -and audio latent lists plus its `refine_context` and `assembly_plan`, rebuilds a -complete AV latent for each physical group, and runs the native tiled upscale -one group at a time. It returns the upscaled video latent list while preserving -the first-pass audio latent list. Connect the latent-upscale and spatial-split -parameter nodes to its optional tiled inputs; its sampler, scheduler, steps, -denoise, CFG and noise seed are independent from the ordinary Second Pass -settings. +The package declares Python **3.10+** and ComfyUI **0.32.0+**. +The minimum declaration is not a GPU acceptance result for every Core version. -The node is an adapter around ComfyUI's native MiniMax H3 tiled-upscale -implementation; it does not include model weights or vendor the upstream -implementation. Install this repository as a normal custom-node folder and -restart ComfyUI after updating it. +## Required model files and extensions -**Latest package: 3.9.4.** Use the fixed-version GitHub downloads below. Registry publication is verified separately. +Download the weights separately from [Comfy-Org / MiniMax-H3](https://huggingface.co/Comfy-Org/MiniMax-H3). +The table follows the **saved V3.9 template selections**; folders are relative to `ComfyUI/`. -| Version | Release | Custom-node ZIP | SHA-256 checksum | -| --- | --- | --- | --- | -| 3.9.4 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.4) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.4/ComfyUI-H3-Continuum-v3.9.4.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.4/SHA256SUMS.txt) | -| 3.9.3 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.3) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.3/ComfyUI-H3-Continuum-v3.9.3.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.3/SHA256SUMS.txt) | -| 3.9.2 | [Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.2) | [ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.2/ComfyUI-H3-Continuum-v3.9.2.zip) | [SHA256SUMS.txt](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.2/SHA256SUMS.txt) | +| Component | File / download | Folder | +| --- | --- | --- | +| H3 diffusion model | [minimax_h3_fl2va_pruned_int8_convrot.safetensors](https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/diffusion_models/minimax_h3_fl2va_pruned_int8_convrot.safetensors) | `models/diffusion_models/` | +| Text encoder | [qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors](https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors) | `models/text_encoders/` | +| Video VAE | [minimax_h3_video_vae_int8_convrot.safetensors](https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/vae/minimax_h3_video_vae_int8_convrot.safetensors) | `models/vae/` | +| Audio VAE | [minimax_h3_audio_vae_fp32.safetensors](https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/vae/minimax_h3_audio_vae_fp32.safetensors) | `models/vae/` | -The original [3.9.2 GitHub source archive](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/archive/refs/tags/v3.9.2.zip) remains available from its unchanged tag. This custom-node package ZIP is distinct from the official workflow ZIPs. +Select the downloaded files in the loaders; set the text encoder's type to `minimax`. +Reselect paths if the saved `minimax/` subfolder differs from your installation. +The Video VAE loader selects INT8, although its older embedded download metadata names FP16; +choose the VAE you actually installed. [Other model variants](https://huggingface.co/Comfy-Org/MiniMax-H3/tree/main/diffusion_models) must match the generation task and loader support. +Quantized variants require compatible Core/GPU support; these selections are not a universal hardware guarantee. +The retained V3.8X2 graph instead saves DasiwaMinimaxH3_dasiwaHybridV2_int8.safetensors and +[FP16 Video VAE](https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/vae/minimax_h3_video_vae_fp16.safetensors). +That custom model is not bundled or supplied by the table above; reselect a compatible H3 model you have installed. -{56C36D94-39EC-4484-9495-5648A1F486F3} - - -## 3.9.4 — Registry packaging repair (2026-10-14) +The complete supplied graph also needs these external node packages: -Include the declared Review restoration guide and exclude repository-only prompt-authoring files from the Registry ZIP. The publishing workflow now builds the actual package and checks its exact file set, CRC and every Registry Manifest hash before uploading. Runtime behavior, twelve public node IDs, workflows and saved Runs/Takes are unchanged. GitHub Releases 3.9.3 and 3.9.2 remain available. +- [Spectrum](https://github.com/xmarre/ComfyUI-Spectrum-MiniMax-H3) — optional acceleration; saved disabled. Its presence does not imply every version is reuse-compatible; see the compatibility table below. +- [KJNodes](https://github.com/kijai/ComfyUI-KJNodes) — supplies the template's H3 SageAttention patch. Follow its attention dependency requirements, or replace/bypass that patch if unavailable. +- [rgthree-comfy](https://github.com/rgthree/rgthree-comfy) — supplies `Power Lora Loader (rgthree)`. -## 3.9.3 — choose temporary storage (2026-10-13) - -Choose where Continuum writes its temporary decoded frames and Finalize buffer. Open **Settings → H3Continuum → Storage → Manage temporary storage**. Enter an absolute folder on the **ComfyUI server**, or choose a server storage candidate, then validate and save. Leave it blank to keep the existing locations. No workflow changes are required; continue using the V3.9 nodes and your 3.9.1 / 3.9.2 workflows. - -- The selected folder applies to **both Finalize and Decode Cache Helper**. It contains a dedicated `h3-continuum-scratch` directory. Saved Runs/Takes and finished videos keep their existing locations. -- The panel shows current and previous locations, temporary file sizes, free space, and files in use or eligible for deletion. **Delete unused temporary files** protects live outputs, Tensor views, active processes and files whose ownership cannot be verified. Deleting a cache can require decoding and writing it again. -- Save or clean only when the running and pending queues are empty. New files use the new location; existing outputs remain valid at their old locations. A missing selected drive does not silently redirect writes to your original SSD. Shared storage controls are read-only in multi-user mode. -- Mode selection stays in the existing nodes: **Finalize: Auto / RAM / Disk-backed**; **Decode Cache Helper: Auto / RAM / Off**. Auto keeps its conservative 4 GiB final-IMAGE threshold and RAM reserve. Manual RAM now checks available memory before allocation; manual Disk-backed checks free space. These checks cannot guarantee against OOM, changing disk usage or a drive disconnect during execution. No new VRAM storage mode is added. - -**Moving storage changes where writes occur, not their total volume.** With only one physical drive, moving to another folder or partition on that drive does not divert its writes. A separate SSD is usually the faster alternative; an HDD can be used but may slow decoding, assembly and saving. If sufficient CPU RAM is available, RAM modes can avoid these scratch writes, but memory pressure can cause paging or OOM. Turning Decode Cache Off does not turn off Finalize's Disk-backed buffer. File-size displays are logical sizes, not physical disk allocation or cumulative SSD writes. Local filesystems are supported; network shares are outside this feature's supported scope. - -Update the custom node package, restart ComfyUI to load the backend, and hard-refresh the browser. Later changes to this storage setting take effect without a restart. Blank settings retain the ComfyUI temp directory for Finalize and `H3_DECODE_CACHE_TEMP_DIR` (or OS temp) for Decode Cache. A selected folder takes precedence over that cache environment variable. - -The storage changes preserve frame dtype, video/audio assembly and generation identity. Validation and remaining platform limits are recorded in [PACKAGE_VALIDATION.txt](PACKAGE_VALIDATION.txt). The implemented settings screenshot appears at the top of this README. GitHub Release and Registry publication status are listed above; neither follows automatically from a source update. - -If the panel reports HTTP 404, inspect the ComfyUI startup log. An old process can keep the chosen address/port occupied, so the updated process fails to start while its new JavaScript is already visible. Stop the obsolete instance or choose another port, then start the updated backend. **Refresh** retrieves storage status; it does not restart ComfyUI. Failed reads now show the HTTP result and keep mutations disabled until status is available. - -## 3.9.2 — Issue #30 frontend hotfix (2026-10-13) - -This hotfix reduces unnecessary Review and Reference Images UI work: - -- Skip upstream Review settings snapshots when no comparison baseline exists. -- Notify connected Samplers once per Reference selection, preserving immediate native values and the original widget callback. -- Skip Reference node resizing when its target dimensions already match its actual dimensions. - -Review monitoring with a baseline and fresh Take/Queue checks remain in place. Sampling, saved Runs/Takes, public node IDs and official workflow bytes are unchanged. Keep using the V3.9 nodes. - -The frontend repair passed **1,703 CPU/JavaScript regression tests, 2 skipped**, with **2 explicit expected failures** for the independent Reference Plan Inspector bug after repeated Sampler configuration. Offline Core registration/planning and isolated Chromium checks passed. Real ComfyUI browser checks for this package are recorded in [PACKAGE_VALIDATION.txt](PACKAGE_VALIDATION.txt); mobile freeze resolution is unconfirmed. Reference table rebuilding and Review snapshots with a baseline remain. No new GPU generation is part of this hotfix's validation. - -After updating, **hard-refresh the browser (Ctrl+F5)** to load the JavaScript. Restart ComfyUI normally to update the displayed package version. A 3.9.1 Run/Take does not require migration for this UI hotfix. Versioned downloads are listed in [GitHub Releases](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases); Registry publication is separate. - -## 3.9.1 — what changed (2026-10-04) - -This patch fixes Second Pass conditioning, Take reuse and Review audio: - -- **Second Pass:** preserve audio-only/mixed keyframes and inherit the verified conditioning and Reference assignments of the actual Review output, including a single middle chunk. -- **Take reuse:** include sampler closures and MODEL CFG/wrappers in compatibility checks to prevent reuse under different generation settings. -- **Review Driving Audio:** cut the source PCM once at the physical group's natural time, with the same start position for Exact ON/OFF. -- **Audio resampling:** prefer ComfyUI Core's standard API, with the legacy fallback for older Core versions. The Reference Encode Cache limitation for direct VAE weight changes is documented below. - -**Updating from 3.9.0:** restart ComfyUI and refresh the browser after updating. Existing v5 Takes and history remain readable and are not deleted, but cannot be reused as prefixes for new v6 generation. Start a new Full Video or choose **Start again from Chunk 1**. Public node IDs, widget order and official workflows remain unchanged; keep using the **V3.9** nodes. - -The repaired code passed **1,696 CPU tests / 1 skipped**, targeted Review Second Pass GPU checks and an integrated generation/reuse check. Browser acceptance remains pending. Optional latent-upscale doubled outlines are tracked separately in [Issue #27](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/issues/27); they are not a required gate for these fixes. This is a main-source update, not a new GitHub Release or Registry publication. - -## 3.9.1 repair details - -Second Pass preserves audio-only keyframes and adapts only the video component of mixed keyframes. Review Driving Audio uses the retained natural frame range of the physical decode group, measured before projection. Exact ON/OFF share that PCM origin. Completely empty Review intervals receive silence for the selected video duration; partially short audio stays short with Exact OFF. - -New generation uses Sampling Contract v6 and Graph Contract v4, including sampler code/closures and MODEL CFG/wrapper settings. Saved v5 Takes, raw tensors and provenance remain readable, but cannot be reused in v6 generation. Start a new Full Video or use Review's **Start again from Chunk 1** to create a new revision. Old Takes remain intact. Unobservable external settings still allow fresh generation with reuse disabled; incompatible explicit Take/Retry requests are not replaced with a different Take. - -Reference/Driving resampling prefers Core's standard API and uses legacy TorchAudio only when that API is absent. Preserved output PCM keeps its original waveform and sample rate. - -**Reference Encode Cache limitation:** direct weight mutation inside the same VAE object is not detected automatically. Call `v3.ref_encode_cache.clear_ref_encode_cache()` afterwards or reload into a new VAE object. Unchanged VAE/input pairs continue to hit the cache. Decode Cache Helper reset affects a separate cache and does not clear Reference Encode Cache. - -This repair stays within V3.9: public node IDs, socket/widget order, official workflows, Run Storage v3 and State/Session formats are retained. LoRA Plan is not included. CPU checks and browser/GPU acceptance are separate. - -V3.9 also projects captured conditioning onto the actual Review output groups before Second Pass. A partial prefix or a single middle chunk can inherit its own conditioning and Reference assignments when the context validates. Full-sequence completion and saved Takes are unchanged; missing or mismatched context keeps the diagnostic prompt-only fallback. - -The repaired runtime passed **1696 CPU tests, 1 skipped**, and three targeted GPU cases at **512×512 / 24 fps**: a two-group partial prefix, Chunk 2 alone, and complete three-group reuse. All groups inherited verified conditioning; saved FLAC matched the corresponding source PCM exactly and existing Takes/raw files were preserved. This validates the targeted repair. Browser acceptance remains pending; optional latent-upscale double outlines are a separate investigation in Issue #27. Historical V3.8 releases and tags remain available unchanged. - -![H3 Continuum V3.9: fixed Reference Image slots, per-chunk assignments, and one Sampler input](docs/images/v39/v39-feature-summary.png) - -*V3.9 is current on `main`: fixed Image 1–9 slots, per-chunk Reference selection, and one Reference Images connection to the V3.9 Sampler.* - -## Getting started video - -[H3 Continuum V3.9 — Getting Started: Chunks, Prompts & Reference Images](https://youtu.be/AKJxBXaiG6Q) (12:26) - -Learn basic First Image setup, chunk settings, Review/Take retries, Timeline prompting, and Reference Images. Includes English narration and subtitles, seven timestamped chapters, version-labeled UI stills, and actual generated examples. - -![H3 Continuum V3.8X2 feature card from its original release](docs/images/v39/v38x2-feature-summary-historical.png) - -*This V3.8X2 card is retained for comparison. Its “CURRENT MAIN” label describes the time it was made; V3.9 is current now. The V3.8 Sampler and V3.8X2 workflow remain available, but their Reference wiring is not automatically converted to V3.9.* - -## External INT Width/Height fix on main (2026-10-01) - -Fixed the visible Width/Height input binding in both V3.8 and V3.9. External INT connections now stay aligned with their displayed controls through workflow save/reload and tab switching. Connected controls are read-only; their displayed numbers are saved Manual reserve values, not a prediction of the upstream node's runtime output. Disconnecting restores local editing. - -To set exact dimensions from Core **Int** nodes, choose **Size Source = Manual** and connect the Width and Height INT inputs. **First Image** still uses the image and Resolution setting; connected dimensions do not override it or automatically change Size Source. If no active First Image is available, the existing Manual fallback applies. Dimension validation and backend input order/defaults are unchanged. - -Validation: **1569 CPU tests passed, 1 skipped**, including 22/22 new frontend regression cases and 60/60 existing Review cases; Chrome save/reload and five tab round trips for both versions. One V3.9 GPU smoke run with external INT values produced exactly **480×640, 96 frames at 24 fps, with 4-second audio** in **107.3 s** (20 sampling steps); the entire saved video decoded successfully. This is a short single-condition check, not long-form or all-model acceptance. Sampling, Run Storage, the earlier Review/cache repairs, official workflow JSONs/ZIPs and historical Releases are unchanged. - -Update Continuum from `main`, then **hard-refresh the browser (Ctrl+F5)** to load the new JavaScript. This fix alone does not require a ComfyUI backend restart; restart normally if the update also brings Python changes or new node definitions. This remains a main-source fix, not a new Release or Registry package. - -## V3.9 performance fix on main (2026-10-01) - -V3.9 could repeat unnecessary prompt-conditioning preparation when **Prompt Format = Fixed** and **no Reference Images are selected**. This repair reuses the existing bounded conditioning cache when its inputs are unchanged. First Image is supported; List/Timeline prompts, selected Reference Images, Reference Audio, Timeline Video and terminal-pair groups keep their existing paths. This is not the Decode Cache Helper and does not skip Sampling. - -In the tested `2 × 5 s`, 480×640 First Image workflow, group preparation fell from about **10.76 s to 0.013 s**. In the post-fix same-session comparison (three measured runs per version, after warm-up), median total time was **273.58 s for V3.8 vs 273.78 s for V3.9**; the ranges overlapped. The earlier roughly 6% gap was no longer observed under these conditions. This does **not** establish a speed fix for every workflow, model or GPU, or a GPU-kernel speedup. - -Update Continuum from `main` and **fully restart ComfyUI** to load the Python changes. Validation: **1558 CPU tests passed, 1 skipped; all 8 GPU generation runs succeeded** on ComfyUI 0.38.0 / RTX 5060 Ti 16 GB. Seeds, chunk/frame contracts, Run Storage, V3.8X2/V3.9 official workflows and ZIPs, and historical Releases are unchanged. This is a main-branch fix, not a new Release or Registry package. - -## Review restoration fix on main (2026-10-01) - -Switching to another workflow and back could hide Review actions even though saved Takes still existed. This frontend repair waits for workflow restoration before reading history and ignores stale results from previous graphs. Real generation-setting changes still disable Review/Take application; restoring the original settings re-enables the actions. - -Update the custom node from `main`, then refresh the browser to load the new JavaScript. Validation: 60/60 frontend regression cases, 108 focused CPU tests, five Chrome tab round trips, and a Chrome Base Seed edit/restore test; saved Take metadata stayed unchanged. Sampling, Run Storage contracts, V3.8X2/V3.9 workflow files and historical Releases are unchanged. GPU continuation was not tested for this repair. [Details and verification limits](docs/REVIEW_RESTORATION_REPAIR.md). - -## Start here: V3.9 and the retained V3.8X2 workflow - -The ComfyUI **Templates → ComfyUI-H3-Continuum** gallery offers two separate entries: the user-selected [V3.9 workflow](examples/workflows/MiniMax_H3_Continuum_V39.json) and [V3.8X2 workflow](examples/workflows/MiniMax_H3_Continuum_V38X2.json). The [V3.8X2 workflow ZIP](examples/workflows/MiniMax_H3_Continuum_V38X2.zip) contains **both unchanged JSON workflows** for one-download setup; the [V3.9 ZIP](examples/workflows/MiniMax_H3_Continuum_V39.zip) contains only V3.9. These are workflow archives, not custom-node installers. The V3.8 Sampler remains available, so existing V3.8X2 workflows still load. V3.9 does not automatically convert their Reference connections or saved Runs/Takes: preserve the old workflow and open the dedicated V3.9 graph for new work. - -The selected V3.9 template has 32 nodes. Image loaders 1–6 are wired to the new helper and bypassed by default; slots 7–9 remain available but require the user to add and connect their own image loaders. Choose actual files and enable only the desired images. The saved size controls are **First Image + Draft — 0.30 MP**, and the separate First Image loader is enabled; select your own First Image file before Queue. The saved 480×640 Width/Height values apply only in Manual mode. `Reference Image Size` is `Match Output`; it resizes conditioning after source-image load, not the source files themselves. For a clear per-chunk Reference test, turn First Image and Last Image off, switch to Manual, and use Reference Images alone. First/Last additionally constrain the video; Last Image may merge the final two logical chunks into one physical group, which requires the same effective Reference set in both. A subject may remain visible in later chunks through video continuity even after its Reference is no longer assigned. - -In the helper, `All chunks` uses connected images throughout; `Per chunk` provides an image-by-chunk table. The template starts in `Per chunk` with all assignments off: after enabling a loader, tick the chunks that should use it. Slot numbers never shift: Image 1 is `@R1` and Image 9 is `@R9`, even when intervening slots are empty. In Sequence Prompt, describe the action for each chunk and use `@R` tags only for active References; their actual `` numbers are resolved per group. Unused tags warn without stopping generation. Start with short chunks and pre-resized images: source images may consume RAM before the Sampler's Reference Image Size setting applies. - -V3.9.3 is the current source version on `main`. Download versioned source from [GitHub Releases](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases); ComfyUI Registry publication is separate. Historical Releases and tags remain available. Configured 1024×1024 Reference-only GPU/API runs succeeded, but the unchanged default template and browser save/reload remain separate acceptance gates. For a reproducible older environment, use the matching historical Release/tag and workflow; the retained V3.8 Sampler on current `main` specifically supports V3.8X2 workflows. - -`pyproject.toml` declares ComfyUI `>=0.32.0`; earlier real-generation/GPU validation used ComfyUI `0.34.2`, and the scoped Fixed cache comparison above used `0.38.0`. The minimum declaration does not establish V3.9 runtime acceptance on 0.32.0. The previous Windows CPU run is `1696 passed / 1 skipped / 0 failed`; the earlier separate Linux rerun report records `1534 passed / 3 skipped / 0 failed` and does not include the new cache or external INT tests. Neither replaces browser save/reload or GPU acceptance for the unchanged official template. - -## V3.9 Reference Images - -### Reference Images node: choose the image for each chunk - -![H3 Continuum Reference Images V3.9 node with fixed image slots and a per-chunk assignment table](docs/images/v39/v39-reference-images-node.png) - -*Example UI, not the downloadable workflow's default assignments.* Image 1–9 are fixed slots: Image 1 is always `@R1`, even when other slots are empty. With `Reference Use = Per chunk`, tick the image/chunk intersections you want; each row's `All` / `Off` buttons select or clear that image across chunks. In this screenshot, Image 1 is assigned to Chunks 1 and 2, while other images have different assignments. The official V3.9 workflow starts with its image loaders bypassed and every assignment unchecked; choose real image files, enable their loaders, then tick the intended chunks. - -### Sampler V3.9: connect the helper once - -![H3 Continuum Sampler V3.9 with one Reference Images Optional input](docs/images/v39/v39-sampler-node.png) - -Connect the helper's green `reference_images` output to the Sampler's single `Reference Images (Optional)` input. The V3.8X2 workflow uses its own V3.8 Sampler and older Reference sockets; opening it does not convert those connections to V3.9. This screenshot shows a **Manual 480×640 example**, not the official V3.9 workflow's saved **First Image + Draft 0.30 MP** setting. `Reference Image Size = Match Output` controls Reference conditioning size after image loading; it does not pre-resize source files or set output resolution. - -V3.9 now connects all nine fixed Reference Images through one **H3 Continuum Reference Images V3.9** node. Its in-node table selects All chunks or specific chunks. The V3.9 Sampler has one typed Reference Images connection and keeps Sequence Prompt, First/Last, Review and the rest of its generation controls. Use `@R1` for Image 1; the backend converts active tags to the group's actual ``. Both modes use the same group-routing engine. - -Prompt parsing never blocks generation. If an explicit Timeline cannot be parsed, the original text falls back to Fixed with diagnostic `H3C-P100`. An uncovered Timeline chunk reuses the previous prompt and reports `H3C-P101`. Select the image for each chunk in the Reference Images node; `@R1`–`@R9` in Sequence Prompt refer to those fixed image numbers. - -For the supplied `2 × 10 s` workflow, put each time header on its own line and describe only that chunk's action. For example, after enabling the matching image loaders and checking their chunk assignments: - -```text -[0-10s] -@R1 walks forward through a quiet hallway. The camera follows smoothly. - -[10-20s] -@R2 enters from the right. The camera turns to follow @R2. -``` - -Use the actual subjects and actions from your images; this is a syntax example, not a saved prompt in the downloadable workflow. Do not place prompt text on the same line as `[0-10s]`: that is not a Timeline header. A Reference can still influence a chunk without an explicit `@R` mention when its checkbox is enabled. - -The [official V3.9 workflow](examples/workflows/MiniMax_H3_Continuum_V39.json) is the latest user-supplied JSON, copied without editing; its [single-workflow ZIP](examples/workflows/MiniMax_H3_Continuum_V39.zip) is also available. It preserves the full V38X2 model/LoRA, Decode Cache, Finalize and Save chain. Six image loaders are prewired (initially bypassed); to use Image 7–9, add `H3 Continuum Load Image` nodes and connect them to the matching helper slots. The Sequence Prompt input remains connected but is intentionally blank: write your own prompt before Queue. The saved graph uses `Timeline`, two 10-second chunks, `Full Run` (displayed as Generate Full Video), First Image + Draft 0.30 MP size selection, and a separate Project ID. The earlier [Reference Inline migration fixture](examples/workflows/MiniMax_H3_Continuum_V39_Reference_Inline.json) remains available unchanged. See the [step-by-step Reference Images guide](docs/V39_REFERENCE_INLINE.md). Replace local media and model filenames as needed before Queue; enabling an image requires choosing a real file. Seven to nine active references can be particularly memory-intensive: start with fewer, smaller source images. A full ComfyUI backend restart and browser hard-refresh are required before the new node definitions appear. Browser save/reload and GPU acceptance of this unchanged default graph are still pending; a GitHub Release does not imply these gates or a Registry package have been completed. - -**Compatibility:** Existing V3.8X2 workflows still use the V3.8 Sampler and old Reference Images 4–9 helper. V3.9 needs its new helper and connection. Open the new V3.9 workflow instead of only changing the Sampler type in an old graph: older V3.9 prototype workflows with direct 1–3 connections and Sampler-side routing widgets need manual rewiring, and their saved widget positions may differ. Accepted V3.8 Runs/Takes are not automatically migrated. Keep a copy of the previous workflow and use a new Run Name for V3.9. - -Earlier browser checks covered the previous V3.9 controls. The new helper has GPU/API execution evidence; its browser save/reload and the unchanged default template's full acceptance are still open. CPU/JS and manifest results are separate; no V3.9 Release/Registry publication is implied. - -**Version boundary:** V3.8X2 package 3.8.3 and V3.9.0 are separate workflows. This update does not create a V3.8X2 or V3.9 GitHub Release, tag, maintenance branch, or Registry version; it does not remove any older Release. The existing [`v3.8.0` tag](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/tree/v3.8.0) remains the reproducible V3.8.0 baseline. - -## 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. The V3.8X2 baseline registered ten node IDs including these two legacy nodes; V3.9 adds the V3.9 Sampler and Reference Images helper as separate IDs, for twelve total. V3.8 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. - - -## Timeline Video — Experimental on main - -The existing video IMAGE input is now displayed as **`Timeline Video Frames`** and has one appended optional control, **`Video Reference Mode`**. Existing workflows and API calls that do not contain the new setting keep the old behavior through the default **`Repeat Reference`** mode. - -- **`Repeat Reference`** keeps the legacy Video Guide contract: each physical generation group receives the same bounded prefix from the source. It does not loop or stretch a short source. -- **`Follow Timeline`** uses the 24 fps source interval corresponding to each physical output group. Continuation-prefix frames are not consumed twice. If the source ends, the remaining groups continue without video reference; a final usable partial interval may receive only H3's short frame-grid padding. - -This setting is independent of `Prompt Format = Timeline`. It does not add a new socket or loader, does not use the source video's audio automatically, and does not provide frame-perfect motion copying. The complete decoded IMAGE batch is still held in system memory, so this feature is not a long-input RAM optimization. - -Use the existing connection: - -```text -Core Load Video -> H3 Continuum Video Adapter -> Timeline Video Frames -``` - -The two comparison workflows are intentionally separate from the unchanged official V3.8X2 workflows: - -- [Follow Timeline JSON](examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Follow.json) | [ZIP](examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Follow.zip) -- [Repeat Reference JSON](examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Repeat.json) | [ZIP](examples/workflows/MiniMax_H3_Continuum_V38X2_Timeline_Experimental_Repeat.zip) - -Local acceptance passed with full CPU `1424 passed / 1 skipped / 0 failed`, browser save/reload, and Follow/Repeat `2 x 5 s` GPU runs at 704x416, 24 fps, 240 frames, and 10-second 32 kHz stereo audio. Follow changed to the later source interval for Chunk 2 while Repeat retained the shared prefix; both completed without OOM, NaN, allocation failure, or crash. Peak observed VRAM was about 15.6–15.7 GiB on the tested RTX 5060 Ti 16 GB system, so 16 GB headroom was small. This is a functional mode-separation result, not a universal speed or subjective-quality guarantee. See [Timeline Video Experimental](docs/TIMELINE_VIDEO_EXPERIMENTAL.md). - -> **V3.8X2** is the product and workflow label for package `3.8.3`. It keeps the V3.8 production sampler and adds optional Reference Images 4–9 plus the built-in Decode Cache Helper. The older V3.8.0 package remains available from tag [`v3.8.0`](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/tree/v3.8.0). - exec-9cfa73b4-c1d3-4416-8950-fa661b946638_2 - - -## Official V3.8X2 workflows - -- **Standard name:** [JSON](examples/workflows/MiniMax_H3_Continuum_V38X2.json) | [ZIP](examples/workflows/MiniMax_H3_Continuum_V38X2.zip) -- **Helper-explicit name:** [JSON](examples/workflows/MiniMax_H3_Continuum_V38X2+Decode_Cache_Helper.json) | [ZIP](examples/workflows/MiniMax_H3_Continuum_V38X2+Decode_Cache_Helper.zip) - -The two V3.8X2 JSON names contain the **same official graph**; they are distribution aliases, not different configurations. Both include the built-in Decode Cache Helper with its saved `Auto / RAM 256MB / Disk 8GB / reset_token 0` settings and the nine-reference helper connection. The standard V3.8X2 ZIP now also contains the separate V3.9 JSON, while the helper-explicit ZIP contains only its correspondingly named V3.8X2 JSON. Older V3.8X workflows remain available for existing projects. - -## Nine Reference Images: memory warning - -Reference Images 1–3 connect directly to the Sampler. Optional images 4–9 connect through `H3 Continuum Reference Images` and then to `Reference Images (Optional)`. Using all nine is a high-resource configuration, not the normal minimum requirement. - -The acceptance run completed on an **RTX 5060 Ti 16 GB / 64 GB system** only after the nine source references were kept near **0.30 MP each**. With `512 × 608` output, `3 × 5 seconds`, Spectrum Off, LoRA Off, Sage Attention, and Balanced 22-frame continuity, Sampling used about **15.0–15.5 GiB of 16,311 MiB VRAM**. There was little 16 GB headroom. - -When using many references, especially all nine, resize copies of the source images to about 0.30 MP before loading or connecting them. The Sampler still performs its normal conditioning resize, but smaller source files reduce input and preprocessing pressure. Larger references, larger output sizes, extra wrappers, or concurrent GPU work may require a higher-spec GPU and more system RAM. Nine references are optional and are not guaranteed to improve quality over three. - -## Built-in Decode Cache Helper - -### Important: this is not an unconditional new-generation speedup - -**Manual cache clear:** normally no action is needed. Press the Helper's "キャッシュをクリア" (Clear cache) button to discard that Helper's cache on the next Queue and run native Decode again. It does not delete immediately or queue automatically. The internal `reset_token` remains serialized for workflow/API compatibility and increments once per click (wrapping to 0 at the INT limit). Creating, loading, or cloning a node does not change it. Without JavaScript, or in API workflows, change `reset_token` through the traditional numeric input. - -**The Helper saves time only when unchanged latents are decoded again. It does not accelerate Sampling.** A first MISS runs native Decode and stores the result; hashing and storage can make that run slower. Generating different latents with a new random seed each time normally produces MISS, so this feature should not be expected to speed up that usage. - -Concrete reuse scenarios: - -- **Continue by adding chunks:** when existing chunk latents are retained and decoded again for output, cached existing chunks can HIT; newly generated chunks initially MISS. -- **Fix / partial regeneration:** unchanged chunk latents can HIT when submitted again; regenerated chunks whose latent contents changed MISS. -- **Complete / Resume output:** decoding retained latents again without resampling can benefit. Merely playing an existing video file is not a cache use case. -- **Retry from Decode onward, or change Finalize/output settings:** reuse applies when the same latents and decode-related metadata reach the Helper and Decode runs again. -- **Regenerate with a fixed seed:** reuse requires identical resulting latent contents. The same seed alone does not guarantee HIT. - -The action names themselves do not enable reuse. **Each Video/Audio entry must match in latent contents, shape, dtype, decode-related metadata, and VAE identity, and its cache entry must still exist in that Helper.** If ComfyUI reuses an existing output without executing Decode, there is no additional Decode saving attributable to this Helper. Connect the Helper and select `Auto` or `RAM`. In its report, `hit` means reuse, `miss` means native Decode, and `off` / `bypass` mean no cache reuse. - -Cache reuse is process-local and does not survive Python restarts. Eviction and VAE identity changes can also cause MISS. Changing mode, RAM/Disk budgets, or `reset_token` clears this implementation's Helper cache. Keeping `reset_token = 0` does not reset it on every Queue. - -V3.8X2 ships `H3DecodeCacheHelper` inside this Continuum package. It remains a separate public node under `MiniMax H3/Continuum/Helpers`; no second custom-node addon is needed. The original nine IDs remain registered for compatibility; the loader migration adds H3ContinuumVideoAdapter. Sampler, Finalize, Assembly Plan, Core Decode, and saved Sampler widget/socket contracts are unchanged. - -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. - -`Auto` caches full physical Video decodes on private process-local disk and small Audio decodes in bounded RAM. `Off` delegates native Decode and clears the Helper cache. Cache failure falls back to native Decode; native Decode, OOM and queue interruption are not retried. Files are not reused across Python restarts. Keep only one provider of the `H3DecodeCacheHelper` node ID: the previous standalone addon must be disabled or removed during the migration, after a verified built-in installation. - -At 736×416 (0.306MP), 3×5 seconds, Euler/simple 6 steps, Turbo FL2V v1.2, a warm backend and three Video HITs, one measured configuration produced a **mechanistic estimate of about 47 seconds / 24.5% less Full Run Total**. One direct A/B pair observed 50.887 seconds / 26.46%, and two Complete/Resume re-decode pairs averaged 46.309 seconds / 79.826% less Total. These are narrow observations, not repeated universal averages or an unconditional 20%+ speed promise. The first MISS can be slower, new Sampling is not accelerated, and a changed latent or VAE identity produces a MISS. - -**Historical V3.8X workflow: [JSON](examples/workflows/MiniMax_H3_Continuum_V38x.json) | [ZIP](examples/workflows/MiniMax_H3_Continuum_V38x.zip)** — [Published releases](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases) - -✅ V3.8X on `main` includes the September 8, 2026 Review hotfix: Review Each Chunk continuation, stale `Regenerate From` state, completed-sequence extension, and Render History queue handling are repaired. Update with `git pull --ff-only origin main` (or ComfyUI Manager **Update**), restart ComfyUI, and hard-refresh the browser if the old UI remains. Existing saved Takes are preserved. Issue #13 remains a separate open long-continuation quality issue and is not part of this hotfix. - - -H3 Continuum is a Production Sampler for generating, reviewing, partially regenerating, and resuming long-form MiniMax H3 video without restarting the entire work. V3.8 has two product layers: **Main / Production** and **Advanced**. - -## Install or update first - -For a new Git installation: - -```bash -cd ComfyUI/custom_nodes -git clone https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum.git -``` - -For an existing Git checkout: - -```bash -cd ComfyUI/custom_nodes/ComfyUI-H3-Continuum -git pull --ff-only origin main -``` - -Restart ComfyUI after cloning or pulling. If ComfyUI Manager installed the node, use its **Update** action instead of mixing Manager updates with a second Git checkout. - -To install the historical V3.8.0 package into a separate checkout instead: - -```bash -cd ComfyUI/custom_nodes -git clone --branch v3.8.0 --single-branch https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum.git ComfyUI-H3-Continuum-v3.8.0 -``` - -Use only one Continuum checkout at a time. ComfyUI Manager **Update** tracks `main`; it does not select historical tags. - -Download the current V3.8X2 workflow: [JSON](examples/workflows/MiniMax_H3_Continuum_V38X2.json) or [combined V3.8X2/V3.9 ZIP](examples/workflows/MiniMax_H3_Continuum_V38X2.zip). The V3.8X2 JSON is one Spectrum-capable graph, also usable with [LightX2V Turbo](https://github.com/ModelTC/Minimax-H3-Turbo); both Spectrum and all Turbo LoRA entries are saved disabled. Install its external Spectrum, rgthree, and KJNodes nodes before opening it. ComfyUI-Easy-Use is not required. See [Spectrum and Turbo setup](#turbo-lora-and-spectrum-in-supplied-workflows) below. - -## Prompt and skill downloads - -- [V3.9 Reference Images prompt skill](write-h3-v39-reference-prompts/SKILL.md) | [ZIP](write-h3-v39-reference-prompts.zip) — for fixed `@R1`–`@R9` image slots and per-chunk assignments. Use it with the V3.9 Reference Images node; it is separate from the general Continuum prompt skill below. -- [LLM system prompt ZIP](H3-Continuum-LLM-System-Prompt-v1.zip) — system instructions and reference material for Continuum prompt authoring. -- [Continuum prompt skill ZIP](H3-Continuum-Skill-v1.zip) — general chunk-aware prompt authoring for Codex and other compatible agents. -- [Continuum Dance Director skill ZIP](minimax-h3-continuum-dance-director.zip) — long-form choreography prompts for one primary dancer, with body and camera continuity across chunks. - -These are optional prompt-authoring resources, not ComfyUI custom nodes. Extract each ZIP and follow its included instructions. They do not change the sampler or guarantee generated motion or image quality. - -## You can ask an AI to read this manual - -This README is intentionally detailed. You do not have to memorize it. Give its GitHub URL or this file to a web-enabled AI, describe your target video, GPU/VRAM, available First Image/audio, and whether you want to review every chunk. Ask it to use the **exact V3.8 labels** below. - -Example request: - -```text -Read the current ComfyUI-H3-Continuum V3.8 README. I have a 16 GB GPU and want -to create a 30-second I2VA video, reviewing every chunk. Tell me exactly which -Continuum inputs and controls to use, what must stay fixed between Queue runs, -and what output length I should expect after each action. Do not use older V3.7 UI. -``` - -AI products, plans, and repository-reading behavior change frequently. If a URL is not read correctly, paste or upload this README instead. Do not send private workflows, local paths, tokens, or credentials to a public AI service. The README and the UI remain the source of truth; an AI summary can still be wrong. - -## V3.8 supported surface - -The V3.8X2 baseline registers ten node IDs, including two deprecated loader compatibility IDs; V3.9 adds a separate Sampler and Reference Images helper. Current official 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** (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 -- **Decode Cache Helper** — the existing optional decoded-result cache - -The current frontend uses `Show Advanced Settings` / `Hide Advanced Settings` to change presentation without changing generation values. Saved drafts that still contain the former frontend-only `H3 Continuum View` property are migrated to the matching collapsed/expanded view and the legacy property is removed. If the frontend extension is unavailable, the complete Python-defined interface remains visible and executable. - -The official V3.8X2 workflow uses the Helper path: - -```text -H3 Continuum Sampler V3.8 - -> Decode Cache Helper - -> H3 Continuum Finalize - -> Create Video - -> Save Video -``` - -The Helper delegates cache MISS entries to native Core Video/Audio Decode. A manually wired direct Core Decode path remains supported, but it has no decoded-result cache. Save and upscaling remain external. Hi-Res Fix is not part of the V3.8X2 standard workflow; use Second Pass as the bridge when an external latent processor or upscaler is needed. External processors may change only Video LATENT spatial geometry while preserving physical groups, B/C/T, finite values, first-pass Audio, and the original Assembly Plan. Finalize accepts public `IMAGE`/`AUDIO` outputs and does not require a specific decoder class. SageAttention, Sol-Attn, and Spectrum remain external MODEL wrappers. See the [V3.8 Open Integration Contract](docs/V38_OPEN_INTEGRATION_CONTRACT.md). - -## Complete V3.8 UI reference - -This section covers every user-facing control and socket on the seven public V3.8 nodes. Names such as `Power Lora Loader (rgthree)`, Spectrum, SageAttention, Core VAE Decode, and Core Save Video belong to ComfyUI or another extension. They may be used in a supplied workflow, but they are not Continuum controls. - -### H3 Continuum Sampler V3.8: required graph inputs - -| Input | What it does | Normal use | -|---|---|---| -| `model` | MiniMax H3 diffusion model, including any upstream MODEL wrappers or selected LoRA | Required | -| `clip` | MiniMax H3 text encoder | Required | -| `video_vae` | Encodes connected image conditioning; Continuum does not use it for final decoding | Required by the node; unused by pure T2VA | -| `sampler` | ComfyUI sampling algorithm | Required | -| `sigmas` | Noise schedule and effective step count | Required | -| `Sequence Prompt` | Complete text, list, timeline, or JSON sequence prompt | Required | - -The Sampler returns six outputs: a list of `video_latents`, a list of `audio_latents`, one `assembly_plan`, a text `status`, the selected `driving_audio` when used, and a `refine_context` for the Advanced Second Pass. Raw latent lists normally go through Core Video/Audio Decode before Finalize. - -### H3 Continuum Sampler V3.8: optional media inputs - -| Input | Role | Important distinction | -|---|---|---| -| `first_frame` | First Image for I2VA or FL2VA | Can also supply the output aspect ratio when `Size Source = First Image` | -| `last_frame` | Optional final-image constraint for FL2VA | Can trigger a Long Terminal Merge; the final pair may become one atomic review unit | -| `reference_image_1`–`reference_image_3` | Ordered appearance, identity, subject, or scene references | They never become the implicit size source | -| `Reference Images (Optional)` | Additional images 4–9 bundled by `H3 Continuum Reference Images` | Empty inputs are skipped; encoding remains in the Sampler | -| `Video Guide Frames` | A video loader's IMAGE frame batch, applied as a persistent guide | It does not carry the source video's audio; frames are interpreted at 24 fps | -| `Driving Audio` + `Driving Audio VAE` | Original audio timeline used as native guide conditioning | The selected source audio becomes final audio; generated audio and Audio Seam are bypassed | -| `Reference Audio (Optional)` + `Reference Audio VAE (Optional)` | Legacy single conditioning-only audio reference | Generated audio remains final audio | -| `Audio References (Optional)` | Ordered bundle from `H3 Continuum Reference Audios` | Do not connect this together with the legacy single Reference Audio path | -| `Still Image Guide (Optional)` | Compatibility socket inherited from the V3.7 guide contract | Experimental; not part of the V3.8X2 official workflow | - -#### First Image, Last Image, and Reference Images - -![First Image enabled and Last Image bypassed](docs/images/v38-manual/first-last-image-bypass.png) - -- **First Image** establishes the opening image and is the normal visual starting point for I2VA/FL2VA. It is also the only media input that can drive `Size Source = First Image`. -- **Last Image** constrains the sequence ending. Leave it `OFF` for T2VA and ordinary I2VA. With a connected Last Image, extending or regenerating the sequence may rebuild the terminal pair. -- **Reference Images 1–9** guide identity or appearance throughout generation. Inputs 1–3 remain on the Sampler; optional inputs 4–9 are on `H3 Continuum Reference Images`, connected to the Sampler's `Reference Images (Optional)` socket. The helper only bundles images: resizing, hashing, and VAE encoding remain in the existing Sampler path. Empty slots are skipped; Picture numbers follow active slot order after any First/Last Image. Existing three-loader templates still work unchanged. - -Saved workflows with the earlier direct image 4/5 inputs migrate those links into a bundle after graph loading. Migration preserves the original source links and only removes a legacy input after its new link is verified. If a source is unavailable or its destination is occupied, the legacy link is retained with a warning. Old API prompts remain accepted; supplying both legacy and bundle images for the same slot is an explicit input conflict. - -![Three optional Reference Image loaders](docs/images/v38-manual/reference-images-three-bypass.png) - -Every `H3 Continuum Load Image` has `Enable Image`. `ON` loads through ComfyUI Core. `OFF` uses native node bypass and makes that optional path behave as unconnected without deleting the node or cable. First, Last, and up to nine Reference Image inputs can therefore be connected without forcing every input to be active. An empty image bundle returns no reference and does not change the zero-to-three-image sampling/reuse contract. - -| Public loader | Controls | Outputs | -|---|---|---| -| `H3 Continuum Load Image` | `Enable Image`, `image` file | `IMAGE`, `MASK` | -| `H3 Continuum Load Audio` | `Enable Audio`, `audio` file | `AUDIO` | -| `H3 Continuum Load Video` | `Enable Video`, `Video` file, `Force Rate` | `images`, `audio` | - -#### Video, audio, and their bypass switches - -![Continuum Video and Audio loaders with Enable controls](docs/images/v38-manual/input-video-audio-bypass.png) - -- `H3 Continuum Load Video`: `Enable Video`, `Video`, and `Force Rate`. `Force Rate = 0` uses source FPS; a positive value drops/duplicates frames to that rate while preserving nominal duration and audio. Connect `images` to `Video Guide Frames` when visual video guidance is wanted. Connect `audio` to `Driving Audio` only when the source audio should guide and become the final output. -- `H3 Continuum Load Audio`: `Enable Audio` and the audio file. Use it for Driving Audio or Reference Audio according to the socket you connect. -- The node titled `Audio Switch` in the example image is ComfyUI Core's `If/Else Switch` (`ComfySwitchNode`); `Fast Groups Bypasser (rgthree)` belongs to the rgthree extension. Neither is a Continuum node or a requirement of Continuum. The Continuum loaders already provide their own native ON/OFF controls. - -`Audio Continuity` is different from both audio inputs: it passes the previously generated audio context into the next generated chunk. It does not import a source track. Driving Audio replaces final generated audio; Reference Audio only conditions generation. - -### Main Sampler controls - -| Displayed control | Meaning | Recommended starting point | -|---|---|---| -| `Prompt Format` | `Auto`, `Fixed`, `List`, or `Timeline` interpretation of `Sequence Prompt` | `Auto` unless you need to force one parser | -| `Continuity` | Prior Video context retained at each chunk boundary | `Balanced — 22 frames` for Standard audiovisual continuation | -| `Base Seed` | Base for deterministic per-chunk seed derivation | Keep the value unchanged when continuing, comparing, or selecting Takes | -| `Control After Generate` | What ComfyUI does to `Base Seed` after a Queue | `fixed` for `Review Each Chunk`, resume, and controlled comparisons | -| `Audio Continuity` | Carries generated-audio context across boundaries | `true` for normal audiovisual generation | -| `Chunks` | Planned total chunk count, from 1 to 16 | Enter the final total, not the number to add next | -| `Seconds per Chunk` | Duration shared by every chunk | 5–15 seconds is the validated range; see duration notes below | -| `Total Length` | Read-only `Chunks × Seconds per Chunk` | Check only; it never edits either input | -| `Size Source` | `First Image` or `Manual` output geometry | First Image for I2VA/FL2VA; Manual for T2VA or exact dimensions | -| `Resolution` | First-Image sizing preset | `Draft — 0.30 MP` for tests, `Balanced — 0.60 MP` for more detail, or `Native 768` for the H3-native short edge | -| `Custom MP` | Custom First-Image pixel budget | Visible only when `Resolution = Custom` | -| `Width` / `Height` | Exact output canvas in 32-pixel steps | Visible/editable only in Manual mode; 32–16384 is accepted | -| `Run` | `Generate Full Video` or `Review Each Chunk` | Use Review when you want a human decision after each physical group | -| `Progress` | Saved raw chunks, safe resume, and Take history | Review turns it On automatically; enable it for resume/regeneration | -| `Ready to Queue` | Plain-language summary of the next Queue | Read it before pressing ComfyUI's top-right blue `Run` button | -| `Show Advanced Settings` / `Hide Advanced Settings` | Shows or hides technical controls | Visibility only; it does not change their values | - -`Continuity = Balanced — 22 frames` with `Continuation Backend = Standard` and `Audio Continuity = true` uses the current Masked AV route. `Fast — 5 frames`, `Strong — 39 frames (Experimental)`, and `Auto — conservative` safely resolve to the older Reference Context route while generated-audio continuity is on. With Audio Continuity off, Standard uses the Video-only masked route. - -#### Choose First Image sizing or Manual sizing - -![First Image sizing with Draft 0.30 MP](docs/images/v38-manual/sampler-size-first-image-draft.png) - -`Size Source = First Image` preserves the connected First Image aspect ratio. `Resolution` then chooses its pixel area: - -| Preset | Target | -|---|---| -| `Draft — 0.30 MP` | Fastest and lowest-memory First Image starting point | -| `Balanced — 0.60 MP` | More detail with greater memory and processing cost | -| `Native 768` | 768 px short-edge target with a 1344 px long-edge cap | -| `Custom` | `Custom MP` selected by the user; separate from the Native 768 cap | - -![Size Source First Image tooltip](docs/images/v38-manual/size-source-first-image-tooltip.png) - -`Size Source = Manual` ignores the preset and uses exact Width/Height values. Both must be multiples of 32. Manual is the normal choice for T2VA and also supports a 32×32 diagnostic canvas when only generated audio is being checked. - -![Manual Size Source with explicit Width and Height](docs/images/v38-manual/size-source-manual-640.png) - -If First Image mode is selected but no usable First Image reaches the Sampler, V3.8 uses the stored Manual Width/Height as a safe fallback and reports the dimensions in `status`. Select `Size Source = Manual` to inspect or edit those values; Width/Height are hidden in the First Image facade. Reference Images and Video Guide never become implicit size sources. The historical `Auto / Landscape / Portrait / Square` values are migration/API compatibility values, not current Main choices. - -Size selection is built into the V3.8 Sampler. A separate megapixel, empty-latent, or image-size node is not required for the normal Continuum workflow. - -#### Choose a chunk duration - -- **5 seconds** is a valid H3 duration and the fastest practical choice for workflow checks, Review UI checks, and quick Takes. -- **8–10 seconds** usually reduces the number of handoffs while keeping each Queue easier to review and rerun. -- **15 seconds** is the [upstream MiniMax H3 native maximum per generation](https://github.com/MiniMax-AI/cli/blob/main/skill/h3-video/SKILL.md) and minimizes the number of boundaries, but it increases per-chunk time and memory. Longer is not automatically higher quality. -- Continuum accepts 4–30 seconds for compatibility and experimentation. Values above 15 seconds are not the same as an upstream native-duration recommendation and can be expensive at high resolution. - -For an audio-only listening diagnostic, use T2VA, `Size Source = Manual`, and a very small canvas such as 32×32, then play the saved video and ignore its picture. This is useful for hearing music or boundary continuity; it is not evidence of normal-resolution video quality. - -### Advanced Sampler controls - -| Control | When it appears | Meaning | -|---|---|---| -| `Continuation Backend` | Advanced open | `Standard` is the V3.8 path; `Compatibility` restores the older Reference Context route for comparison | -| `Regenerate From` | Advanced open and Progress On | `Auto` resumes the longest compatible prefix; `Chunk N` reuses earlier chunks and rebuilds N through the target | -| `Variation Nonce` | Explicit `Regenerate From = Chunk N` | `0`: automatic variation selection with interrupted-run resume; `1` or higher: a fixed variation value. Base Seed and the other generation settings stay unchanged | -| `Run Name (Optional Override)` | Advanced open and Progress On | Stable name for resume and Render History; blank uses the Sampler's automatic identity | -| `Reference Image Size` | Advanced open and a Reference Image connected | `Match Output` is practical; `Max Identity` preserves more reference detail and may use more memory | -| `Video Guide Size` | Advanced open and Video Guide connected | `Efficient — 0.4 MP`, `Balanced — 0.6 MP`, or `Match Output` | - -Frontend-managed IDs, selected Take IDs, one-shot review actions, diagnostics, preview, and legacy compatibility values are deliberately not editable as ordinary node widgets. The corresponding settings or action buttons below are the supported interface. - -### Review-state controls - -When `Run = Review Each Chunk`, `Progress` is On, and a review unit is ready, the settings view changes to this action view: - -| Button | What the next top-right ComfyUI `Run` does | -|---|---| -| `Use it and continue` | Accepts the current result, reuses it, and generates one next physical group | -| `Try this chunk again` | Keeps the earlier accepted prefix and creates another Take of the current review unit | -| `Start again from Chunk 1` | Selects a fresh branch from Chunk 1 with current settings and automatic variation; press Queue afterward. Saved Takes are kept. The selection resets to Auto after Queue | -| `Use it and finish the rest` | Accepts the current result and generates every remaining group without further review pauses | -| `Back to Settings` | Shows the normal settings; does not queue, reset, or discard the review | -| `Return to Review` | Returns from settings to the pending review; does not undo edited values | -| `Render History — N Takes` | Opens or closes stored Take browsing; N is Take count, not chunk count | -| `Previous Take` / `Next Take` | Changes the selected stored Take only | -| `Use This Take` | Makes the selected Take canonical on the next Queue; no new sampling is required | -| `Continue From Here` | Branches from the selected Take and generates the next review unit | - -The action button selects intent and gains a `✓`; it does not start generation. Press ComfyUI's top-right blue `Run` button afterward. Full step-by-step examples begin in [Review, continue, and revise a chunked video](#review-continue-and-revise-a-chunked-video). - -### H3 Continuum Reference Audios - -`H3 Continuum Reference Audios` bundles up to three standalone audio references behind one `Audio References (Optional)` Sampler socket. Connect the references without gaps and use `