From 120ca6c9ea8923e33e0bdb335205c2dc23de5d6a Mon Sep 17 00:00:00 2001 From: ukr8b3g-cmyk Date: Sun, 4 Oct 2026 20:16:55 +0900 Subject: [PATCH] docs: reconcile 3.9.1 package validation and historical guides --- MANIFEST.sha256 | 8 ++--- PACKAGE_INFO_JA.txt | 46 ++++++++++++++++++++++++ PACKAGE_VALIDATION.txt | 62 ++++++++++++++++++++++++++++++++ PROJECT_STATE.md | 2 +- REGISTRY_MANIFEST.sha256 | 4 +-- WORKLOG.md | 1 + docs/VALIDATION_JA.md | 78 ++++++++++++++++++++++++++++++++++++++++ 7 files changed, 194 insertions(+), 7 deletions(-) diff --git a/MANIFEST.sha256 b/MANIFEST.sha256 index dc73e27..e8f828b 100644 --- a/MANIFEST.sha256 +++ b/MANIFEST.sha256 @@ -89,7 +89,7 @@ ca9f1aecd1032f0f0b237948c7fc1e4e693440dff35f5f17fd5e6d5ca4dab7f9 docs/V38_BEGIN 717577efdec5e61600504b77bc2a099ef022c4fe2333e936c3310c7182d8f2a0 docs/V38_OPEN_INTEGRATION_CONTRACT.md 3496636f645b39336fd95a4f21a562810c56f8e1d92fa6eeb1e4b0786ad11b37 docs/V38_RELEASE_AND_MIGRATION.md 4d17d74107e78404b190fec9494b443249e5aff4f58670c50d54dfdfb064334b docs/V39_REFERENCE_INLINE.md -1f5d49944c6b1dd0ff1c2edd1fcb54b6c2698f0b8cba85f5f59425c80df18460 docs/VALIDATION_JA.md +e558a7d2282873437ed6f704eb9991ff5fb5f3c2b60d9f9891058efd2824d8a4 docs/VALIDATION_JA.md 3fec541a675c1e4e5e287cc8e498036001f34f7a62460321e16f9ba27b5e4c18 docs/VALIDATION_RESULTS.md a8c56379abe23b98c8ceed6ea5e60a02ecc3c6d9636232d7371615f4eb306e81 driving_audio.py 6771c9905d35666121c4892d2ec26202505f96d244ce814ad9a87a02878952cd examples/H3_CONTINUUM_V1_WIRING.md @@ -131,8 +131,8 @@ ad0835f8fb6d171d8ff8d7295fb48291abc93ef02fd46a2e283265c15b93366a metadata.ini fd23c7f32810788aaaf1709c4959c40ec72303aecc6f6afa5fa68d824cca97a8 minimax-h3-continuum-dance-director.zip d7e613e2cc24110213b477bdd1d390234a41f2af3b1ed006a809066d71d658eb model_patch.py ecb65a5dbf9e1683c5a3cadd82daaea3a90a2b776f6ebabfbe8b07aa93177422 nodes.py -99405e4357a143b0f5d0b374c9c0d2089435a7055bea2f3d1216dbbad25e4339 PACKAGE_INFO_JA.txt -ea64b8e0aa0dda828047c9c12818be8554429774049b9e8c0482c84b9c4f4071 PACKAGE_VALIDATION.txt +1568dc8a5b5d8678f69846252ea10dbd33f7226f533c7767384516bdb8004fab PACKAGE_INFO_JA.txt +e98b150a8587fd67df53c0962ea86232eede355450c621f20fbb6d7ec9018ac7 PACKAGE_VALIDATION.txt b470819f16fc179654dc1600721a63f0a5a14e777f4c004d574b499da6886ba5 public_api.py 1047d05b0aedc405e3a36ee571a8939111d69bb5565e09a3e1caa3c40bf33170 pyproject.toml 94fdc2d545b2d4077a4d70229fd22ba3ccac21d49d1097d2873f76d04e9a3c7a pytest.ini @@ -141,7 +141,7 @@ b470819f16fc179654dc1600721a63f0a5a14e777f4c004d574b499da6886ba5 public_api.py 9539f5cb9fb695841073fa58d9246d5a7410bc372f6cd340378185004dfaf978 reference_audio.py 5cb9bfd6810d3a93a637451980a4cc5c1436e5b84cfd1c7a111cd192e876351b reference_video.py caa572ea65dafc86850db99f52433d360ac9c4ab36b854292a3dccd5ba32dc76 reference.py -afbcf643d9caf65ad05c6711650f5ebc7c973989e5b0da01e5038abbbfb61a4c REGISTRY_MANIFEST.sha256 +ad043fb5b30e68c2c330beb9689b06d56286f5e696b522f7b8f95617b7869058 REGISTRY_MANIFEST.sha256 467edb2c188d024c2392aafe7423b3f835e16b10f570da76e2f7dda8a962c1c5 requirements.txt 1845cbf7ba4d3b35afd087a15f5a4d92dc73d4858e61982f8ccf431a836a22b1 run_storage.py 6056de6c0a5322a8a51ba5a114538dca2ef67788cd1afba10fedd483b95f6afa state_io.py diff --git a/PACKAGE_INFO_JA.txt b/PACKAGE_INFO_JA.txt index 0db19a8..dacc451 100644 --- a/PACKAGE_INFO_JA.txt +++ b/PACKAGE_INFO_JA.txt @@ -1,3 +1,49 @@ +ComfyUI-H3-Continuum 3.9.1 / V3.9安定化修正・V3.8X2併存 +パッケージmetadata: 3.9.1(2026-10-04) + +現行パッケージ: +- 公開登録は12ノード。引き続きSampler V3.9/Reference Images V3.9を使う。 +- V3.8X2は別Workflowとして維持。旧Run/TakeやReference配線を自動移行しない。 +- Second Passの音声のみ/複合キーフレーム、途中Reviewの条件・Reference継承を修正。 +- Sampling Contract v6/Graph Contract v4でSamplerやCFG/wrapperも照合する。 +- Review Driving Audioを元physical groupの自然時間から一度だけ切り出す。 +- Core標準resampleを優先。同一VAE内部の重みを直接変える場合はキャッシュの + 明示的クリア、またはVAE再読込が必要。 +- 公開Node ID、widget順、公式Workflow、Run Storage v3、State/Session形式を維持。 +- Experimental LoRA Plan/V4.0は含まない。 + +更新時の注意: +ComfyUIを再起動し、ブラウザーも更新する。旧v5 Takeと履歴は読めて削除されないが、 +新しいv6生成の前半には再利用できない。新規Full Video、または +「Start again from Chunk 1」で開始する。 + +検証と公開: +- 実Coreの全CPU: 1,696成功/1スキップ/失敗0。CUDA初期化0回。 +- 実CoreのRelease準備確認: 66成功。文書・Manifest確認: 9成功。 +- 公開CI: 1,676成功/21スキップ/失敗0。実Coreが必要な18件と、既存環境制約3件。 + 実Coreの1696件をCIでも実行したという意味ではない。件数を単純合算しない。 +- 対象GPUの途中Review/Chunk単独/完了経路と生成・Take再利用確認は成功。 +- ブラウザー受入と無改変公式Workflow全体の受入は別途必要。万能な画質・速度・ + アクセラレータ互換性のPASSは宣言しない。 +- GitHub Release v3.9.1は公開済み。文書訂正はmainへの後続更新として扱い、 + 公開済みtagは保持する。Registry公開は別作業で、今回は未実施。 +- Manifestは開発429件/Registry payload 144件。任意LATENT拡大の問題はIssue #27。 + +公式V3.9 Workflow: +MiniMax_H3_Continuum_V39.json/同名ZIP。32ノード/39リンク。 +画像Loader 1~6は初期Bypass、7~9は必要に応じて追加する。Sequence Promptは空欄。 +初期設定はFirst Image+Draft 0.30 MP、2×10秒、Generate Full Video。 +Queue前にモデル・画像・プロンプトを自分の素材へ設定する。Reference-onlyなら +First ImageをOFFにしてManualへ切り替える。Workflow ZIPはノード本体の +インストーラーではなく、モデル・素材も含まない。 + +現行手順: README_JA.md、docs/VALIDATION_JA.md、PACKAGE_VALIDATION.txt。 + +====================================================================== +以下は旧3.9.0および過去版の履歴。バージョン、公開状態、検証条件は当時の記録であり、 +現在の3.9.1の導入案内・受入結果ではない。 +====================================================================== + ComfyUI-H3-Continuum 3.9.0 / V3.8X2併存 パッケージmetadata: 3.9.0(mainソース。新しいGitHub Release/Registry公開は未実施。過去のReleaseは維持) diff --git a/PACKAGE_VALIDATION.txt b/PACKAGE_VALIDATION.txt index 84f4356..63386ca 100644 --- a/PACKAGE_VALIDATION.txt +++ b/PACKAGE_VALIDATION.txt @@ -1,3 +1,65 @@ +ComfyUI-H3-Continuum 3.9.1 / V3.9 stability validation - 2026-10-04 + +Current package metadata: 3.9.1. Public registration: twelve nodes. +The V3.9 Sampler and Reference Images helper retain their public IDs and +official workflows; V3.8X2 remains a separate workflow. LoRA Plan / V4.0 is +not included. Run Storage v3 and State/Session formats are unchanged. + +Repair scope +- Preserve audio-only/mixed Second Pass keyframes; spatially adapt video only. +- Match partial/middle-chunk Review conditioning and References to the actual + output physical groups, retaining Terminal Merge groups as atomic units. +- Use Sampling Contract v6 / Graph Contract v4 for Take compatibility, + including sampler closures and MODEL CFG/wrapper settings. +- Crop Review Driving Audio once from the original physical-group time range. +- Prefer Core audio resampling. Direct weight mutation inside the same VAE + object requires explicit Reference Encode Cache clearing or VAE reload. + +Recorded validation (separate environments; do not add these counts) +- Full CPU with real ComfyUI Core: 1,696 passed / 1 skipped / 0 failed. + CUDA initialization attempts: zero. +- Release preparation with real Core: 66 passed / 0 skipped / 0 failed. +- Standalone dependency check: 48 passed / 18 skipped / 0 failed. +- Release document/manifest checks: 9 passed / 0 failed. +- GitHub Actions at release commit 94eaf70d674a58244e1cb139f021290d63fb2e6c: + 1,676 passed / 21 skipped / 0 failed. Eighteen cases require real Core and + are explicitly skipped without it; three retain existing environment or + fixture limits. This is not 1,696 real-Core cases executed in CI. +- Offline native PackedLayout, Fixed 3x5-second planning and twelve-node + registration passed. +- Targeted GPU partial-prefix, single-middle-chunk and complete-sequence + Review Second Pass checks passed at 512x512 / 24 fps, including conditioning + inheritance, source-PCM alignment and saved Take/raw preservation. +- Integrated generation and Take-reuse GPU checks passed for the repaired + runtime. These are targeted results, not universal quality/accelerator gates. + +Current manifests declare 429 development files and 144 Registry payload +files. Hash integrity does not establish semantic freshness of every document. +The official V3.9 workflow retains 32 nodes / 39 links, the original JSON +bytes and matching workflow ZIP. Models/media are not included. + +Publication and remaining gates +- GitHub Release v3.9.1 is published. Its tag remains fixed at the release + commit above; later documentation corrections are follow-up main updates. +- Registry publication is separate and has not been performed for this patch. +- Browser save/reload acceptance and full acceptance of the unchanged default + workflow remain separate gates; do not infer them from CPU or targeted GPU + results. Record the tested workflow and runtime when completing them. +- Optional latent-upscale doubled outlines remain separate in Issue #27. + +Updating: restart ComfyUI and refresh the browser. Old v5 Takes/history remain +readable and are not deleted or rewritten, but cannot supply prefixes to new +v6 generation. Start a new Full Video or Start again from Chunk 1. Continue +using the V3.9 nodes. + +See README.md, README_JA.md and docs/VALIDATION_JA.md for current instructions. + +====================================================================== +Historical V3.9.0 main-source record - 2026-09-29 +The original record below is retained as history. Its metadata, test counts, +manifest counts and publication status do not describe package 3.9.1. +====================================================================== + ComfyUI-H3-Continuum 3.9.0 / V3.9 main-source validation — 2026-09-29 Status: MAIN SOURCE PUBLICATION. The ComfyUI_W worktree has 12 public node IDs: the diff --git a/PROJECT_STATE.md b/PROJECT_STATE.md index 4dfe809..04aa52e 100644 --- a/PROJECT_STATE.md +++ b/PROJECT_STATE.md @@ -31,4 +31,4 @@ Run Storage v3 and State/Session formats are retained. Unknown upstream settings - Optional latent-upscale doubled outlines are tracked separately in [Issue #27](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/issues/27). - Versioned source downloads are listed in GitHub Releases. Registry publication is separate, and Release publication does not complete the pending acceptance gates. -See README.md, README_JA.md and CHANGELOG.md for user instructions and repair details. +See README.md, README_JA.md and CHANGELOG.md for user instructions and repair details. Current package records are in PACKAGE_VALIDATION.txt and PACKAGE_INFO_JA.txt; docs/VALIDATION_JA.md separates the current acceptance procedure from historical V2 instructions. Follow-up documentation corrections on main retain the published v3.9.1 tag. diff --git a/REGISTRY_MANIFEST.sha256 b/REGISTRY_MANIFEST.sha256 index ad79adb..3af445f 100644 --- a/REGISTRY_MANIFEST.sha256 +++ b/REGISTRY_MANIFEST.sha256 @@ -45,8 +45,8 @@ d3e213005670e94dee33a240349a4d245cf9a3b6602099f11ed30cf5a32e2c21 media.py ad0835f8fb6d171d8ff8d7295fb48291abc93ef02fd46a2e283265c15b93366a metadata.ini d7e613e2cc24110213b477bdd1d390234a41f2af3b1ed006a809066d71d658eb model_patch.py ecb65a5dbf9e1683c5a3cadd82daaea3a90a2b776f6ebabfbe8b07aa93177422 nodes.py -99405e4357a143b0f5d0b374c9c0d2089435a7055bea2f3d1216dbbad25e4339 PACKAGE_INFO_JA.txt -ea64b8e0aa0dda828047c9c12818be8554429774049b9e8c0482c84b9c4f4071 PACKAGE_VALIDATION.txt +1568dc8a5b5d8678f69846252ea10dbd33f7226f533c7767384516bdb8004fab PACKAGE_INFO_JA.txt +e98b150a8587fd67df53c0962ea86232eede355450c621f20fbb6d7ec9018ac7 PACKAGE_VALIDATION.txt b470819f16fc179654dc1600721a63f0a5a14e777f4c004d574b499da6886ba5 public_api.py 1047d05b0aedc405e3a36ee571a8939111d69bb5565e09a3e1caa3c40bf33170 pyproject.toml 0b7cd2a93c820955d1dc22f5a22d83ee25bf43bac67900b223fcddc6971f4cef README_JA.md diff --git a/WORKLOG.md b/WORKLOG.md index d204807..763f957 100644 --- a/WORKLOG.md +++ b/WORKLOG.md @@ -13,5 +13,6 @@ - Mark the eighteen real-Core integration cases as dependency skips in standalone CI when ComfyUI Core is absent. They still execute with Core installed; broken Core dependencies remain test failures. Production code is unchanged. - Release-preparation checks for the affected tests and package metadata: 66 passed with real Core; 48 passed / 18 dependency skips without Core. Both CPU gates had zero CUDA initialization attempts. - GitHub Actions confirmed 1,676 passed / 21 skipped / no failures in standalone CI. Eighteen skips require real Core; the remaining three reflect existing platform/fixture limits. Prepare the versioned GitHub Release with English/Japanese repair and migration notes; Registry publication remains separate. +- Reconcile PACKAGE_VALIDATION.txt, PACKAGE_INFO_JA.txt and docs/VALIDATION_JA.md with package 3.9.1, the actual CPU/CI scopes, v5 migration and Release status. Retain the original V3.9.0/V2 text under explicit historical sections. Documentation corrections follow the fixed v3.9.1 release tag on main; runtime and official workflow bytes are unchanged. Earlier product behavior is described in CHANGELOG.md and the historical Release/tag versions. This log contains public engineering summaries rather than private operational records. diff --git a/docs/VALIDATION_JA.md b/docs/VALIDATION_JA.md index 88af334..a1cf99e 100644 --- a/docs/VALIDATION_JA.md +++ b/docs/VALIDATION_JA.md @@ -1,3 +1,81 @@ +# H3 Continuum 3.9.1 — 検証手順と受入範囲 + +現行版はパッケージ3.9.1、公開12ノードです。引き続きV3.9ノードを使用します。 +旧版の検証手順は末尾に履歴として残しています。 + +## CPU・登録確認 + +リポジトリのルートで、ComfyUIに使用しているPythonを指定して実行します。 + +```powershell +powershell -ExecutionPolicy Bypass -File tools/validate.ps1 ` + -Python "path/to/ComfyUI/venv/Scripts/python.exe" ` + -ComfyRoot "path/to/ComfyUI" +``` + +pytestが実Coreを必要とするケースまで実行したかは、結果のスキップ理由と +使用したCore環境を確認してください。`-ComfyRoot`はruntime verifierへの指定で、 +この指定だけでpytestのCore import環境を設定するわけではありません。 +Coreがないstandalone環境では、実Core依存18件を明示的にスキップします。 +Core内部の依存エラーや計算エラーをスキップで隠す設計ではありません。 + +記録済みの結果は環境別です。実Coreの全CPUは1,696成功・1スキップ、公開CIは +1,676成功・21スキップです。CIの21件は実Core依存18件と既存環境制約3件です。 +詳細・対象コミットは[PACKAGE_VALIDATION.txt](../PACKAGE_VALIDATION.txt)を参照し、 +異なる環境の件数を単純合算しないでください。 + +## 実ブラウザー受入 + +生成中のワークフローを再起動・置換せず、実行中と待機中のキューが空の状態で +検証用Workflowを使用します。元Workflowと採用済みTakeを先に保存してください。 + +1. 実backendの`object_info`で公開12ノードの登録を確認します。 +2. V3.9公式Workflowを開き、モデル・素材・Promptを検証用に設定します。 +3. 別名保存→再読込→別Workflowタブへ移動→戻る、を実際の画面で確認します。 +4. 外部INTのWidth/Height接続、Reference割り当て、Decode Cache Helper設定が + 保存・復元されていることを確認します。 +5. 保存済み履歴のReviewとTake選択が表示されることを確認します。 +6. Second Passの接続・設定が保存・復元されることを確認します。実際の生成完走、 + 条件継承、音声一致は次のGPU Gateで別途確認します。 + +Canvasの表示だけ、API登録だけ、DOM代替のJSテストだけで、保存・再読込の +実ブラウザーPASSとはしません。検証用Workflowの合格も、無改変公式Workflowの +初期設定でのGPU受入とは区別します。 + +## 修正対象のGPU Gate + +- R1/Review Second Pass: audio-only/mixed keyframes、partial prefix、 + 中央Chunk単独、complete sequenceを確認します。出力group自身のconditioning、 + Referenceのlogical chunk対応、First Pass Audio passthroughを記録します。 +- R2: 同一v6条件は前半を再利用し、Sampler/CFG/wrapper等が異なる条件では + 誤再利用しないことを確認します。旧v5履歴は読めてもv6へ継ぎ足しません。 +- R3: 識別できるDriving Audioで、元physical groupの自然時間に対応するPCMを + Exact ON/OFFとも一度だけ切り出すことを確認します。 +- 保存済みTakeのJSON/raw、動画と音声の尺、CUDA/OOM/NaN、残留キューも記録します。 + +対象修正のGPU確認は記録済みですが、ブラウザー受入、無改変公式Workflow全体、 +全アクセラレータ構成や総合画質の受入まで済んだとは扱いません。 +任意LATENT拡大の二重輪郭は[Issue #27](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/issues/27) +として分けて扱います。 + +## 更新と旧Take + +更新後はComfyUIを再起動し、ブラウザーも更新してください。旧v5 Takeは保持・閲覧 +できますが、新しいv6生成の前半としては再利用できません。新規Full Video、または +**Start again from Chunk 1**で開始します。旧manifestを新契約へ書き換えません。 +同一VAEオブジェクトの重みを直接変更した場合は、Reference Encode Cacheを +明示的にクリアするか、VAEを再読込してください。 + +GitHub ReleaseとRegistry公開は別作業です。公開済みv3.9.1 tagは保持し、後続の +文書訂正はmainで参照してください。 + +--- + +## 履歴:V2専用の旧検証手順 + +以下は当時の記録です。V1/V2ノード数、`strict_compatibility`、旧Session再開手順を +3.9.1の現行仕様や受入結果として使用しないでください。 + # H3 Continuum Join 2.0 — 実機検証 ## 1. インストール検査