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

9.5 KiB
Raw Blame History

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 -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を参照し、 異なる環境の件数を単純合算しないでください。

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 として分けて扱います。

更新と旧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を終了後、展開フォルダーで実行します。

.\install_windows.bat

または:

$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基準生成

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:

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に次を出します。

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. リロール

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. 報告時に必要な情報

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