280 lines
21 KiB
Markdown
280 lines
21 KiB
Markdown
# ComfyUI-H3-Continuum 3.9.10 — V3.9
|
||
|
||
MiniMax H3の映像・音声をチャンクに分けて生成し、結果を確認しながら
|
||
一部分の再生成や、互換性のある保存Takeからの継続ができます。
|
||
**現在のWorkflowはV3.9です。V3.8X2も別のWorkflowとして保持しています。**
|
||
|
||
[v3.9.10本体ZIP](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.10/ComfyUI-H3-Continuum-v3.9.10.zip) ·
|
||
[Release](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/tag/v3.9.10) ·
|
||
[チェックサム](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/releases/download/v3.9.10/SHA256SUMS.txt) ·
|
||
[English](README.md)
|
||
|
||
## 3.9.10 — Spectrum再利用とReference割り当て表示
|
||
|
||
SpectrumソースのCRLF改行でSampling v6 read-onlyになる判定を修正し、対応済みの
|
||
2種類の実装にPython 3.12用の監査済みプロファイルを追加しました。既存3.13の
|
||
プロファイルと正常なTakeの識別値は維持します。未知のコード・追加状態は拒否します。
|
||
|
||
外部Chunks接続時のReference Imagesは、古いWidget値の代わりに割り当て範囲1–16を
|
||
表示します。生成チャンク数や保存済みの選択内容は変更しません。
|
||
|
||
CPU/JS:**2,096成功・2スキップ・既知の期待失敗2件**。Python 3.12の対象試験、
|
||
保存・継続と実JS照合も成功。Reference表示は実ブラウザー確認済みです。
|
||
**3.9.10としての新たなGPU受入は未実施です。**
|
||
|
||
更新後はComfyUIを再起動し、ブラウザーを更新してください。既存WorkflowとTakeは
|
||
そのまま保持できます。新しく対応した構成は新規Runで確認してください。
|
||
旧unsafe/v5 Takeは閲覧用として保持し、自動変換しません。[詳細と制約](docs/RELEASE_NOTES_V3910.md)。
|
||
|
||
## 3.9.9の修正と検証
|
||
|
||
確認済みの公開KJ Preview Overrideで、新規Runまでv6 read-onlyとなる対応漏れを修正。
|
||
再利用不可のTakeには保存時の理由を表示します。安全判定・既存Take・Workflowは維持します。
|
||
|
||
CPU **2,075成功/2スキップ/既知の期待失敗2件**。公開KJのGPU継続と、既設KJを維持した
|
||
実ブラウザーのReviewボタン・Continue From Here→Runを確認し、**Chunk 1保持・Chunk 2生成
|
||
(1再利用・1新規生成)**に成功。4本の映像・音声を全デコードしました。
|
||
|
||
更新後は再起動とブラウザー強制再読込を行ってください。Preview Override側の任意VAE/Audio VAEは
|
||
未接続、Tiny VAEはnoneにし、通常の生成用VAEは維持してください。旧unsafe/v5 Takeは保持されますが
|
||
更新だけで再利用可能にはなりません。設定修正後は新Runで開始します。配線変更・Take削除は不要です。
|
||
[検証条件と制約・Release notes](docs/RELEASE_NOTES_V399.md)。
|
||
|
||
## 基本操作を動画で見る
|
||
|
||
[H3 Continuum V3.9 — Chunks, Prompts & Reference Images](https://youtu.be/AKJxBXaiG6Q) — **12分26秒**、英語ナレーション・字幕・チャプター付き。
|
||
|
||
First Image、チャンク設定、Review・Takeの再試行、Timeline Prompt、Reference Imagesを説明しています。
|
||
画面写真と詳しい操作は[日本語の詳細ガイド](docs/USER_GUIDE_JA.md)を参照してください。
|
||
|
||
## インストール・更新
|
||
|
||
Continuumは`ComfyUI/custom_nodes`内に1つだけ配置してください。
|
||
モデル・外部カスタムノードは本体ZIPに含まれません。
|
||
|
||
### 固定バージョンのZIPを使う
|
||
|
||
1. 冒頭の**本体ZIP**を取得し、必要に応じてチェックサムを確認します。
|
||
2. パッケージフォルダーを`ComfyUI/custom_nodes`へ展開します。
|
||
更新時は既存パッケージを置き換え、重複したコピーを残さないでください。
|
||
3. ComfyUIを再起動し、ブラウザーを**Ctrl+F5**で強制再読込します。
|
||
4. 下記のV3.9 Workflowを開き、導入したモデルと入力ファイルを選びます。
|
||
|
||
保存済みWorkflow、Run/Takeフォルダー、設定は保持してください。
|
||
**Workflow ZIPはグラフの配布物であり、カスタムノードのインストーラーではありません。**
|
||
|
||
### Git・ComfyUI-Managerを使う
|
||
|
||
Gitで新規導入する場合:
|
||
|
||
```bash
|
||
cd ComfyUI/custom_nodes
|
||
git clone https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum.git
|
||
```
|
||
|
||
既存のGit導入を更新する場合:
|
||
|
||
```bash
|
||
cd ComfyUI/custom_nodes/ComfyUI-H3-Continuum
|
||
git pull --ff-only origin main
|
||
```
|
||
|
||
Managerで導入した場合は、そのコピーをManagerから更新してください。
|
||
更新後はComfyUIを再起動し、ブラウザーを再読込します。
|
||
Registry審査・Managerが選択する版・GitHub Releaseの状態は別です。
|
||
正確なv3.9.9を使う場合は、冒頭の固定版リンクを参照してください。
|
||
|
||
パッケージの宣言上の最低要件は**Python 3.10以降・ComfyUI 0.32.0以降**です。
|
||
この最低要件の宣言だけで、すべてのCore版でのGPU動作確認を意味するものではありません。
|
||
|
||
## 必要なモデル・拡張機能
|
||
|
||
重みは[Comfy-Org / MiniMax-H3](https://huggingface.co/Comfy-Org/MiniMax-H3)から別途取得します。
|
||
次の表は**保存されているV3.9テンプレートの選択値**です。配置先は`ComfyUI/`からの相対パスです。
|
||
|
||
| 用途 | ファイル・ダウンロード | 配置先 |
|
||
| --- | --- | --- |
|
||
| H3生成モデル | [minimax_h3_fl2va_pruned_int8_convrot.safetensors](https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/diffusion_models/minimax_h3_fl2va_pruned_int8_convrot.safetensors) | `models/diffusion_models/` |
|
||
| テキストエンコーダー | [qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors](https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors) | `models/text_encoders/` |
|
||
| 動画VAE | [minimax_h3_video_vae_int8_convrot.safetensors](https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/vae/minimax_h3_video_vae_int8_convrot.safetensors) | `models/vae/` |
|
||
| 音声VAE | [minimax_h3_audio_vae_fp32.safetensors](https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/vae/minimax_h3_audio_vae_fp32.safetensors) | `models/vae/` |
|
||
|
||
各Loaderで取得したファイルを選び、テキストエンコーダーのtypeは`minimax`にします。
|
||
保存済みの`minimax/`サブフォルダーが環境と異なる場合は、実際の配置先から選び直してください。
|
||
動画VAEの選択値はINT8版ですが、旧ダウンロード情報にFP16版が残っています。
|
||
実際に導入したVAEを選んでください。[別のモデル形式](https://huggingface.co/Comfy-Org/MiniMax-H3/tree/main/diffusion_models)は生成用途とLoaderの対応に合わせて選択します。
|
||
量子化形式には対応するCore・GPUが必要であり、上表は全ハードウェアでの動作保証ではありません。
|
||
|
||
保持しているV3.8X2グラフでは、DasiwaMinimaxH3_dasiwaHybridV2_int8.safetensorsと
|
||
[FP16動画VAE](https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/vae/minimax_h3_video_vae_fp16.safetensors)が選択されています。
|
||
このカスタムモデルは同梱されず、上表の配布元から取得するものでもありません。導入済みの互換H3モデルを選び直してください。
|
||
|
||
配布グラフ全体を使う場合は、次の外部ノードも必要です。
|
||
|
||
- [Spectrum](https://github.com/xmarre/ComfyUI-Spectrum-MiniMax-H3):任意の高速化機能。保存時は無効です。全バージョンでのTake再利用を保証しません。
|
||
- [KJNodes](https://github.com/kijai/ComfyUI-KJNodes):テンプレートのH3 SageAttentionパッチを提供します。必要なAttention依存関係を導入するか、利用できないパッチを置換・Bypassしてください。
|
||
- [rgthree-comfy](https://github.com/rgthree/rgthree-comfy):`Power Lora Loader (rgthree)`を提供します。
|
||
|
||
**Turboを使う場合のみ:** 用途に合う[LightX2V Turbo LoRA](https://huggingface.co/lightx2v/Minimax-h3-Turbo)を1つ選び、`models/loras/`へ配置します。
|
||
標準WorkflowではLoRAはすべて保存時に無効です。別のTurbo Sampleでは1つ有効です。配布元のSampler・Steps指定に従ってください。
|
||
[ファイル一覧と設定の詳細](docs/USER_GUIDE.md#turbo-lora-and-spectrum-in-supplied-workflows)も参照できます。Continuumがこれらを自動導入することはありません。
|
||
|
||
## Workflowを選ぶ
|
||
|
||
| Workflow | ダウンロード | 用途 |
|
||
| --- | --- | --- |
|
||
| **V3.9** | [JSON](examples/workflows/MiniMax_H3_Continuum_V39.json) / [ZIP](examples/workflows/MiniMax_H3_Continuum_V39.zip) | 現行Samplerと固定Reference Imageスロット |
|
||
| **V3.9 Turbo Sample** | [JSON](examples/workflows/MiniMax_H3_Continuum_V39_Turbo_Sample.json) / [ZIP](examples/workflows/MiniMax_H3_Continuum_V39_Turbo_Sample.zip) | Auto・2×8秒のダンスとタイ語ラップ。[設定・制約](docs/TURBO_SAMPLE.md) |
|
||
| **V3.8X2** | [JSON](examples/workflows/MiniMax_H3_Continuum_V38X2.json) / [統合ZIP](examples/workflows/MiniMax_H3_Continuum_V38X2.zip) | 既存Workflow用。統合ZIPにはV3.9も収録 |
|
||
|
||
ComfyUIの**Templates → ComfyUI-H3-Continuum**からも開けます。
|
||
V3.8X2のReference配線や保存履歴はV3.9へ自動変換されません。
|
||
元のグラフを保持し、新しい作業は専用のV3.9グラフで開始してください。
|
||
不足する外部ノードは導入・置換・削除してからQueueします。ComfyUI-Easy-Useは不要です。
|
||
|
||
V3.9テンプレートでは、自分の**First Image**を選んでください。
|
||
Reference Loader 1〜6はBypass、チャンク別割り当てはすべてOFFで保存されています。
|
||
Image 7〜9を使う場合はLoaderを追加・接続します。
|
||
[テンプレートの詳しい説明](docs/USER_GUIDE_JA.md#最初にv39とv38x2)。
|
||
|
||
## 最初の生成
|
||
|
||
長い動画を作る前に、短い2チャンクで確認してください。
|
||
|
||
1. H3モデル、テキストエンコーダー、Sampler、対応VAEを選びます。
|
||
2. `Sequence Prompt`を記入します。全チャンク共通なら`Prompt Format = Fixed`を使います。
|
||
3. 画像から作る場合は`Size Source = First Image`と解像度を選びます。
|
||
初期値は**Draft — 0.30 MP**です。幅・高さを直接指定する場合は`Manual`にします。
|
||
4. `Chunks`を**2**、`Seconds per Chunk`を**5**にし、`Total Length`が**10秒**になることを確認します。
|
||
5. `Base Seed`を維持し、`Control After Generate`を`fixed`にします。
|
||
6. `Run`を`Review Each Chunk`、`Progress`を`On — Resume and Takes available`にします。
|
||
7. `Regenerate From = Auto`のまま`Ready to Queue`を読み、ComfyUI上端の**Run/実行ボタン**を押します。
|
||
|
||
`Chunks`は最終目標数であり、次のQueueで追加する数ではありません。
|
||
Reviewでは通常1単位ずつ生成するため、この例の最初の出力は**5秒**です。
|
||
Last ImageのTerminal Mergeでは、最後の2チャンクを1単位として扱う場合があります。
|
||
|
||
一括生成する場合は`Generate Full Video`を選びます。
|
||
保存Take・互換Resume・後からの再生成を使う場合はProgressをONにしてください。
|
||
|
||
## 確認・継続・再試行
|
||
|
||
Review操作を選ぶだけでは生成は始まりません。選択後にComfyUIの
|
||
**Run/実行ボタン**(`Queue`)を押してください。
|
||
|
||
| 操作 | 次のQueueで行うこと |
|
||
| --- | --- |
|
||
| `Use it and continue` | 採用済みチャンクを保持して、次のReview単位を生成 |
|
||
| `Try this chunk again` | 前のチャンクを保持して、確認中の単位を別Takeで再生成 |
|
||
| `Use it and finish the rest` | 採用済みの部分を保持して、残りをまとめて生成 |
|
||
| `Back to Settings` / `Return to Review` | 設定と確認画面の移動。生成開始・Take削除は行わない |
|
||
| `Use This Take` | 保存結果を採用。新しいSamplingは行わないがDecode・保存は実行され得る |
|
||
| `Continue From Here` | 選んだTakeまでを保持した分岐を作り、次の単位を生成 |
|
||
|
||
**2×5秒**の例では、Chunk 1を採用して継続すると、それを再利用してChunk 2を生成し、**10秒**の完成動画になります。
|
||
完了後に現在の単位をRetryすると、別のChunk 2 Takeを作ります。
|
||
|
||
継続時はモデル・LoRA・Seed・Prompt・入力素材・寸法・Sampling設定・継続設定・Run識別を維持します。
|
||
Seedを固定しただけで再利用が保証されるわけではありません。Statusと再利用数を確認してください。
|
||
完成動画を延ばす場合は条件を維持し、`Regenerate From = Auto`のまま最終目標の`Chunks`を増やしてQueueします。
|
||
[Review・Takeの詳細](docs/USER_GUIDE_JA.md#10秒を5秒ずつ確認しながら作る)。
|
||
|
||
## 指定チャンクから再生成する
|
||
|
||
1. 設定を開き、**Regenerate From = Chunk N**を選びます。
|
||
2. ProgressをONにし、前のチャンクの生成条件を維持します。
|
||
3. N以降をまとめて作るなら`Generate Full Video`、次の単位で確認するなら`Review Each Chunk`を選びます。
|
||
4. **Variation Nonce**を指定し、ComfyUIの実行ボタンを押します。
|
||
5. 通常の継続・Take操作へ戻る前に、`Regenerate From = Auto`へ戻します。
|
||
|
||
Nonce **0**は、再生成完了後の再実行で別Variationを自動選択します。
|
||
互換性のある中断処理では、同じVariationをResumeします。
|
||
正のNonceはVariationを固定します。同じ条件・同じ正数を繰り返しても別結果の要求にはなりません。
|
||
ReviewのRetryは、これとは別にVariationを管理します。
|
||
|
||
前の互換チャンク・以前のTakeは保持します。
|
||
後続は変更後の継続に従うため、Full RunのChunk 2指定は、目標数によってChunk 2以降をまとめて再生成します。
|
||
Terminal Mergeのpairは分割せず、チャンク内の任意フレームだけを変更することもできません。
|
||
[再生成・互換性の詳細](docs/REGENERATE_INTENT_V396.md)。
|
||
|
||
## Prompt・Reference Images
|
||
|
||
- **Fixed**は共通Prompt、**List**はチャンク別、**Timeline**は時間指定です。
|
||
- V3.9のReference Imagesは**Image 1〜9の固定スロット**を持ち、Samplerへ1本で接続します。
|
||
`All chunks`は共通使用、`Per chunk`は画像とチャンクの交点を選択します。
|
||
- `@R1`は空きスロットに関係なくImage 1です。有効なReferenceだけをタグで参照してください。
|
||
実際のPicture番号は物理groupごとに解決されます。
|
||
- First/Last Image、Reference Images、Reference Audio、Driving Audioは用途が異なります。
|
||
Driving Audioは元の音声を保持し、Reference Audioは生成条件として使います。
|
||
- Reference単独を試す場合はFirst/Last ImageをOFF、サイズをManualにします。
|
||
終端を結合するpairでは、両チャンクの有効なReferenceセットを揃えてください。
|
||
- 大きな入力画像は事前に縮小してください。条件付けのresizeだけでは元画像の読込RAMは減りません。
|
||
割り当てを外した後も、映像の連続性により被写体が残る場合があります。
|
||
|
||
[Referenceガイド](docs/V39_REFERENCE_INLINE.md) ·
|
||
[Prompt例(英語)](docs/README_HISTORY.md#prompt-formats) ·
|
||
[V3.9用Promptスキル](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/tree/main/write-h3-v39-reference-prompts) ·
|
||
[Prompt・スキル配布](docs/USER_GUIDE_JA.md#プロンプトスキルのダウンロード)
|
||
|
||
## 保存・Decode・Second Pass
|
||
|
||
ProgressはRun/Takeを保存します。任意の**Decode Cache Helper**はデコード結果のキャッシュであり、保存履歴とは別です。
|
||
Finalizeで結合し、後段のCoreノードで動画を作成・保存します。
|
||
|
||
一時保存先は**設定 → H3Continuum → Storage → 一時ストレージを管理**で指定します。
|
||
ComfyUIサーバー側のフォルダーで、FinalizeとDecode Cacheに適用します。
|
||
Run/Takeや完成動画は移動しません。変更・削除は実行中/待機中Queueが空のときに行ってください。
|
||
同じ物理ドライブ内のフォルダー移動だけでは、書き込みを別機器へ逃がせません。
|
||
[保存方式・削除・制約](docs/TEMPORARY_STORAGE_JA.md)。
|
||
|
||
**Second Pass**は外部のRefinement・拡大処理へ渡す任意の機能です。
|
||
チャンク継続や通常のReview Retryとは別で、V3.8X2標準WorkflowにHi-Res Fixは不要です。
|
||
V3.8ではReview途中のpartial sequenceに対応しません。V3.9は検証済みの実出力groupの条件を継承できます。
|
||
[外部連携の仕様](docs/V38_OPEN_INTEGRATION_CONTRACT.md)。
|
||
|
||
## 互換性・v3.9.9の対応範囲
|
||
|
||
| 対象 | 対応条件 |
|
||
| --- | --- |
|
||
| 保存履歴 | 既存Takeは読取可能です。旧v5・unsafe履歴をSampling v6の再利用可能履歴へ自動修復・昇格しません。必要に応じて新Runを使います。 |
|
||
| 未知のMODEL wrapper | 新規生成は可能です。再利用には生成契約の完全な観測と一致が必要で、名前・版だけで許可しません。 |
|
||
| Attention/Spectrum | Core PyTorch/Kitchenと、公式v0.2.29を含む指定Spectrum実装の監査済みプロファイルに対応します。[厳密な範囲](docs/ISSUE31_SAMPLING_SIGNATURES.md)。 |
|
||
| KJ Model Preview Override | 固定したKJ/Core実装のみ。**VAE/Audio VAE未接続・Tiny VAE `none`**、Core NoPreviews/Auto/Latent2RGB。監査済みローカルソースはupstreamと異なり、KJNodes 1.5.2全般の合格ではありません。[対応ハッシュ](docs/KJ_PREVIEW_OVERRIDE_V398.md)。 |
|
||
|
||
公開版**v3.9.9**は、新Run・別QueueでのChunk 1→2継続を
|
||
**PyTorch+KJ**と**Comfy Kitchen INT8+監査済みローカルSpectrum+KJ**で確認しています。
|
||
プレビュー画像を保持し、元Chunk 1と契約を維持、映像・音声4本は全デコード成功でした。
|
||
条件はRTX 5060 Ti 16 GB、512×512、24fps、2×5秒、8-step Turbo、Core API経由です。
|
||
別のKJ/Spectrum実装やPreview VAE接続を合格とするものではありません。
|
||
[詳しい条件・未確認範囲](docs/RELEASE_NOTES_V398.md)。
|
||
|
||
## 既知の問題・制約
|
||
|
||
- **Reference Plan Inspector:** Samplerの再configure後に古い表示が残る問題は未修正です。
|
||
2件の期待失敗は修正済みを意味しません。
|
||
- **モバイル:** UI処理の削減は確認していますが、フリーズ解消は未確認です。
|
||
- **メモリ:** 大きなReference画像9枚や長尺の最終DecodeでVRAM/RAM不足になる場合があります。
|
||
Disk-backed Finalizeでも、他ノードの大きなメモリ確保は防げません。
|
||
- **Refinement:** 高倍率のLatent Resizeでアーティファクトが残る場合があります。
|
||
長いHi-Res/Hybrid条件と二重輪郭には制約・調査中の事項があります([Issue #27](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/issues/27))。
|
||
- **連続性:** 完全な同一性・動作・口の同期・元動画の全フレーム再現は保証しません。長尺には既知の品質制約もあります。
|
||
- **検証範囲:** ブラウザー実行/保存再読込、報告者の完全一致グラフ、他実装、主観画質・音質、速度・VRAM比較は、今回の限定GPU再検証で確立していません。
|
||
|
||
## 詳細資料
|
||
|
||
| 内容 | 資料 |
|
||
| --- | --- |
|
||
| 導入・画像・詳細操作 | [日本語の詳細ガイド](docs/USER_GUIDE_JA.md) / [英語の図解ガイド](docs/USER_GUIDE.md) |
|
||
| 現行Reference Images | [V3.9 Referenceガイド](docs/V39_REFERENCE_INLINE.md) |
|
||
| V3.8X2からの更新 | [移行・保持する仕様](docs/V38_RELEASE_AND_MIGRATION.md) |
|
||
| 更新履歴・旧版画像・実装説明 | [日本語の履歴資料](docs/README_HISTORY_JA.md) / [CHANGELOG](CHANGELOG.md) |
|
||
| 最新版の検証記録 | [v3.9.9詳細](docs/RELEASE_NOTES_V398.md) / [配布検証](PACKAGE_VALIDATION.txt) |
|
||
| 不具合報告 | [GitHub Issues](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/issues) — Workflow、Status、`auto-resume disabled:`の理由を添えてください |
|
||
|
||
過去のRelease・タグは保持しています。mainの文書更新で、公開済みv3.9.9のタグや配布物を置き換えることはありません。
|
||
この整理は文書のみであり、公開ノード・公式Workflow JSON/ZIP・Sampling v6・既存Run/Takeは変更しません。
|
||
|
||
## ライセンス
|
||
|
||
[MIT](LICENSE)。外部コンポーネントの[ライセンス・表記](THIRD_PARTY_NOTICES.md)も参照してください。
|