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は維持）

現行ソース:
- 登録IDは計12件。V3.8X2の10件（旧Audio／Video Loader互換IDを含む）に、別IDのSampler V3.9とReference Images V3.9を追加
- V3.9公式Workflowは無改変のユーザー指定MiniMax_H3_Continuum_V39.json／同名ZIP。32ノード／39リンク、画像Loader 1～6だけが新ヘルパーへ配線済み・初期Bypass。7～9は必要に応じて追加接続。V3.8X2標準ZIPにも両バージョンのJSONを同梱
- V3.8X2公式WorkflowとSampler V3.8は別に維持。Reference配線、保存済みRun／TakeはV3.9へ自動移行しない
- 初期V3.9 WorkflowはFirst Image＋Draft 0.30 MP、2×10秒、Generate Full Video（保存値はFull Run）。First Image Loaderは有効なので、Queue前に自分の画像ファイルを選ぶ。Reference-onlyならFirst ImageをOFFにしてManualへ切り替える。保存済み480×640はManual時だけ有効。Sequence Promptは空欄なので入力する
- ComfyUI依存の宣言は>=0.32.0、現行の実生成・GPU検証基準は0.34.2。新テンプレートのブラウザー保存・再読込とGPU受入は別途必要

以下は旧V3.8X / package 3.8.1の履歴記録です。現在の導入案内ではありません。

MiniMax H3の5秒ChunkをAV latent contextで継続し、長尺映像として組み立てるComfyUIカスタムノードです。

V3.8X / 3.8.1:
- 公開面はSampler V3.8、Finalize、Load Image、Load Audio、Load Video、Second Pass、Reference Audios helperの7ノード
- Main Samplerへfrontend-onlyのBasic／Production表示propertyを追加。Python Schema、widget順・値、backend引数は不変
- MainのAspect選択をSize Source（First Image／Manual）へ整理。ManualではWidth／Heightを表示し、旧Aspect値は同じcanvasへ移行
- Draft 0.30 MP、Balanced 0.60 MP、Native 768、Custom MPのResolution Resolverを維持
- Review Each Chunk、Continue、Regenerate Current、Finish RemainingをRun Storageへ統合
- FL2VA Terminal Merge pairを1つのatomic review unitとして維持
- Driving AudioをReview、Smart Regenerate、Finish Remaining、restart persistenceと併用可能
- Image／Audio／Video Loaderはnative Bypass中もEnable行を明瞭に表示し、その場でONへ復帰可能
- 公開WorkflowはMiniMax_H3_Continuum_V38x.jsonと同じJSONを含む同名ZIP。Spectrum対応graphで、保存状態ではSpectrumとTurbo LoRAはOFF。Spectrum、rgthree、KJNodesが必要。ComfyUI-Easy-Useは不要
- 旧V3.8.0は`v3.8.0` tagから導入可能。旧WorkflowとV3.8Xを混在させない
- 16GB GPU GateはPASS。ただしVRAM headroomは小さく、Strict Minimal 14.96 GiB、複雑なGateは約15.5～15.6 GiB
- Review途中のpartial sequenceではSecond Pass／refine_contextは正式対応外。Review完了後にSecond Passを実行
- V3.7以前のNode IDはV3.8で非export。旧保存Workflowは対応するhistorical Release/tagを使用
- Registry配布からtests、tools、diagnostics、Labs資産、旧Workflowを除外し、内部継承moduleは維持

V3.7.0:
- H3 Continuum Sampler V3.7と、1枚のStill Image Guide用optional入力を追加
- Conditioning AdapterでFirst／Last、Continuation context、Still Guide元画像をSecond Passのtarget解像度へ再構築
- 内部RefineSchedule v1としてExternal／Full／Tail／Partialを定義し、既存SIGMAS socketとの互換性を維持
- 704×704 Internal Tail 6と1152×1152 Guide再ConditioningのGPU Correctness GateをPASS
- Still Image GuideはCorrectness PASS、Experimental／Production HOLD。hard anchorによる急なtrajectory変化が起きる場合あり
- V3.6 Production初期値、旧Node ID、保存済みWorkflow、Core PackedLayout／RoPE、First Pass Audio passthroughを維持

