95 lines
4.5 KiB
Markdown
95 lines
4.5 KiB
Markdown
# ComfyUI-H3-Continuum 3.4.0
|
||
|
||
**V3.4.0 Stable:** Driving Audio、Video Reference、Audio / Video Seam、Run Storageを含む安定版です。
|
||
|
||
MiniMax H3を複数チャンクで連続生成し、直前チャンク末尾の**映像latent / 音声latentを直接**次チャンクへ継承するComfyUIカスタムノードです。チャンク間でVideo/Audio VAEのDecode→Encodeは行いません。
|
||
|
||
## V3.4.0 Stable
|
||
|
||
V3.4.0は、最大3枚のReference Image、Run Storage、Spectrum Interop、Decode後のAudio / Video Seam補正を維持し、Driving AudioとVideo Referenceを正式な入力として追加します。
|
||
|
||
Driving Audioは入力音声を絶対時間で各Chunkのガイドに使い、最終出力には元音声を維持します。Video Referenceは参照映像を全Chunkで継続使用し、`Efficient - 0.4 MP`、`Balanced - 0.6 MP`、`Match Output`から処理解像度を選択できます。
|
||
|
||
Reference入力のバイパスされたソケットは無視され、有効な画像だけがPicture 1から連続採番されます。空欄や不完全なプロンプトも停止せず、警告とFixed fallbackで生成を続行します。未知のモデル、ノード、プロンプト形式を独自判断で拒否する制限も撤廃しました。
|
||
|
||
Run Storageの保存契約にはDriving AudioとVideo Referenceのidentityを含め、入力変更後に古いChunkを誤再利用しないようにしています。
|
||
|
||
## Driving Audio / Video Reference / Seam
|
||
|
||
Driving Audioだけを使う、Video Referenceだけを使う、Video Referenceと別音声を組み合わせる、という3通りの接続に対応します。Video Referenceは24 fps入力を基準とし、異なるfpsの素材はLoad Video側で24 fpsへ設定してください。
|
||
|
||
H3 Continuum Assemble + SeamはAudio Seam AutoとVideo Seam Autoを既定とし、フレーム削除を行わずに境界の一時的な露出・色変化を補正します。Auto 2は露出ランプ向けの実験的な追加モードです。
|
||
|
||
## Legacy V2.1.7 Stable Facade UI
|
||
|
||
V2.1.7では、V2.1.6の動的表示制御を廃止し、標準ComfyUI描画だけを使用する静的Facadeへ移行しました。生成処理は互換用`H3ContinuumSamplerV2`を再利用し、State、Session、Prompt Plan、Spectrum Interop、保存Schemaは変更していません。
|
||
|
||
通常表示は次を中心にします。
|
||
|
||
```text
|
||
model / clip / video_vae / audio_vae / sampler / sigmas
|
||
Sequence Prompt
|
||
first_frame
|
||
prompt_overrides(任意pack)
|
||
advanced(任意pack)
|
||
|
||
Prompt Format
|
||
chunks
|
||
chunk_seconds
|
||
width / height
|
||
continuity
|
||
base_seed
|
||
control after generate
|
||
Seam Correction
|
||
Seam Correction
|
||
|
||
outputs: images / audio / result
|
||
```
|
||
|
||
### 補助ノード
|
||
|
||
- `H3 Continuum Clip Overrides`: Clip別Promptを1本のpackへまとめます。
|
||
- `H3 Continuum Advanced`: resume/session入力と低頻度設定をまとめます。
|
||
- `H3 Continuum Result`: resultから`last_state / session / report`を展開します。
|
||
- 補助ノードを使わない通常生成では、Sampler本体だけで動作します。
|
||
|
||
### Legacy互換
|
||
|
||
旧`H3ContinuumSamplerV2`は削除せずLegacy/Coreノードとして登録を維持します。既存WorkflowのノードID、入力順、出力順は変更していません。
|
||
|
||
## Continuity
|
||
|
||
- `Auto — conservative`
|
||
- `Balanced — 22 frames`(標準)
|
||
- `Fast — 5 frames`
|
||
- `Strong — 39 frames (Experimental)`
|
||
|
||
5/22/39フレームはH3の時間latent周期`1,4,4,4,4`に対して、それぞれ2/7/12 temporal latent stepsです。
|
||
|
||
## Spectrum
|
||
|
||
Continuumは有効な前チャンクContextがある場合だけ`h3_continuum` Interop API v1をMODEL optionsへ付与し、対応Spectrumへ`min_actual_prefix_steps=2`を要求します。初回チャンクにはInterop keyを付与しません。未知・未対応Spectrumでは通常Spectrumとしてfail-openします。
|
||
|
||
## 推奨配線
|
||
|
||
```text
|
||
UNET -> SageAttention -> Sol-Attn -> LoRA -> Spectrum -> H3 Continuum Sampler
|
||
```
|
||
|
||
まず`chunks=2 / chunk_seconds=5 / Balanced 22f / Seam Correction=Off`でNative Continuityを確認し、その後`Seam Correction=Auto`を比較してください。
|
||
|
||
## インストール
|
||
|
||
ZIPを展開して、`ComfyUI-H3-Continuum`フォルダーを`ComfyUI/custom_nodes/`へ置き、ComfyUIを再起動します。
|
||
|
||
旧`ComfyUI-H3-Continuum-Join`が残っている場合は同時ロードを避けるため削除または退避してください。同梱`install_windows.bat`は旧名・新名の既存フォルダーを日時付きでバックアップします。
|
||
|
||
## 検査
|
||
|
||
```text
|
||
python -m compileall -q .
|
||
pytest -q
|
||
```
|
||
|
||
MIT License。
|