From 55fc2d545f61d7de94877940fbfcdc89f24d4ed1 Mon Sep 17 00:00:00 2001 From: ukr8b3g-cmyk Date: Sun, 27 Sep 2026 14:31:40 +0900 Subject: [PATCH] Update README for current main validation and prompt behavior --- README.md | 12 ++++++++---- README_JA.md | 24 +++++++++++++++++++++--- 2 files changed, 29 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index fbcc8af..52ae93a 100644 --- a/README.md +++ b/README.md @@ -33,7 +33,7 @@ The two comparison workflows are intentionally separate from the unchanged offic Local acceptance passed with full CPU `1424 passed / 1 skipped / 0 failed`, browser save/reload, and Follow/Repeat `2 x 5 s` GPU runs at 704x416, 24 fps, 240 frames, and 10-second 32 kHz stereo audio. Follow changed to the later source interval for Chunk 2 while Repeat retained the shared prefix; both completed without OOM, NaN, allocation failure, or crash. Peak observed VRAM was about 15.6–15.7 GiB on the tested RTX 5060 Ti 16 GB system, so 16 GB headroom was small. This is a functional mode-separation result, not a universal speed or subjective-quality guarantee. See [Timeline Video Experimental](docs/TIMELINE_VIDEO_EXPERIMENTAL.md). -> **V3.8X2** is the product and workflow label for package `3.8.3`. It keeps the V3.8 production sampler and adds optional Reference Images 4–9 plus the built-in Decode Cache Helper. The older V3.8.0 package remains available from tag [`v3.8.0`](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/tree/v3.8.0). +> **V3.8X2** is the product and workflow label for package metadata `3.8.3`. Current `main` includes the post-3.8.3 loader-persistence repair: the official workflows use Core Load Audio and Core Load Video -> H3 Continuum Video Adapter, while the deprecated Continuum Audio/Video loader IDs remain registered for saved-workflow compatibility. V3.8X2 also includes optional Reference Images 4–9 and the built-in Decode Cache Helper. Timeline Video remains Experimental on `main`. The older V3.8.0 package remains available from tag [`v3.8.0`](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/tree/v3.8.0). exec-9cfa73b4-c1d3-4416-8950-fa661b946638_2 @@ -1020,7 +1020,7 @@ The retired V3.3 Timeline Sampler and earlier timeline-audio paths remain histor ## Installation -V3.8 is verified against ComfyUI 0.34.2. Historical acceptance records below may mention older ComfyUI versions; they are not the current installation target. +`pyproject.toml` declares `requires-comfyui >=0.32.0`. The current generation baseline verified by this project is ComfyUI `0.34.2`. The current V3.8X2 live-runtime acceptance evidence recorded here is for `0.34.2`, not `0.32.x`, and seam behavior on newer Core versions is currently being investigated in Issue #24. Treat `0.34.2` as the current verified baseline, not as the minimum install version or a guarantee that all newer Core versions behave identically. Historical acceptance records below may mention older ComfyUI versions. ### Updating an existing installation @@ -1190,7 +1190,9 @@ Not recommended: [0-5s] Describe the scene. ~~~ -The second form is not recognized as a Timeline header. When **Prompt Format = Auto**, it may therefore be interpreted as a Fixed prompt instead, causing the complete text to be reused across chunks. +The second form is not recognized as a Timeline header. With **Prompt Format = Auto**, it is detected as Fixed. With **Prompt Format = Timeline**, a Timeline parse error currently fails open to Fixed and emits diagnostic `H3C-P100`; the complete text can therefore be reused across all chunks. + +A Timeline that parses successfully but does not cover a chunk emits `H3C-P101` and reuses the previous prompt, or the earliest valid section for a leading gap. To avoid accidental repeated actions, explicitly cover every chunk interval. The time ranges should normally match the configured `chunk_seconds`. @@ -1345,7 +1347,9 @@ Use a 24 fps source for `Video Guide Frames`. `Load Video (Upload)` may accept f The V3.8X2 public-surface suite checks the exact ten-node export, both unchanged official workflow names and matching ZIP payloads, the separate experimental Follow/Repeat workflows, declared external dependencies, Registry exclusions, the preserved V3.8 widget/socket prefix plus the appended mode widget, and presentation-only `Show Advanced Settings` / `Hide Advanced Settings` behavior. Registry payload hashes are recorded in `REGISTRY_MANIFEST.sha256`; source integrity is recorded in `MANIFEST.sha256`. -**Latest V3.8X2 preparation evidence:** after the Timeline Video integration, the full CPU suite passed **1,424 passed / 1 skipped / 0 failed**. Browser persistence and Follow/Repeat `2 × 5 second` GPU gates passed; both produced 704×416, 24 fps, 240-frame, 10-second video with 32 kHz stereo audio and no OOM, NaN, allocation failure, or crash. The prior dedicated Review Functional Gate passed a `3 × 5 second` run: Q1–Q3 generated one physical group at a time, and Q4 reused all three groups with `3 reused / 0 generated`; Q3 and Q4 had identical decoded RGB and PCM SHA-256 values. The separate nine-reference Gate is recorded below. These checks confirm functional execution, prefix reuse, AV reconstruction, mode separation, and the tested nine-reference path; they are not a full subjective image- or audio-quality rating. +**Current `main` HEAD CPU/CI evidence (`88363ccd`):** GitHub Actions run `35811479080` completed successfully on Python 3.11 with **1,429 passed / 3 skipped / 0 failed**. + +**Most recent browser/GPU acceptance:** the Timeline Video integration gate previously passed **1,424 passed / 1 skipped / 0 failed**, browser save/reload, and the Follow/Repeat `2 × 5 second` GPU functional runs described above. Those runs produced 704×416, 24 fps, 240-frame, 10-second video with 32 kHz stereo audio and no OOM, NaN, allocation failure, or crash. They predate the current PackedLayout HEAD and are not presented as a fresh GPU validation of `88363ccd`. The prior dedicated Review Functional Gate passed a `3 × 5 second` run: Q1–Q3 generated one physical group at a time, and Q4 reused all three groups with `3 reused / 0 generated`; Q3 and Q4 had identical decoded RGB and PCM SHA-256 values. The separate nine-reference Gate is recorded below. These checks confirm functional execution, prefix reuse, AV reconstruction, mode separation, and the tested nine-reference path; they are not a full subjective image- or audio-quality rating. ### Nine-reference input gate (0.3 MP reference images) diff --git a/README_JA.md b/README_JA.md index 9517c3a..eef547f 100644 --- a/README_JA.md +++ b/README_JA.md @@ -33,7 +33,7 @@ Core Load Video → H3 Continuum Video Adapter → Timeline Video Frames ローカル受入ではFull CPU `1424 passed / 1 skipped / 0 failed`、ブラウザ保存・再読込、Follow/Repeatの`2 × 5秒` GPUテストがPASSしました。両方とも704×416、24fps、240フレーム、映像10秒、32kHz stereo音声10秒で、OOM/NaN/allocation failure/crashはありません。FollowはChunk 2で後半区間へ切り替わり、Repeatは同じ先頭側参照を維持しました。RTX 5060 Ti 16 GBで観測した最大VRAMは約15.6~15.7 GiBで、16 GBの余裕は小さい条件です。これは機能・mode分離の受入結果であり、一般的な速度や主観画質の保証ではありません。詳細は[Timeline Video Experimental](docs/TIMELINE_VIDEO_EXPERIMENTAL.md)を参照してください。 -> **V3.8X2**はpackage `3.8.3`の製品名・Workflow名です。V3.8 Production Samplerを維持し、任意のReference Image 4~9と内蔵Decode Cache Helperを追加しています。旧V3.8.0は[`v3.8.0`タグ](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/tree/v3.8.0)から導入できます。 +> **V3.8X2**はpackage metadata `3.8.3`の製品名・Workflow名です。現在の`main`には3.8.3以降のLoader保存・復元修正が入り、公式WorkflowはCore Load AudioとCore Load Video → H3 Continuum Video Adapterを使用します。旧Continuum Audio/Video Loader IDは保存Workflow互換用として残します。Reference Images 4~9と内蔵Decode Cache Helperを含み、Timeline Videoは`main`上のExperimental機能です。旧V3.8.0は[`v3.8.0`タグ](https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum/tree/v3.8.0)から導入できます。 ## V3.8X2 公式Workflow @@ -554,6 +554,22 @@ outputs: images / audio / result 当時のV2.1.7では、旧`H3ContinuumSamplerV2`をLegacy/Coreノードとして登録し、既存WorkflowのノードID、入力順、出力順を維持していました。これはV3.8の公開範囲を示す説明ではありません。このIDを使う旧Workflowは対応するhistorical Release/tagで開いてください。 +## Timeline Promptの注意 + +`Prompt Format = Timeline`では、`[0-5s]`のようなtime-range headerを必ず単独行に置き、prompt本文は次の行から記述してください。 + +```text +[0-5s] +最初の5秒の動作を記述します。 + +[5-10s] +次の5秒の動作を記述します。 +``` + +`[0-5s] prompt text`のように同じ行へ本文を書く形式はTimeline headerとして認識されません。`Prompt Format = Auto`ではFixedとして判定されます。`Prompt Format = Timeline`を明示した場合でも、現行実装はTimeline parse errorで生成を停止せず、diagnostic `H3C-P100`を出してFixedへfail-openします。この場合、入力全体が各Chunkで再利用されるため、同じactionが繰り返されるように見えることがあります。 + +また、Timeline自体が正しくparseされても、あるChunkの時間範囲が未指定の場合は`H3C-P101`を出し、直前のpromptを再利用します。先頭側にgapがある場合は最初の有効sectionを使います。意図しないaction反復を避けるため、全Chunkの時間範囲を明示してください。 + ## Continuity - `Auto — conservative` @@ -577,7 +593,7 @@ UNET -> SageAttention -> Sol-Attn -> LoRA -> Spectrum -> H3 Continuum Sampler ## インストール -V3.8はComfyUI 0.34.2で検証しています。以下の歴史的な受入記録には旧ComfyUI版も登場しますが、現在のインストール目標ではありません。V3.8の依存を満たす限り、ComfyUIの最新版は必須ではありません。 +`pyproject.toml`では`requires-comfyui >=0.32.0`を宣言しています。現在このプロジェクトで実生成まで検証済みの基準はComfyUI `0.34.2`です。現行V3.8X2についてREADMEに記録されているlive runtime受入証拠は`0.34.2`であり、`0.32.x`ではありません。新しいCoreについてはIssue #24のseam regressionを調査中です。したがって`0.34.2`は現在の検証基準であり、最低インストールversionや、すべての新しいCoreで同一挙動を保証する意味ではありません。以下の歴史的な受入記録には旧ComfyUI版も登場します。 ZIPを展開して、`ComfyUI-H3-Continuum`フォルダーを`ComfyUI/custom_nodes/`へ置き、ComfyUIを再起動します。 @@ -589,7 +605,9 @@ ZIPを展開して、`ComfyUI-H3-Continuum`フォルダーを`ComfyUI/custom_nod 現在のV3.8X2 Public Surface suiteは、正確な10 ID export、変更していない公式Workflow 2名称と各ZIP内JSONの同一性、別名のExperimental Follow/Repeat Workflow、外部依存、Registry除外、既存V3.8 widget/socket先頭契約と末尾追加mode、`Show Advanced Settings`/`Hide Advanced Settings`による表示切替を確認します。Registry配布対象のハッシュは`REGISTRY_MANIFEST.sha256`、source側の整合性は`MANIFEST.sha256`で管理します。 -**最新のV3.8X2準備証拠:** Timeline Video統合後のFull CPU suiteは**1,424 passed / 1 skipped / 0 failed**です。ブラウザ保存・再読込とFollow/Repeatの`2 × 5秒` GPU GateもPASSし、両方とも704×416、24fps、240フレーム、映像10秒、32kHz stereo音声10秒で完走しました。OOM/NaN/allocation failure/crashはありません。従来のReview Functional Gateでは`3 × 5秒`を実行し、Q1~Q3はphysical groupを1つずつ生成、Q4は`3 reused / 0 generated`で全3 groupを再利用し、Q3とQ4の復号後RGB/PCM SHA-256が一致しました。9枚Reference Imageの別Gateは下記に記録しています。これは機能実行、prefix再利用、AV再構築、mode分離、テストした9枚経路の確認であり、画像・音声の総合的な主観品質評価ではありません。 +**現在の`main` HEAD CPU/CI証拠(`88363ccd`):** GitHub Actions run `35811479080`はPython 3.11で成功し、**1,429 passed / 3 skipped / 0 failed**でした。 + +**直近のbrowser/GPU受入:** Timeline Video統合時のGateではFull CPU **1,424 passed / 1 skipped / 0 failed**、ブラウザ保存・再読込、Follow/Repeatの`2 × 5秒` GPU functional runがPASSしました。両方とも704×416、24fps、240フレーム、映像10秒、32kHz stereo音声10秒で完走し、OOM/NaN/allocation failure/crashはありません。ただし、これらのbrowser/GPU結果は現在のPackedLayout HEADより前のものであり、`88363ccd`を新たにGPU検証した結果としては扱いません。従来のReview Functional Gateでは`3 × 5秒`を実行し、Q1~Q3はphysical groupを1つずつ生成、Q4は`3 reused / 0 generated`で全3 groupを再利用し、Q3とQ4の復号後RGB/PCM SHA-256が一致しました。9枚Reference Imageの別Gateは下記に記録しています。これは機能実行、prefix再利用、AV再構築、mode分離、テストした9枚経路の確認であり、画像・音声の総合的な主観品質評価ではありません。 ### 9枚Reference Image入力Gate(0.3 MP参照画像)