V3.6.1:
- Timeline/List混在PromptへH3C-P105警告を追加し、Timelineではstandalone --- 行だけを除去
- Standard＋Audio Continuity ONのFast 5／Strong 39／Autoを、実行開始時からReference Contextへ安全にfallback
- Balanced 22 Masked AV、Audio OFF Masked Video、Compatibility、Run Storage schema、旧Node／Workflow互換を維持

V3.6.0:
- H3 Continuum Sampler V3.6を追加
- 標準Continuationは前ChunkのVideo／Audio latentを次Target内でNoise Mask保護するMasked AV方式
- AdvancedのCompatibilityで従来V3.5 Reference Contextへ切替可能
- Run Storage identityをbackend別に分離し、Terminal Mergeのlogical [2,3]はphysical group単位で再利用／再生成
- chunk_seconds上限を30秒へ拡張（5～15秒を推奨・検証済み範囲として維持）
- V3.5.3、V3.4 Node ID、保存済みWorkflow、Second Pass、Hi-Res Fix、Assemblyを維持

V3.5.3:
- 公開Conditioning Bridge WorkflowのWidth／Height接続を修正
- 公開V3.4／V3.5 Workflowの孤立link IDを清掃し、全配布Workflowのserialization整合性テストを追加
- Hybrid First／Last＋Referenceの`<Picture N>`警告を公開番号のまま表示
- 生成契約、Node／socket、V3.5.2最適化、V3.4互換性は不変

V3.5.2:
- 同一Prompt / CLIP条件の繰り返し生成でCPU conditioning結果を再利用
- Referenceや特殊CLIP経路は安全側でcache bypass
- 長尺Video Guideの全source identityとfinite検査を維持し、必要prefixだけを保持
- 検証条件でVideo GuideのPeak追加RSSを約71%、保持Storageを約59%削減
- Sampling、Conditioning payload、Terminal Merge、Assembly、Seam、Run Storage、標準Seed動作は不変

V3.5.1:
- physical groupごとに完全なMODEL / CONDITIONINGを公開するConditioning Bridge V3.5
- 生成音声を置換しない任意のReference Audio conditioningと常設socket
- Video loaderのIMAGE frame batchを示すVideo Guide Frames / Video Guide Size表示名
- backend socket key、既存workflow接続、V3.4 sampling契約を維持

V3.5.0:
- 外部加工したH3 latentをphysical group構造のまま再SamplingするSecond Pass
- Pixel/VAE round tripを使うHi-Res Fix（Experimental）
- Latent Resize utility（高倍率の直接latent補間はMain経路非推奨）
- RAM / Disk-backed / Autoを選べるAssemble + Seam V3.5
- Exact Duration、Seam、Terminal Merge、元音声passthroughを維持
- V3.4ノードと保存済みワークフローの互換性を維持

安定範囲:
- Advanced Second Pass Bridge
- Assemble + Seam V3.5のRAM / Disk-backed / Auto

Experimental:
- Still Image Guide V3.7（Correctness PASS、hard-anchor qualityはProduction HOLD）
- Main Hi-Res Fix V3.5
- Main Hi-Res Fix 3x5 2x（RTX 5060 Ti 16 GiBではTerminal 77TでCUDA OOM）

GPU受入済み:
- Internal Tail 6 704×704（外部Tail 6比Video SSIM 0.982936、decoded Audio PCM bit-exact）
- Still Guide元画像の1152×1152再Conditioning（Correctnessのみ。品質はProduction HOLD）
- Main Hi-Res Fix 1x5、576から1152
- Hybrid FL2VA + Reference 1x5の統合Hi-Res FixとAdvanced Second Pass

詳細: README.md および docs/VALIDATION_RESULTS.md
