Squashed 'vendor/dumas_h3_continuum/' content from commit d07ed31

git-subtree-dir: vendor/dumas_h3_continuum
git-subtree-split: d07ed31b442d283d6a1740f875a843b9feda4c91
This commit is contained in:
2026-10-20 13:43:38 +00:00
commit bf8f76505f
481 changed files with 131517 additions and 0 deletions
+246
View File
@@ -0,0 +1,246 @@
# H3 Continuum 3.9.3 — 検証手順と受入範囲
現行版はパッケージ3.9.3、公開12ノードです。引き続きV3.9ノードを使用します。
旧版の検証手順は末尾に履歴として残しています。
## 3.9.3 一時ストレージ
保存先切替、参照中のTensor/viewと削除、owner不明・別プロセス保護、RAM/ディスク容量確認、実HTTPの設定APIをCPUで検証します。実ブラウザーでは設定画面の保存・再読込・削除・繰り返し開閉と既存Workflowの読込を確認します。検証件数と実行したプラットフォームはPACKAGE_VALIDATION.txtに記録します。実H3の長尺GPU生成・速度・SSD寿命の確認とは区別します。
## 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内部の依存エラーや計算エラーをスキップで隠す設計ではありません。
3.9.2のFrontend修正の実Core CPUは1703成功・2スキップ・2期待失敗です。
期待失敗は、独立したInspector再configure問題の2条件を追跡します。
公開候補の最終試験・CI・実画面の記録はPACKAGE_VALIDATION.txtを参照してください。
以前の3.9.1の結果は環境別です。実Coreの全CPUは1,696成功・1スキップ、公開CIは
1,676成功・21スキップです。CIの21件は実Core依存18件と既存環境制約3件です。
詳細・対象コミットは[PACKAGE_VALIDATION.txt](../PACKAGE_VALIDATION.txt)を参照し、
異なる環境の件数を単純合算しないでください。
## Issue #30の限定ブラウザー確認
GPU生成を行わず、分離した検証WorkflowでReference単体・Sampler単体・接続時を
比較します。無操作、パン/ズーム、連続チェック、All/Off、複数helper/Sampler、
接続変更、Chunks縮小・復元、native値の保存・再読込を確認します。
Review比較基準がある場合は上流widget/接続/Bypassの変更と元に戻す操作、
最新設定でのTake/Queueガードを確認します。Inspector再configure問題は別件です。
実モバイルの解消確認、既存実Runの採用・生成確認とは区別して記録します。
## 実ブラウザー受入(全体の確認項目)
生成中のワークフローを再起動・置換せず、実行中と待機中のキューが空の状態で
検証用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受入とは区別します。
## 以前の3.9.1生成修正の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、残留キューも記録します。
以前の3.9.1対象修正の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公開は別作業です。公開版はGitHub Releasesで確認し、
過去のv3.9.1 tagも保持します。3.9.1からのUI hotfixではRun/Takeの移行は不要です。
---
## 履歴:V2専用の旧検証手順
以下は当時の記録です。V1/V2ノード数、`strict_compatibility`、旧Session再開手順を
3.9.2の現行仕様や受入結果として使用しないでください。
# H3 Continuum Join 2.0 — 実機検証
## 1. インストール検査
ComfyUIを終了後、展開フォルダーで実行します。
```powershell
.\install_windows.bat
```
または:
```powershell
$ComfyRoot = "path/to/ComfyUI" # 使用中のComfyUIの場所へ置き換える
& "$ComfyRoot/venv/Scripts/python.exe" `
.\tools\verify_runtime.py `
--comfy-root $ComfyRoot
```
確認項目:
- native H3 API
- Sol-Attn形式の`*args/**kwargs` PackedLayout wrapper互換
- real PackedLayout行構造とin-place座標補正
- V1/V2計10ノード登録
- Fixed 3×5秒Prompt Plan
## 2. 最初のV2基準生成
```text
chunks: 3
chunk_seconds: 5.0
continuity: Balanced — 22 frames
audio_continuity: true
exact_total_duration: true
diagnostics: Basic
reroll_from_chunk: 0
reroll_nonce: 0
strict_compatibility: true
```
Model:
```text
H3 INT8 ConvRot
20 steps / CFG 1
Turbo LoRA OFF
```
同じ入力画像とPromptで、既存V1の3×5秒ワークフローとV2を比較します。
## 3. アクセラレータ比較
同じBase Seed、Prompt、解像度で次を順番に確認します。
1. SageAttentionのみ
2. Sage + Sol-Attn
3. Sage + Spectrum
4. Sage + Sol-Attn + Spectrum
RTX 5060 Ti環境で既に動作したSage backendを基準にします。クラッシュしたbackendへ切り替えません。
確認:
- 全チャンクが順番に完了
- Spectrumのrunが各チャンクで開始・終了
- `Sol-Attn takes first refusal...`ログ
- 黒出力、NaN、CUDA errorなし
- VAE Decodeが全H3 Sampling後に始まる
- 最終出力が指定尺になる
## 4. 接続品質
Basic確認:
- 人物ID、髪、服、背景
- 前チャンクからの姿勢・移動方向・カメラ速度
- 口形、歌唱・発話の継続
- 音声tick、無音、語尾重複
- 最終フレーム数と音声samples
Full DiagnosticsではReportに次を出します。
```text
video overlap MAE
video overlap PSNR
audio overlap correlation
audio boundary jump
```
絶対的な合格値ではなく、V1と各アクセラレータ構成の相対比較に使います。
## 5. Session再開
1. 3チャンク生成
2. `Save Session slot 1`
3. ComfyUI再起動
4. `Load Session slot 1`
5. chunksを4へ変更し、sessionへ接続
6. Chunk 1〜3がreused、Chunk 4だけSamplingされることをReportで確認
## 6. リロール
```text
reroll_from_chunk: 3
reroll_nonce: 1
```
確認:
- Chunk 1〜2はSamplingされない
- Chunk 3以降だけ新Seed
- 入力Sessionファイルは変更されない
- 出力Sessionの`parent_session_id`が入力Sessionを示す
## 7. Promptモード
- Fixed:Qwen encodeが1回
- List:`---`で3 Prompt
- Timeline:`[0-5s] / [5-10s] / [10-15s]`
- Prompt変更時、変更前チャンクだけSession再利用される
## 8. Auto Context
Balanced 22fを品質基準にします。その後Autoと比較します。
- 静かな動き:5fを選ぶ可能性
- 通常:22f
- 強いlatent motionかつ39f State:39f
Autoの結果が悪い内容ではBalancedへ固定します。
## 9. RAM guard
高解像度・多数チャンクで、Sampling前にRAM見積りエラーが出ることを確認します。これは意図した安全停止です。chunks、秒数、解像度を下げます。
## 10. 報告時に必要な情報
```text
ComfyUI version / revision
Python / Torch / CUDA
GPU / VRAM / RAM
H3 checkpoint
Sage backend
Sol settings
Spectrum settings
chunks / seconds / context
steps / scheduler / sampler
Console log
V2 report
```