docs: reconcile 3.9.1 package validation and historical guides

This commit is contained in:
ukr8b3g-cmyk
2026-10-04 20:16:55 +09:00
parent 94eaf70d67
commit 120ca6c9ea
7 changed files with 194 additions and 7 deletions
+4 -4
View File
@@ -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
+46
View File
@@ -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は維持)
+62
View File
@@ -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
+1 -1
View File
@@ -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.
+2 -2
View File
@@ -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
+1
View File
@@ -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.
+78
View File
@@ -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. インストール検査