Release V3.8 source, illustrated manual and Spectrum workflow

This commit is contained in:
ukr8b3g-cmyk
2026-09-07 21:25:51 +09:00
parent 0a7c6703b7
commit 315146946e
208 changed files with 74579 additions and 24542 deletions
+54 -54
View File
@@ -192,61 +192,61 @@ Spectrum ONの品質はSeed依存で変化する。結果確認なしの長尺
- このMarkdownと機械可読なJSON/CSVを通常Gitへ追加する。
- コンタクトシートは`docs/assets/ab-tests/`等へ追加する。
- 大容量MP4は通常Gitへ直接追加せず、GitHub Release assetsまたはGit LFSを検討する。
- 公開前にPrompt、Workflow、モデル、ComfyUI revision、Python/Torch/CUDA、GPU、生成時間を各サンプルへ紐付ける。
## 00048 / 00049: 0.5 MP Seam Off vs Auto
- 共通条件: 576x896 (約0.5 MP), 24 fps, 3 x 5秒, Spectrum On, Warmup 1, Actual Prefix 2, Balanced 22, base seed 1235。
- 00048: Seam Off。5秒境界比 0.3583、10秒境界比 0.8562。
- 00049: Seam Auto。5秒境界比 0.3709、10秒境界比 0.4271。
- 視覚評価: 両方とも人物・衣装・肌は安定し、見た目の差は小さい。Autoは10秒境界を数値上改善した。
- 音声: 両方ともほぼ無音のため、音声シーム効果は未評価。
- 注意: 0.5 MP条件のため、0.6 MPで発生したSeed 1235の崩れをWarmup 1が解消したとは断定しない。
### 目視評価の補足
- ユーザー目視では00049(Seam Auto)の方がフリックが若干目立つ。
- 00048(Seam Off)の方が境界変化を比較的抑えられている。
- 境界指標の改善と主観的なフリック低減は一致しなかったため、本比較では目視評価を優先しSeam Offを採用候補とする。
## 00050: 音声あり一貫性テスト
- 条件: 576x896(約0.5 MP)、24 fps、3 x 5秒、Spectrum On、Warmup 1、Balanced 22、base seed 1235、Seam Off。
- 音声レベル: mean -19.9 dB、peak -6.4 dB。前回のほぼ無音サンプルより音声境界の評価に適する。
- 目視: 3チャンクを通して人物、髪、衣装、背景、露出は安定。肌・顔の累積崩れも目立たない。
- 5秒境界: 境界付近で瞬きが始まるためフレーム差はあるが、露出フリックより自然動作として見える。
- 10秒境界: 口形、顔、背景の連続性が高く、明確な視覚ジャンプは小さい。
- 未確認: 音声境界のクリック、F0、短時間RMS、スペクトル差の数値解析。
- 次の比較: 同一Prompt・Seed・解像度・Warmupのまま、SeamだけAutoへ変更した1本と比較する。
### 00050 音声の目視・聴感補足
- ユーザー聴感で10秒(Chunk 2→3境界)に短いプチノイズを確認。
- 同境界の映像連続性は良好であり、映像シームと音声シームの品質が一致しない例となった。
- 暫定対策候補: Video Seam Off、Audio Seam Autoを独立設定にする。
### 00050 実行レポート補足
- Prompt plan: Fixed、3 chunks、5.000秒。Seam correction Off。
- Chunk seeds: 12362262848839836333 / 1129406137053299874 / 8524677167168820503。
- Continuity motion: Chunk 2 = 0.378492、Chunk 3 = 0.388277。Continuation chunksはActual Prefix 2を要求。
- Retained frames: 124 + 119 + 119 = 362。Exact-durationで360 framesへ末尾調整。
- Audio: 480000 samples(32 kHz、15.000秒)。末尾補正 -2667 samplesは2 frames相当で、10秒境界のプチノイズ原因とは分離して扱う。
- 判定: sample-boundary alignmentは尺を整合させているが、波形位相・振幅の連続性までは保証しない。Audio Seam Off基準として保存する。
### 00050 境界評価の訂正
- 5秒(Chunk 1→2): 映像フリックが確認できる。
- 10秒(Chunk 2→3): 映像フリックは目立たないが、音声に短いプチノイズがある。
- 映像と音声の問題位置は一致していないため、Video SeamとAudio Seamは独立評価・独立処理が必要。
- 公開前にPrompt、Workflow、モデル、ComfyUI revision、Python/Torch/CUDA、GPU、生成時間を各サンプルへ紐付ける。
## 00048 / 00049: 0.5 MP Seam Off vs Auto
- 共通条件: 576x896 (約0.5 MP), 24 fps, 3 x 5秒, Spectrum On, Warmup 1, Actual Prefix 2, Balanced 22, base seed 1235。
- 00048: Seam Off。5秒境界比 0.3583、10秒境界比 0.8562。
- 00049: Seam Auto。5秒境界比 0.3709、10秒境界比 0.4271。
- 視覚評価: 両方とも人物・衣装・肌は安定し、見た目の差は小さい。Autoは10秒境界を数値上改善した。
- 音声: 両方ともほぼ無音のため、音声シーム効果は未評価。
- 注意: 0.5 MP条件のため、0.6 MPで発生したSeed 1235の崩れをWarmup 1が解消したとは断定しない。
### 目視評価の補足
- ユーザー目視では00049(Seam Auto)の方がフリックが若干目立つ。
- 00048(Seam Off)の方が境界変化を比較的抑えられている。
- 境界指標の改善と主観的なフリック低減は一致しなかったため、本比較では目視評価を優先しSeam Offを採用候補とする。
## 00050: 音声あり一貫性テスト
- 条件: 576x896(約0.5 MP)、24 fps、3 x 5秒、Spectrum On、Warmup 1、Balanced 22、base seed 1235、Seam Off。
- 音声レベル: mean -19.9 dB、peak -6.4 dB。前回のほぼ無音サンプルより音声境界の評価に適する。
- 目視: 3チャンクを通して人物、髪、衣装、背景、露出は安定。肌・顔の累積崩れも目立たない。
- 5秒境界: 境界付近で瞬きが始まるためフレーム差はあるが、露出フリックより自然動作として見える。
- 10秒境界: 口形、顔、背景の連続性が高く、明確な視覚ジャンプは小さい。
- 未確認: 音声境界のクリック、F0、短時間RMS、スペクトル差の数値解析。
- 次の比較: 同一Prompt・Seed・解像度・Warmupのまま、SeamだけAutoへ変更した1本と比較する。
### 00050 音声の目視・聴感補足
- ユーザー聴感で10秒(Chunk 2→3境界)に短いプチノイズを確認。
- 同境界の映像連続性は良好であり、映像シームと音声シームの品質が一致しない例となった。
- 暫定対策候補: Video Seam Off、Audio Seam Autoを独立設定にする。
### 00050 実行レポート補足
- Prompt plan: Fixed、3 chunks、5.000秒。Seam correction Off。
- Chunk seeds: 12362262848839836333 / 1129406137053299874 / 8524677167168820503。
- Continuity motion: Chunk 2 = 0.378492、Chunk 3 = 0.388277。Continuation chunksはActual Prefix 2を要求。
- Retained frames: 124 + 119 + 119 = 362。Exact-durationで360 framesへ末尾調整。
- Audio: 480000 samples(32 kHz、15.000秒)。末尾補正 -2667 samplesは2 frames相当で、10秒境界のプチノイズ原因とは分離して扱う。
- 判定: sample-boundary alignmentは尺を整合させているが、波形位相・振幅の連続性までは保証しない。Audio Seam Off基準として保存する。
### 00050 境界評価の訂正
- 5秒(Chunk 1→2): 映像フリックが確認できる。
- 10秒(Chunk 2→3): 映像フリックは目立たないが、音声に短いプチノイズがある。
- 映像と音声の問題位置は一致していないため、Video SeamとAudio Seamは独立評価・独立処理が必要。
### 00050 最終訂正(この評価を優先)
- 5秒(Chunk 1→2): 映像フリックあり。
- 10秒(Chunk 2→3): 映像フリックは目立たない。
- 音声: 明確なプチノイズは確認できない。先行する「10秒に音声ノイズあり」という記録は取り消し、未検出として扱う。
- 5秒(Chunk 1→2): 映像フリックあり。
- 10秒(Chunk 2→3): 映像フリックは目立たない。
- 音声: 明確なプチノイズは確認できない。先行する「10秒に音声ノイズあり」という記録は取り消し、未検出として扱う。
- 00050はAudio Seam不具合の根拠にはせず、音声は専用テストで改めて検証する。
## V3.2.1 Reference + Continuation 実機成績
+69
View File
@@ -0,0 +1,69 @@
# Branch Provenance Contract v1
Status: V3.8 N2b implementation contract.
## Purpose
Branch Provenance records which immutable physical-group revision is active at
each point in a Run Storage chain. It allows a user to select an older Take and
generate only the physical groups after that Take without deleting the former
branch or confusing equal nonces with equal ancestry.
Take labels are presentation only. Internal identity is always `revision_id`.
## Physical-group revision
Every completed physical group records:
- `revision_id`: immutable SHA-256-derived identity;
- `parent_revision_id`: the immediately preceding physical-group revision;
- `group`: one-based `start`, `end`, and `physical_group` values;
- `variation_nonce` and `seed_identity`;
- `storage_revision_id` and `generation_contract_sha256`;
- `lineage_sha256` and immutable chunk record identities;
- `created_utc` plus deterministic `revision_order`;
- optional `branch_cut` metadata.
Terminal Merge `[N-1,N]` is one physical group. A chain that contains only one
logical half is invalid.
## Canonical chain
`project.json` has exactly one `canonical_chain`, one
`canonical_head_revision_id`, and an `active_revisions` map. Browsing Takes does
not change them. `Use This Take` or `Continue From Here`, followed by the normal
Queue action, creates a finalized Schema v3 storage revision and atomically
switches the canonical chain.
`Continue From Here` keeps the selected prefix exactly and starts a new existing
sampling nonce boundary at the next physical group. The Sampling Contract itself
remains version 5 and is not extended with provenance fields.
## Run Storage Schema v3
Schema v3 separates `revision_id` (storage execution identity) from
`sampling_revision_id` (the unchanged Sampling Contract identity). A finalized
manifest contains Branch Provenance v1 metadata with its complete active chain,
branch selection/cut when applicable, and a monotonic `canonical_sequence`.
The write order is:
1. save and fsync new chunk payloads;
2. validate all logical records in the completed physical group;
3. atomically write the finalized manifest and its active chain;
4. atomically replace `project.json` with the new canonical head.
A failure before step 4 leaves the preceding canonical project head intact.
If `project.json` is corrupt, the highest validated `canonical_sequence` in a
finalized manifest is the recovery source. In-progress and interrupted revisions
are not Render History Take candidates.
## Schema v2 compatibility
Schema v2 manifests remain readable and are never rewritten merely by loading
them. Their contiguous records are interpreted in memory as a legacy chain with
one canonical physical-group revision per group. The first Schema v3 save uses a
separate storage revision directory, so the legacy manifest and payloads remain
unchanged.
No automatic Take garbage collection is part of N2b.
+35 -35
View File
@@ -1,35 +1,35 @@
# V2.1.4 UI Simplification
The integrated `H3 Continuum Sampler V2` is the primary workflow node.
## Default workflow
```text
Text (Multiline) -> Sequence Prompt
Image -> first_frame
Sampler images/audio -> Create Video
```
The default node surface shows Sequence Prompt, first frame, chunk timing,
continuity, seed, and seam correction. Individual clip overrides and Advanced
settings are collapsed.
## Advanced settings
Advanced settings expose `last_frame`, `initial_state`, `session`,
`prompt_plan`, reroll controls, diagnostics, `last_state`, session output, and
report output. A saved workflow with an existing Advanced connection expands
the section automatically.
The Advanced Settings button remains the section header when expanded. The
button is placed before the expanded controls instead of moving below them.
## Legacy nodes
V1 Join, Finish, Assemble, state utilities, and auxiliary V2 plan/session nodes
remain registered for saved-workflow compatibility. They are marked deprecated
and moved to `MiniMax H3/Continuum/Legacy`, so ComfyUI can omit them from the
normal node picker.
No sampling, State/Session schema, output order, or accelerator behavior changes
in V2.1.4.
# V2.1.4 UI Simplification
The integrated `H3 Continuum Sampler V2` is the primary workflow node.
## Default workflow
```text
Text (Multiline) -> Sequence Prompt
Image -> first_frame
Sampler images/audio -> Create Video
```
The default node surface shows Sequence Prompt, first frame, chunk timing,
continuity, seed, and seam correction. Individual clip overrides and Advanced
settings are collapsed.
## Advanced settings
Advanced settings expose `last_frame`, `initial_state`, `session`,
`prompt_plan`, reroll controls, diagnostics, `last_state`, session output, and
report output. A saved workflow with an existing Advanced connection expands
the section automatically.
The Advanced Settings button remains the section header when expanded. The
button is placed before the expanded controls instead of moving below them.
## Legacy nodes
V1 Join, Finish, Assemble, state utilities, and auxiliary V2 plan/session nodes
remain registered for saved-workflow compatibility. They are marked deprecated
and moved to `MiniMax H3/Continuum/Legacy`, so ComfyUI can omit them from the
normal node picker.
No sampling, State/Session schema, output order, or accelerator behavior changes
in V2.1.4.
+20 -20
View File
@@ -1,20 +1,20 @@
# V2.1.5 UI Serialization Stability
V2.1.5 preserves the backend-defined Sampler V2 widget and slot structure.
The frontend may change labels, computed height, and DOM/slot visibility only.
## Stability contract
- Backend widget type, serialization behavior, and relative order are unchanged.
- Backend inputs and outputs are never removed or re-added for UI folding.
- Individual Clip Overrides and Advanced buttons are appended non-serialized frontend widgets.
- Prompt and advanced sockets remain registered in stable order while collapsed slots are hidden visually.
- onNodeCreated and onConfigure are wrapped by one Sampler V2 extension only.
This release does not change Sampling, State, Session, Prompt Plan, Spectrum Interop, or project schemas.
## Browser regression
Set chunks=2, chunk_seconds=5.0, width=1344, height=768, Balanced 22 frames, Seam Correction Auto, and a fixed seed.
Open and close Individual Clip Overrides and Advanced settings, change tabs, save, reload ComfyUI, and reload the workflow.
All values and connections must remain in their original slots.
# V2.1.5 UI Serialization Stability
V2.1.5 preserves the backend-defined Sampler V2 widget and slot structure.
The frontend may change labels, computed height, and DOM/slot visibility only.
## Stability contract
- Backend widget type, serialization behavior, and relative order are unchanged.
- Backend inputs and outputs are never removed or re-added for UI folding.
- Individual Clip Overrides and Advanced buttons are appended non-serialized frontend widgets.
- Prompt and advanced sockets remain registered in stable order while collapsed slots are hidden visually.
- onNodeCreated and onConfigure are wrapped by one Sampler V2 extension only.
This release does not change Sampling, State, Session, Prompt Plan, Spectrum Interop, or project schemas.
## Browser regression
Set chunks=2, chunk_seconds=5.0, width=1344, height=768, Balanced 22 frames, Seam Correction Auto, and a fixed seed.
Open and close Individual Clip Overrides and Advanced settings, change tabs, save, reload ComfyUI, and reload the workflow.
All values and connections must remain in their original slots.
@@ -0,0 +1,254 @@
# V3.8 初心者向けマニュアル設計・撮影台本
状態: Computer Use実画面検証PASS/4-step・0.30 MP・Spectrum OFFでContinue完走/README反映中(2026-09-07)
最新結果: 提供された00058を、Turbo4、実Steps 4、Euler/simple、Draft 0.30 MP、Spectrum OFF、2×5秒でUIから再検証した。Chunk 1の三択レビュー画面が出現し、`Use it and continue`選択後に右上の青い`Run`を押すと、受理済みChunk 1を再SamplingせずChunk 2だけをSampling(Sampler表示43.738秒)し、10秒の`Saved sequence is complete`へ到達した。修正後の`Try this chunk again`も別の実画面試験でPASS済み。現在フロントエンドの実行ボタンは右上の青い`Run`で、ノード内の`Run`設定やカード内の旧`Queue`表記と区別する。
## 現在の制作範囲(以下の旧撮影案より優先)
- 完成原稿は英語の `../README.md`。日本語READMEの翻訳は最終段階まで保留。単純な初回生成説明は増やさず、任意チャンク数での継続・再試行・残り生成・設定へ戻る・履歴・指定位置以降の再生成・完成後の延長を中心にする。
- 継続操作だけでなく、V3.8が公開する7ノードの全ユーザー向けsocket/control/outputをREADMEで説明する。SamplerのMain/Advanced/Review状態、Continuum Settings、Load Image/Audio/Video、Reference Audios、Finalize、Second Passを省略しない。非表示の内部IDは「UI」扱いせず、frontend管理であることだけを示す。
- UIの文字列、変更する値、維持する値、Queue操作、その回に新規生成される範囲、保存動画の長さを順番に説明する。2チャンクは例であり固定条件ではない。fixed seed、Chunksは追加数でなく合計数、Terminal Merge例外を省略しない。
- 提供された実画面6枚を加工せず `images/v38-manual/` へ保存済み。`seed-fixed.png`、`review-settings.png`、`review-actions.png`、`continue-selected.png`、`return-to-review.png`、`full-video-progress.png`。Spectrum設定の画像はこの章に使用しない。元画像とのSHA一致・PNG形式・READMEリンクを確認済み。
- 今回追加した公開用実画面はreview三択、continue選択、sequence完了、Back to Settings後の完了設定、Render History内部、Regenerate FromとVariation Nonce。既存画像を新規撮影と称さない。全画面ではなく操作部分の実スクリーンショットを使用する。finish選択は三択画面で場所と意味を説明し、必要になった場合だけ追加撮影する。
- 追加提供された7枚を、Video/Audio loaderとbypass、Reference Image 1–3、First/Last Image、First Image + Draft 0.30 MP、LightX2V Turbo LoRA一覧、First Image tooltip、Manual Width/Heightとして無加工コピーした。LoRA loader、Spectrum、画像中のAudio Switch/Fast Groups Bypasserは外部workflow要素として分離し、Continuum公開UIと誤認させない。
- README冒頭に「Web対応AIへこのREADMEを読ませる」案内を置く。ChatGPT/Gemini/Grokの現行公式情報に限定し、URLだけでrepository全文を読めるとは保証しない。GeminiのImport codeと、失敗時のREADME貼付/uploadを案内する。
- Size Source/Resolution/Manual Width・HeightはV3.8 Sampler本体に搭載されたため、通常workflowに外部MP/size nodeは不要と説明する。32×32は音声だけを聴く診断用であり、映像品質の推奨値にはしない。
- Issue #13はOpen、StandardにはProduction mitigationなし、R6-Aは一条件で改善したが最終4×8ではno-opだった、という証拠範囲を固定する。「解決済み」「全く改善方法がない」のどちらにも誇張しない。
- ユーザーが `http://127.0.0.6:8188/` で起動した `00058` ワークフローを使用した。ユーザー所有backendは停止しない。
- READMEの測定例は今回の4-step実測へ更新し、旧6-step値と混在させない。commit/pushは今後の明示依頼時のみ。
作成日: 2026-09-06
対象: `H3 Continuum Sampler V3.8`の現在のMain UI
再開時の正本: この文書と`PROJECT_STATE.md`
## この文書を読めば撮影準備から再開できる
この文書は、V3.8の初心者向け画像マニュアルを作るための設計書兼撮影台本です。完成マニュアルそのものではありません。ドリフト軽減策、公開UI、標準Workflowが固まったあと、この台本に沿ってComputer Useで実画面を確認し、スクリーンショットを撮影します。
撮影開始の指示を受けた担当者は、最初に次を読みます。
1. `AGENTS.md`
2. `PROJECT_STATE.md`
3. この文書
4. `README_JA.md`の「10秒を5秒ずつ確認しながら作る」
5. `examples/workflows/MiniMax_H3_Continuum_V38.json`
撮影開始前に、表示ラベル、標準Workflow、公開ノード数、Review/Take動作がこの台本と一致するか確認します。違いがある場合は、古い画面を撮影せず、先に台本を現在のUIへ合わせます。
## 完成マニュアルは初回手順と目的別の逆引きに分ける
読者はComfyUIの基本操作を知っているものの、Continuumのチャンク、Review、Take、保存再開は初めてという利用者を想定します。モデルの入手、ComfyUI本体の導入、一般的なSampler解説は別資料へ任せます。
完成版では、最初に読む範囲と必要時だけ読む範囲を分けます。
- 初回に読む: 1~4章
- 必要なときに読む: 5章以降
予定する章は次のとおりです。
1. V3.8で最初の動画を作る
2. 長さと出力サイズを決める
3. 10秒を5秒ずつ確認しながら作る
4. 完成動画をFinalizeして保存する
5. 現在のチャンクだけを作り直す
6. 保存されたTakeを選ぶ
7. 選んだ地点から続きを作る
8. List/Timeline Promptを使う
9. Audio Continuityと参照素材を使う
10. Second Passを完成後のsequenceへ使う
11. 症状から原因を探す
12. 用語集と報告テンプレート
マニュアル冒頭には、V3.8が「生成、チャンクごとの確認、部分再生成、保存再開」を行うProduction Samplerであることを短く示します。V3.7以前の画面やNode IDをV3.8の手順へ混ぜません。
## 1操作につき1枚の画面と1つの期待結果を示す
各手順は次の順番で書きます。
1. 目的を1文で示す
2. 変更する項目を画面上の正確な表示名で示す
3. 操作対象を番号付きスクリーンショットで示す
4. なぜ必要かを1文で添える
5. Queue後に見える正常な結果を示す
6. 次に選べる操作へつなぐ
7. 失敗時は対応する逆引き項目へ案内する
1枚へ多数の番号を詰め込みません。特にReviewでは「ボタンを選ぶ」と「ComfyUIのQueueを押す」を別ステップとして扱います。選択しただけで生成が始まらないことを、本文と画面の両方で明示します。
## 撮影はUIと長尺品質が固定されたあとに始める
本撮影は、次の条件がそろってから開始します。
- 公開対象のV3.8 UIラベルと配置が確定している
- 標準Workflowが確定している
- 現在進行中のドリフト調査について、ローンチ時の扱いが決まっている
- READMEと実画面のReview手順が一致している
- `Review Each Chunk`、再生成、Take選択、再開の正常系が通る
- 画面更新、警告表示、失敗時の案内が確認済みである
- 撮影に使うruntimeとsourceの一致を確認できる
構成と本文の下書きは先に進められます。UIが変わる可能性のある段階では、最終スクリーンショットと座標依存の注釈を確定しません。
## 撮影環境を固定して画面差し替えを減らす
撮影前に次の条件を記録します。
| 項目 | 撮影時に記録する内容 |
|---|---|
| Continuum | version、source commitまたはtree識別情報 |
| ComfyUI | versionまたはcommit |
| Workflow | 正本ファイル名とSHA-256 |
| Browser | 種類、表示倍率 |
| Viewport | 幅、高さ |
| Theme | light/dark |
| Sampler view | 現在のMain UIとAdvancedの開閉状態 |
| Input | 使用する画像、音声、動画の識別名 |
| Generation | Seed、Model、LoRA、Sampler、Steps、SIGMAS |
| Output | Width、Height、fps、Chunks、Seconds per Chunk |
撮影用Workflowは、個人名、ローカルの機密パス、過去の不要な履歴を含まない専用コピーを使います。ComfyUI Coreノードは標準表示名のまま撮影し、Continuum専用に見える名前へ変更しません。
## 撮影台本はQuick Startから始める
最初の撮影セットは、`2 × 5s = 10 seconds`のReview手順です。以下のShot IDを画像名にも使います。
| Shot ID | 撮影する状態 | 画面で確認する要素 | 本文で伝えること |
|---|---|---|---|
| V38-M01 | 標準Workflow全体 | Sampler、Core Decode、Finalize、Core Save Video | 最小の接続全体 |
| V38-M02 | Sampler初期Main | Prompt Format、Continuity、Base Seed、Control After Generate、Audio Continuity | 最初に確認する場所 |
| V38-M03 | 長さ設定後 | Chunks `2`、Seconds per Chunk `5`、Total Length `10 seconds` | 合計10秒の指定 |
| V38-M04 | 出力サイズ設定 | Size Sourceと適用中のWidth/Height | First ImageとManualの違い |
| V38-M05 | Review準備完了 | Run `Review Each Chunk`、Progress On、緑色のReadyカード | 最初のQueue準備完了 |
| V38-M06 | Chunk 1実行中 | ComfyUI Queueと進行表示 | 最初は5秒だけ作る |
| V38-M07 | Review Ready | `Chunk 1 is ready for review`のアンバー表示 | 5秒出力は正常 |
| V38-M08 | Reviewの3操作 | Use it and continue、Try this chunk again、Use it and finish the rest | 3つの分岐 |
| V38-M09 | Continue選択後 | 選択ボタンの`✓` | 選択だけでは生成しない |
| V38-M10 | 2回目のQueue | ComfyUI Queue | 採用済みChunk 1を再利用する |
| V38-M11 | 10秒完成後 | 完成状態、Finalize、保存結果 | 2チャンクの完成 |
| V38-M12 | Settingsへ戻る | Back to Settings | Reviewを失わず設定を見る |
| V38-M13 | Reviewへ戻る | Return to Review | 保留中のReviewへ戻る |
Quick Startの撮影が終わったら、同じ撮影用Runを再利用して再生成と履歴を撮ります。
| Shot ID | 撮影する状態 | 画面で確認する要素 | 本文で伝えること |
|---|---|---|---|
| V38-R01 | 再生成選択前 | 現在のChunkとTake | 作り直す対象 |
| V38-R02 | 再生成選択後 | Try this chunk againの`✓` | 同じChunkの別Takeを作る |
| V38-R03 | 再生成完了後 | 新しいTakeとReview状態 | 前のTakeは消えない |
| V38-H01 | Render Historyを開く | Take一覧と現在の選択 | 閲覧だけではcanonicalを変えない |
| V38-H02 | 過去Takeを選ぶ | Previous/Nextまたは現在の選択表示 | 候補を比較する |
| V38-H03 | Take採用前 | Use This Take | Queue後にcanonicalを変更する操作 |
| V38-H04 | 途中から継続する前 | Continue From Hereと再利用範囲 | 選択地点より後ろだけを作り直す |
## サイズ・入力・Advancedは目的別に追加撮影する
Quick Startへすべてを詰め込まず、次の画面は独立した章で撮ります。
| Shot ID | 撮影する状態 | 必須の比較 |
|---|---|---|
| V38-S01 | Size Source `First Image` | 画像の縦横比と参照表示のWidth/Height |
| V38-S02 | Size Source `Manual` | 編集可能な32-pixel単位のWidth/Height |
| V38-I01 | First Image接続 | I2VA/FL2VAでのサイズ決定 |
| V38-I02 | Reference Image接続 | First Imageとは異なる役割 |
| V38-I03 | Video Guide接続 | Video Guide SizeとFrames |
| V38-A01 | Reference Audios | Audio 1/2/3の順序 |
| V38-A02 | Audio Continuity | On/Offの意味と最終音声との違い |
| V38-X01 | Advancedを開く | Mainにない高度な項目の位置 |
| V38-X02 | Second Pass接続 | Review完了後のsequenceに使うこと |
## 異常系は実際の表示を再現して撮る
正常系の撮影後、データを壊さない条件で次の状態を意図的に再現します。各ケースは、表示された文言と解決手順が現在の実装に一致することを確認してから掲載します。
| Shot ID | 症状または表示 | マニュアルで案内する確認 |
|---|---|---|
| V38-T01 | 最初のQueueで5秒だけ出た | Review Each Chunkの正常動作 |
| V38-T02 | 次の操作が表示されない | Queue完了、Progress On、Chunks 2以上、画面更新 |
| V38-T03 | 操作を選んでも生成されない | 選択後にQueueが必要 |
| V38-T04 | Chunksが1 | 次のChunkが存在しない |
| V38-T05 | fixedを求める案内 | Control After GenerateとSeed lineage |
| V38-T06 | First Imageが届かない | 表示中のManual canvasへのfallback |
| V38-T07 | 保存済みprefixを再利用しない | Run Name、Seed、Prompt Plan、生成契約の差 |
| V38-T08 | Review途中でSecond Passを使おうとした | sequence確定後に実行 |
| V38-T09 | 音声境界や冒頭語の欠落を報告する | Workflowと再現条件を保存して報告 |
| V38-T10 | 長尺で色・質感・identityが変化する | 現行の既知制限と報告に必要な情報 |
T09とT10は原因を決めつけません。実際のバグ、設定差、説明不足を分けられるよう、報告テンプレートへ誘導します。
## スクリーンショットは同じ規則で保存する
画像は`docs/images/v38-manual/`へ置く想定です。撮影を始めるまでは空フォルダを作りません。
ファイル名は次の形式にします。
```text
v38-m01-standard-workflow.png
v38-m05-review-ready-to-queue.png
v38-m08-review-actions.png
v38-h04-continue-from-here.png
v38-t05-control-after-generate-fixed.png
```
元画像を保管する場合は`*-raw.png`、掲載用に注釈を加えた画像は通常名とします。注釈は番号、短いラベル、必要最小限の枠線に限定します。文字やsocketを覆わず、色だけに意味を持たせません。
## Computer Use撮影は観察と確認を1ステップずつ行う
撮影時はComputer Useで現在のComfyUIウィンドウを選び、操作前に画面状態を確認します。クリックや入力後は新しい画面状態を取得し、古い座標や要素番号を再利用しません。
各Shotは次の手順で確定します。
1. 台本の前提状態を作る
2. 表示ラベルと値を画面上で読む
3. スクリーンショットを取得する
4. Shot ID、Workflow、設定、実行前後を記録する
5. 画像と本文が同じ操作を示すか確認する
6. 次のShotへ進む
ログイン、権限変更、公開投稿、ファイル送信など、画面撮影に不要な外部操作は行いません。個人情報や認証情報が見えた場合は撮影を止め、撮影用環境を整え直します。
## 完成版には再現可能なバグ報告テンプレートを付ける
問い合わせ時には、少なくとも次を添えてもらいます。
- Continuum version
- ComfyUI version
- Workflow JSON
- Prompt全文とPrompt Format
- Model、LoRA、Sampler、Steps、SIGMAS
- SeedとControl After Generate
- ChunksとSeconds per Chunk
- ContinuityとAudio Continuity
- RunとProgress
- Width/HeightとSize Source
- 使用したFirst/Last/Reference Image、Video Guide、Driving/Reference Audioの有無
- どのChunk境界で起きたか
- Status/Report全文
- 問題が分かる短い出力またはスクリーンショット
音声の冒頭語が欠ける場合は、期待した台詞、実際に聞こえた台詞、欠落したChunk番号も記録します。ドリフトの場合は、開始Chunkと最も目立つChunkを示します。
## 撮影後は画面だけで手順を判断しない
完成判定では、画像の見た目に加えて実際の動作を確認します。
- すべての画像が現在のV3.8 UIである
- 表示名が実装と完全に一致する
- Quick Startを初見の利用者が順番どおり実行できる
- Review操作を選ぶ工程とQueueする工程が分かれている
- 再生成で前のTakeが保持される
- Continue From Hereの再利用範囲が正しい
- Coreノードの標準表示名を変更していない
- 画像内に個人情報や不要なローカルパスがない
- 英語版と日本語版で同じ画像を安全に共有できる
- README、完成マニュアル、実画面の説明が矛盾しない
撮影・本文作成後は、手順を最初から一度再実行します。画像と文章だけを見て再現できない箇所は、UI改善候補、マニュアル修正、実装バグのいずれかへ分類します。
## 次回の開始指示
ユーザーから「V3.8マニュアルの撮影を開始」「初心者向けマニュアルを作成」などの指示があった場合は、この文書を正本として再開します。まず撮影開始条件を確認し、未確定のUIやドリフト表示方針があれば、その部分だけを保留します。条件がそろっていればV38-M01から順に進めます。
公開、commit、push、Civitai掲載は、この台本の作成や撮影開始には含まれません。別の明示指示が必要です。
+84
View File
@@ -0,0 +1,84 @@
# V3.8 Open Integration Contract
This document defines the supported boundary between H3 Continuum V3.8 and
external processing, decoder, and acceleration nodes. It does not add a public
node or change the Sampling, State, Session, Run Storage, or Assembly Plan
schemas.
## Supported pipeline
```text
H3 Continuum Sampler V3.8
-> external latent processor or latent upscaler (optional)
-> H3 Continuum Second Pass
-> Core Video/Audio Decode
-> H3 Continuum Finalize
-> Core Save Video
```
Pixel upscalers remain outside the latent boundary. If a workflow decodes to
pixels for processing, it must encode the result back to one H3 video LATENT per
physical group before Second Pass.
## External processor contract
An external processor may change only the spatial geometry of the video
latents. It must preserve:
- physical-group count and order;
- one indivisible entry for every Long Terminal Merge group;
- video batch, 24 channels, and temporal latent length;
- one common target H/W across every physical group;
- the matching first-pass audio latent list and its order;
- the original Assembly Plan input.
Spatial video dimensions may be preserved or enlarged. Smaller dimensions,
NaN/Inf values, changed B/C/T geometry, a changed group count/order, or a changed
audio shape are rejected before Second Pass Sampling.
Second Pass rebuilds supported conditioning for the target geometry, samples
complete physical groups, and returns a copied Assembly Plan with only target
geometry and Second Pass execution metadata added. It does not mutate the input
plan or Run Storage. The accepted first-pass audio LATENT objects are returned
unchanged; temporary audio produced during video refinement is discarded.
## Decoder boundary
H3 Continuum has no decoder allowlist. Any Core or third-party Video/Audio VAE
path, including a TensorRT-backed VAE, is compatible when it implements the
public ComfyUI contracts and produces the normal decoded types consumed by
Finalize:
- `IMAGE`: `[frames, height, width, channels]` per physical group;
- `AUDIO`: a mapping with `waveform` and positive `sample_rate` per physical
group.
Finalize depends on those public decoded types and the Assembly Plan, not on a
decoder class name. Decoder fallback, tiling, device placement, and acceleration
are owned by the decoder or ComfyUI Core.
## Acceleration boundary
SageAttention, Sol-Attn, Spectrum, and comparable accelerators remain external
MODEL wrappers. Continuum uses ComfyUI's public ModelPatcher wrapper APIs,
preserves existing wrapper/model options on call-local clones, and publishes
only the documented `h3_continuum` interoperability hint when continuation
context exists.
Continuum does not select an attention backend, import accelerator-private
functions, or globally monkey-patch an accelerator. Missing optional accelerator
markers are informational and never become package dependencies.
## Ownership summary
| Owner | Responsibility |
|---|---|
| Continuum | Physical-group identity/order, temporal ownership, conditioning reconstruction, Second Pass validation/Sampling, first-pass audio passthrough, target-geometry plan copy, Finalize assembly |
| External processor | Spatial Video LATENT transformation while preserving B/C/T, group order, and finite values |
| Core or decoder node | Video/Audio VAE decode/encode behavior, tiling, fallback, device lifecycle |
| Accelerator wrapper | Sage/Sol/Spectrum backend selection and wrapper lifecycle |
| User workflow | Correctly wire the matching Video LATENT list, first-pass Audio LATENT list, and original Assembly Plan |
The contract deliberately avoids an All-in-One node. New processors and
decoders can integrate through public ComfyUI types without requiring a
Continuum release, provided these invariants remain true.
+35
View File
@@ -0,0 +1,35 @@
# V3.8 Release and Migration Policy
## Supported release
V3.8 is the current supported H3 Continuum product. Its package exports seven Node IDs:
```text
H3ContinuumSamplerV38
H3ContinuumReferenceAudios
H3ContinuumAssembleSeamV35
H3EasyLoadImage
H3EasyLoadAudio
H3ContinuumLoadVideo
H3ContinuumSecondPassV35
```
The assembler, loader, and Second Pass IDs are retained while their V3.8 display names are simplified. AUDIO-R1 adds one modular Reference Audios helper and appends one optional Sampler bundle socket. The Resolution / Size Source UX keeps the old Aspect input hidden for compatibility and appends Size Source, Width, and Height; saved fixed-Aspect workflows migrate to an equivalent Manual canvas. Sampling, Run Storage, State/Session, and Assembly contracts are unchanged.
## Saved workflows from older releases
Only the seven IDs listed above are exported by V3.8, including the retained Finalize, loader, and Second Pass IDs. Other public Node IDs from V3.7 and earlier are not exported. ComfyUI can therefore show an unknown node when a saved workflow refers to an ID outside this list. This is an intentional support boundary, not a request to replace the unknown node with a superficially similar V3.8 node.
- Use tag `v3.7.0` for V3.7 workflows.
- Use tag `v3.6.0` for V3.6 workflows.
- V3.4/V3.5 archives will be finalized during Release Preparation. Until then, use the matching historical commit or release asset already associated with that workflow.
Do not mix a historical workflow's private schema with the V3.8 package. Install the matching historical package, open and render the workflow there, or rebuild the graph explicitly with the V3.8 public nodes.
## V3.8 workflow and external integration
The declared Registry payload and GitHub distribution use `examples/workflows/MiniMax_H3_Continuum_V38.json` and `examples/workflows/MiniMax_H3_Continuum_V38.zip`. The ZIP contains exactly the same JSON: one graph, not two variants. This is the user-supplied Spectrum workflow, not the former dependency-free Core template. It requires external Spectrum, rgthree, KJNodes, and ComfyUI-Easy-Use nodes, which Continuum does not bundle or install. Its saved default is the Spectrum path; users may switch the same graph to one task-matched LightX2V Turbo LoRA after disabling Spectrum, but all custom-node types remain in the graph.
The supplied JSON and ZIP are preserved byte-for-byte, including prompt, media filenames, custom titles, and settings. Select local files and disable unused inputs before rendering. A saved title such as `Save 3x5s Video` does not control duration; the Sampler settings do. The output path uses Core Video/Audio Decode, Finalize, Core Create Video, and Core Save Video (with the supplied Easy Use cleanup wrapper before Save). External latent processors and upscalers connect through H3 Continuum Second Pass; the old integrated Hi-Res Fix is not part of the V3.8 standard workflow. The supported processor, decoder, and accelerator boundaries are defined in [V3.8 Open Integration Contract](V38_OPEN_INTEGRATION_CONTRACT.md). Registry validate/pack and publication remain separate gates; a GitHub source commit does not claim they have run.
Tests, runner/probe/diagnostic tools, internal development documents, Labs nodes, and historical workflows remain available in the GitHub source for development and audit purposes but are excluded from the Registry archive. The archive retains `tools/__init__.py` and `tools/p20_file_backed_tensor_poc.py`, which are runtime dependencies of the Production file-backed buffer path, plus `tools/verify_runtime.py` for verification. `MANIFEST.sha256` validates its declared source files; the staged archive instead carries `REGISTRY_MANIFEST.sha256`. These development assets are not part of the supported V3.8 searchable node surface.
Binary file not shown.

After

Width:  |  Height:  |  Size: 7.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 718 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.9 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.6 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 282 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 26 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 62 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 47 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 107 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 112 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 172 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 55 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 17 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 127 KiB