Files
DumasNodes/docs/VALIDATION_JA.md
T
chris.dumas bf8f76505f Squashed 'vendor/dumas_h3_continuum/' content from commit d07ed31
git-subtree-dir: vendor/dumas_h3_continuum
git-subtree-split: d07ed31b442d283d6a1740f875a843b9feda4c91
2026-10-20 13:43:38 +00:00

247 lines
9.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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
```