Compare commits

...
22 Commits
Author SHA1 Message Date
ketle-manandClaude Sonnet 5 74eb8b779f Merge branch 'feature/video-edit-tab': Video Edit tab (v0.7.0)
Video タブに簡易動画編集機能(Editサブタブ)を新規実装。クリップの
タイムライン配置、トリム(Clipchamp風ビジュアルスクラバー)、複数
クリップの結合書き出し、静止画/アニメーション画像クリップ対応。
あわせてAssetサブタブをPlan/Editと並ぶ中央下部へ移設し検索・グリッド
/テーブル表示切替を追加、プレビュー枠の高さ固定、Frame保存のVideo
Assets登録とAsset→PlanのFirst/Last Image連携も実装した。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 13:32:40 +09:00
ketle-manandClaude Sonnet 5 baed398fe8 chore(release): v0.7.0 - Video Edit tab初回リリース + Asset移設・トリムスクラバー等
pyproject.tomlのバージョンを0.7.0に更新し、DEVLOG.mdとREADME.mdを
今回のリリース内容(Edit subtab全体の初回公開、Assetサブタブの中央下部
移設、トリムパネルのClipchamp風スクラバー、Frame保存のVideo Assets
登録、Asset→PlanのFirst/Last Image連携)に合わせて更新した。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 13:31:47 +09:00
ketle-manandClaude Sonnet 5 77cfedb243 docs(video-tab): Video Tabヘルプを現行UIとEdit/Asset機能に合わせて更新
Asset subtabが左サイドバーから中央下部(Plan/Editと並ぶ)に移設された
ことを反映し、Project subtabの説明からも「Assetの隣」という古い記述を
削除。Editサブタブ(クリップタイムライン・トリムスクラバー・書き出し)
とAssetサブタブ(検索・グリッド/テーブル切替・First/Last Image連携)の
説明を新規項目として追加し、Frameタブの説明にVideo Assets登録
チェックボックスを追記。index.html・i18n.js(en/ja/zh)・app.jsの
helpIdMapの3点セットで更新。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 13:28:28 +09:00
ketle-manandClaude Sonnet 5 ad70622942 feat(video-tab): FrameのVideo Assets登録チェックボックスとAsset→Plan画像連携を追加
Frameタブの「Outputに保存」にオプションのチェックボックスを追加し、
チェック時は保存したフレームをGalleryの__Video Assets__グループに
自動登録できるようにした。

またAssetタブの画像アセット詳細に「First Imageに設定」「Last Imageに
設定」ボタンを追加し、Planタブの選択中ブロックのFirst/Last Imageへ
直接送れるようにした(動画クリップでは非表示、画像のみ対象)。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 13:19:51 +09:00
ketle-manandClaude Sonnet 5 f726418aeb feat(video-edit-tab): トリムパネルにClipchamp風のビジュアルスクラバーを追加
動画クリップのトリム編集を、テキスト入力のみだったUIから、時間目盛り・
再生位置(playhead)・ドラッグ可能なトリムハンドルを備えたビジュアルな
スクラバーに拡張。プレビュー動画のcurrentTimeとplayheadが同期し、
トラックのクリック/ドラッグでシークも可能。既存のStart/End数値入力・
「現在位置を使用」ボタンとは同じcommit経路で連動する。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 12:55:30 +09:00
ketle-manandClaude Sonnet 5 a917e82ad7 feat(video-tab): AssetをPlan/Editと並ぶ中央下部の第3サブタブに移設
左サイドバーにあったAsset一覧・詳細パネルを中央ペイン下部に移設し、
左=素材一覧(サムネイル/テーブル切替可)・右=選択ファイルの詳細という
2カラムレイアウトに再構成。一覧上部にグループ切替・ファイル名検索・
表示切替ボタンを追加した。左サイドバーはProjectのみのシンプルな
パネルになった。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 12:32:54 +09:00
ketle-manandClaude Sonnet 5 2fc2365461 fix(video-tab): プレビュー枠の高さを固定してPlan/Editの位置ずれを解消
動画ソースのネイティブサイズによってプレビュー枠(min-height)が伸縮し、
中央ペイン下部のPlan/Editサブタブの表示位置が動画ごとに動いてしまう問題を修正。
枠の高さを固定し、動画/画像は縮小表示のみ(拡大はしない)に変更した。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 12:18:58 +09:00
ketle-manandClaude Sonnet 5 337fd6ecb8 docs: log Video Edit tab work-in-progress in DEVLOG
Records this session's feature/video-edit-tab branch work (unreleased,
no version bump) — Edit subtab MVP, Phase 0 node-behavior findings,
image-clip support, and the audio-mismatch fix — under a new
Unreleased section, per existing DEVLOG convention where every
version heading corresponds to an actual tagged release.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-16 20:13:07 +09:00
ketle-manandClaude Sonnet 5 831ba1bd43 Support still/animated image clips in the Edit timeline
Asset's Video Assets/Video Temp groups already list any image tagged
into them (no video-only filter), but selecting one always fed a
<video> element, which can't render image formats — the preview
stayed blank and "Send to Edit" produced a broken clip.

Adds an <img> companion to both preview panes (video-preview.js gains
a mediaType param on setSourcePreview/setResultPreview) so images
preview correctly, and gives Edit-tab clips a kind: "video" | "image".
Image clips get a single editable hold duration instead of in/out trim
points, and export turns them into a real video segment via
LoadImage -> (ImageScale center-crop, only if resolution needs to
match another clip) -> RepeatImageBatch -> CreateVideo — verified on a
live instance to produce an exact-duration, concatenation-compatible
clip. The resolution-mismatch guard now only compares video clips
against each other, since images are auto-fit instead of blocked.

Also fixes a bug this surfaced: ConcatenateVideo hard-errors mixing a
clip with real audio (e.g. stereo/32kHz) next to a silent
image-derived clip. Multi-clip exports now strip audio from every
video clip too (via GetVideoComponents -> CreateVideo) so the whole
timeline is uniformly silent when concatenating; a lone clip keeps its
original audio since no concatenation occurs.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-16 20:10:07 +09:00
ketle-manandClaude Sonnet 5 899feb1bb5 Add sequential timeline preview sharing the Result pane with Export
Adds a Play/Stop toggle on the timeline toolbar that plays every ready
clip back-to-back (each trimmed to its in/out point) in the same
"Result" preview pane Export writes its finished output into — not a
new <video> element — so what's shown there is always exactly what
Export would currently produce. Clip-boundary advancement is driven by
timeupdate/ended listeners comparing against each clip's trimEnd.

video-preview.js gains getResultPreviewVideoElement() since driving
playback (seeking, listening for the trim-out point, swapping sources)
needs direct element access that setResultPreview()'s simple
src-and-visibility API doesn't provide.

Verified end-to-end on a live instance: 2-clip preview with automatic
mid-playback advancement at the first clip's trim-out, then export
producing the same combined duration the preview showed.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-16 17:55:12 +09:00
ketle-manandClaude Sonnet 5 075e2a8c62 Fix trim panel overflow and add timeline total duration display
The Start/End (seconds) inputs and their "use current position"
buttons were laid out side by side, letting the button label overflow
past the container edge and making the button hard to distinguish
from a text field. Stacks the button below the input instead, shrinks
it, and narrows the input column so both fit cleanly.

Also adds a running total-duration readout next to the Clear button,
summing every clip's trimmed length — updated automatically whenever
the timeline re-renders.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-16 17:46:46 +09:00
ketle-manandClaude Sonnet 5 77163de202 Fix Edit tab layout collapsing to center; drop its own dropzone
Root cause: a leftover CSS rule from the pre-implementation
"Editing tools coming soon" placeholder era (display:flex;
align-items:center; justify-content:center; dashed border) still
targeted .wfm-video-edit-panel and, coming later in the cascade,
silently overrode the real layout — shrinking the timeline, trim
panel, and export panel to their content width and centering them
instead of stretching full-width like the Plan subtab. Removed the
stale rule and gave the timeline track explicit width:100%/flex:none
so it stays a fixed full-width bar (matching Plan's track) regardless
of clip count.

Also removes the Edit subtab's own drop zone now that clips can only
be added via Asset's "Editへ送る" and the Video Source panel's
"Add to Edit" button — one fewer entry point to keep in sync, and the
now-unused videoEditDropLabel i18n key goes with it.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-16 17:38:22 +09:00
ketle-manandClaude Sonnet 5 7f0ecc2ba3 Redesign Video Edit timeline to match the Plan subtab's UI pattern
Replaces the vertical clip list (per-row ▲▼⧉✕ buttons) with a
horizontal timeline track whose blocks are left-aligned at their real
duration (px/sec scale) rather than stretched to fill the track like
Plan's blocks. Reordering moves to a shared toolbar below the track
(◀/▶/Duplicate/Delete/Clear acting on the selected clip), matching
Plan's "+ Split/+ Block/Delete" pattern, plus native HTML5
drag-and-drop reordering directly on the blocks.

Adds a new "Add to Edit" button on the Video Source panel so whatever
is loaded there (a plain drop, an Asset selection, a Frame/GIF source)
can be added to the Edit timeline explicitly — deliberately not
automatic on every Source drop, since Frame/GIF is a single-video tool
used far more often than multi-clip editing and auto-adding would
clutter the timeline.

Verified end-to-end on a live ComfyUI 0.36.0 instance: left-aligned
block widths, Asset -> Add to Edit handoff, move/duplicate/delete/
clear (with i18n'd confirm dialog), and export after a clear.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-16 17:24:51 +09:00
ketle-manandClaude Sonnet 5 ac733db81e Add Video Edit tab MVP: clip timeline, trim, and concatenate export
Implements the Edit subtab (previously a placeholder) with a minimal
clip timeline: add clips from Asset/local files, reorder/duplicate/
delete, trim per clip, and export by dynamically assembling a ComfyUI
API-format prompt ("Video Slice" per clip -> ConcatenateVideo when
multiple clips -> SaveVideo) run through the existing execution
infrastructure. Exported videos are tagged into the __Video Temp__
gallery group like Plan-tab runs.

Verified end-to-end against a live ComfyUI 0.36.0 instance, including
two bugs only caught by inspecting actual output (not just
execution_success): a missing WebSocket connect before trackProgress,
and VideoTrim silently no-opping on a flat trim value (switched to the
simpler, non-experimental "Video Slice" node instead). See
VIDEO_EDIT_TAB_PLAN.md for the full design and findings.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-16 17:05:31 +09:00
ketle-manandClaude Sonnet 5 7f2720ff8f release: v0.6.3 — Send CCボタンでMP4動画をComic Creatorの動画ツールへ送れるように対応
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-14 22:24:58 +09:00
ketle-manandClaude Sonnet 5 f9dbf3f399 release: v0.6.2 — Image Editタブにペンタブレット筆圧対応とFillツール(バケツ塗りつぶし)を追加
Draw/MaskツールをPointer Events化し、ペン筆圧でブラシサイズ/不透明度が
変化するように対応(マウス操作の挙動は変更なし)。Comic CreatorのImageタブ
から移植したFillツール(バケツ塗りつぶし、Solid/Gradient対応)を新規追加。
実機フィードバックを受け、Fillのグラデーションランプ/方向ダイヤルが
ペンタブレットで操作できない不具合も追加修正。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-09 09:25:36 +09:00
ketle-manandClaude Sonnet 5 a99bfc19a1 release: v0.6.1 — Galleryタブ検索の停止不具合・パフォーマンス問題を修正
検索欄のdebounce/AbortController追加、メタデータストアのロック保持時間短縮、
ponyxlWildcardsVaultフォールバック探索でのVaultフォルダ誤検出によるglob多発を解消。
53枚フォルダへの検索が3327ms→74msに改善。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-07 16:57:19 +09:00
ketle-manandClaude Sonnet 5 d75a9c812f release: v0.6.0 — Gallery/Image EditにPSD(Photoshop)対応を追加、Image Editのアクションバー/レイヤーパネル改善
- Gallery: 複数選択画像を1つのレイヤー付きPSDにまとめる「PSD作成」一括操作を追加
- Image Edit: Save PSD(レイヤー個別保持で書き出し)/Open PSD(レイヤー分解して読込)を追加
- Gallery→Image Edit: 複数選択画像を各レイヤーとして一括転送する「レイヤーとして編集」を追加
- Gallery: .psdファイルの一覧・サムネイル・プレビュー表示に対応(psd-tools合成→PNGキャッシュ)
- 実機発覚バグ2件を修正: サムネイル配信がイベントループをブロックする問題(run_in_executor化)、
  単一画像送信ボタンでPSDが1レイヤーに潰れる問題
- Image Edit: File Open改名、Open PSD配置、Close/複製レイヤーボタン追加、レイヤーヘッダー2段化
- ヘルプドキュメント更新+検証中に見つかった既存の翻訳漏れ/重複定義を修正
- 依存関係: psd-tools>=1.10を追加(pytoshopはWindowsでCコンパイラ必須のため不採用)

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-06 20:22:41 +09:00
ketle-man 925a249cbe chore: v0.5.8リリース準備
Tagger DBタブの一括削除機能(PR #2)追加に伴うバージョン更新
2026-09-02 01:19:13 +09:00
ketle-man e067f34cd4 Merge pull request #2 from censor-ed/feature/tagger-bulk-delete
検証済み: バックエンドAPI・フロントエンドの動作を実機(ComfyUI + ブラウザ)で確認。一括削除時のcount不整合と全選択チェックボックスのトグル挙動の2点を修正コミットで追加。
2026-09-02 01:10:37 +09:00
ketle-man 995e98e1aa fix(tagger): 一括削除のcount不整合と全選択トグルの挙動を修正
- handle_db_delete_bulk: レスポンスのcountを渡されたID数ではなく
  実際の削除件数(delete_bulkの戻り値)にする
- _dbToggleSelection: 常時反転するトグル方式ではなく、クリック後の
  ヘッダーチェックボックス自身の状態に全行を揃える一般的な全選択挙動にする
2026-09-02 01:05:14 +09:00
censor-ed 398be43060 feat(tagger): Tagger DBの複数選択削除を追加 2026-09-01 10:53:27 +09:00
37 changed files with 14687 additions and 9346 deletions
+6
View File
@@ -2,6 +2,12 @@
Condensed version-by-version index of DEVLOG.md (each line: version + one-line summary of what changed and why). Full rationale, code details, and "How to apply" lessons live in the excluded DEVLOG.md itself; this index exists so graphify can extract a queryable semantic node per release without feeding the full log to the local Ollama model. Regenerate with `python tools/generate_doc_index.py devlog` whenever DEVLOG.md changes.
- **v0.7.0(2026-09-17)** — プレビュー枠の高さ固定・AssetサブタブをPlan/Editと並ぶ中央下部へ移設・トリムパネルにClipchamp風スクラバー追加・Frame保存のVideo Assets登録とAsset→Plan画像連携
- **v0.6.3** — Send CCボタンでMP4動画をComic Creatorの新設「動画ツール」へ送れるように対応
- **v0.6.2** — Image Editタブにペンタブレット筆圧対応とFillツール(バケツ塗りつぶし)を追加
- **v0.6.1** — Galleryタブの検索が「読み込み中」のまま止まりクリアでも中断できない不具合、および50枚程度のフォルダでも数秒〜十数秒かかる不具合を修正
- **v0.6.0** — Gallery/Image Edit両タブにPSD(Photoshop)対応を追加 — 複数画像の一括PSD書き出し、レイヤー保存/読み込み、Gallery表示、Image Editのレイヤーパネル改善
- **v0.5.8** — Tagger DBタブに一括削除機能を追加(外部コントリビューターPRのレビュー・検証・修正・マージ)
- **v0.5.7** — 設定エクスポート/フルバックアップのドキュメント修正: v0.5.5のVideo Plan機能追加分の言及漏れ
- **v0.5.6** — バグ修正: WD Taggerで不正確なタグが生成される問題を修正(GitHub Issue #1)
- **v0.5.5** — Videoタブ全面刷新: Plan/Asset/Editバッチ生成 + Projectサブタブ + プレビュー2ペイン化 + Video Assets/Video Temp運用整理 + Galleryメタデータ消失バグ根本修正
+181 -24
View File
@@ -2,6 +2,153 @@
---
## v0.7.0(2026-09-17)
### プレビュー枠の高さ固定・AssetサブタブをPlan/Editと並ぶ中央下部へ移設・トリムパネルにClipchamp風スクラバー追加・Frame保存のVideo Assets登録とAsset→Plan画像連携
Edit サブタブMVP実装後、実際にユーザーが使う中で見つかった調整要望をまとめて対応した。
**プレビュー枠の高さ固定**: 中央ペインのSource/Resultプレビュー枠が`min-height`指定のみだったため、動画ソースのネイティブサイズ(特に縦長)によって枠が伸縮し、下のPlan/Editサブタブの表示位置がソースを選ぶたびに動いてしまっていた。枠を`height:260px`固定にし、動画/画像側は`width/height:auto; max-width/max-height:100%`(ネイティブサイズが枠より大きい場合のみ縮小、小さい場合は拡大しない)に変更して解消。
**AssetサブタブをPlan/Editと並ぶ中央下部の第3サブタブへ移設**: 左サイドバーにあったAsset一覧・詳細パネルを中央ペイン下部(Plan/Editと同じ場所)へ移設し、左=一覧(サムネイル/テーブル切替可)・右=選択ファイルの詳細という2カラムレイアウトに再構成。一覧上部にグループ切替・ファイル名検索・表示切替(▦グリッド/☰テーブル)ボタンを追加した。左サイドバーはProjectのみのシンプルなパネルになった。
**トリムパネルにClipchamp風ビジュアルスクラバーを追加**: 動画クリップのトリム編集がテキスト入力(開始/終了秒)のみだったのを、時間目盛り(ルーラー)・Sourceプレビューの`currentTime`と同期するドラッグ可能な再生ヘッド・時刻バッジ付きのドラッグ可能なイン/アウトハンドルを備えたビジュアルなスクラバーに拡張した。全位置を`clip.duration`基準の%指定にすることでpx/秒換算の管理を持たずに済ませている。既存のStart/End数値入力・「現在位置を使用」ボタンとは同じ`commit`関数を通して連動する。ハンドルドラッグ中は`_renderTimeline()`の再描画を避け、pointerup時のみ確定してパフォーマンスに配慮。playheadとトリムハンドルが同じ位置に重なってもハンドル操作を優先できるようz-indexを調整した。
**Frame保存のVideo Assets登録とAsset→Plan画像連携**: 右ペインFrameタブの「Save to Output」に「Add to Video Assets group」チェックボックスを追加し、チェック時は保存したフレームをGalleryの`__Video Assets__`グループへ自動登録できるようにした。またAssetタブの画像アセット詳細に「Set as First Image」「Set as Last Image」ボタンを追加し、PlanタブのFirst/Last Imageへ直接画像をアップロードできるようにした(動画クリップでは非表示、選択中のPlanブロックへ反映後Planサブタブへ自動切り替え)。
**検証**: いずれもKaptureで実機ComfyUI_5(ポート8189)に接続し、正方形/縦長動画でのプレビュー枠固定確認、Asset新レイアウトでのグリッド/テーブル切替・検索・選択、トリムスクラバーのplayhead同期・トラッククリックシーク・ハンドルドラッグ(playhead重なり時含む)・複数クリップ切替時のリスナー管理、Frame保存後のGalleryグループ登録をAPI経由で確認、Asset画像からFirst/Last Imageへの反映まで一通り実機確認済み。
**How to apply**: プレビュー枠のようにコンテンツ依存でサイズが変わる要素が、隣接するUIの表示位置に影響する場合は、コンテンツ側ではなく枠側を固定サイズにしてコンテンツを内側で縮小表示する方が安全([[project_video_edit_tab_feature_branch]])。ドラッグ可能なUI要素同士が同じ座標に重なる可能性がある場合は、操作頻度の高い方(今回はトリムハンドル)のz-indexを優先し、もう一方の当たり判定に埋もれないようにする。
関連: [[project_video_edit_tab_feature_branch]]
### Video タブ Edit サブタブ: 簡易動画編集機能(クリップタイムライン・トリム・結合・書き出し)を新規実装
これまで「Editing tools coming soon」のプレースホルダーのみだったVideoタブのEditサブタブに、Adobe Premiereライクな簡易動画編集機能を実装した。詳細設計・調査結果は[VIDEO_EDIT_TAB_PLAN.md](VIDEO_EDIT_TAB_PLAN.md)にまとめてある。
**MVP機能**: クリップのタイムライン配置(左詰め、実秒数×固定px/秒スケール)、トリム(開始/終了秒)、複数クリップの結合書き出し、タイムライン全体の疑似連続プレビュー、静止画/アニメーション画像クリップ(表示時間指定)、Clear/複製/削除/並べ替え(◀▶ボタンおよびネイティブドラッグ&ドロップ)。新規ファイル`static/js/video-edit-tab.js`が中心実装。
**Phase 0実機検証での重要な発見(当初の設計を訂正)**:
- ComfyUI Core 0.35〜0.36には`VideoSlice`という名前のノードは存在せず、正しいclass_typeは`"Video Slice"`(スペース込み)。`VideoTrim`(experimental)の`trim`入力はフラット値`{"start_time":..}`を渡すと**エラーにならず黙って何もトリムしない**(`.get("trim")`で一段余計にネストを剥がす実装のため)。実際に出力duration をprobeして初めて発覚し、「`execution_success`だけでは検証不十分」という教訓を得た。
- `ConcatenateVideo`のAutogrow入力`videos`は、ネストしたJSONオブジェクトではなく`"videos.video0"`のようなドット結合フラットキーがinputsのトップレベルに必要(ComfyUI Core `Autogrow.TemplatePrefix`のドット結合ロジックに由来)。
- `ConcatenateVideo`は解像度不一致で実行時ハードエラーになるため、クライアント側で事前チェックし、動画クリップ同士の不一致は書き出しをブロック、画像クリップは`ImageScale`(crop=center)で自動フィットして回避。
- 動画クリップ(音声あり)と画像由来クリップ(無音)を結合すると`ConcatenateVideo`が音声レイアウト不一致でエラーになる。複数クリップ結合時のみ、全クリップを`GetVideoComponents`→`CreateVideo`で無音統一する対策を実装(単一クリップ書き出しは音声を保持。**複数クリップ結合時は音声が失われるのが既知の限界**)。
**静止画/アニメーション画像クリップ対応**: 既存のAsset一覧(`__Video Assets__`/`__Video Temp__`グループ)には元々ビデオ専用フィルタが無く画像も一覧されていたが、プレビューが常に`<video>`要素前提で画像では何も表示されなかった。`video-preview.js`のSource/Resultプレビュー枠に`<img>`コンパニオン要素を追加し、`mediaType`引数で切り替えるよう拡張。画像クリップは`LoadImage`→(必要時)`ImageScale`→`RepeatImageBatch(amount=表示秒数×24fps)`→`CreateVideo`で正確な長さの動画セグメントに変換して書き出しグラフに組み込む。
**UI設計はPlanサブタブに合わせて再設計**: 当初は縦リスト+各行ボタンだったが、ユーザー指示によりPlanタブの横トラック+共有ツールバー方式(◀▶/複製/削除/クリアが選択中クリップに対して働く)に変更。タイムライン自体はPlanのブロックのようにflex-growで幅一杯に引き伸ばさず、実秒数の固定幅で左詰め(空きトラックはそのまま空く)。この過程で、Edit実装以前の「Editing tools coming soon」プレースホルダー時代の重複CSSルール(`align-items:center`等)が残存しており、実装後もタイムライン全体が中央に縮んで表示される不具合を発見・修正した。
**タイムライン連続プレビュー**: 新規`<video>`要素を追加せず、Export結果が最終的に書き出される「生成された動画」(Result)プレビュー枠を共有し、全クリップ(トリム区間反映)を順番に連続再生する機能を追加(「▶ プレビュー / ■ 停止」トグル)。ユーザー要望「このプレビューの動画=書き出しされる動画」に対応。
**検証**: 全JS/Pythonファイルを`node --check`/構文チェックで確認。開発元リポジトリと実行時`custom_nodes`は別実体のため、変更のたびに両フォルダへ同期しmd5ハッシュ比較で完全一致を確認。Kapture(ブラウザDevTools連携)で実機ComfyUI_5(ポート8189)に接続し、クリップ追加・トリム・並べ替え(ドラッグ含む)・複製・削除・クリア・連続プレビュー・単一/複数クリップ書き出し・静止画クリップの書き出し・動画+画像混在結合を一通り実機確認済み。
**How to apply**: ComfyUI Coreの新しいノード(特にexperimental扱いのもの)をAPIプロンプト形式で直接呼び出す際は、`/object_info`のクラス名・入力スキーマを鵜呑みにせず、実際に`/prompt`で実行して**出力を実測**するまで検証を終えたとみなさない——`execution_success`は型検証を通っただけで、パラメータが意図通り効いたかは別問題(今回`VideoTrim`のトリムが黙って無視される形で顕在化)。Autogrow(`COMFY_AUTOGROW_V3`)型の動的入力は、フラットなドット結合キー(`"prefix{name}"`を`.`区切りでinputsトップレベルに並べる)で渡す。
関連: [[project_dev_deploy_sync]]
## v0.6.3
### Send CCボタンでMP4動画をComic Creatorの新設「動画ツール」へ送れるように対応
Comic Creator(`eagle_comic_creator_spa/comfyui-comic-creator`、別リポジトリ)側にレイアウトタブの新機能「動画ツール」(MP4をコマに配置して再生・停止・音量/ミュート調整・指定フレームでの静止画キャプチャができる実験的機能)が追加されたのに伴い、Galleryタブの「Send CC」ボタンをこれに対応させた。
**問題**: 既存の`sendCcBtn`クリックハンドラ(`gallery-tab.js`)は、選択中ファイルのURLを`window.parent.insertImageFromUrl()`(レイアウトタブ宛て)または`window.parent._ccImageTab.loadFromUrl()`(Imageタブ宛て)へ渡すだけで、`.mp4`を判別する分岐が無かった。Comic Creator側の受け口は画像専用ロジックしか持たないため、動画を選んでSend CCを押しても正しく処理されなかった。
**対応**: `gallery-tab.js`に既にあった`isVideoFile()`ヘルパー(拡張子判定、Video Assetsグループのバッジ表示等で使用中)で選択中ファイルが動画かどうかを判定し、レイアウトタブ宛て(デフォルト経路)で動画の場合はComic Creator側が今回新設した受け口`window.parent.insertVideoFromUrl(url, filename)`を呼ぶよう分岐した。Imageタブ宛て(`_ccI2ITargetMode === 'image'`)で動画を選んだ場合は、Comic Creator側が今回Imageタブの動画編集には対応していないため、トースト(新規i18nキー`galleryVideoNotSupportedInImageTab`、英/日/中3言語)で案内して送信を中断するようにした。
**検証**: 双方の変更点を構文チェック(`node --check`)のみで確認。ComfyUI実機でのSend CC往復動作(Gallery側でmp4選択→送信→Comic Creator側でのオーバーレイ表示・再生確認)はユーザー側での実機確認待ち。
**How to apply**: Comic Creator側とWorkflow Studio側は別リポジトリだが、Send CC・Send to LI nodeのような`window.parent`/`window.opener`経由のクロスウィンドウ連携APIは、どちらか一方だけを変更すると壊れる。片方(今回はComic Creator側)に新しい受け口(`insertVideoFromUrl`)を追加したら、呼び出し元であるこちらのGalleryタブ側も同時に更新する必要がある。
## v0.6.2
### Image Editタブにペンタブレット筆圧対応とFillツール(バケツ塗りつぶし)を追加
ユーザーから「Comic CreatorのImageタブ同様にこちらのImage Editタブをペンタブレット対応させたい」という依頼を起点に、Draw/Maskツールの筆圧対応、Fillツール(バケツ塗りつぶし)の移植、そして実機フィードバックを受けた追加のペンタブレット不具合修正まで一連の作業を行った。
**Draw/Maskツールの筆圧対応**: `image-edit-tab.js`のキャンバスイベントを`mousedown/mousemove/mouseup/mouseleave`から`pointerdown/pointermove/pointerup/pointerleave`に変更し、両canvasに`touch-action: none`を設定。`PointerEvent.pressure`(ペン=実際の筆圧、マウス=ボタン押下中は常に0.5)を`DrawTool`/`MaskTool`の`onMouseDown`/`onMouseMove`に伝播させ、両ツールに`pressureEnabled`(既定ON)を追加——筆圧に応じてブラシサイズ(0.3〜1.7倍)とDraw側は不透明度(0.4〜1.6倍)を可変化する。pressure=0.5(マウス)では従来と同じ1.0倍になるため、マウス操作の挙動は変わらない。実装はComic Creator(`eagle_comic_creator_spa`)のImageタブで先行実装済みだった筆圧対応パターンをそのまま移植した。
**Fillツール(バケツ塗りつぶし)を新規追加**: Comic CreatorのImageタブにあった`FillTool.js`(スキャンライン方式のフラッドフィル、Solid/Gradient(線形・放射状)両対応、particle_engine.js由来のグラデーション評価ロジック)をそのまま移植し、`image-edit-tab.js`にツール切り替え・アクティブ化・クリック処理・プロパティパネル(Mode/Color/Ramp/Direction dial/Tolerance/Opacity)を追加、ショートカット`G`を割り当てた。ツールバーのボタンは`templates/index.html`に静的HTMLとして定義されていたため個別追加が必要だった(`TOOL_DEFS`配列だけでは表示されない)。
**追加のペンタブレット不具合修正(ユーザー実機フィードバック)**: Fillツールのグラデーション設定UI——色ストップを並べた「Ramp」(ドラッグでストップ位置を変更)と方向・強度を指定する「Direction」ミニダイヤル——がペンタブレットでスライド操作できないという報告を受けた。原因はこの2つのミニウィジェットのドラッグ処理だけが`mousedown/mousemove/mouseup`のまま残っていたこと(`touch-action`未指定でブラウザのパン/スクロールジェスチャに奪われやすく、`document`に張った`mousemove`はポインタキャプチャが無いため速いペンの動きを取りこぼしやすい)。`_setupFillGradientRamp()`/`_setupFillGradientDir()`を`pointerdown/pointermove/pointerup/pointercancel`に変更し、`canvas.style.touchAction = "none"`と`canvas.setPointerCapture(e.pointerId)`を追加、ドラッグ中のリスナーも`document`ではなく`canvas`自身に張るよう変更した。
**Comic Creator側も同じ不具合を横展開で修正**: Fillツールの移植元であるComic Creator(`image-tab.js`)にも同一パターンの`_setupFillGradientRamp()`/`_setupFillGradientDir()`に加え、Shapeツールの塗りグラデーションランプ`_setupShapeGradRamp()`(同一コードパターンの複製)が存在し、同じ理由でペンタブレット操作ができない状態だった。3箇所とも同じPointer Events化を適用して修正した。
**検証**: Kaptureで実ブラウザ(ComfyUI_5上のWorkflow Studio `/wfm`、Comic Creator `/ccc`)を操作し、Draw/Mask/Fillそれぞれで新規キャンバス作成→クリック描画/塗りつぶし→コンソールエラーなし・レイヤーサムネイル即時更新を確認。Ramp/Directionダイヤルもクリックでのストップ選択・ハイライト表示が正しく動作することを確認した(ペン特有の筆圧・ドラッグ挙動そのものは自動化ツールでは検証できないため、筆圧の効き具合とドラッグ操作は実機ユーザー確認による)。Comic Creator側は開発フォルダがComfyUI custom_nodes配下にシンボリックリンクされているため、コピー不要で編集がそのまま反映される構成だった(Workflow Studio側は開発リポジトリと実行時custom_nodesが別実体のため、変更のたびに手動コピーが必要)。
**How to apply**: キャンバスベースの描画・ドラッグ操作を実装する際は、最初から`mousedown/mousemove/mouseup`ではなく`pointerdown/pointermove/pointerup/pointercancel`(Pointer Events)を使い、`touch-action: none`を設定する——マウス専用に見えるミニウィジェット(カラーランプ、方向ダイヤル等)であっても、後からペンタブレットで使われた際に同じ不具合が起きる。ドラッグ中の`move`/`up`リスナーは`document`ではなく対象の`canvas`自身に張り、`setPointerCapture()`を使うと要素境界を越えた高速な動きでも取りこぼさない。同一パターンのコードが複数箇所(ファイル間・同一ファイル内)に複製されている場合、1箇所の不具合報告を機に全箇所を横展開で確認する。
関連: [[project_v062_fill_tool_pentablet]], [[feedback_realtime_debug_logs_and_kapture]], [[project_comic_creator_deploy_symlink]]
## v0.6.1
### Galleryタブの検索が「読み込み中」のまま止まりクリアでも中断できない不具合、および50枚程度のフォルダでも数秒〜十数秒かかる不具合を修正
ユーザーから「ギャラリータブで検索を行うと読み込み中のままでクリアを行っても中断できない。50枚程度のフォルダで検索をかけても時間がかかっている」という報告を受け、原因調査から修正まで対応した。
**フロントエンドの2つの不具合**(`gallery-tab.js`): 検索欄はキー入力のたびに即座に(debounceなしで)`loadImages()`を呼んでおり、しかも直前のfetchをキャンセルする仕組み(AbortController)が無かった。そのため「クリア」を押した直後でも、その前に打っていた検索文字列の(まだ処理中の)リクエストが後から返ってきて、クリア後の空検索の結果を上書きしてしまい、「読み込み中のまま/検索結果のまま」に見えていた。検索入力に300msのdebounceを追加し、`loadImages()`にAbortController管理を追加(新しいリクエスト発行時に前回の未完了リクエストを中断)、「クリア」「Clear filters」ボタンはdebounceタイマーもクリアして即座に反映するようにした。
**バックエンドのロック競合**(`gallery_metadata.py`, `gallery_service.py`): フォルダを開くたびに起動するバックグラウンドインデックス処理が、`gallery_metadata.json`(画像数が多い環境では1MBを超える)全体を`threading.RLock`保持したままJSONシリアライズ+ディスク書き込みしており、その間ずっと検索リクエストの`get()`呼び出しがロック待ちでブロックされていた。さらに10枚処理するごとに1件ずつ`save()`を呼んでいたため、実質10回分の全体書き込みが発生していた。`_save_to_disk()`をロック内ではデータのdeepcopyのみに留め、実際のファイルI/Oは別の書き込み専用ロック(`_write_lock`)でロック外に出すよう変更し、バックグラウンドインデックス側もまとめて1回で保存する`save_batch()`を新設して使うようにした。また検索時は(該当時に全メタデータのJSON全体書き込みを伴う)`cleanup_stale_images()`をスキップするようにした(通常の検索なしロード時に実行されれば十分なため)。
**根本原因: ponyxlWildcardsVaultフォールバック探索でのVaultフォルダ誤検出**(`gallery_service.py`): 上記2件を直しても実機で53枚のフォルダへの検索が約3秒かかっており、一時的な計測ログを実機に仕込んで原因を特定した。出力ルート直下にComfyUI/StabilityMatrixが作る空の`thumbnails`フォルダがたまたま存在しており、これが検索対象画像の`.txt`サイドカーが無い場合のフォールバックである`_find_vault_category_root()`(ponyxlWildcardsVault形式——「直下にthumbnails(_option2)フォルダを持つ祖先ディレクトリ」というゆるい条件で判定)によって誤ってVaultのcategory_rootと認識されていた。誤検出されたcategory_root(1万枚超のファイルを含む出力ルート)に対し、`_load_vault_leaves()`がキャッシュの妥当性確認のため画像1枚ごとに`glob("*.yaml")`+`glob("*.yml")`を実行しており、1回あたり約53msかかるglobを53回(検索対象の画像数分)実行して合計2.8秒——実測ベンチマークで再現・確認した数値と実機ログの数値がほぼ一致した。`_load_vault_leaves()`をTTL(60秒)ベースのキャッシュに変更し、TTL内はglobを省略するようにして解消した。
**検証**: Kaptureで実ブラウザ(ComfyUI_5上のWorkflow Studio)を操作し、ネットワークリクエストのタイミングを実測しながら段階的に検証した。Python変更後の再起動が確実に反映されているかはプロセス起動時刻とファイル更新時刻を比較して都度確認した。最終的に53枚のフォルダへの検索は3327ms→74msまで短縮し、検索・クリアとも実機で即座に反映されることを確認した。デバッグ用の計測ログは検証完了後に削除済み。
**How to apply**: サブフォルダを持つ画像出力ルートで「Vault風フォルダ名(thumbnails等)の存在だけで判定するフォールバック検出」を書くと、無関係な巨大フォルダを誤検出してglob/scandir系の操作が本来の対象より何桁も遅くなることがある——検出ロジック自体だけでなく、誤検出時に何度も高コストな操作(特に大量ファイルを含むディレクトリへのglob)が繰り返し呼ばれないか、呼び出し頻度とキャッシュの妥当性も含めて確認する。原因不明のパフォーマンス低下は仮説で止めず、実機に一時的な計測ログ(`perf_counter`で区間ごとの時間を`logger.warning`に出力)を仕込んで実測すると、コードレビューだけでは気づけない誤検出のような盲点が見つかることがある。
関連: [[feedback_asyncio_blocking_in_aiohttp_routes]], [[feedback_realtime_debug_logs_and_kapture]], [[feedback_verify_restart_via_process_creation_time]]
## v0.6.0
### Gallery/Image Edit両タブにPSD(Photoshop)対応を追加 — 複数画像の一括PSD書き出し、レイヤー保存/読み込み、Gallery表示、Image Editのレイヤーパネル改善
ユーザーから「ギャラリーで複数画像を選択してPSDファイルを作成したい」という依頼を起点に、段階的に機能を積み上げてPSD対応を一式実装した。
**ライブラリ選定の紆余曲折**: 当初はPythonでPSDを書き込めるライブラリとして`pytoshop`を候補に選定したが、実際にインストールを試すとWindows用のプリビルドwheelが存在せず、`packbits`というC拡張のビルドに`cl.exe`(Visual Studio Build Tools)を要求することが発覚した。StabilityMatrix/ComfyUI Portable環境のユーザーは通常Cコンパイラを持たないため、この依存はほぼ確実にインストール失敗を招く。代わりに`psd-tools>=1.10`を採用した——1.10以降は読み取り専用ではなく`PSDImage.frompil()`/`PixelLayer.frompil()`による書き込みにも対応しており、依存(`attrs`, `numpy`, `Pillow`, `typing-extensions`)は全てプリビルドwheelを持ちCコンパイラ不要。実機と同等の条件(venv構築→pip install→実際にPSD作成→再読み込みで往復検証)でレイヤー構成・重なり順・opacity・blend_mode・visibleが正しく機能することを確認してから実装に着手した。
**Gallery: 複数選択→PSD一括書き出し** — Galleryの一括操作バーに「PSD作成」ボタンを追加。選択した複数画像を、既存のZIPエクスポート機能と同じ選択・送信パターンを踏襲して1つのPSDファイル(各画像=1レイヤー、レイヤー名=ファイル名)にまとめてダウンロードする。画像サイズが異なる場合は最大サイズのキャンバスに左上基準で配置する仕様とした(ユーザー選定)。バックエンドは`GalleryService.build_psd_from_images()`、ルートは`POST /wfm/gallery/images/export-psd`。
**Image Edit: Save PSD / Open PSD** — Image Editタブ自体にも「Save PSD」(アクションバー)を追加。`LayerManager.layers`を背面→前面順に走査し、各レイヤーをキャンバス全体サイズのoffscreen canvasに`Layer.applyTransform()`(回転・反転・拡縮)のみベイクして書き出す——PSDのピクセルレイヤーは矩形しか持てず回転角度を保持できないため、位置・変形は必ずピクセルに焼き込む一方、opacity・blend_mode・visibleは実際のPSDレイヤー属性としてそのまま渡し、Photoshop側で編集可能な状態を保つ。`maskApply=true`のクリッピングマスクは対象レイヤーと合成して1枚にベイクする簡略化とし、PSD本来のレイヤーマスク機構は使わない(「ライブラリで素直に対応できない部分は無視してよい」というユーザーの了承のもとでの意図的な妥協)。続けて逆方向の「Open PSD」も実装——`psd_tools.PSDImage.open()`→`psd.descendants()`で全レイヤーを再帰的に走査し、`layer.topil()`でレイヤーのbbox範囲にクロップ済みの実サイズ・実位置の画像を復元、`layer.bbox`/`opacity`/`blend_mode`/`visible`を`Layer`オブジェクトに変換する。グループ自体(フォルダ)はスキップしつつ中身は再帰的に取り込み、PSD側のブレンドモード(4バイトタグ)とCanvas2Dの`globalCompositeOperation`文字列の相互変換テーブルを新設した(Canvas2Dに対応物が無いモードはNormalにフォールバック)。
**Gallery → Image Edit: 複数画像を一括レイヤー転送** — Galleryの一括操作バーに「レイヤーとして編集」ボタンを追加。選択した複数画像(mp4は自動除外)でImage Editタブに切り替え、各画像を独立レイヤーとして展開する。既存の単一画像版「Image Edit」送信ボタンと同じ`window._wfmImageEditTab`グローバル参照の仕組みを再利用し、PSDファイルを経由しない直接URL読み込み方式(`loadLayersFromUrls()`新設)とした——各URLを`new Image()`で並列ロードし、最大幅・高さをキャンバスサイズとして採用、`fitToCanvas()`(既存ヘルパー)で各画像をアスペクト比を保ったまま中央配置する。
**Gallery: PSDファイルの一覧・サムネイル・プレビュー表示** — `.psd`を`IMAGE_EXTENSIONS`に追加し、Galleryのフォルダ一覧・検索・グループ機能に自動的に乗るようにした。ブラウザは`<img>`でPSDを直接レンダリングできないため、`serve_image`/`serve_thumb`ルートで`.psd`の場合は`psd_tools`で全レイヤーを合成(非表示レイヤーは除外)した上でPNG/JPEGに変換し、mtimeベースのキャッシュキーでディスクキャッシュして配信する方式にした。情報パネルの幅・高さもPSDヘッダーから取得するようにした。
**実機テストで発覚した2件のバグとその修正**:
1. **サムネイル表示が遅く、他の無関係なPNGサムネイルまで真っ黒になる**——原因は`serve_image`/`serve_thumb`ルートがPSD合成という重いCPU処理を`async def`ハンドラ内で直接同期実行しており、aiohttpの単一スレッドイベントループ全体をブロックしていたこと。PSD1枚の合成中は他の並行リクエスト(別画像のサムネイル配信など)も完全に止まり、結果的に無関係な画像まで表示が固まって見えた。`serve_image`・`serve_thumb`・`import_psd_layers`・新設`get_psd_layers`の4ルートを`loop.run_in_executor(None, ...)`でデフォルトのThreadPoolExecutorに逃がすことで解消した。この教訓は今後の重い処理全般に適用すべき一般原則として別途メモリに記録した。
2. **単一画像「Image Edit」送信ボタンでPSDを開くと1レイヤーしかない**(「Open PSD」ボタンでは正しく全レイヤー開ける)——原因はこのボタンが常に`loadFromUrl()`(1枚のフラット画像として読み込む経路)を使っており、PSD専用のレイヤー分解経路を通っていなかったこと。サーバー上のファイルを再アップロードせず直接レイヤー分解できる新規`GET /wfm/gallery/image/psd-layers`(`GalleryService.get_psd_layers_from_path()`)を追加し、既存の`import_psd_layers()`とロジックを`_extract_psd_layers()`に共通化した上で、PSDファイルの場合はこの新エンドポイントを使うよう分岐させた。
**Image Editタブのアクションバー・レイヤーパネル改善**: 「Upload」を「File Open」に改名し「Open PSD」をその右隣に移動;新規「Close」ボタン(確認ダイアログ後、現在のドキュメントを破棄してプレースホルダー表示に戻す)を追加;レイヤーパネルヘッダーを2段構成(1段目=+/⧉(複製)/−/↑/↓、2段目=「Mask」ボタン単独、旧「M」から改名・移動)に変更;新規「複製レイヤー」ボタン(⧉)を追加し、`Layer.toJSON()`→`Layer.fromJSON()`のシリアライズ往復でアクティブレイヤーを複製(id再採番)して元レイヤーの直前に挿入する方式とした。実装にあたり、レイヤーリストクリック時の「選択」ロジック(種別・現在ツールに応じたキャンバス同期)を`_activateLayerById()`という共通メソッドに抽出し、複製直後の自動選択でも再利用することで、レイヤー種別(画像・描画・マスク・テキスト)を問わず正しく動作するようにした。
**ヘルプドキュメント更新**: 上記全機能についてヘルプタブを更新(`templates/index.html` + `i18n.js`英日中3言語 + `app.js`のhelpIdMapの3点セット)。更新作業の検証中に、今回の変更とは無関係の既存バグを2件発見し合わせて修正した——Image Editの「タイプアイコン」説明が英語版で重複定義されておりマスクレイヤーの表記が欠けていた点(片方は死んだ定義だったため削除)、日本語版でStyle Catalogの「Load in GenerateUI」項目が丸ごと未翻訳で英語表示にフォールバックしていた点(翻訳を追加)。
**検証**: PSD書き込み/読み込みロジックは全て、実際の`GalleryService`コード(相対importを差し替えたコピーをテスト用venvで直接実行)に対してテストスクリプトで検証した——複数レイヤー・サイズ不一致・非表示レイヤー・opacity/blend_mode・グループ内レイヤー・クリッピングマスクを含むPSDを実際に構築し、書き出し→再読み込みで往復一致することを確認。Gallery一括PSD書き出し・Image Edit Save/Open PSD・Gallery表示・Gallery→Image Editレイヤー転送・アクションバー/レイヤーパネル改善は全てユーザーが実機(実ComfyUI環境)で動作確認済み。
**How to apply**: Cコンパイラを要求するPythonライブラリはWindows向けComfyUIカスタムノードでは避け、`pip install --only-binary=:all: <lib>`でプリビルドwheelの有無を先に確認してから採用する。aiohttpの`async def`ルート内でCPU負荷の高い同期処理(画像デコード・合成・リサイズ等)を直接呼ばず、`loop.run_in_executor()`でスレッドプールに逃がす——特にサムネイル/プレビューのように頻繁に並行して呼ばれるエンドポイントは、1回の遅延が他の全リクエストに波及するため重要。ヘルプ更新は`index.html`だけでなく`i18n.js`(3言語)と`app.js`の`helpIdMap`の3点セットで行う。
関連: [[project_gallery_psd_export]], [[project_gallery_psd_display]], [[project_gallery_to_image_edit_layers]], [[project_v04x_image_edit_ui_polish]], [[feedback_psd_export_library_choice]], [[feedback_asyncio_blocking_in_aiohttp_routes]]
## v0.5.8
### Tagger DBタブに一括削除機能を追加(外部コントリビューターPRのレビュー・検証・修正・マージ)
GitHub上の外部コントリビューター(`censor-ed`氏、fork経由)からPR #2「Tagger DBの複数選択削除を追加」が届いたため、内容確認・実機検証・マージまで一貫して対応した。PRの変更内容はバックエンド(`tagger_routes.py`に`DELETE /wfm/tagger/db`エンドポイントを新設、`tagger_db_service.py`に`delete_bulk()`をプレースホルダ経由のSQLite `DELETE ... WHERE id IN (...)`で実装)とフロントエンド(DBテーブルの各行にチェックボックス、ヘッダーに全選択チェックボックス、既存の単一削除`_dbDelete`と同じ`confirm()`パターンを踏襲した確認ダイアログ、英日中3言語のi18n)。
コードレビューでは危険な処理(外部送信・eval・shell実行等)は無く、SQLインジェクション対策も適切と判断。ただし2点の懸念を指摘した:(1) 一括削除の`count`がAPIレスポンスで返る削除件数の妥当性、(2) 全選択チェックボックス`_dbToggleSelection`が単純トグル(クリックのたびに全チェックボックスの状態を反転)方式になっており、一部だけ選択済みの状態でクリックすると直感に反する(選択済み行が外れ未選択行が入る)挙動になる懸念。
実機検証はKapture経由でComfyUI_5(ポート8189)に実際に接続して実施。データベースには実データ(既存のタグ付け済み画像)しか存在しないため、削除操作自体は実行せず安全に検証する方針を取った:一括削除APIは`curl`で存在しないID(999999)を渡して直接叩き、`ids`未指定時の400エラー・不正な値混入時の500エラーハンドリングを確認。UI側はKaptureで実際にチェックボックスを操作し、行クリックとチェックボックスクリックが正しく分離されていること、未選択で削除ボタンを押すと警告トーストが出ること、削除ボタンで`confirm()`ダイアログ(日本語i18n表示)が開くことを確認した上で`mcp__kapture__dialog`の`accept:false`でキャンセルし、実データには一切触れずに検証を完了した。この過程で指摘(2)の懸念が実機で再現することを確認——ID66のみ選択した状態で全選択チェックボックスをクリックすると、ID66のチェックが外れ他の全行がチェックされるという実際の誤動作を確認した。またAPIレベルの検証で指摘(1)も実バグと確定:存在しないID 1件を渡しても`{"ok": true, "count": 1}`が返っていた。原因は`handle_db_delete_bulk`が`delete_bulk()`の戻り値(実際の削除件数=`cur.rowcount`)を使わず、渡された`ids`の件数(`len(ids)`)をそのまま返していたため。
この検証プロセス中に、ComfyUIの「再起動」がユーザー申告だけでは信頼できないケースに遭遇した。Pythonファイル(`tagger_routes.py`)をコピーしてComfyUI再起動を依頼したところ、依頼直後は新エンドポイントへの`DELETE`が405 Method Not Allowed(`Allow: GET,HEAD`のみ)を返し続けた。原因調査でComfyUI起動ログ(`user/comfyui_8189.log`)や`app.router`のルート登録順序(ComfyUIコア自身のSPAフォールバック用static routeとの競合の可能性)を疑ったが、最終的にはPowerShellの`Get-CimInstance Win32_Process`でプロセスの実際の`CreationDate`を確認し、動いているComfyUIプロセスの起動時刻がコードをコピーした時刻より前であることを突き止めた——つまりユーザーが「再起動しました」と報告した操作は、ブラウザページのリロード等では反映されず、プロセス自体は起動されたままだった。ユーザーに再度プロセスの完全停止・起動を依頼し、新しいプロセス起動時刻(コピー時刻より後)を確認してから再テストしたところ405エラーは解消した。
2点のバグ修正(`handle_db_delete_bulk`が`delete_bulk()`の戻り値を`count`として返すよう変更、`_dbToggleSelection`をクリックされたヘッダーチェックボックス自身の新しい状態(`e.target.checked`)に全行を揃える一般的な「全選択」挙動に変更)をコミットし、`maintainerCanModify`権限を使ってPR元のフォークブランチ(`censor-ed/ComfyUI-Workflow-Studio`の`feature/tagger-bulk-delete`)に直接pushしてPRへ反映、`gh pr merge`でGitHub上のPR #2を正式にマージした(マージコミット`e067f34`)。ローカル`main`をfast-forward更新し、実行時`custom_nodes`フォルダへ最終版を再同期して`diff --strip-trailing-cr`で完全一致を確認した上で、最後にもう一度ComfyUI再起動→APIレスポンス確認まで実施した。
**検証**: バックエンドAPI(`curl`直叩き、正常系・異常系)とフロントエンドUI(Kaptureブラウザ操作、チェックボックス・確認ダイアログ・トースト)の両方を実機で確認。修正コミット後も同様に再検証し、`count`が正しい値(0)を返すこと・全選択チェックボックスが選択済み行を含めて正しく全ON/全OFFされることを確認した。実データは一度も削除していない。
**How to apply**: 外部コントリビューターのPRを取り込む際は、まず実行時`custom_nodes`フォルダと開発リポジトリの現在のブランチが完全一致していること(改行コード差分のみ)を確認してから安全にファイルを上書きする([[project_dev_deploy_sync]])。DBやファイルシステムなど実データを持つ機能のUIテストでは、可能な限り「削除・変更操作自体は実行せず、確認ダイアログの表示とキャンセル」「存在しないIDでのAPI直接テスト」など非破壊的な手段で検証を組み立てる。Pythonファイル変更後のComfyUI再起動は、ユーザーの「再起動しました」という申告だけでなく、`Get-CimInstance Win32_Process`等でプロセスの実際の起動時刻を確認し、コード変更時刻より後であることを検証してから動作確認に進む——ブラウザのページリロードやタブの再接続だけでは、バックエンドのPythonプロセス自体は再起動されていない場合がある。APIレスポンスの件数系フィールド(`count`等)は、渡された引数の長さではなく実際の処理結果(DBの`rowcount`等)を返すべきというありがちなバグパターンに注意する。「全選択」チェックボックスは常時トグルではなく、クリックされた自身の新しい状態を全体に適用する実装が直感に合う。
関連: [[project_dev_deploy_sync]], [[feedback_comfyui_running_check_before_launch]], [[feedback_realtime_debug_logs_and_kapture]]
## v0.5.7
### 設定エクスポート/フルバックアップのドキュメント修正: v0.5.5のVideo Plan機能追加分の言及漏れ
@@ -97,9 +244,10 @@ UI面ではDuration(元々ブロックごとの独立値)とNoise Seed(Pla
**3. 動画再生ボリュームの保存設定**: 動画を切り替えるたびに音量が最大へ戻ってしまう問題を解消するため、設定タブに音量設定を追加しVideo/Galleryタブの全プレーヤー間で保存・共有されるようにした。
**4. GenerateUIタブ: LTX-2.5 / Wan2.2対応(プロンプト検出・Latent Image・タイムアウト)**: Videoタブとは独立した解析経路(`analyzeWorkflow()`、フラット化済みAPI形式ワークフローを解析)側でも同じ2ファミリーの通常ワークフロー読み込みに対応させる作業。実機確認したところ、Model タブ(Checkpoint/VAE/Diffusion Model/Text Encoder/LoRA)は既存の`UNETLoader`/`CLIPLoader`/`VAELoader`ベースの汎用検出でWan2.2/LTX-2.5とも既に問題なく動作していたが、次の2点に不備を発見した。
- **Positive/Negative Prompt検出(LTX-2.5)**: LTX-2.5は`LTXVDualCFGGuider`(positive/negativeが同一の`LTXVConditioning`ノードの別出力スロットを指す)+ `LTXVConditioning`(自身のpositive/negative入力を介して実際のプロンプトソースへ分岐)という専用ノード構成を使うため、既存の`CFGGuider`/`InstructPixToPixConditioning`向けロール伝播ロジックでは拾えず、Positive/Negative Promptが空欄のままSaveVideoノードへのフォールバック表示になっていた。`LTXVDualCFGGuider`をロール伝播の起点に、`LTXVConditioning`を`InstructPixToPixConditioning`と同型の分岐伝播ノードとして追加し解決した。
- **Latent Image検出(Wan2.2・LTX-2.5共通)**: SettingsタブのLatent Imageセクションが`EmptyLatentImage`/`EmptySD3LatentImage`/`EmptyFlux2LatentImage`のみ対応しており、Wan2.2の`EmptyHunyuanLatentVideo`とLTX-2.5の`EmptyLTXVLatentVideo`が未対応で「No EmptyLatentImage node found」表示になっていた。両ノード型を追加し、動画特有の`length`(フレーム数)入力を編集するフィールドも新設した(Duration×FPSの数式ノードにリンクされ非リテラルなことが多いため、Width/Height同様「linked」表示にフォールバックする)。
- あわせて`isVideoWorkflow()`(生成タイムアウトを30分に延長する判定)を、`SaveVideo`/`CreateVideo`ノードや動画用latentノードの存在でも判定できるよう拡張した。従来はMiniMax H3のようなオールインワン`*ToVideo`ノードの有無でしか判定できず、LTX-2.5/Wan2.2は通常の静止画と同じ短いタイムアウトで打ち切られる恐れがあった。
- **Positive/Negative Prompt検出(LTX-2.5)**: LTX-2.5は`LTXVDualCFGGuider`(positive/negativeが同一の`LTXVConditioning`ノードの別出力スロットを指す)+ `LTXVConditioning`(自身のpositive/negative入力を介して実際のプロンプトソースへ分岐)という専用ノード構成を使うため、既存の`CFGGuider`/`InstructPixToPixConditioning`向けロール伝播ロジックでは拾えず、Positive/Negative Promptが空欄のままSaveVideoノードへのフォールバック表示になっていた。`LTXVDualCFGGuider`をロール伝播の起点に、`LTXVConditioning`を`InstructPixToPixConditioning`と同型の分岐伝播ノードとして追加し解決した。
- **Latent Image検出(Wan2.2・LTX-2.5共通)**: SettingsタブのLatent Imageセクションが`EmptyLatentImage`/`EmptySD3LatentImage`/`EmptyFlux2LatentImage`のみ対応しており、Wan2.2の`EmptyHunyuanLatentVideo`とLTX-2.5の`EmptyLTXVLatentVideo`が未対応で「No EmptyLatentImage node found」表示になっていた。両ノード型を追加し、動画特有の`length`(フレーム数)入力を編集するフィールドも新設した(Duration×FPSの数式ノードにリンクされ非リテラルなことが多いため、Width/Height同様「linked」表示にフォールバックする)。
- あわせて`isVideoWorkflow()`(生成タイムアウトを30分に延長する判定)を、`SaveVideo`/`CreateVideo`ノードや動画用latentノードの存在でも判定できるよう拡張した。従来はMiniMax H3のようなオールインワン`*ToVideo`ノードの有無でしか判定できず、LTX-2.5/Wan2.2は通常の静止画と同じ短いタイムアウトで打ち切られる恐れがあった。
**5. Videoタブ左パネルのハイライト表示**: GenerateUIのModelタブが持つ「ワークフローに実際に該当する項目のラベルをハイライト」する仕組み(`wfm-model-label-active`クラス、設定タブでカスタマイズ可能な共通色)をVideoタブの左パネルにも適用した。Prompt/Durationは常時、First Frame/Last Frameはサブグラフがそのスロットを公開している場合のみ、Aspect Ratio/Megapixels/MultipleはResolutionSelectorノードが存在する場合のみハイライトする — Wan2.2のように該当ノードがなく操作不可(disabled)な項目は、既存の無効化表示と矛盾しないよう非ハイライトのままにした。
@@ -154,10 +302,12 @@ v0.5.0/v0.5.1で専用Videoタブを整備したMiniMax H3動画生成ワーク
**3. バグ修正: LabタブKsampler列が動画ワークフローでも表示される**: 「Model同様に該当ノードがなければ非表示にしたい」との要望に対し当初`sampler_nodes.length > 0`で判定したが、実機確認で「まだ表示される」との報告。原因はMiniMax H3のサブグラフ内部に実際に`SamplerCustomAdvanced`が配線されており(内部プリセットの一部で、ユーザーが調整すべきものではない)、単純な有無判定では引っかからなかったこと。判定を`comfyWorkflow.isVideoWorkflow(analysis)`ベースに切り替え、動画ワークフロー全体ではKsampler列自体を常に非表示にするよう修正した。
**4. Videoタブ拡張: Frame抽出 / アニメーションGIF変換**: Eagleプラグイン(video-to-frame, video2gif)を参考に要望された2機能。Eagle版はNode.js+ffmpegバイナリ直接呼び出しの実装だったため、ComfyUI-Workflow-Studioの構成(Python/aiohttpバックエンド)に合わせて設計し直した。フレーム抽出は`<video>`+`<canvas>`でブラウザ完結(サーバー往復・追加依存なし)。GIF変換はユーザー確認の上サーバー側実装を選択:PyAV(デコード)+ Pillow(GIFエンコード)— どちらもComfyUI本体が既に要求している依存のため、ffmpegバイナリや新規ライブラリの追加インストールは不要。`py/services/video_service.py` / `py/routes/video_routes.py`を新規追加し、`folder_paths.get_save_image_path()`でComfyUI標準の自動採番保存パターンをそのまま踏襲。合成テスト動画(PyAVで生成)を使いvenv環境でデコード→GIFエンコードの実処理を検証済み。
- あわせてVideoタブの中央パネルを再設計:「結果」見出し/「まだ結果がありません」表示を廃止し、生成結果とドロップされた任意のローカル動画を同じプレビュー枠に統合、横に**Video Source**ドロップ/クリック選択エリア(Clearボタン付き)を新設。右パネルの「Properties」プレースホルダーを**Frame**/**GIF**の2タブに置き換え。生成結果に限らず任意の動画に対してFrame/GIF機能が使える設計にした。
- あわせてVideoタブの中央パネルを再設計:「結果」見出し/「まだ結果がありません」表示を廃止し、生成結果とドロップされた任意のローカル動画を同じプレビュー枠に統合、横に**Video Source**ドロップ/クリック選択エリア(Clearボタン付き)を新設。右パネルの「Properties」プレースホルダーを**Frame**/**GIF**の2タブに置き換え。生成結果に限らず任意の動画に対してFrame/GIF機能が使える設計にした。
**5. データ管理の監査とZIPフルバックアップ機能の新規実装**: 「設定のデータ管理を現在のバージョンで対応できているか確認してほしい」との依頼を受け、既存の`_DATA_FILES`(単一JSONバンドル方式)と実際のデータディレクトリを突き合わせ監査。**`civitai_cache.json`(3.6MB、CivitAI連携キャッシュ)がエクスポート対象から漏れていた**ことを発見し即修正。また、ヘルプが謳う「export all plugin data」に反し、フォルダ形式のデータ(`ai_skills/`、`lab_plan/`、`style/`)とSQLite DB(`tagger.db`)が単一JSONバンドル方式では原理的に扱えず完全に対象外になっていた点をユーザーに報告、ZIP形式のフルバックアップ機能を新規実装する方針で合意。`DATA_DIR`配下を丸ごとZIP化する`GET /api/wfm/settings/export-full`/`POST /api/wfm/settings/import-full`を追加(一時ファイル系`gmic_temp`/`thumb_cache`と、他custom_node(comfyui-impact-pack)へのシンボリックリンクである`wildcard/`のみ除外、`settings.json`はAPIキーを除外してから含める)。復元側はZip Slip対策(`../`等でDATA_DIR外に書き込もうとするエントリは`relative_to()`チェックでスキップ)を実装し、悪意あるZIPでの検証済み。
- 追加要望「デフォルトワークフローフォルダー(`user/default/workflows`)とwildcardフォルダー(`comfyui-impact-pack/wildcards`)もオプションでバックアップに含めたいが、インポートは除外し手動対応としたい」に対応:エクスポート画面にオプトインのチェックボックスを2つ追加、有効時はZIP内に`_external/`プレフィックスで格納し、復元処理は`_external/`配下のエントリを常にスキップする実装にした(他プラグイン/ComfyUI本体が管理する領域を自動上書きしないため)。実データ(ワークフロー535件・wildcard 34件)で検証済み。
- 追加要望「デフォルトワークフローフォルダー(`user/default/workflows`)とwildcardフォルダー(`comfyui-impact-pack/wildcards`)もオプションでバックアップに含めたいが、インポートは除外し手動対応としたい」に対応:エクスポート画面にオプトインのチェックボックスを2つ追加、有効時はZIP内に`_external/`プレフィックスで格納し、復元処理は`_external/`配下のエントリを常にスキップする実装にした(他プラグイン/ComfyUI本体が管理する領域を自動上書きしないため)。実データ(ワークフロー535件・wildcard 34件)で検証済み。
**6. Send to LI node機能をGalleryタブにも追加 + ボタン名統一**: Image Editタブに既にあった「選択画像をComfyUIキャンバス上の選択中ノードのimageウィジェットへ送る」機能(`window.opener.wfmSendImageToSelectedNode`、`node_sets_menu.js`で定義されたクロスウィンドウ橋渡し)を、Galleryタブの選択画像にも使えるよう追加。Galleryの画像は任意のフォルダにあり得るため、既存の「Send GenUI Image」と異なりLoadImageノードの有無に依存せず、`/upload/image`でinputフォルダへアップロードしてからファイル名を書き込む方式にした。あわせてImage Edit側の既存ボタン名「Send to Workflow」を「Send to LI node」に統一(トースト文言・コメント・ヘルプも合わせて更新)。
@@ -212,7 +362,8 @@ v0.5.0で追加したmp4 Gallery対応(一覧・サムネイル・再生のみ
**4. First Frame/Last Frameを両方optionalに、LoadImageノードが無いワークフローにも対応**: 「First Frameなしでも動作させたい(ノードをバイパスで処理)。またノードのないワークフローにも対応させたい」との要望。`minimax_test1.json`(first_frame/last_frame双方とも未接続、対応するLoadImageノードがトップレベルに存在しない構成)を新たに確認し、`locateMiniMaxNodes()`のLoadImageノード必須チェックを撤廃。first_frame未指定時はリンクなしのまま実行(バイパス)し、画像が指定された場合のみその場でLoadImageノードを動的に注入する設計に変更(ノードID/リンクIDはclone内の実際の最大値+1で採番するため重複の心配がない)。first_frameスロットにもlast_frameと同様のClearボタンを追加した。
**5. バグ修正: mp4のタグ/メモがComfyUI再起動後に消える**: 「タグ、メモadd、保存操作はできるが記録されていない。画像ファイルもできていない。エラー表示はなし、ブラウザもなし」との報告を受け、`comfyui_8189.log`を直接確認したところ`Cleaned up 189 stale metadata entries from ...\Text2Img`という決定的なログを発見。**根本原因**: `cleanup_stale_images()`は「現在表示中のフォルダ配下」のメタデータキーを全階層(サブフォルダ含む)対象にstale判定するが、Galleryがルートフォルダを非再帰スキャンした場合、`existing_paths`(現在のファイル一覧)にはルート直下のファイルしか含まれない。Videoタブで生成した動画は`SaveVideo`の`filename_prefix`設定で`video/MiniMax_H3/`というサブフォルダに保存されるため、ルートフォルダを開くたびに「サブフォルダ内ファイルは非再帰スキャンには映らない→存在しないと誤判定→メタデータ削除」が発生し、189件ものタグ/メモ/お気に入り情報が消えていた。`cleanup_stale_images()`に`recursive`引数を追加し、非再帰スキャン時はfolder_path直下のみを対象にするよう修正(`gallery_service.py`の`list_images()`から`recursive`をそのまま伝播)。既に削除済みのデータはバックアップが無く復元不可能だった旨をユーザーに伝えた。
- 副次的に発見したフロントエンドのバグも合わせて修正: `saveMetaField()`がサーバーのレスポンス(`{"ok": bool}`)を一切チェックせず常に成功したかのようにローカル状態を楽観的更新していたため、サーバー側で保存が拒否されてもUI上はエラーなく成功したように見えてしまう作りになっていた。レスポンスの`ok`フィールドを検証し失敗時は例外を投げるよう変更、`addTag`/`removeTag`/メモ保存ハンドラは戻り値を見て成功時のみローカル状態を更新するよう修正した。保険的措置として`save_image_meta`(バックエンド)の保存キーも`get_image_metadata`と同じ`resolve()`後のパスに統一した。
- 副次的に発見したフロントエンドのバグも合わせて修正: `saveMetaField()`がサーバーのレスポンス(`{"ok": bool}`)を一切チェックせず常に成功したかのようにローカル状態を楽観的更新していたため、サーバー側で保存が拒否されてもUI上はエラーなく成功したように見えてしまう作りになっていた。レスポンスの`ok`フィールドを検証し失敗時は例外を投げるよう変更、`addTag`/`removeTag`/メモ保存ハンドラは戻り値を見て成功時のみローカル状態を更新するよう修正した。保険的措置として`save_image_meta`(バックエンド)の保存キーも`get_image_metadata`と同じ`resolve()`後のパスに統一した。
**ヘルプ・README更新**: `project_v0336_conventions`の慣習(index.html + i18n.js 3言語 + app.jsのhelpIdMapの3点セット)に従い、新規Video Tabヘルプページを追加。README.mdはバージョンバッジ更新、Workflow Tab(サイドパネルツールバーの3ボタン構成)、Gallery Tab(Downloadボタンの新配置・mp4対応・GenUIボタンへの改名)、新規Video Tabセクション(3ペイン構成・optional First/Last Frame・ノードなしワークフロー対応)を追加した。
@@ -263,7 +414,8 @@ v0.5.0で追加したmp4 Gallery対応(一覧・サムネイル・再生のみ
**4. yamlワイルドカードを使うサンプルワークフロー**: 「yamlファイルのワイルドカードを使用するワークフローを作成してもらうことはできますか」との依頼。調査の結果、このプラグイン自体のワイルドカード展開(SPA側の`_expandWildcardsInWorkflow`)は`.txt`拡張子固定でyaml非対応であり、yaml形式は`ImpactWildcardEncode`/`ImpactWildcardProcessor`ノード(Impact Pack、サーバー側処理)でのみ解決できることが判明。プラグインのwildcardディレクトリはjunction経由でImpact Packの`wildcards/`フォルダへ直結しているため、通常のWildcard File Manager経由で保存したyamlファイルがそのままImpactWildcardEncodeから参照可能。サンプルyamlワイルドカードファイル(`ws_sample_season_lighting.yaml`)とImpactWildcardEncodeノードを使うサンプルワークフロー(`ws_yaml_wildcard_sample.json`)を作成し、実際にComfyUIで生成→出力PNGのメタデータで`populated_text`が階層キー参照から正しく展開されていることを確認した。
**5. Galleryタブ詳細パネルに「Prompt」タブ新設**: 「メタデータでも確認できるが頻度を考えるとマウス操作が多いため、プロンプトだけはこちらでも表示としたい。ボタンは右端でデフォルトで選択状態としたい」との要望。当初は単純な全文連結表示で実装したが、「メタデータタブの表示の様に複数プロンプトがあるケースも考慮したい」とのフィードバックを受け、Metadataタブの`extractPrompts`/`buildPromptItem`をexportし、完全に同じPOS/NEGバッジ付きリスト→クリックで全文表示のUIに作り直した。
- さらに実機確認の中で、同一画像でもMetadataタブとGalleryタブでpositive数が食い違うケース(`Krea2_turbo_00133_.png`、Metadataでは2件のPositiveが見える)を発見。原因は埋め込みデータの優先順位の違い — Metadataタブは`prompt`(API形式、サブグラフ展開済みでフラット)を優先するのに対し、Gallery側サーバーAPIは`workflow`(UI形式、ノード位置等を保持)を優先していた。トップレベルとサブグラフに独立した2系統のサンプリングを持つワークフローでは、UI形式のトップレベルnodes配列に一方の系統しか含まれず、`extractPromptsLiteGraph`の早期returnロジックがその系統しか拾えないため。既存のLoad GenUI/JSON表示/Copy & Send Canvas等には一切影響しないよう、`gallery_service.py`に優先順位を選べる`_extract_embedded_workflow`ヘルパーを追加し、新規`extract_prompt_workflow_from_metadata`(API形式優先)を`/wfm/gallery/image/workflow`のレスポンスへ`prompt_workflow`として追加、Galleryの Promptタブの抽出だけこちらを使うようにした。Python側の変更を反映するため、ユーザー自身の手でComfyUIを再起動していただいた。
- さらに実機確認の中で、同一画像でもMetadataタブとGalleryタブでpositive数が食い違うケース(`Krea2_turbo_00133_.png`、Metadataでは2件のPositiveが見える)を発見。原因は埋め込みデータの優先順位の違い — Metadataタブは`prompt`(API形式、サブグラフ展開済みでフラット)を優先するのに対し、Gallery側サーバーAPIは`workflow`(UI形式、ノード位置等を保持)を優先していた。トップレベルとサブグラフに独立した2系統のサンプリングを持つワークフローでは、UI形式のトップレベルnodes配列に一方の系統しか含まれず、`extractPromptsLiteGraph`の早期returnロジックがその系統しか拾えないため。既存のLoad GenUI/JSON表示/Copy & Send Canvas等には一切影響しないよう、`gallery_service.py`に優先順位を選べる`_extract_embedded_workflow`ヘルパーを追加し、新規`extract_prompt_workflow_from_metadata`(API形式優先)を`/wfm/gallery/image/workflow`のレスポンスへ`prompt_workflow`として追加、Galleryの Promptタブの抽出だけこちらを使うようにした。Python側の変更を反映するため、ユーザー自身の手でComfyUIを再起動していただいた。
**6. Send to Canvasのフォールバック方式を刷新**: 「このワークフローを生成UIタブに読み込むと...またキャンバスへ送るでAPI形式のためタイトルをキャンバスへドラッグのメッセージが表示されますがこの動作を変更したい...UI形式のサムネイルがないパターンのワークフローも同様にしたい」との要望。`window.opener`経由の直接ロードに失敗した場合の従来のフォールバック(`localStorage`+パネルタイトルのドラッグ、API形式のワークフローはそもそも非対応でエラーのみ)を、Workflow Studio LibraryのW(Workflows)タブを該当ワークフローで絞り込み表示する方式に統一した。`node_sets_menu.js`に`showWorkflowInLibrary()`をexportし、`top_menu_extension.js`が新規localStorageキー`wfm_library_filter_request`への`storage`イベントを監視して呼び出す(同一オリジンの別タブでのみ発火する仕様を利用)。フォーマット(UI形式・API形式)を問わず同じ導線になり、サムネイル付きの実物のワークフローカードからユーザー自身がドラッグできるようになった。Galleryタブの「Copy & Send Canvas」(画像埋め込みのその場限りのワークフローが対象で、そもそもLibrary一覧=保存済みファイルには存在しない)は今回のスコープ外として変更していない。
@@ -290,14 +442,15 @@ v0.5.0で追加したmp4 Gallery対応(一覧・サムネイル・再生のみ
**2. GenerateUIタブ: Save ボタンをBatch/Labサブタブで非表示化**: 「ワークフローのSaveボタンをBatch、Labサブタブ選択時、非表示にしたい」との要望。両サブタブは現在ロード中のワークフロー本体ではなく、ワークフローの複製やLab独自のPlanファイルを操作するため、Saveボタンが誤解を招く(クリックしても実際に触っているワークフローとは別物が保存される)ことへの対処。サブタブ切替ハンドラ(`generate-tab.js`)にワンライナーの表示切替を追加。
**3. Promptタブに「Table」表示を新設**: 「現在のプロンプトタブをタブ化してテーブルタブを追加したい(既存はフォームタブとする)。テーブルタブではプロンプトのプリセット、ワイルドカード、スタイルがそれぞれ表形式で一覧表示、編集可能としたい」との要望を起点に、複数回のフィードバックを経て以下の形に発展した:
- 既存の3カラムレイアウト(AI Assistant / Presets・Preset Manager / Wildcard・Style)をまるごと「Form」パネルとしてラップし、新設の「Table」パネルと上部のトップレベルタブで切り替える構成にした。
- Tableパネル内にPresets・Wildcards・Styleの3つの編集可能テーブルを新設(`prompt-table.js`新規ファイル)。既存の`prompt-tab.js`が保持するAPIヘルパー(`fetchPresets`/`apiUpdatePreset`/`wcSaveFile`/`styleApiUpdate`等)とリフレッシュ関数を`export`して再利用し、Table側での編集は即座にForm側にも反映されるようにした。
- **「Presets右隣にPresets Groupを追加したい」**: グループ管理専用の4つ目のサブタブを新設。グループの作成・リネーム・削除・メンバー一覧(バッジ表示・×で削除)に対応。
- **「共通で左端に番号(自動)列を追加したい。個別の削除ボタンは誤操作が予想されるため上部にボタンを設置し番号列で該当番号選択、削除という手順にしたい」**: 4テーブル共通で自動採番の`#`列を新設し、番号クリックで行選択(複数可・赤ハイライト)→ツールバーの「Delete」ボタンで一括削除、という手順に統一。個別の行削除ボタンは全廃した。新規行追加時は番号セルの代わりに小さな✓(Add)/✕(Cancel)アイコンを表示する設計にした。
- **「バッチグループの登録方法を変更したい」**: PresetsテーブルにForm側と同じ仕組みの「B」列(クリックでグレー⇔黄色にトグルしBatchグループへ登録/解除)と、Batchグループを一括クリアする「BC」ボタンをツールバー上部に追加。Presets Groupテーブルからは予約グループ「Batch」を非表示にし、Batch管理をPresetsテーブル側のB列/BCボタンへ一本化した。
- **「PresetsのコピーボタンとグループドロップダウンをテーブルのPresetsタブに配置したい。これによりPresets GroupタブのAdd Presetsをなくしたい(プリセットが多くなった際に選択が困難なため)」**: Presets Groupテーブルの「Add Preset」列(プリセットが多いと使いづらい長大なドロップダウン)を廃止。代わりにPresetsテーブルのツールバーに「PP Copy」「NP Copy」(選択中1件のPositive/Negativeをクリップボードへコピー)と、グループ選択+「Add to Group」(選択中の複数プリセットを一括で選んだグループへ追加)を新設した。プリセット側を検索・選択してから短いグループ一覧から選ぶ流れにしたことで、プリセット数が多くても操作しやすい設計になった。
- **「選択クリアボタンも追加したい」**: 4テーブル共通で「Deselect」ボタンをツールバーへ追加し、選択状態を一括解除できるようにした。
- **「プリセット、ワイルドカード、スタイルで番号をWクリックでモーダルでプロンプトの表示、編集したい」**: `#`列のダブルクリックで、既存の共有モーダル基盤(`app.js`の`openModal`/`closeModal`)を再利用したプロンプト編集モーダルを開くようにした。Presets/Styleは正負プロンプト切り替えボタン+共有の大型テキストエリア(切り替えても両方の編集内容を保持)、Wildcardsはファイル内容のみのテキストエリアで、Save/Closeボタンを備える。
- 既存の3カラムレイアウト(AI Assistant / Presets・Preset Manager / Wildcard・Style)をまるごと「Form」パネルとしてラップし、新設の「Table」パネルと上部のトップレベルタブで切り替える構成にした。
- Tableパネル内にPresets・Wildcards・Styleの3つの編集可能テーブルを新設(`prompt-table.js`新規ファイル)。既存の`prompt-tab.js`が保持するAPIヘルパー(`fetchPresets`/`apiUpdatePreset`/`wcSaveFile`/`styleApiUpdate`等)とリフレッシュ関数を`export`して再利用し、Table側での編集は即座にForm側にも反映されるようにした。
- **「Presets右隣にPresets Groupを追加したい」**: グループ管理専用の4つ目のサブタブを新設。グループの作成・リネーム・削除・メンバー一覧(バッジ表示・×で削除)に対応。
- **「共通で左端に番号(自動)列を追加したい。個別の削除ボタンは誤操作が予想されるため上部にボタンを設置し番号列で該当番号選択、削除という手順にしたい」**: 4テーブル共通で自動採番の`#`列を新設し、番号クリックで行選択(複数可・赤ハイライト)→ツールバーの「Delete」ボタンで一括削除、という手順に統一。個別の行削除ボタンは全廃した。新規行追加時は番号セルの代わりに小さな✓(Add)/✕(Cancel)アイコンを表示する設計にした。
- **「バッチグループの登録方法を変更したい」**: PresetsテーブルにForm側と同じ仕組みの「B」列(クリックでグレー⇔黄色にトグルしBatchグループへ登録/解除)と、Batchグループを一括クリアする「BC」ボタンをツールバー上部に追加。Presets Groupテーブルからは予約グループ「Batch」を非表示にし、Batch管理をPresetsテーブル側のB列/BCボタンへ一本化した。
- **「PresetsのコピーボタンとグループドロップダウンをテーブルのPresetsタブに配置したい。これによりPresets GroupタブのAdd Presetsをなくしたい(プリセットが多くなった際に選択が困難なため)」**: Presets Groupテーブルの「Add Preset」列(プリセットが多いと使いづらい長大なドロップダウン)を廃止。代わりにPresetsテーブルのツールバーに「PP Copy」「NP Copy」(選択中1件のPositive/Negativeをクリップボードへコピー)と、グループ選択+「Add to Group」(選択中の複数プリセットを一括で選んだグループへ追加)を新設した。プリセット側を検索・選択してから短いグループ一覧から選ぶ流れにしたことで、プリセット数が多くても操作しやすい設計になった。
- **「選択クリアボタンも追加したい」**: 4テーブル共通で「Deselect」ボタンをツールバーへ追加し、選択状態を一括解除できるようにした。
- **「プリセット、ワイルドカード、スタイルで番号をWクリックでモーダルでプロンプトの表示、編集したい」**: `#`列のダブルクリックで、既存の共有モーダル基盤(`app.js`の`openModal`/`closeModal`)を再利用したプロンプト編集モーダルを開くようにした。Presets/Styleは正負プロンプト切り替えボタン+共有の大型テキストエリア(切り替えても両方の編集内容を保持)、Wildcardsはファイル内容のみのテキストエリアで、Save/Closeボタンを備える。
**ヘルプ・README更新**: `project_v0336_conventions`の慣習(index.html + i18n.js 3言語 + app.jsのhelpIdMapの3点セット)に従い、GenerateUI Tab(Saveボタン非表示の説明)・Prompt Tab(新規カード「Form / Table」「Table View」10項目)・Gallery Tab(Metadataサブタブの説明)・Metadata Tab(Galleryタブ内へ移動した旨の注記、`metadata-tab.js`側の独自i18n適用ロジックへ追加)を更新。README.mdはGenerateUI TabのSaveボタン説明を拡張、Prompt Tabセクションに新規ブロックを追加、「Metadata Tab」セクションをGalleryタブの4番目のサブタブとして「Metadata Gallery subtab」に改称の上、Style_Catalog Gallery subtabの直後へ移設した。
@@ -320,10 +473,11 @@ v0.5.0で追加したmp4 Gallery対応(一覧・サムネイル・再生のみ
ユーザーから「トップバーで保存した2つのワークフロー(I2I_rmbg.json/I2I_rmbg_2.json)を生成UIタブで読み込んで生成するとRemove Background(RMBG)ノードが機能せず透過画像が作成されない。ComfyUIのExport(API)で保存した3つ目のファイルは正しく動く」との報告を受けて調査した一連のセッション。
**1. ワークフロー解析の調査**: RMBGノードは`background_color`という「ウィジェットを持たない特殊な入力(COLORCODE型、`model`より前の位置)」を持つ特徴的な構造で、UI形式→API形式変換時に`widgets_values`の対応がずれる可能性を最初に疑った。`comfyui-workflow.js`の`convertUiToApi()`を段階的に検証:
- `/object_info/RMBG`を実機から取得し、`_getWidgetInputNames()`が`forceInput`相当(widgetキーを持たない入力)を正しく除外し、`background_color`がウィジェット名リストから漏れることを確認。
- ユーザー提供の`I2I_rmbg_2.json`をブラウザ内(Playwright MCP)で実際に`convertUiToApi()`にかけ、変換結果を確認 — `model`/`sensitivity`/`background`など全フィールドが正しくマッピングされていた。
- その変換結果を実際に`/prompt`へキューイングして実行、さらにGenerateUIタブの本物のGenerateボタンをクリックする経路でも実行 — いずれも出力PNGはRGBA・アルファチャンネル0〜255の**正しい透過画像**だった。
- 結論: 現在デプロイされているv0.4.3のワークフロー解析ロジックに該当バグは再現せず、コード変更は行わなかった。報告時点でより古いバージョンを使っていた可能性が高いと判断し、ユーザーに調査結果と再検証手順を報告した。
- `/object_info/RMBG`を実機から取得し、`_getWidgetInputNames()`が`forceInput`相当(widgetキーを持たない入力)を正しく除外し、`background_color`がウィジェット名リストから漏れることを確認。
- ユーザー提供の`I2I_rmbg_2.json`をブラウザ内(Playwright MCP)で実際に`convertUiToApi()`にかけ、変換結果を確認 — `model`/`sensitivity`/`background`など全フィールドが正しくマッピングされていた。
- その変換結果を実際に`/prompt`へキューイングして実行、さらにGenerateUIタブの本物のGenerateボタンをクリックする経路でも実行 — いずれも出力PNGはRGBA・アルファチャンネル0〜255の**正しい透過画像**だった。
- 結論: 現在デプロイされているv0.4.3のワークフロー解析ロジックに該当バグは再現せず、コード変更は行わなかった。報告時点でより古いバージョンを使っていた可能性が高いと判断し、ユーザーに調査結果と再検証手順を報告した。
**2. Labタブ: モデルの無いワークフローで無意味なキーフレームが作成される問題**: 調査の副産物として、RMBGのみ(Checkpoint/LoRA/VAEいずれのノードも無い)ワークフローをLabタブで開くと、Model列に「1: (ワークフローの設定のまま)」という空のキーフレーム行が常に表示されてしまうことを実機で発見。ユーザーから「不要なため作成しない形にしたい」との要望を受けて修正。`_buildWorkflowForIteration()`は対象ノードIDが存在しない場合、書き込みを黙ってスキップするだけ(`write()`の`wf[nodeId]`ガード)なので、この行はRun時に何の効果も持たない死んだコントロールだった。`_hasNodeForColumn(col)`を新設し、`_renderColumn()`と`_initColumnButtons()`の+ボタンで判定 — 対応ノードが無い列は「このワークフローに該当ノードがありません」というプレースホルダーを表示し、キーフレーム追加もブロックする。VAEだけは特殊扱いで、専用VAELoaderが無くてもCheckpointノードが存在すれば内蔵VAEの上書き注入が意味を持つため(既存の`_buildWorkflowForIteration`のVAELoader自動注入ロジック)、Checkpoint存在時はVAE列も通常表示のままにした。
@@ -348,6 +502,7 @@ v0.5.0で追加したmp4 Gallery対応(一覧・サムネイル・再生のみ
ユーザーから「生成UIタブのLab機能のLora、ModelタブのLoraのLoraノード自体をバイパスする機能を追加したい。Lab機能ではキーフレームごとに切り替え対応可能としたい」との要望を受けて着手。同じセッション内で続けて「Lab機能のLoraにLora syntax、Trigger wordsの適用を可能にしたい」「AI TOOLタブのCHATの画像生成でチャットによる設定項目を増やしたい」という要望にも順次対応した一連のセッション。
**1. LoRAノードのバイパス機能**: 実装方針の分岐点(ComfyUI本来のBypass(mode:4)相当の配線迂回か、strength=0にする簡易実装か)をAskUserQuestionでユーザーに確認し、簡易実装(strength=0)を選択。理由は、Lab/GenerateUIが扱う`workflow`は既に`comfyui-workflow.js`の`convertUiToApi()`でAPI形式に変換済みで`mode`の概念自体が失われており、`mode:4`を書き込んでも実行エンジンには一切効果がないため——本物のBypass相当の配線再接続を自前実装するのは過剰投資と判断した。
- **GenerateUI Model タブ**: LoRA列ヘッダーの「Refresh Stack group」ボタン左に⛔トグルボタンを追加(`comfyui-editor.js`の`toggleLoraNodeBypass()`/`_loraNodeBypass`/`_loraBypassSnapshot`)。対象ノードのstrength値をゼロ化し、退避したスナップショットから復元をトグルする。Lora Managerノードの場合はLoRAリスト自体(複数エントリ)は差し替えず維持したまま各エントリのstrength/clipStrengthだけを0にする。Single/Stack Applyボタンを押すとバイパス状態は自動クリアされ、あとから無言で再適用されることはない。
- **Lab機能**: 既存の行単位「bypassed」(キーフレーム自体を無視するスキップ機能)とは独立した、LoRA列専用の`nodeBypass`フィールドをキーフレームの値に追加。編集モーダルに「LoRAノードをバイパス(強度を0にする)」チェックボックスを新設。`_applyLabLoraToWorkflow()`で`nodeBypass`時はstrength/active/textを0/false/空に強制する。
@@ -356,9 +511,10 @@ v0.5.0で追加したmp4 Gallery対応(一覧・サムネイル・再生のみ
**3. AI TOOL Chat: generate_imageツールのパラメータ拡張**: AskUserQuestionで追加したい項目をユーザーに確認し、KSampler系(steps/cfg/sampler_name/scheduler/denoise/seed)・画像サイズ(width/height)・生成枚数(batch_size)を選択。`comfyui-editor.js`に`setGenerationParams()`を新設し、Lab機能の`_buildWorkflowForIteration`と同じ`sampler_nodes`のstepsNodeId/cfgNodeId等のノードID間接参照パターンを再利用することで、Advanced Samplingワークフロー(Flux.1/2、SD3.5等でKSamplerが複数ノードに分割される構成)にも対応した。seedは`window._wfmGenerateTab.generate()`(実体は`handleGenerate`)へのオプション引数として渡すよう、`generate-tab.js`の`handleGenerate`/`_coreGenerate`にgenOptions引数を追加(既存の呼び出し元との後方互換は維持)。batch_size>1時は複数画像がチャットバブルに表示されるよう`appendChatBubble`に`imageUrls`(複数URL)対応を追加した。実機のOllama(ornith-1.5:9b)でツール呼び出しから画像生成までEnd-to-Endで検証し、指定した各パラメータが正しく反映されることを確認した。
**4. Resolution Selectorノード対応**: ユーザーから実際のワークフロー画像(aspect_ratio COMBO・megapixels・multipleウィジェットを持つ「Resolution Selector」ノード)を見せられ、「3:2などで指定可能か」と問われて調査。`/object_info/ResolutionSelector`で確認したところComfyUI本体組み込みノード(`comfy_extras.nodes_resolution`)で、aspect_ratioは`"3:2 (Photo)"`のような固定ラベル付きCOMBO値と判明した。当初のwidth/height直接指定実装ではこの手のノードに非対応だったため、追加で以下を実装:
- `comfyui-workflow.js`の`analyzeWorkflow()`に`resolution_selector_nodes`カテゴリを新設。
- `comfyui-editor.js`に`resolveAspectRatioOption(nodeType, requested)`を新設。LLMが渡す短い`"3:2"`形式を、`/object_info`から取得した実際のCOMBO選択肢と前方一致でマッチさせ`"3:2 (Photo)"`のような完全な文字列に解決する(未知の比率はそのままフォールバックし、ComfyUI側の検証エラーに委ねる)。
- `setGenerationParams()`にResolution Selector優先ロジックを追加:aspect_ratio指定時はEmptyLatentImageへのwidth/height直接書き込みをスキップし、ResolutionSelectorノードのaspect_ratioだけを書き換える——EmptyLatentImageのwidth/heightがResolutionSelectorの出力へのリンクになっている場合、直接数値を書き込むとそのリンクを上書きしてしまい、意図した比率指定が無視されてしまうため。
- `comfyui-workflow.js`の`analyzeWorkflow()`に`resolution_selector_nodes`カテゴリを新設。
- `comfyui-editor.js`に`resolveAspectRatioOption(nodeType, requested)`を新設。LLMが渡す短い`"3:2"`形式を、`/object_info`から取得した実際のCOMBO選択肢と前方一致でマッチさせ`"3:2 (Photo)"`のような完全な文字列に解決する(未知の比率はそのままフォールバックし、ComfyUI側の検証エラーに委ねる)。
- `setGenerationParams()`にResolution Selector優先ロジックを追加:aspect_ratio指定時はEmptyLatentImageへのwidth/height直接書き込みをスキップし、ResolutionSelectorノードのaspect_ratioだけを書き換える——EmptyLatentImageのwidth/heightがResolutionSelectorの出力へのリンクになっている場合、直接数値を書き込むとそのリンクを上書きしてしまい、意図した比率指定が無視されてしまうため。
**ヘルプ・README更新**: `project_v0336_conventions`の慣習(index.html + i18n.js 3言語 + app.jsのhelpIdMapの3点セット)に従い、`helpLab16`/`helpLab17`(Lab LoRAバイパス・プロンプト適用)、`helpGen29`(GenerateUI Model LoRAバイパスボタン)を新規追加し、`helpAi3`(AI TOOL Chatの説明)を拡張パラメータの説明を含めて更新した。README.mdのGenerateUI Tab/Lab subtab/AI TOOL Tabの各セクションも同内容で更新した。
@@ -5420,8 +5576,7 @@ SPA および Workflow Studio Library サイドパネルの両方に AI タブ
**`applyTextareaFontSize(size)` 追加(export)**
- `<style id="wfm-ta-font-size-style">` を `<head>` に注入
- 対象セレクタ(対象を 8 箇所に一括適用):
| 対象 | ID |
- 対象セレクタ(対象を 8 箇所に一括適用):| 対象 | ID |
| ---------------------------------------- | -------------------------- |
| Generate UI — Positive Prompt | `#wfm-prompt-pos-text` |
| Generate UI — Negative Prompt | `#wfm-prompt-neg-text` |
@@ -6705,6 +6860,7 @@ Feeder 専用スタイルを末尾に追加:
- **型バッジの削除:** ThumbView・CardView・SidePanelの `renderSideInfo` から `typeBadge = badgeHtml(typeLabel)` を削除。ユーザー定義バッジのみ表示
- **`GENUI_TYPE_MAP` 追加:**
```javascript
const GENUI_TYPE_MAP = {
checkpoint: { key: "checkpoints", inputKey: "ckpt_name" },
@@ -6718,6 +6874,7 @@ Feeder 専用スタイルを末尾に追加:
hypernetwork / embedding は対象外
- **`applyToGenUI(modelName, modelType)`** 追加:
- `comfyUI.currentWorkflow` からターゲット `inputKey` を持つノードを検索
- `node.inputs[inputKey] = modelName` で直接セット
- `<select id="wfm-model-${key}">` の表示値も同期
+6 -5
View File
@@ -26,7 +26,7 @@ A comprehensive workflow, asset management, and generation UI plugin for [ComfyU
- Built-in AI tools (translation and more)
![Workflow Studio](https://img.shields.io/badge/ComfyUI-Custom_Node-blue)
![Version](https://img.shields.io/badge/version-0.5.7-green)
![Version](https://img.shields.io/badge/version-0.6.2-green)
## Features (tab -> feature names)
@@ -52,7 +52,7 @@ Setting / Results / Plan JSON sub-panels, Per-column keyframes, Model column —
2-column layout, Collapsible sections, Theme selection, Theme customization, Workflows directory, Gallery output directory, Eagle connection, CivitAI Host, CivitAI API Key, Default workflow, Default Checkpoint, Video Playback Volume, Data Management, Text Size, RAW JSON Colors, GenerateUI Model Tab Highlight, Wildcard Integration, G'MIC-Qt Integration, Language
### Gallery Tab (v0.3.44)
Output / ImagePrompt / Style_Catalog / Metadata sub-tabs, Image browser, Folder tree root label, Thumbnail / Table views, Folder management, File operations, Download, MP4 video support, MP4 embedded metadata, Info tab: dimensions & duration, Multi-select, Image Compare, Prompt search, Server-side filtering, Group management, Thumbnail F button, Favorites, Detail panel, Prompt tab, Workflow viewer, GenUI button, Image Edit button, Send GenUI Image button, Send to LI node button, Send CC button, Search clear (✕), Clear all filters (✕ Clear), Workflow auto-save, Output folder configurable, SVG file support, Performance
Output / ImagePrompt / Style_Catalog / Metadata sub-tabs, Image browser, Folder tree root label, Thumbnail / Table views, Folder management, File operations, Download, MP4 video support, MP4 embedded metadata, Info tab: dimensions & duration, Multi-select, Image Compare, Prompt search, Server-side filtering, Group management, Thumbnail F button, Favorites, Detail panel, Prompt tab, Workflow viewer, GenUI button, Image Edit button, Send GenUI Image button, Send to LI node button, Send CC button, Search clear (✕), Clear all filters (✕ Clear), Workflow auto-save, Output folder configurable, SVG file support, PSD file support, Performance
### ImagePrompt Gallery subtab (v0.3.94, renamed from Style/Prompt in v0.3.95)
Visual prompt library, 3-column layout, Prompt builder (right pane), Plain-text prompt storage, ponyxlWildcardsVault format support, Seed data importer
@@ -73,10 +73,10 @@ Model Browser, Thumbnail / Table views, Table column sort, Search & Filter, User
3 sub-tabs, Model support, Threshold sliders, VLM tagging, Single tab, Single output options, Batch tab, DB tab, Dependencies
### Image Edit Tab (v0.3.65)
Layer-based image editor, Loading images, New button, Tools, Layer panel, Layer lock, Text quality, Export, Canvas navigation, Undo / Redo
Layer-based image editor, Loading images, Open PSD button, Close button, New button, Tools, Layer panel, Duplicate layer (⧉), Layer lock, Text quality, Export, Canvas navigation, Undo / Redo
### Video Tab (v0.5.0 – v0.5.7)
Dedicated video generation UI, independent of GenerateUI, Plan / Edit subtabs, Base settings row, Asset / Project subtabs, Two center previews, First Frame / Last Frame are both optional, Semantic node lookup, not hardcoded IDs, Field highlight color, Load in Video, Frame tab, GIF tab, Playback volume
### Video Tab (v0.5.0 – v0.7.0)
Dedicated video generation UI, independent of GenerateUI, Plan subtab, Base settings row, Edit subtab, Asset subtab, Project subtab, Two center previews, First Frame / Last Frame are both optional, Semantic node lookup, not hardcoded IDs, Field highlight color, Load in Video, Frame tab, GIF tab, Playback volume
### AI TOOL Tab (v0.3.14)
4-pane layout, Translation pane, Chat pane, Chat pane — image generation via Tool Calling, Chat pane — generate_image extra parameters, TOOLS pane (VLM), TOOLS pane — shared Chat attachment, TOOLS pane (Wildcards), Chat pane — image-to-image (I2I), Chat pane — SVG generation, no ComfyUI workflow involved, Chat pane — Skills, Settings pane, Unsloth backend, Settings pane — Chat Image Generation, Settings pane — Chat I2I Generation, Settings pane — Generation, Model unload, Settings shared, Backend support, URL security, Lemonade's other endpoints (not integrated)
@@ -160,6 +160,7 @@ Click the **camera icon** (next to the W button) in ComfyUI's top bar to capture
- **[Unsloth](https://unsloth.ai/)** — alternative backend for translation, chat, and VLM (OpenAI-compatible API); always requires an API key, set via `UNSLOTH_API_KEY` in a `.env` file — `pip install -r requirements.txt` for `python-dotenv`
- **[Eagle](https://eagle.cool/)** — for auto-saving generated images with metadata
- **[comfyui-mask-editor-one](https://github.com/ketle-man/comfyui-mask-editor-one) (v0.1.9+)** — enables BiRefNet background removal, SAM3 text-prompt segmentation, and ABR stamp-brush library in the Image Edit Mask tool; `birefnet.safetensors` must be placed in `ComfyUI/models/background_removal/` for BiRefNet
- **[psd-tools](https://pypi.org/project/psd-tools/)** (v0.6.0) — enables all PSD (Photoshop) features: Gallery bulk "Create PSD" export, Gallery browsing/thumbnails for `.psd` files, and Image Edit's Save PSD / Open PSD buttons; `pip install -r requirements.txt` (ships prebuilt wheels, no C compiler required); without it, PSD-related actions show an error toast with the install command instead of failing silently
---
+26 -18
View File
@@ -22,7 +22,7 @@ A comprehensive workflow, asset management, and generation UI plugin for [ComfyU
- Built-in AI tools (translation and more)
![Workflow Studio](https://img.shields.io/badge/ComfyUI-Custom_Node-blue)
![Version](https://img.shields.io/badge/version-0.5.7-green)
![Version](https://img.shields.io/badge/version-0.6.2-green)
## Screenshots
@@ -254,7 +254,7 @@ An experimental batch generator: runs the workflow currently loaded in GenerateU
- **MP4 video support** (v0.5.0) — `.mp4` files are browsable, previewable (detail panel with native `<video controls>`, lightbox, and Compare), and included in favorites/tags/groups/move/delete/export alongside images; server-side thumbnails are generated from the first video frame via PyAV (falls back to a placeholder if PyAV/ffmpeg decoding isn't available); a small ▶ badge overlays video thumbnails in the grid
- **MP4 embedded metadata** (v0.5.1) — the Prompt and JSON tabs now also work for `.mp4` files: reads the `workflow`/`prompt` container tags ComfyUI's `SaveVideo` writes into the mp4 (via PyAV server-side), including all-in-one video-generation nodes that carry their prompt directly on a `prompt` input rather than a separate `CLIPTextEncode`-style node (e.g. `MiniMaxH3ImageToVideo`)
- **Info tab: dimensions & duration** (v0.5.1) — the detail panel's Info tab now also shows image dimensions (width×height) or video duration, in addition to filename, size, date, tags, and memo
- **Multi-select** — Ctrl+click to select multiple images; Bulk Bar appears for batch operations: select group → "Add to Group" / "Remove from Group"; Favorite All / Unfavorite All; Compare (2–4 images); Move To...; **Export** (downloads all selected images as a ZIP file); Delete File
- **Multi-select** — Ctrl+click to select multiple images; Bulk Bar appears for batch operations: select group → "Add to Group" / "Remove from Group"; Favorite All / Unfavorite All; Compare (2–4 images); Move To...; **Export** (downloads all selected images as a ZIP file); **Create PSD** (v0.6.0, combines the selected images into one layered PSD file, positioned top-left on a canvas sized to the largest image); **Edit as Layers** (v0.6.0, opens all selected images in the Image Edit tab at once, each as its own layer); Delete File
- **Image Compare** — select 2–4 images with Ctrl+click, then click "Compare" in the Bulk Bar to open a side-by-side lightbox; grid adapts to the number of selected images
- **Prompt search** — text search covers filename, tags, memo, and prompt text (A1111 `parameters` field cached on first detail panel open)
- **Server-side filtering** — filter by group, favorites, or tags with fast server-side set lookup (no full rescan)
@@ -265,15 +265,16 @@ An experimental batch generator: runs the workflow currently loaded in GenerateU
- **Prompt tab** (v0.4.7) — selected by default (the most frequently checked piece of info shouldn't need an extra click); lists every positive/negative prompt candidate found in the embedded workflow with POS/NEG badges, reusing the exact same list→click→full-text UI as the Metadata tab; extracts from the API-format embedding when available rather than the UI-format one, since a workflow with independent top-level and subgraph sampling chains (e.g. Krea-2) can otherwise have some of its prompts missed
- **Workflow viewer** — Metadata tab displays workflow JSON from PNG embedded data (`prompt` / `workflow` keys) or from workflow saved by the Generate UI tab; **Copy & Send Canvas** button copies the JSON to the clipboard and sends the workflow directly to the ComfyUI canvas (UI and API formats both supported)
- **GenUI button** (renamed from "Load GenUI" in v0.5.0 for readability) — loads the embedded ComfyUI workflow from the selected image directly into the GenerateUI tab; shows a warning toast if no workflow is embedded or the format is unsupported; Metadata button is styled green, GenUI button uses the primary accent color
- **Image Edit button** — toolbar button; sends the selected image directly to the Image Edit tab as the base layer
- **Image Edit button** — toolbar button; sends the selected image directly to the Image Edit tab as the base layer; PSD files (v0.6.0) are fully decomposed into their original layers instead of being flattened into one image
- **Send GenUI Image button** — toolbar button (next to Image Edit); uploads the selected image to ComfyUI and sets it as the input for the first LoadImage node in the GenerateUI tab; automatically switches to GenerateUI → Input → Image; requires a workflow with at least one LoadImage node to be loaded
- **Send to LI node button** (v0.5.2) — toolbar button (next to Send GenUI Image); uploads the selected image and writes its filename into the `image` widget of the node currently selected on the ComfyUI canvas (falling back to the first LoadImage-type node found) — same destination and cross-window bridge as the Image Edit tab's **Send to LI node** button (renamed from "Send to Workflow" in this same release), so both entry points now share one consistent name; requires Workflow Studio to have been opened from ComfyUI's top menu button
- **Send CC button** (v0.3.69) — toolbar button, shown only when this Gallery tab is embedded as an iframe inside ComfyUI Comic Creator (a separate custom node); sends the selected image directly into Comic Creator's currently selected panel/overlay
- **Send CC button** (v0.3.69) — toolbar button, shown only when this Gallery tab is embedded as an iframe inside ComfyUI Comic Creator (a separate custom node); sends the selected image directly into Comic Creator's currently selected panel/overlay; when the selected file is an MP4 video (v0.6.3), it is routed to Comic Creator's Layout-tab Video tool instead — inserted as a new video object in the selected panel (playable, capturable to a still frame) rather than as a flattened image; sending a video while the Image tab is the intended destination is not yet supported and shows an info toast instead
- **Search clear (✕)** — inline ✕ button appears inside the search box whenever text is entered; click to clear immediately
- **Clear all filters (✕ Clear)** — toolbar button next to the view-mode (Thumbnail/Table) switch (v0.5.2, moved from the toolbar's rightmost position so it sits with the other display-affecting controls); resets search text, tag filter, group filter, and favorites filter in one click (sort order is preserved)
- **Workflow auto-save** — images generated from the Generate UI tab have their workflow automatically saved to gallery metadata
- **Output folder configurable** — set the scanned output folder from Settings tab
- **SVG file support** (v0.3.77) — `.svg` files are browsable, previewable (detail panel and lightbox), and included in favorites/tags/groups/move/delete/export alongside raster formats; served as-is with no rasterized thumbnail, since `<img>` scales vector graphics natively at any size
- **PSD file support** (v0.6.0) — `.psd` files are browsable alongside other formats; thumbnails and full-size previews show every layer merged together (hidden layers excluded), rendered server-side via `psd-tools` and disk-cached; the underlying PSD file itself is never modified — only the Gallery preview is a flattened rendering
- **Performance** — server-side 256px JPEG thumbnail generation with disk cache (`data/thumb_cache/`); infinite-scroll paging (50 images per page, IntersectionObserver); folder-level mtime cache (60s TTL); bulk operations use single-request API endpoints
</details>
@@ -373,7 +374,7 @@ An experimental batch generator: runs the workflow currently loaded in GenerateU
- **Single tab** — drag & drop an image onto the preview area or click Upload; Gallery detail panel **Tagger** button opens the selected image directly here
- **Single output options** — (1) **GenUI:P** — appends tags to the GenerateUI tab's positive prompt and immediately applies to the loaded workflow; (2) **Send to Prompt** — appends tags to the Prompt tab's positive textarea; (3) **Save to Gallery** — saves tags to Gallery image metadata (requires image opened from Gallery); (4) **Write to File** — embeds tags into JPEG EXIF (`ImageDescription`) or PNG `tEXt` chunk (`Tags` key), other formats get a `.tags.json` sidecar; (5) **Save to DB** — stores in internal SQLite database
- **Batch tab** — enter a folder path, configure WD Tagger thresholds and (via the same ⚙ Settings modal as Single) the VLM backend; output options: **Save to DB** (default on), **Write to File** (EXIF/PNG metadata), **Write .txt** (creates `<filename>.txt` alongside each image with all tags); real-time progress bar and log; Stop cancels after the current image
- **DB tab** — searchable SQLite database of all tagged images; click a row to open the edit panel and modify WD Tags / VLM Tags; Save updates the record, Delete removes it; Export CSV downloads all records
- **DB tab** — searchable SQLite database of all tagged images; click a row to open the edit panel and modify WD Tags / VLM Tags; Save updates the record, Delete removes it; Export CSV downloads all records; **bulk delete** (v0.5.8) — per-row checkboxes plus a header checkbox to select/deselect all, a confirmation dialog before deleting the selected records
- **Dependencies** — install into ComfyUI's embedded Python: `python_embedded\python.exe -m pip install -r requirements.txt`; for GPU inference use `onnxruntime-gpu`; TensorFlow (DeepDanbooru) is optional and commented out in `requirements.txt`
</details>
@@ -381,41 +382,47 @@ An experimental batch generator: runs the workflow currently loaded in GenerateU
<details>
<summary><h3>Image Edit Tab (v0.3.65)</h3></summary>
- **Layer-based image editor** — compose images with multiple layers (Image, Text, Draw, Mask types) and export the composite as PNG
- **Loading images** — drag & drop onto the canvas, Upload button, or send from the Gallery tab via the **Image Edit** toolbar button; first image becomes Layer 1 (auto-locked), subsequent images are added as new layers scaled to fit the canvas
- **Layer-based image editor** — compose images with multiple layers (Image, Text, Draw, Mask types) and export the composite as PNG or a fully layered PSD
- **Loading images** — drag & drop onto the canvas, **File Open** button (renamed from Upload in v0.6.0), or send from the Gallery tab via the **Image Edit** toolbar button; first image becomes Layer 1 (auto-locked), subsequent images are added as new layers scaled to fit the canvas
- **Open PSD button** (v0.6.0, next to File Open) — loads a layered PSD file from disk and decomposes it into individual layers, restoring each layer's position, size, visibility, opacity, and blend mode; groups and non-raster layers (adjustment layers, etc.) are flattened into their rendered appearance
- **Close button** (v0.6.0, next to Open PSD) — closes the current document after a confirmation prompt, discarding all layers and unsaved edits and returning to the empty placeholder view
- **New button** — create a blank canvas with custom dimensions (WxH prompt); clears all existing layers and automatically adds an empty Layer 1 (v0.3.70)
- **Tools** — Select (V), Draw (B), Text (T), Shape (S), Mask (🎭), Blur (≈), BG Remove (⬚), Filter (★), Inpaint (🩹); tool options bar updates per active tool
- **Tools** — Select (V), Draw (B), Text (T), Shape (S), Fill (G), Mask (🎭), Blur (≈), BG Remove (⬚), Filter (★), Inpaint (🩹); tool options bar updates per active tool
- **Select** — click to select; drag to move; drag corner handles to resize; drag circle handle to rotate; Flip H / Flip V / Rotate angle in the options bar; double-click a text layer to re-edit its content
- **Draw** — freehand brush; options: color, brush size, blend mode; paints directly onto the active draw layer while all other layers remain visible; brush cursor shown as a size-accurate circle; strokes can start from outside the canvas margin and continue past the edge
- **Draw** — freehand brush; options: color, brush size, blend mode; paints directly onto the active draw layer while all other layers remain visible; brush cursor shown as a size-accurate circle; strokes can start from outside the canvas margin and continue past the edge; **pen tablet support** (v0.6.2) — brush size and opacity respond to pen pressure (mouse behaves exactly as before); the canvas listens for Pointer Events so pen, touch, and mouse all work through the same code path
- **Text** — click to place; configure font, size, bold/italic, align, and color; placed as an exact-size text layer sized to the measured bounding box; double-click to re-edit
- **Shape** — drag to draw geometric shapes (Rect / Ellipse / Line / FreeLine); options: shape type, Rounded toggle (Rect/Ellipse), Fill color, Stroke color + width, Opacity; each committed shape becomes an independent draw layer; Stroke None hidden for Line/FreeLine (stroke always active)
- **Mask** — 7 sub-tools for painting masks onto a dedicated mask layer; click **M** in the Layers header to add a mask layer (Mask tool activates automatically); clicking a mask layer in the list also switches to the Mask tool; **Tool Options bar**: sub-tool buttons (Paint / Color / Alpha / Text / Vector / Shape / SAM3), Invert checkbox, Overlay color picker (default red), Blur slider (0–50 px); the overlay is only shown for the currently active mask layer, other mask layers stay hidden until selected (v0.3.70); SAM3 requires Mask Editor One (disabled when not installed); Color / Alpha / Text / Vector / Shape work without Mask Editor One; **Properties pane — Paint**: Mode (Add / Erase), Size (1–200 px), Hardness (0–100%); **MASK EDITOR ONE section** (Paint sub-tool, visible when installed): Select opens the ABR stamp-brush library; ✕ clears back to Circle; when an image brush is active, Hardness is disabled and Spacing (5–100%), Angle (0–359°), Sz Jitter (0–100%), Rot. Jitter (on/off) appear; **Edit in Mask Editor One →** (v0.4.0) — sends the current canvas composite (plus the active mask layer's content, if one is selected) to a MaskEditorOne node on the ComfyUI canvas — the currently selected node if it is one, otherwise the first MaskEditorOne node found in the graph (same selection logic as **Send to LI node**) — and opens its full interactive editor (paint, SAM3, BiRefNet, shapes, etc.) in the ComfyUI browser tab; clicking Apply there imports the result back here as a new mask layer; requires Workflow Studio to have been launched from ComfyUI's top-menu button and at least one MaskEditorOne node to exist on the ComfyUI canvas; **Properties pane — Color**: click canvas to flood-select pixels by color similarity; Mode (Add / Subtract), Tolerance (0–255), Feather % (0–100); **Properties pane — Alpha**: extract the active layer's transparency as a mask; Threshold, Invert checkbox, Extract Alpha button; **Properties pane — Text**: click canvas to open a stamp overlay — enter text, set Font / Size / Bold / Italic / Align / Mode (Add / Erase), Stamp or Ctrl+Enter to apply; multi-line supported; **Properties pane — Vector**: click to add Catmull-Rom spline points; Enter (or click first point) closes and fills the polygon; Backspace removes the last point; Esc resets; Mode (Add / Erase); **Properties pane — Shape**: drag to draw Rect or Ellipse; hold Shift for square/circle; blue dashed outline preview while dragging; Mode (Add / Erase); **Properties pane — SAM3**: enter a text prompt, set Max candidates (3/6/9/12), click Segment; select candidate thumbnails (multi-select), Apply Selected (N) applies with current Mode; **Mask layer A/S operation**: A/S toggle — Add (green) composites normally, Subtract (red) cuts the mask from below; **✂ clipping mask button** clips the layer below to the painted area; brush cursor shown as size-accurate circle; strokes can start from outside the canvas margin and continue past the edge
- **Fill** (v0.6.2) — bucket fill; click a contiguous same-color region on the active layer to flood-fill it (scanline-based, ported from the Comic Creator plugin's Image tab); **Properties pane**: Mode (Solid / Gradient) — Solid: Color picker; Gradient: Shape (Linear / Radial), a draggable color-stop Ramp (click a stop to select it, drag to reposition, +/- to add/remove stops, color swatch to edit the selected stop's color), and a Direction dial (drag to set angle/radius); both Tolerance (0–255, color-match threshold) and Opacity apply to either mode; Ramp and Direction dial are pointer-event based with pointer capture, so pen tablets work the same as mouse
- **Mask** — 7 sub-tools for painting masks onto a dedicated mask layer; click **Mask** on the second row of the Layers header (renamed from "M" and moved to its own row in v0.6.0) to add a mask layer (Mask tool activates automatically); clicking a mask layer in the list also switches to the Mask tool; **Tool Options bar**: sub-tool buttons (Paint / Color / Alpha / Text / Vector / Shape / SAM3), Invert checkbox, Overlay color picker (default red), Blur slider (0–50 px); the overlay is only shown for the currently active mask layer, other mask layers stay hidden until selected (v0.3.70); SAM3 requires Mask Editor One (disabled when not installed); Color / Alpha / Text / Vector / Shape work without Mask Editor One; **Properties pane — Paint**: Mode (Add / Erase), Size (1–200 px), Hardness (0–100%); brush size responds to pen pressure on a tablet (v0.6.2, same as the Draw tool); **MASK EDITOR ONE section** (Paint sub-tool, visible when installed): Select opens the ABR stamp-brush library; ✕ clears back to Circle; when an image brush is active, Hardness is disabled and Spacing (5–100%), Angle (0–359°), Sz Jitter (0–100%), Rot. Jitter (on/off) appear; **Edit in Mask Editor One →** (v0.4.0) — sends the current canvas composite (plus the active mask layer's content, if one is selected) to a MaskEditorOne node on the ComfyUI canvas — the currently selected node if it is one, otherwise the first MaskEditorOne node found in the graph (same selection logic as **Send to LI node**) — and opens its full interactive editor (paint, SAM3, BiRefNet, shapes, etc.) in the ComfyUI browser tab; clicking Apply there imports the result back here as a new mask layer; requires Workflow Studio to have been launched from ComfyUI's top-menu button and at least one MaskEditorOne node to exist on the ComfyUI canvas; **Properties pane — Color**: click canvas to flood-select pixels by color similarity; Mode (Add / Subtract), Tolerance (0–255), Feather % (0–100); **Properties pane — Alpha**: extract the active layer's transparency as a mask; Threshold, Invert checkbox, Extract Alpha button; **Properties pane — Text**: click canvas to open a stamp overlay — enter text, set Font / Size / Bold / Italic / Align / Mode (Add / Erase), Stamp or Ctrl+Enter to apply; multi-line supported; **Properties pane — Vector**: click to add Catmull-Rom spline points; Enter (or click first point) closes and fills the polygon; Backspace removes the last point; Esc resets; Mode (Add / Erase); **Properties pane — Shape**: drag to draw Rect or Ellipse; hold Shift for square/circle; blue dashed outline preview while dragging; Mode (Add / Erase); **Properties pane — SAM3**: enter a text prompt, set Max candidates (3/6/9/12), click Segment; select candidate thumbnails (multi-select), Apply Selected (N) applies with current Mode; **Mask layer A/S operation**: A/S toggle — Add (green) composites normally, Subtract (red) cuts the mask from below; **✂ clipping mask button** clips the layer below to the painted area; brush cursor shown as size-accurate circle; strokes can start from outside the canvas margin and continue past the edge
- **Blur** — **Whole Blur**: Gaussian blur to the entire active layer with intensity slider (1–50 px); **Whole Mosaic**: pixelation mosaic with block-size slider (5–100 px); **Rect Blur / Rect Mosaic**: enable the toggle then drag a rectangle on the canvas to apply blur or mosaic to that region only (blue preview for blur, orange for mosaic); Rect Blur and Rect Mosaic are mutually exclusive; all operations support Undo
- **BG Remove** — remove the background from the active layer; **Lightweight (@imgly)**: runs entirely in the browser via CDN (no server required; ~40 MB model downloaded on first use); **BiRefNet**: high-quality removal via Mask Editor One's Python backend (requires Mask Editor One installed and `birefnet.safetensors` in `ComfyUI/models/background_removal/`); **New Layer** option (default on) adds the result as a new layer above the original; when off, replaces the active layer in-place
- **Filter (G'MIC)** — apply G'MIC-Qt filter effects to the active image layer; click **Edit with G'MIC** to launch G'MIC-Qt GUI; select a filter and click OK — a "G'MIC-Qt filter output" window appears; close it to save the result back as the active layer; requires G'MIC-Qt Standalone installed and path configured in Settings → G'MIC-Qt Executable Path
- **Inpaint** (v0.3.71) — composites the visible layers plus a Mask layer into one RGBA image (mask baked into the alpha channel) and applies it to the first inpaint-capable LoadImage node in the workflow currently loaded in GenerateUI (a node whose MASK output feeds something like `VAEEncodeForInpaint`); also supports workflows built around the **Mask Editor One** custom node (`comfyui-mask-editor-one`) instead of LoadImage — image/mask are pushed via its node_id-keyed server cache and `layer_data` widget; **Properties pane**: Positive/Negative prompts, Grow Mask By (applied to the VAE Encode (for Inpainting) node), Denoise (applied to KSampler), Run button; **Use dedicated workflow** checkbox — when off, generates against the workflow currently loaded in GenerateUI; when on, pick a saved workflow from the dropdown to load, edit, and generate entirely in the background without disturbing what's shown in GenerateUI; the result image is shown back in the Properties pane when generation completes; requires a Mask layer painted first (Mask tool)
- **Layer panel** — layer list with visibility (👁/🚫), lock (🔒/🔓), and clipping-mask (✂) toggles; opacity slider; type icons (🖼 image / T text / ✏ draw / ⬚ mask); Layer 1 is automatically locked on first image load
- **Layer panel** — layer list with visibility (👁/🚫), lock (🔒/🔓), and clipping-mask (✂) toggles; opacity slider; type icons (🖼 image / T text / ✏ draw / ⬚ mask); Layer 1 is automatically locked on first image load; header is arranged in two rows (v0.6.0) — +, **⧉ Duplicate**, −, ↑, ↓ on top, **Mask** alone below
- **Duplicate layer (⧉)** (v0.6.0) — copies the active layer, including its pixels, position, size, opacity, blend mode, and visibility, and inserts the copy directly above the original as the new active layer; works on any layer type (image, draw, text, mask)
- **Layer lock** — locked layers show an orange bounding box and 🔒 icon on the canvas; move/resize/rotate are disabled while locked; click the 🔓 button in the layer row to unlock
- **Text quality** — text layers are rendered at their measured bounding-box size; resizing with the Select tool regenerates the canvas at the new display resolution so text stays sharp
- **Export** — Save PNG (download composite locally); **Save to Gallery** (saves to Gallery root folder with a timestamped default name `wfs-image-YYYYMMDDHHmmss`); **Send to LI node** (renamed from "Send to Workflow" in v0.5.2) — uploads to ComfyUI's input folder via `/upload/image`, then writes the resulting filename directly into the `image` widget of the node currently selected on the ComfyUI canvas (falls back to the first LoadImage-type node found); requires Workflow Studio to have been launched from ComfyUI's top-menu button so the ComfyUI tab is reachable; the Gallery tab's toolbar has the same button (v0.5.2, see Gallery Tab below) so a selected Gallery image can be sent the same way without going through Image Edit first
- **Export** — Save PNG (download composite locally); **Save to Gallery** (saves to Gallery root folder with a timestamped default name `wfs-image-YYYYMMDDHHmmss`); **Save PSD** (v0.6.0, downloads a layered PSD file with every layer preserved separately — position, rotation, flip, and scale are baked into each layer's pixels since PSD layers cannot store a rotation angle, while opacity, blend mode, and visibility are kept as real, editable PSD layer attributes; clipping masks are merged into their target layer since PSD's native layer-mask mechanism isn't used); **Send to LI node** (renamed from "Send to Workflow" in v0.5.2) — uploads to ComfyUI's input folder via `/upload/image`, then writes the resulting filename directly into the `image` widget of the node currently selected on the ComfyUI canvas (falls back to the first LoadImage-type node found); requires Workflow Studio to have been launched from ComfyUI's top-menu button so the ComfyUI tab is reachable; the Gallery tab's toolbar has the same button (v0.5.2, see Gallery Tab below) so a selected Gallery image can be sent the same way without going through Image Edit first
- **Canvas navigation** — scroll-wheel zoom, Space + drag to pan; zoom indicator in the bottom bar
- **Undo / Redo** — Ctrl+Z / Ctrl+Y (or toolbar buttons); keyboard shortcuts: V (Select), B (Draw), T (Text), S (Shape), Delete (remove selected layer when 2+ exist)
- **Undo / Redo** — Ctrl+Z / Ctrl+Y (or toolbar buttons); keyboard shortcuts: V (Select), B (Draw), T (Text), S (Shape), G (Fill), Delete (remove selected layer when 2+ exist)
</details>
<details>
<summary><h3>Video Tab (v0.5.0 – v0.5.7)</h3></summary>
<summary><h3>Video Tab (v0.5.0 – v0.7.0)</h3></summary>
- **Dedicated video generation UI, independent of GenerateUI** — a purpose-built tab for MiniMax H3 (Image to Video), LTX-2.5 (Text / Image / First & Last Frame to Video), and Wan2.2 (Text to Video) workflows (LTX-2.5/Wan2.2: v0.5.4); does not share state with the GenerateUI tab, and model selection (UNet/CLIP/VAE/Audio VAE) is fixed to the loaded workflow's own defaults rather than editable here
- **Plan / Edit subtabs** (center panel, batch redesign in v0.5.5) — a **plan** is a sequence of timeline blocks, each a fully self-contained generation job with its own Prompt, Duration, and First/Last Image; split the timeline with **+ Split** / **+ Block** / **Delete**, then **Run** to generate every block in order (Pause/Cancel work mid-run) — a plan with a single block behaves exactly like the old one-shot form. First Image can be None, an explicit image, or "use previous block's last frame" (chaining — an explicit Last Image on the previous block always wins over extracting one from its generated output). Save / Save As / Clear a plan (`ws_videoplan_*.json`, with a PNG contact-sheet thumbnail that embeds the full plan data so dropping the image back on works too); Edit is reserved for future video-editing tools
- **Plan subtab** (center panel, batch redesign in v0.5.5) — a **plan** is a sequence of timeline blocks, each a fully self-contained generation job with its own Prompt, Duration, and First/Last Image; split the timeline with **+ Split** / **+ Block** / **Delete**, then **Run** to generate every block in order (Pause/Cancel work mid-run) — a plan with a single block behaves exactly like the old one-shot form. First Image can be None, an explicit image, or "use previous block's last frame" (chaining — an explicit Last Image on the previous block always wins over extracting one from its generated output). Save / Save As / Clear a plan (`ws_videoplan_*.json`, with a PNG contact-sheet thumbnail that embeds the full plan data so dropping the image back on works too)
- **Base settings row** (topbar, v0.5.7) — Aspect Ratio / Megapixels / Multiple / Duration (seconds) / Noise Seed on one row — Duration always reflects the currently selected block (each block keeps its own value), the rest are plan-wide — plus a second row of model-specific fields: Width / Height (become directly editable for workflows with no Resolution Selector node, e.g. Wan2.2 and LTX-2.5's First & Last Frame to Video), Turbo Mode / Strength / Steps (MiniMax H3's turbo LoRA — Turbo Mode doubles as Wan2.2's own turbo toggle, sharing one field), and Prompt Enhance (LTX-2.5 only). Every field in both rows is enabled only when the loaded workflow actually has it — see Field highlight color below (one exception: Wan2.2's Text-to-Video variant doesn't expose Noise Seed at all, so it alone leaves that field disabled)
- **Asset / Project subtabs** (sidebar, v0.5.5) — **Asset** browses generated videos through three groups: **Video Assets** (a manually-curated keeper group you organize yourself, on your own schedule), **Video Temp** (every plan run's output lands here automatically regardless of whether the plan itself was saved — a **Clear Video Temp** button in the Gallery tab's detail panel empties it in one click), and **All Video Assets** (the union of both); selecting a video shows it in the center panel's left preview and lets you tag/memo it or jump straight to the full Gallery tab. **Project** lists every saved plan file (thumbnail, block count, last updated) — click one to load it into the Plan editor, or delete it with the × button; either sidebar panel collapses back down when its own tab is clicked again
- **Two center previews** (v0.5.5) — the left preview shows either the video currently selected in the Asset subtab or whatever's dropped/picked in the **Video Source** panel to its left (**Clear** resets it to empty); the right preview always shows the most recently generated clip. The Frame/GIF tools act on whichever preview was touched most recently
- **Edit subtab** (v0.7.0) — a lightweight clip timeline for trimming and concatenating video/image clips outside of generation: add clips via the Video Source panel's **Add to Edit** button or the Asset subtab's **Send to Edit** button, drag blocks to reorder (or use the ◀/▶ toolbar buttons), Duplicate/Delete the selected clip, Clear to empty the timeline. The trim panel for a selected video clip shows a Clipchamp-style scrubber — a time ruler, a draggable playhead synced to the Source preview, and draggable in/out handles with time badges (image clips get a simple hold-duration field instead). **▶ Preview** plays every ready clip back-to-back (trimmed to its in/out points) in the result preview, and **Export** builds and runs the actual ComfyUI graph (trim → concatenate if more than one clip → save), tagging the result into Video Temp automatically — exporting more than one clip currently drops audio, since ComfyUI's concatenation node requires uniform audio across all inputs
- **Asset subtab** (center panel, next to Plan/Edit — moved here from the sidebar in v0.7.0) — browses generated videos/images through three groups: **Video Assets** (a manually-curated keeper group you organize yourself, on your own schedule), **Video Temp** (every plan run's output lands here automatically regardless of whether the plan itself was saved — a **Clear Video Temp** button in the Gallery tab's detail panel empties it in one click), and **All Video Assets** (the union of both); a filename search box and a thumbnail-grid/table (▦/☰) view toggle sit above the list (v0.7.0). Selecting an item shows it in the center preview and lets you tag/memo it, **Send to Edit** (queues it as a clip in the Edit subtab), jump straight to the full Gallery tab, or — for images only — **Set as First Image** / **Set as Last Image** (v0.7.0, uploads it straight into the currently-selected Plan block and switches to the Plan subtab)
- **Project subtab** (sidebar) — lists every saved plan file (thumbnail, block count, last updated) — click one to load it into the Plan editor, or delete it with the × button; the panel collapses back down when its own tab is clicked again
- **Two center previews** (v0.5.5) — the left preview shows either the video currently selected in the Asset subtab or whatever's dropped/picked in the **Video Source** panel to its left (**Clear** resets it to empty); the right preview always shows the most recently generated clip; both preview frames are a fixed height (v0.7.0) so switching sources never shifts the Plan/Edit/Asset panel below them. The Frame/GIF tools act on whichever preview was touched most recently
- **First Frame / Last Frame are both optional** — leaving First Image empty runs the workflow text-only (the node is simply left unconnected — a "bypass"); workflows that don't even include a LoadImage node for First Frame are supported out of the box (Wan2.2's Text-to-Video graph has neither slot at all), and a LoadImage node is only injected into the graph on the fly if an image is actually supplied
- **Semantic node lookup, not hardcoded IDs** (generalized in v0.5.4) — detects which of the three families is loaded from its subgraph's internal node types (or, for Wan2.2, the subgraph's own name — it has no distinctive internal node type), then locates its Resolution Selector and LoadImage node(s) by the subgraph's *public input label* (`prompt`, `duration`, `width`, `first_frame`, `last_frame`) rather than a fixed slot index — so it keeps working even though the three families expose those inputs under different internal names; a workflow no longer needs to match any bundled reference file's exact node IDs, and no fallback test workflow is auto-loaded on tab open
- **Field highlight color** — Prompt / Duration / First Image / Last Image / Aspect Ratio / Megapixels / Multiple / Noise Seed / Width / Height / Turbo Mode / Strength / Steps / Prompt Enhance labels turn the same highlight color as the GenerateUI Model tab (shared setting, customizable in the Settings tab — see below) when the loaded workflow actually exposes that field; e.g. a Wan2.2 workflow (no Resolution Selector node) leaves Aspect Ratio / Megapixels / Multiple unhighlighted while Width / Height light up instead
- **Load in Video** (Workflow tab) — load any workflow containing a MiniMax H3 Image-to-Video node, an LTX-2.5 Text/Image/First&Last-Frame-to-Video node, or a Wan2.2 Text-to-Video node straight into this tab from the Workflow tab's side-panel toolbar (next to Load in GenerateUI) — starts a fresh single-block plan seeded from the workflow's own current values; unsupported workflows show an error toast instead of loading
- **Frame tab** (right panel) — captures the active preview's current playback position as a still frame: play/seek to the position you want, click **Capture Frame** (client-side canvas, no server round-trip), then **Save to Output** to write it as a PNG into ComfyUI's own Output folder (auto-numbered, same pattern as other generated images)
- **Frame tab** (right panel) — captures the active preview's current playback position as a still frame: play/seek to the position you want, click **Capture Frame** (client-side canvas, no server round-trip), then **Save to Output** to write it as a PNG into ComfyUI's own Output folder (auto-numbered, same pattern as other generated images); an optional **Add to Video Assets group** checkbox (v0.7.0) also tags the saved frame into Gallery's Video Assets group
- **GIF tab** (right panel) — converts the active preview to an animated GIF; set Start/End (seconds), FPS, and an optional Max Width, then **Convert to GIF** — the server decodes the video (PyAV) and encodes an animated GIF (Pillow), both dependencies ComfyUI itself already requires, so no ffmpeg binary or extra install is needed; the result is saved into ComfyUI's Output folder and previewed inline
- **Playback volume** — the preview player's volume is saved to the Settings tab and shared across every video player in the plugin (Video tab, Gallery tab), so it no longer resets to maximum each time a different video is opened
@@ -561,6 +568,7 @@ Click the **camera icon** (next to the W button) in ComfyUI's top bar to capture
- **[Unsloth](https://unsloth.ai/)** — alternative backend for translation, chat, and VLM (OpenAI-compatible API); always requires an API key, set via `UNSLOTH_API_KEY` in a `.env` file — `pip install -r requirements.txt` for `python-dotenv`
- **[Eagle](https://eagle.cool/)** — for auto-saving generated images with metadata
- **[comfyui-mask-editor-one](https://github.com/ketle-man/comfyui-mask-editor-one) (v0.1.9+)** — enables BiRefNet background removal, SAM3 text-prompt segmentation, and ABR stamp-brush library in the Image Edit Mask tool; `birefnet.safetensors` must be placed in `ComfyUI/models/background_removal/` for BiRefNet
- **[psd-tools](https://pypi.org/project/psd-tools/)** (v0.6.0) — enables all PSD (Photoshop) features: Gallery bulk "Create PSD" export, Gallery browsing/thumbnails for `.psd` files, and Image Edit's Save PSD / Open PSD buttons; `pip install -r requirements.txt` (ships prebuilt wheels, no C compiler required); without it, PSD-related actions show an error toast with the install command instead of failing silently
---
+291
View File
@@ -0,0 +1,291 @@
# Video Editサブタブ「簡易動画編集機能」実装計画
## Context
Video タブは Plan(バッチ動画生成)/ Asset・Project(生成済み動画の一覧)まで実装済みだが、Edit サブタブは `templates/index.html:2895` の空div `#wfm-video-subtab-edit`(「Editing tools coming soon」のプレースホルダーテキストのみ)で、JSロジックは一切無い。ユーザーからは「Adobe Premiereのような簡易動画編集機能」を追加したいという要望があり、調査の結果ComfyUI Core 0.35.0〜0.36.0(2026年9月時点の最新)で `VideoSlice`/`VideoTrim`/`VideoCrop`/`ConcatenateVideo` 等のネイティブ動画編集プリミティブが追加されたばかりであることが判明した。これらを活用しつつ、wf-manager独自のタイムラインUIを被せることで、フルスクラッチでの動画処理実装を避けつつ「複数クリップの配置・トリム・結合」という編集の核となる機能を提供する。
**方針確認済み(ユーザー承認):**
- MVPスコープは最小限(タイムライン配置・トリム・結合書き出しのみ)とし、クロップ・テキストオーバーレイ・BGM合成は明確にPhase 2以降の拡張として切り離す。
- グラフ組立(トリム/クロップ/結合)はComfyUIワークフローに丸投げする方式(Plan tabの`video-workflow.js`と同じ`/prompt`実行基盤を再利用)で進める。`VideoTrim`/`VideoCrop`がexperimental扱いであることのAPI変更リスクは、Phase 0での`/object_info`検証とクラス名参照で軽減する。
実装は下記のPlanエージェント設計をベースに、MVPスコープをPhase 1(タイムライン+トリム+結合)のみに絞り込んで進める。
---
## 1. スコープ定義
### 設計原則(切り分けの判断基準)
| 種別 | 判断基準 | 実装場所 |
|---|---|---|
| **プレビュー/操作UI**(scrub再生、タイムライン上でのドラッグ、トリムハンドル、テキスト位置決めなど、ユーザーが「見ながら触る」もの) | ブラウザの`<video>`/`<canvas>`だけで完結し、即座にフィードバックが必要 | wf-manager独自JS(video-edit-tab.js) |
| **実際の書き出し処理**(トリム確定、複数クリップ結合、クロップ確定、テキスト焼き込み) | 重い処理・GPU不要・単純なメディア操作で、ComfyUI Coreの新ノード(VideoSlice/VideoTrim/VideoCrop/ConcatenateVideo)がほぼそのままカバーする | ComfyUIワークフローを動的組立して`/prompt`に投げる(Plan tabのvideo-workflow.jsパターンを踏襲) |
| **既存方針(PyAV+Pillowのみ、ffmpeg非依存)で完結できないもの**(テキスト/字幕の焼き込み、BGM音量ミックス、簡単なフェード) | ComfyUI Coreノードにも無く、かつ静止画向けtext-overlay系カスタムノードのロジックを流用できる規模 | wf-manager独自Python(video_service.py拡張、PyAV decode + Pillow ImageDraw合成 + PyAV encode) |
| **サムネイル/ファイル一覧/タグ管理** | 既存Galleryインフラで完結 | 既存流用(新規実装なし) |
### MVP(初回リリース、承認済み: 最小限スコープ)
以下の1〜4のみを初回リリース対象とする。クロップ/テキストオーバーレイ/BGM合成/プレビュー高度化は明確にPhase 2以降へ切り出す。
1. **タイムラインへのクリップ配置・並べ替え**
- Asset タブ / Gallery からドラッグ or 「Editへ送る」ボタンで動画をタイムラインに追加。
- 水平方向に複数クリップを並べたシンプルな1トラック構成(Adobe Premiereの「V1」トラック1本のみ、複数トラック無し)。
- ドラッグで順序入れ替え、削除、複製。
2. **クリップ単位のトリム(開始/終了)**
- 各クリップサムネイル上でハンドルをドラッグしてin/outを指定 → プレビューは`<video>`要素のcurrentTimeシークのみ(デコード不要、軽量)。
- 書き出し時にComfy Core `VideoSlice`("Trim Video")ノードで実処理。
3. **複数クリップの結合書き出し**
- タイムライン順に`ConcatenateVideo`ノードをAutogrowで連結し1本のVIDEO出力に。
4. **プレビューと書き出し**
- プレビューはMVPでは「各クリップを順番に`<video>`要素で連続再生する疑似プレビュー」(トリム区間のみ再生してクリップ切り替え)に留める。真の合成プレビューは行わない。
- 「書き出し」ボタン押下でComfyUIワークフロー(`VideoSlice`×N → `ConcatenateVideo`(Autogrow) → `SaveVideo`)を動的組立し`/prompt`に投げ、進捗はWebSocketで表示、完了後Galleryの`VIDEO_GROUP`に自動登録。
### Phase 2以降(MVP対象外、将来拡張として明記)
- **クリップ単位の空間クロップ**: 矩形選択UI(Image Edit Tabのキャンバス選択パターンを流用)→ 書き出し時に`VideoCrop`ノードへ座標を渡す。
- **簡易テキストオーバーレイ(クリップ単位、固定位置・フェード無し)**: テキスト内容・フォントサイズ・色・位置(9グリッドアンカー)・表示区間(開始秒-終了秒)を指定。書き出しはPyAVでフレームデコード→対象区間のフレームだけPillow ImageDraw.textで焼き込み→再エンコード(wf-manager独自Python実装。ComfyUI Coreに動画テキストオーバーレイノードは無いため)。
- **BGM/音声トラック1本の合成**: 元動画の音声をmute/keep選択 + 1本のBGM音声ファイルを全体に重ねる(音量スライダーのみ、ミキシングはPyAVのAudioResampler+単純加算 or `CreateVideo`のcomplete_audio差し替え機能で代替)。複雑なマルチトラックオーディオミキシングは対象外。
- 複数トラック(V1/V2でのピクチャーインピクチャー、オーバーレイ合成)
- クリップ間トランジション(クロスフェード等) — フレーム単位のアルファブレンドはPyAVで可能だが計算コストが高く、CPUのみだと低速。GPU処理が要るなら別途ComfyUIノード化を検討。
- 波形表示付きオーディオトラック編集
- キーフレームアニメーション(テキストの移動/フェードイン等)
- Undo/Redo履歴、複数プロジェクトの保存/読込(Video Planの`video_plan_service.py`と同様の永続化)
- リアルタイム合成プレビュー(WebCodecs APIによるブラウザ内デコード合成、または低解像度プロキシファイルを都度サーバー生成してプレビュー用に配信)
---
## 2. アーキテクチャ
> **補足(実際のサブタブ構造)**: Videoタブは単純な「Plan/Asset/Edit」3分割ではなく、中央ペインが Plan/Edit の2-way切替(`_initCenterSubtabToggle()`, `static/js/video-tab.js:37`)、サイドバーが Asset/Project の独立ペア(`_initSidebarSubtabToggle()`, 同ファイル55行目)という構成。エントリポイントは `static/js/video-tab.js:317` の `export function initVideoTab()` で、ここに `initVideoEditTab()` の呼び出しを追加する。
### フロントエンド(JS)
新規ファイル: `static/js/video-edit-tab.js`
- `class VideoEditTab`(Image Edit Tabの`class ImageEditTab`パターンを踏襲。単一グローバルインスタンスをexportする形も選択可)
- `constructor()`: タイムライン状態(`this.clips = []`、各要素は`{ sourceRef, inPoint, outPoint, cropRect, textOverlay, id }`)、選択中クリップID、DOM参照を初期化。
- `init()`: DOM生成・イベント配線のエントリポイント。`video-tab.js`の`initVideoTab()`から`initVideoEditTab()`として呼ばれる形にする。
- `_setupActionBar()`: Image Edit Tab 1385行目のアクションバー実装を参考に「クリップ追加」「書き出し」「プレビュー再生/停止」ボタン群を構築。
- `_setupTimelinePanel()`: レイヤーパネル(`_setupLayerPanel()` 2194行目)のリスト+サムネ+ドラッグ並べ替えパターンを、縦のレイヤーリストではなく横のタイムラインクリップ列に転用。
- `_setupTrimHandles()`: pointerdown/move/upベースのドラッグ操作(1130-1249行目のポインタイベント処理パターン)をトリムハンドルのドラッグに転用。
- `_setupCropOverlay()`: 同じくpointerイベントパターンをクロップ矩形選択に転用(レイヤーごとに独立canvasを持つ構造は流用しないが、矩形描画のオーバーレイcanvas1枚で足りる)。
- `_setupTextOverlayPanel()`: テキスト内容/フォント/色/アンカー/表示区間の入力フォーム。プレビューは選択中クリップの`<video>`上にCSS絶対配置したdiv要素でオーバーレイ表示(実際の焼き込みはサーバー側、プレビューは近似でよい)。
- `_buildExportWorkflow()`: タイムライン状態からComfyUIワークフローJSON(内部APIフォーマット)を動的組立。`video-workflow.js`の`injectFrameNode()`のノード注入パターン(last_node_id/last_link_id採番、links[]整合性維持)を流用し、`LoadVideo → VideoSlice → (VideoCrop) → ConcatenateVideo(Autogrow) → SaveVideo`のグラフを構築。
- `_exportTimeline()`: `comfyUI.queuePrompt()`/`comfyUI.trackProgress()`(comfyui-client.js既存メソッド、Plan tabと同じ呼び出し方)でグラフを実行し、進捗表示・完了後にGallery登録。
- `_applyTextOverlayJob()`: テキストオーバーレイがある場合のみ、結合済み動画に対して追加で`/api/wfm/video/edit/overlay-text`(新設)を呼ぶ後処理ステップ(ComfyUIグラフでは焼き込めないため、書き出しフローの最終段に独立したPython後処理を挟む二段構成)。
- 既存ファイルへの変更:
- `static/js/video-tab.js`: `initVideoEditTab()`のimportと`initVideoTab()`内呼び出しを追加。`_applyVideoI18n()`にEdit用キーを追加。
- `templates/index.html`: `#wfm-video-subtab-edit`内にタイムライン/アクションバー/クロップオーバーレイ/テキストパネル用のDOM骨格を追加(Plan/Assetサブタブの既存マークアップ構造に合わせる)。
- `static/js/i18n.js`: `videoEditPlaceholder`を削除し、新規i18nキー群(`videoEditTimeline`, `videoEditTrim`, `videoEditCrop`, `videoEditTextOverlay`, `videoEditBgm`, `videoEditExport`等、英/日/中3言語)を追加。
- `static/css/video-tab.css`(存在すれば。無ければ新規`video-edit-tab.css`): タイムラインのクリップブロック、トリムハンドル、クロップオーバーレイのスタイル。
- Asset→Edit連携用の変更:
- `static/js/video-asset-tab.js`: 詳細パネル(`_renderDetail()`)に「Editへ送る」ボタンを追加。クリック時、選択中動画の`{filename, subfolder, type}`または`{kind:"local", file}`参照を`video-edit-tab.js`のエクスポート関数(例: `addClipFromAsset(ref)`)に渡し、Editサブタブに切り替えてタイムライン末尾に追加。
### バックエンド(Python)
判断基準: **ComfyUIワークフローに丸投げできる処理(VIDEO型を保つ、GPU不要でもCPUノードとしてグラフ内で完結できる処理)は`/prompt`実行に任せ、グラフ側に存在しない処理(テキスト焼き込み、音声ミックス、詳細メタ取得)だけを独自Pythonで実装する。** 理由: ワークフロー実行に丸投げすることで実行キュー管理・WebSocket進捗通知・キャンセル(`interrupt`)・履歴(`/history`)を無料で使い回せる一方、独自Python実装は同期/非同期の進捗通知を自前で作る必要があるため、既存インフラで代替できるものは極力グラフに寄せる。
- `py/routes/video_routes.py` 追加エンドポイント:
- `POST /api/wfm/video/edit/probe`: アップロード済み/output上の動画の基本メタ(duration, fps, width, height, has_audio)をPyAVで取得。タイムラインUIがクリップ追加時に必要な長さ・解像度をComfyUIの`/prompt`実行なしで即座に得るため(`GetVideoComponents`ノードを都度実行するのは重く実行キューも消費するため避ける)。
- `POST /api/wfm/video/edit/overlay-text`: 結合済み動画1本 + テキストオーバーレイ指定リスト(区間・アンカー・文字列・色・フォントサイズ)を受け取り、PyAVでデコード→対象区間のみPillow ImageDraw合成→PyAV(av.open(mode="w"))で再エンコードしoutputへ保存。`video_service.convert_to_gif()`のデコード/エンコードパターンを流用。
- `POST /api/wfm/video/edit/mix-audio`(BGM合成が`CreateVideo`ノードのcomplete_audio差し替えだけでは足りない場合の予備、例えば音量調整付き重ね合わせが必要な時): PyAVのAudioResamplerで元音声とBGMをリサンプル→単純加算ミックス→動画に再アタッチ。
- Phase 1では上記のうち`probe`のみ必須、`overlay-text`はテキストオーバーレイ機能実装時に追加、`mix-audio`は`CreateVideo`の`complete_audio`で足りるなら不要(後述リスク参照)。
- `py/services/video_service.py` 追加メソッド:
- `probe_video(path) -> dict`: `av.open()`でstreams[0]の`duration`, `average_rate`, `width`, `height`、`streams.audio`の有無を返す。
- `overlay_text_on_video(src_path, overlays, fps=None) -> dict`: 既存`convert_to_gif`と同じ`_resolve_media_path`を使った安全なパス解決 → フレームループでtがoverlayの区間に該当する時だけPillowで文字を描画 → `av.open(dst, mode="w")`で同じcodec/fpsで書き出し。既存クラスの`_resolve_media_path()`を再利用。
- `mix_audio(...)`: 必要になった場合のみ追加。
- ワークフロー動的組立は**フロントエンドJS側**(`_buildExportWorkflow()`)で行い、バックエンドは実行そのものに関与しない(Plan tabと同じ役割分担: `video-workflow.js`はJSでグラフJSONを操作し、`comfyUI.queuePrompt()`で`/prompt`に投げるのみ)。バックエンドに「ワークフロー組立API」を新設する必要は無い。
### 判断基準まとめ(再掲)
- VIDEO型のまま完結する操作(トリム/クロップ/結合/保存) → ComfyUIグラフ(フロントJSで組立、`/prompt`実行)
- VIDEO型を抜けてピクセル単位の追加合成が要る操作(文字焼き込み、音声ミックス) → wf-manager独自Python(PyAV+Pillow)
- 操作中のインタラクティブ操作(scrub、トリムハンドルのドラッグ、矩形選択) → ブラウザJSのみ、サーバー往復なし
---
## 3. 既存資産の再利用ポイント(具体的な参照箇所)
| 転用元 | 参照箇所 | 転用先 |
|---|---|---|
| Image Edit Tab アクションバー | `static/js/image-edit-tab.js:1385` `_setupActionBar()` | video-edit-tab.jsのツールバー(クリップ追加/書き出し/再生ボタン) |
| Image Edit Tab レイヤーパネル | `static/js/image-edit-tab.js:2194` `_setupLayerPanel()`(リスト/サムネ/透明度スライダー) | タイムラインのクリップリストUI(サムネ表示・並べ替え・削除) |
| Image Edit Tab pointerイベント | `static/js/image-edit-tab.js:1130-1249` | トリムハンドルドラッグ、クロップ矩形選択のドラッグ操作 |
| Image Edit Tab レイヤー合成構造 | `static/js/image-edit-tab.js:2035,2067,2081` | (参考程度)テキストオーバーレイのプレビュー用オーバーレイdiv重畳の考え方 |
| Gallery mp4サムネ/プレビュー | `static/js/gallery-tab.js:63` `isVideoFile()`、`972-985,1750-1766` `<video controls>` | クリップサムネイル生成、プレビューエリアの`<video>`要素の扱い |
| Gallery mp4サーバー側サムネ | `py/services/gallery_metadata.py:1349-1364` `serve_thumbnail`(PyAVで先頭フレームJPEG化) | クリップ追加時のサムネイル取得APIとして直接再利用可能(新規実装不要、`/wfm/gallery/image/thumb`をそのまま叩く) |
| Gallery mp4メタ | `py/services/gallery_metadata.py:766` `_read_mp4_metadata()` | `probe_video()`実装の参考(既存関数を直接呼ぶかロジック共有できないか要確認) |
| video-workflow.js ノード検出/注入パターン | `static/js/video-workflow.js` `locateVideoModelNodes()`, `injectFrameNode()`(last_node_id/last_link_id採番、links[]整合性) | `_buildExportWorkflow()`でVideoSlice/VideoCrop/ConcatenateVideoノードを動的追加する際のID採番・リンク整合性ロジックをそのまま流用 |
| comfyui-client.js 実行基盤 | `static/js/comfyui-client.js:196` `queuePrompt()`, `217` `trackProgress()`, `312` `generate()` | 書き出し実行・進捗表示(新規実装不要) |
| Video Asset Galleryグループ | `static/js/video-asset-tab.js` の`VIDEO_GROUP`/`VTEMP_GROUP`活用パターン | 書き出し完了後の動画を`VIDEO_GROUP`へ自動登録する処理の参考 |
| video_service.py デコード/エンコードパターン | `py/services/video_service.py:60` `convert_to_gif()`(PyAV decode→Pillow処理→再エンコード、`_resolve_media_path`によるパストラバーサル対策) | `overlay_text_on_video()`実装のテンプレートとしてほぼそのまま流用 |
---
## 3.5. 外部カスタムノードの参考実装(追加調査、ユーザー指定4件)
Video Edit実装の設計判断を補強するため、既に「フルスクリーンタイムラインエディタ」を実装している既存カスタムノードを調査した。**これらをそのまま依存として組み込むのではなく、UI/UX設計とノード分割方針の参考にする**(wf-managerはComfyUI Coreの`VideoSlice`/`ConcatenateVideo`丸投げ方針を維持するため、方式は異なる)。
| リポジトリ | 関連度 | 参考にすべき点 |
|---|---|---|
| [SonderSaid/ComfyUI-Sonder-Editor](https://github.com/SonderSaid/ComfyUI-Sonder-Editor) | **高** | マルチレーン(Video/Audio/Prompt/Guide/Driverレーン)タイムラインUI、クリップのドラッグ/トリム/分割/ミュート、レーンのロック/非表示など、Premiereライクな編集UIの完成度が高い実装例。ただし**FFmpeg 7.0以上を必須依存**としており、wf-managerの「ffmpeg非依存(PyAV+Pillowのみ)」方針とは真逆。UIレイアウト(左サイドバー=ギャラリー、中央=ビューポート+トランスポート、下部=マルチレーンタイムライン)は`video-edit-tab.js`のDOM構成の参考にする価値が高いが、実装(FFmpeg CLI呼び出し)はそのまま流用しない。 |
| [shootthesound/ComfyUI-H3Studio](https://github.com/shootthesound/ComfyUI-H3Studio) | **高** | MiniMax H3特化の統合編集ツール。単一ノードから「⤢ open timeline editor」ボタンでフルスクリーンタイムラインを起動する導線、クリップのトリム/クロスフェード/音声ミックスをまとめた「リール」書き出し機能、フィルムストリップ表示・波形表示が参考になる。**「追加のPythonライブラリ不要」と明記**されており、wf-managerの依存最小化方針と親和性が高い(実装詳細は非公開のため、"ノードのカスタムウィジェットからフルスクリーンモーダルを開く"というUIパターンのみ参考にする)。 |
| [domg73/ComfyUI-LoadVideoCrop](https://github.com/domg73/ComfyUI-LoadVideoCrop) | **中(Phase 2クロップ機能に直結)** | 公式`LoadVideo`を拡張し、動画プレビュー上でWYSIWYGにクロップ矩形を描画できる`Load Video Crop`ノード。アスペクト比ロック(1:1/2:3/3:2/3:4/4:3/9:16/16:9/21:9/Free)、`start_time`/`duration`/`strict_duration`によるロード時トリムも兼備。**「追加依存ライブラリ不要」**と明記。Phase 2の`_setupCropOverlay()`実装時、このノードの隠し入力設計(`crop_x/crop_y/crop_w/crop_h`を0..1正規化値で渡す)をComfyUI Core `VideoCrop`ノードとのパラメータ形式比較の参考にする。ノード自体を依存に追加するかはPhase 0で`VideoCrop`(Core)とどちらが安定・高機能か比較検討する。 |
| [astropuzzo/ComfyUI-MiniMax-H3-Image-Studio](https://github.com/astropuzzo/ComfyUI-MiniMax-H3-Image-Studio) | **低** | MiniMax H3モデルを使った**静止画**のT2I/I2I/参照編集ツールで、動画のタイムライン編集や結合とは無関係(対象読者はH3の画像生成ワークフロー利用者)。Video Edit実装への直接的な参考価値は無いため、調査対象から除外し将来のGenerateUI/画像生成系機能検討時の参考候補としてのみ記録する。 |
**設計への反映:**
- `_setupTimelinePanel()`(video-edit-tab.js)のDOM構成は、Sonder Editor/H3Studioのレイアウト(サイドバー=クリップ一覧、中央=プレビュー+トランスポート、下部=タイムライン)を踏襲する。ただし将来のマルチレーン拡張(Phase 2以降のBGMトラック等)を見越し、MVPの単一トラックでも「レーン」という概念でデータ構造を設計しておく(`this.clips`を`this.lanes = [{type:"video", clips:[...]}]`のような形にしておくと将来拡張が容易)。
- Phase 2のクロップUIは、LoadVideoCropの「正規化座標(0..1)でのクロップ矩形」という設計をそのまま踏襲し、ComfyUI Core `VideoCrop`ノードの実際のINPUT_TYPES(Phase 0で`/object_info`確認)と突き合わせて座標系を合わせる。
- H3Studioの「ノードのカスタムウィジェットからフルスクリーンモーダルを開く」という導線は、wf-managerでは既にVideo Editが独立サブタブとして存在するため直接は不要だが、将来「ワークフローグラフ上のノードからEditタブへジャンプする」ショートカットを追加する際の参考にする。
---
## 4. 段階的な実装ステップ(Phase分け)
### Phase 0: 下調査・技術検証(実装前必須)— **完了(2026-09-16、ComfyUI_5実機・ポート8189で検証済み)**
**確定事項(`_buildExportWorkflow()`実装時はこの仕様に厳密に従うこと):**
1. **【2026-09-16 訂正】`VideoSlice`は「クラス名にスペースが入る」ため`/object_info/VideoSlice`が空に見えていただけで、実際には`"Video Slice"`(スペース込み)という正式なclass_typeで存在する。** ソース(`comfy_extras/nodes_video.py:448`)の`node_id="Video Slice"`を確認して判明。**トリムはこちらを使う** — `video`/`start_time`(FLOAT)/`duration`(FLOAT, 0で無制限)/`strict_duration`(BOOLEAN)というフラットな入力のみで、`VIDEO_EDIT`型のネスト構造が一切無く、`experimental`でもない。実機で`start_time=2.0, duration=3.0`を指定し、出力が実際に3.0秒になることをPyAV probeで確認済み(**当初の`VideoTrim`検証は`execution_success`だけを見て「動いた」と誤判定していた——後述の訂正参照**)。
2. **【訂正の経緯・重要な教訓】`VideoTrim`の`trim`入力(`VIDEO_EDIT`型)に一見素直なフラット値`{"start_time":.., "duration":..}`を渡すと、`node_errors`無しで`execution_success`するが、実際には一切トリムされず元動画がそのまま出力される(サイレント無視)。** 原因はソース(`comfy_extras/nodes_video.py:524`)の`execute()`が`(trim or {}).get("trim")`と一段余計にネストを剥がしてから`apply_video_trim()`に渡す実装になっており、`apply_video_trim()`は`trim=None`のとき`start_time=0.0, duration=0.0`とみなして**無条件に元動画をそのまま返す**(`comfy_extras/nodes_video.py:417-424`)ため。正しく`VideoTrim`を使うならフラットではなく**二重に入れ子**にした`{"trim": {"start_time": 0.0, "duration": 1.5}}`が必要。ただし本実装ではより単純な`Video Slice`を採用したため、`VideoTrim`は不使用。**教訓: `execution_success`は「グラフの型検証を通った」ことしか意味せず、パラメータが実際に意図通り効いたかは出力を実際にprobeして確認しない限り分からない。** 以後の実機検証では必ず出力の実測値まで確認すること。
3. **`VideoCrop`の`crop`入力も`VideoTrim`と同じ二重ネスト`.get("crop")`パターン(`comfy_extras/nodes_video.py:555`)。** Phase 2で採用する場合は`{"crop": {"x":0,"y":0,"width":W,"height":H}}`のように二重に入れ子にする必要がある(`VideoCrop`はスペース無しの`"VideoCrop"`のままで、`Video Slice`のような別名は無い)。Phase 2着手時に必ず出力を実測して再確認する。
4. **`ConcatenateVideo`の`videos`(`COMFY_AUTOGROW_V3`)は、ネストしたJSONオブジェクトではなく、ドット区切りの単一文字列キーをinputsのトップレベルに並べる。** これが最大のハマりどころで、`{"videos": {"video0": [...]}}` 等の直感的なネスト表現は**すべて`required_input_missing`で弾かれる**。正しい形式:
```json
"inputs": {
"videos.video0": ["<node_id>", 0],
"videos.video1": ["<node_id>", 0],
"codec": "auto"
}
```
(0始まり、`prefix + index`を単純結合した文字列がそのままキー名。ComfyUI Core `comfy_api/latest/_io.py`の`Autogrow.TemplatePrefix`/`finalize_prefix()`のドット結合ロジックに由来)。実機で2クリップ結合の`execution_success`を確認済み。
5. **`ConcatenateVideo`は解像度不一致で実行時ハードエラーになる。** 実機で960x540と1024x576の2クリップを結合させたところ`ValueError: Accumulated videos have incompatible frame dimensions`で失敗(`comfy_extras/nodes_video.py:178`)。事前チェック無しでの結合は失敗するため、**Phase 1のタイムラインUI側で解像度不一致クリップの警告表示・結合前チェックを必須実装**とする(リスク節で「推奨」としていたものを「必須」に格上げ)。
6. 動画アップロードは標準の`/upload/image`エンドポイント(`OPTIONS`で200確認済み)をそのまま使う想定(`LoadVideo`の`file`ウィジェットが`video_upload: true`を持ち、Core LoadVideo/VHS双方がこのエンドポイントを動画にも流用する既知の挙動)。Phase 1実装時に実際のアップロード→`LoadVideo`参照までを通しで確認する。
7. `LoadVideo`の`file`はCOMBO(inputフォルダ内動画ファイル名の列挙)。Asset/GalleryからEditタブへ渡す動画がComfyUI input配下に無い場合(Gallery出力やVTEMP_GROUP由来)は、書き出し前に`/upload/image`でinputへコピーしてからファイル名を`LoadVideo.file`に渡す必要がある。
### Phase 1: MVP基盤(タイムライン表示・単純トリム結合書き出しのみ)
- 新規: `static/js/video-edit-tab.js`(クラス骨格、タイムラインリスト、クリップ追加/削除/並べ替え)
- 変更: `templates/index.html`(Edit subtab DOM骨格)
- 変更: `static/js/video-tab.js`(init呼び出し追加)
- 変更: `static/js/i18n.js`(新規キー)
- 新規API: `py/routes/video_routes.py`に`/api/wfm/video/edit/probe`追加
- 変更: `py/services/video_service.py`に`probe_video()`追加
- 変更: `static/js/video-asset-tab.js`(「Editへ送る」ボタン)
- 実装内容: クリップ追加→トリムハンドルUI→書き出し(VideoSlice+ConcatenateVideo+SaveVideoのグラフ組立て`/prompt`実行)まで通す。
### Phase 2: クロップ機能
- video-edit-tab.jsに`_setupCropOverlay()`追加
- `_buildExportWorkflow()`を拡張し`VideoCrop`ノードを挿入
### Phase 3: テキストオーバーレイ
- video-edit-tab.jsに`_setupTextOverlayPanel()`追加
- 新規API: `/api/wfm/video/edit/overlay-text`
- `video_service.py`に`overlay_text_on_video()`追加
- 書き出しフローを「グラフ実行→結合済みファイル取得→overlay-text後処理呼び出し」の2段構成に変更
### Phase 4: BGM/音声合成
- `CreateVideo`ノードのcomplete_audio機能で足りるか検証した上で、足りなければ`mix-audio` API追加
- video-edit-tab.jsにBGMアップロード/音量UI追加
### Phase 5: 仕上げ・永続化(任意)
- タイムライン状態の保存/読込(`video_plan_service.py`と同様のJSON永続化を検討、`VideoEditProjectService`として新設するか判断)
- Undo/Redo(将来拡張スコープだが、Phase 5で簡易版のみ着手する場合はここ)
---
## 5. リスク・技術的懸念点
1. **VideoTrim/VideoCropのexperimental扱いリスク**
- ComfyUI Core側で今後のマイナーバージョンでノード名・入出力仕様が変更される可能性がある。`io.VideoEdit`ウィジェット型はフロントエンドのインタラクティブUI前提の設計であり、wf-managerは独自UIから直接パラメータをJSON投入する形になるため、公式フロントエンドUIの挙動と乖離があっても気づきにくい。
- 対策: 表示名ではなくノードのクラス名で参照する。最終的にトリムは`experimental`でも`VIDEO_EDIT`ネストでもない`"Video Slice"`(スペース込みのclass_type、`node_id="Video Slice"`)を採用したため、この項目のリスクは実質解消した。Phase 2で`VideoCrop`(こちらは`experimental`かつ`VIDEO_EDIT`の二重ネスト、代替ノード無し)を使う際は本リスクが残るため、必ず出力を実測確認する。
- CLAUDE.mdの「ワークフローJSON整合性ルール」(last_node_id/last_link_id、links[]の3箇所整合)を`_buildExportWorkflow()`実装時に厳守する。
2. **ffmpeg非依存方針の機能的限界**
- トランジション(クロスフェード等)やアルファブレンド合成はComfyUI Coreノードに無く、PyAVで自前実装するとフレーム単位のデコード→NumPy/Pillow合成→再エンコードとなり、CPU処理でかなり低速になる(特に長尺・高解像度動画)。MVPではトランジション無しとし、将来拡張でも「対応するなら低解像度プレビュー限定」等のスコープ限定を検討すべき。
- コーデック非互換なクリップ同士の結合は`ConcatenateVideo`が自動的に一度デコードしてから再結合するため、異なる解像度/フレームレートのクリップを混在させると処理コストが跳ね上がる可能性がある。タイムラインUI側で「解像度/fps不一致クリップ」を警告表示する簡易チェックをPhase 1に含めることを推奨。
- テキストオーバーレイの再エンコード(Phase 3)は全フレームを一度デコード・Pillow処理・再エンコードするため、長尺動画では書き出しに時間がかかる。プログレス表示(Frame N/Total等)をAPIレスポンスではなくポーリング or 簡易WebSocket通知で出す設計を検討(現状の`convert_to_gif`は同期一括処理でプログレス無し、これをそのまま踏襲すると長尺でUIが固まって見える点に注意)。
3. **既存Video Plan/Assetタブとのデータ連携**
- AssetタブからEditタブへの動画受け渡しは、Asset側が持つ参照形式(Galleryの絶対パス`img.path`)とEdit側のタイムラインが必要とする形式(ComfyUIの`{filename, subfolder, type}`、またはローカルFileオブジェクト)の変換が必要。`video-asset-tab.js`の`_loadIntoSourcePreview()`が既にこの変換(Blob取得→File化→`kind:"local"`)を行っているので、同じパターンをEditタブのクリップ追加処理でも使う。ただし書き出しグラフの`LoadVideo`ノードはComfyUI input/output/temp配下のファイルを期待するため、ローカルFileの場合は動画アップロードAPIを経由してから`LoadVideo`に渡す必要がある(Phase 0の技術検証項目)。
- Video Planタブが生成した動画は`VTEMP_GROUP`に入るため、Editタブの「クリップ追加」ソースとして「Video Plan実行結果」も選択できるようにする導線(Assetタブ経由で十分か、Editタブ内に直接「最近の生成結果」ショートカットを設けるか)はUX判断が必要。
- タイムライン編集結果を保存/読込する永続化機能(Phase 5想定)を作る場合、`video_plan_service.py`のディレクトリ構成・ファイル命名規則を踏襲し、別サービスクラス(`VideoEditProjectService`)として分離するか、既存`VideoPlanService`を拡張するかの設計判断が必要(データモデルが「バッチ生成の入力」と「編集後のタイムライン状態」で意味的に異なるため、別クラス推奨)。
4. **並行実行時のリソース競合**
- Edit書き出しはPlan tabのバッチ生成と同じ`/prompt`キューを使うため、Plan実行中にEdit書き出しを投げると同じキューに並ぶ。ユーザーへの「実行中」表示や二重実行防止のUI制御をPlan tab側の既存パターン(生成中はボタンdisable等)に倣って実装する。
5. **開発・デプロイ運用(CLAUDE.md既存ルール)**
- 開発元リポジトリ(`c:\Users\statsu-11\Desktop\now_work\comfyUI-wf-maneger\ComfyUI-Workflow-Studio`)と実行時`custom_nodes`(`...\ComfyUI_5\custom_nodes\comfyui-workflow-studio`)は別実体。実機確認のたびに同期スクリプトでの全体反映が必要(部分同期は原因不明のエラーの元)。
- `_buildExportWorkflow()`実装時はワークフローJSON整合性ルール(`last_node_id`/`last_link_id`が最大値以上、`links[]`とノード両端の`links`/`link`の3箇所整合)を厳守する。
- Python側変更(`video_service.py`, `video_routes.py`)反映にはComfyUI完全再起動が必須(`py_compile`キャッシュではなくインポート自体が起動時一度きりのため)。
---
## 6. UI再設計(2026-09-16、ユーザー指示によりPlanタブ寄りに変更)
初回MVP実装(縦リスト+各行ボタン方式)を、以下のとおりPlan subtabのUIパターンに揃える形で再設計・実機確認済み。
- **タイムライン**: 縦リスト(`wfm-video-edit-clip-list`)から、Planタブと同じ横トラック構造(`wfm-video-edit-timeline-track`)へ変更。ただしPlanのブロックは`flex-grow`でトラック幅いっぱいに引き伸ばされるのに対し、Editのブロックは実秒数×固定px/秒(20px/秒、最小56px)の幅を持ち**左詰め**で並ぶ(空きトラックはそのまま空く)。
- **並べ替えの共有化**: 各クリップ行が持っていた▲▼⧉✕ボタンを廃止し、タイムライン直下の共有ツールバー(◀ 左へ移動 / ▶ 右へ移動 / 複製 / 削除 / クリア)に統合。Planタブの「+ Split / + Block / Delete」ツールバーと同じ「選択中の対象に対して働く共通ボタン」方式。
- **ドラッグ並べ替え**: ネイティブHTML5 D&Dでブロック同士のドラッグ&ドロップによる並べ替えにも対応(ボタンと併用可)。`_reorderByDrop()`は「削除→対象の新インデックスを探索→挿入」の順で行い、素朴な二段splice実装にありがちなオフバイワンを回避している。
- **Clearボタン新設**: タイムライン全体をクリアする専用ボタン(`videoEditConfirmClear`で確認ダイアログ表示)。
- **上部「動画ソース」パネルとの連携**: 自動連携ではなく、Video Sourceパネルに明示的な「Editに追加」ボタン(`#wfm-video-source-add-to-edit`)を新設。Frame/GIF目的の単発動画ドロップでEditタイムラインが意図せず汚れないよう、ユーザーが選択・確認済み。ローカルFile/サーバー参照(`kind:"local"`/`"input"`/`"output"`)の両方に対応し、クリックでEditサブタブへ自動切替。
- Frame抽出・GIF化(右ペイン、単独動画操作)とEdit(タイムライン編集・結合、複数クリップ操作)の役割分担は従来通り変更なし——ユーザーからの確認事項としてこの分離を維持している。
実機(ComfyUI_5・ポート8189、Kapture)で以下を確認済み: 左詰めタイムライン描画、Asset選択→「Editに追加」経路、2クリップの◀移動での順序入れ替え、複製、削除、クリア(確認ダイアログのi18n適用含む)、クリア後の単一クリップ書き出し(22.13秒で正常出力)。
## 7. レイアウト修正(2026-09-16、追加指示)
UI再設計直後、実機で「空のタイムライン/書き出しパネルが中央に縮んで表示され、Planタブのように横幅いっぱい・右端固定にならない」という不具合をユーザーが発見。原因はCSSのバグで、修正内容は以下の3点。
1. **Editタブ自身のドロップゾーンを削除**: `#wfm-video-edit-drop-zone`をtemplates/index.htmlから削除し、`video-edit-tab.js`の`_wireAddClipDropZone()`も削除。クリップ追加は Asset タブの「Editへ送る」ボタンと、Video Sourceパネルの「Editに追加」ボタン(第4節参照)の2経路に一本化。
2. **【根本原因】`static/css/video-tab.css`に旧プレースホルダー時代の重複`.wfm-video-edit-panel`ルールが残存していた。** Edit サブタブが「Editing tools coming soon」という1行プレースホルダーだった頃の`display:flex; align-items:center; justify-content:center; border:1px dashed ...`というルール(中央に1行だけ表示するための定義)が、実装を追加した後も削除されておらず、CSSカスケード順(後勝ち)で新しい`.wfm-video-edit-panel { padding: 0 16px 16px; }`の直後に来て`align-items:center`等を上書きし続けていた。これによりタイムライン・トリムパネル・書き出しパネルの全てが横方向に縮んで中央寄せされていた。該当ルールを完全に削除して解消。
3. `.wfm-video-edit-timeline-track`に`width:100%; box-sizing:border-box; flex:none;`を明示し、クリップの有無に関わらずトラック自体がPlanの`.wfm-video-timeline-track`と同様に横幅いっぱい・高さ固定のバーであり続けるようにした(今回のバグの根本原因はCSSの重複ルールだったが、将来の再発防止として明示指定を追加)。
修正後、実機で「空のタイムラインが横幅いっぱいに固定表示される」「クリップ追加後もトラックがフル幅を保ち、クリップは左詰め」「書き出しパネルがPlanのRun/Planパネルと同じ右端固定位置に表示される」ことをスクリーンショットで確認済み。
## 8. トリムパネル・ツールバーの細部調整(2026-09-16、追加指示)
- **開始/終了(秒)入力欄+「現在位置を使用」ボタン**: 従来は横並び(`display:flex`)で、ボタンのテキストが枠からはみ出しコンテナ幅を超えていた。入力欄とボタンを縦積み(`.wfm-video-edit-trim-field { flex-direction:column }`)にし、`.wfm-video-edit-trim-row`のグリッド列幅を`minmax(0,160px)`に縮小。ボタンは`.wfm-video-edit-playhead-btn`(font-size:10px、padding:2px 6px)で一回り小さくし、入力欄との見分けを明確化。
- **タイムライン総合時間の表示**: ツールバーのClearボタン左隣に、全クリップのトリム後長さ合計を表示する`#wfm-video-edit-total-duration`(`合計: 22.1s`のような表示)を追加。`_updateTotalDuration()`が`_updateToolbarState()`(タイムライン再描画のたびに呼ばれる)から自動更新される。
## 9. タイムライン連続プレビュー(2026-09-16、追加指示)
「タイムラインの動画を上部の『生成された動画』プレビューで表示したい。このプレビューの動画=書き出しされる動画としたい」という要望に対応。新規に`<video>`要素を追加するのではなく、Exportの結果が最終的に書き出される**同じ「Result」プレビュー枠**(`#wfm-video-preview-video`、`video-preview.js`の`setResultPreview()`が使う枠)を共有し、タイムライン上の全クリップ(トリム区間反映済み)を順番に連続再生する「疑似合成プレビュー」を実装した。当初計画のMVP項目4「各クリップを順番に`<video>`要素で連続再生する疑似プレビュー」を正式に実装したものにあたる。
- **UI**: タイムラインツールバーに「▶ プレビュー / ■ 停止」トグルボタンを追加(Delete と 合計時間表示の間)。クリップが0件のときは無効化。
- **実装**(`video-edit-tab.js`): `_startPreview()`が`serverRef`ありかつエラー無しのクリップを`_previewClips`として捕捉し先頭から`setResultPreview()`で読み込み・`trimStart`へシーク・再生。`timeupdate`イベントで`currentTime >= trimEnd`を検知した時点、または`ended`イベントで次クリップへ自動遷移(`_advancePreview()`)。全クリップ終了で自動停止。
- `video-preview.js`に`getResultPreviewVideoElement()`を新規export(Resultペインの`<video>`要素へ直接アクセスし、`timeupdate`/`ended`購読や`currentTime`制御を行うため。`setResultPreview()`自体はsrc差し替えのみで再生制御はできないため)。
- クリップ削除・クリア・書き出し開始時には`_stopPreview()`を呼び、再生中の疑似プレビューを確実に停止する(書き出し完了後は同じ枠に実際の書き出し結果が上書き表示される——「プレビューの動画=書き出しされる動画」という要望通り、同一枠が編集中プレビューと最終結果の両方を担う)。
実機で2クリップ(22.1s+19.1s)の連続プレビュー再生→クリップ境界での自動切替→停止→書き出し(結合後41.2s)→Resultペインへの結果反映、という一連の流れを確認済み。
## 10. 静止画/アニメーション画像クリップ対応(2026-09-16、追加指示)
「Assetの画像(静止画)を動画ソースでプレビュー、Editに追加可能にしたい。静止画、アニメーション画像をタイムラインに追加時間を設定できるようにしたい」という要望に対応。既存のAsset一覧(`__Video Assets__`/`__Video Temp__`グループ、ユーザー選択によりこの2グループのみを対象、Gallery全体には拡張しない)には元々ビデオ専用フィルタが無く、手動でタグ付けされた画像もそのまま一覧に出ていたが、プレビューが常に`<video>`要素前提だったため画像では何も表示されず、Editに追加しても動画として扱われ破綻していた。
**設計判断(ユーザー承認事項):**
- 静止画/アニメーション画像は区別せず、どちらも「表示時間(秒)」を指定するhold型クリップとして統一的に扱う。
- 画像クリップの解像度が他の動画クリップと不一致の場合は、`ImageScale`ノード(`crop="center"`)で自動的に動画側の解像度へフィット(ブロックしない)。
**実装:**
- `video-preview.js`: Source/Resultの両プレビュー枠に`<img>`コンパニオン要素を追加し、`setSourcePreview()`/`setResultPreview()`に`mediaType`("video"|"image")引数を追加。`getActivePreviewVideoElement()`は画像表示中は`null`を返す(Frame/GIFツールの誤動作防止)。
- `gallery-tab.js`: `isVideoFile()`をexport。
- `video-asset-tab.js`/`video-tab.js`: プレビュー読み込み・「Editへ送る」/「Editに追加」の各経路で`isVideoFile()`により`mediaType`を判定して渡すよう修正。Video Sourceドロップゾーンも`image/*`を受け付けるよう拡張。
- `video-edit-tab.js`: クリップに`kind:"video"|"image"`を追加。画像クリップは`file.type`から自動判定(`addClipFromFile()`)、サーバーへアップロード後、寸法はPyAV probeではなくブラウザの`Image()`で読み取り(`_readImageDimensions()`、PyAVは任意の静止画形式を安定して開けないため)。トリムパネルはStart/Endペアの代わりに単一の「表示時間(秒)」入力に分岐。タイムラインブロックには🖼/🎬の種別アイコンを付与。解像度不一致ガード(`_findResolutionMismatch`)は`kind==="video"`同士のみ比較するよう変更(画像は自動フィットで解決するため対象外)。
- **書き出しグラフ(画像クリップ)**: `LoadImage` → (解像度不一致時のみ)`ImageScale(crop=center)` → `RepeatImageBatch(amount = 表示秒数 × 24fps)` → `CreateVideo(fps=24, codec="auto")`。実機で48フレーム/24fps→1.998秒の正確な動画生成を確認済み。
- **【追加発見・修正】音声トラック不整合によるConcatenateVideo失敗**: 動画クリップ(音声あり、例: 32kHz stereo)と画像由来クリップ(音声なし)を結合すると`ConcatenateVideo`が`audio layout: expected None, got 'stereo'`で失敗することを実機で発見。対策として、**2クリップ以上を結合する場合のみ**、動画クリップも`GetVideoComponents`→`CreateVideo`(audio未指定)で無音再構成してから結合するよう統一。単一クリップの書き出し(結合が発生しない)は従来通り音声を保持する。**この結果、複数クリップを結合した書き出しは音声を持たないという制約がMVPの既知の限界として残る**(Phase 2以降で音声トラックの取り扱いを検討する余地あり)。
実機で以下を確認済み: 静止画の`<img>`プレビュー表示、Editへの追加(🖼アイコン・表示時間入力)、単独画像クリップの書き出し(2.998秒の正確な動画化)、動画クリップ+画像クリップ混在時の自動解像度フィット・音声除去による結合成功(5.996秒)。
---
### Critical Files for Implementation
- static/js/video-edit-tab.js(新規、中心となるクラス実装)
- templates/index.html(Edit subtab DOM骨格、2895行目付近を拡張)
- static/js/video-workflow.js(ノード注入・ID採番パターンの流用元)
- py/services/video_service.py(probe_video/overlay_text_on_video追加)
- py/routes/video_routes.py(新規APIエンドポイント追加)
- static/js/image-edit-tab.js(アクションバー・レイヤーパネル・pointerイベントパターンの流用元、1385行目・2194行目・1130-1249行目)
- static/js/video-asset-tab.js(Asset→Edit連携ボタン追加)
+183 -1
View File
@@ -1 +1,183 @@
{"0": "models-tab.js", "1": "prompt-tab.js", "2": "models_routes.py", "3": "generate-tab.js", "4": "lab-tab.js", "5": "gallery_routes.py", "6": "gallery-tab.js", "7": "ImageEditTab", "8": "ai-tab.js", "10": "feeder-tab.js", "11": "NodesService", "12": "settings_routes.py", "13": "metadata-tab.js", "14": "node_sets_menu.js", "15": "GalleryService", "16": "workflow-tab.js", "17": "tagger_routes.py", "18": "WildcardService", "19": "t", "20": "renderContent", "21": "comfyui-editor.js", "23": "TaggerService", "24": "top_menu_extension.js", "25": "settings-tab.js", "26": "setupAiHandlers", "27": "PromptsService", "28": "workflow_routes.py", "29": "GalleryMetadataStore", "30": "WorkflowService", "31": "lab_routes.py", "32": "SkillService", "33": "LayerManager", "34": "SelectTool", "35": "CivitaiService", "36": "DrawTool", "37": "MaskTool", "39": "gallery_service.py", "41": "image-prompt-tab.js", "42": "KSampler Node", "44": "style-catalog-tab.js", "45": "add", "46": "comfyui-workflow.js", "47": "BlurTool", "48": "MaskShapeTool", "49": "MaskVectorTool", "50": "ShapeTool", "51": "gmic_routes.py", "52": "ollama_routes.py", "53": "TextTool", "54": "analyze_workflow", "55": "MaskTextTool", "56": "i18n.js", "57": ".list_images", "58": "MaskAlphaTool", "59": "MaskColorTool", "60": "gallery_feeder_extension.js", "61": "createPanel", "62": "util.js", "63": "BgRemove", "65": "WFS_GalleryFeeder", "66": "app.js", "67": "InpaintI2IActions", "68": "Sam3Segmentation", "69": "fromWorkflow", "70": "_extractPromptsAPI", "71": "generate_doc_index.py", "72": "WS Inpaint Basic Workflow", "73": "._bg_index_folder", "74": "SettingsService", "75": "import_style_prompt_seed.py", "76": "Image Edit (FireRed Image Edit 1.1) node", "77": "Version 0.3.9", "78": "DWPose Image Feeder Workflow", "79": "civitai_service.py", "81": "WFS_PromptText", "82": "workflow_service.py", "84": "config.py", "85": "Tagger Tab requirements.txt", "88": "Chinese Language Support", "89": "Version 0.3.95", "97": "Lab Subtab", "100": "prestartup_script.py", "101": ".get_image_prompt_root", "102": ".get_style_catalog_root", "103": ".start_background_index", "104": ".update_workflows_dir", "105": "Version 0.4.2", "106": "Workflow Studio Banner", "107": "Workflow Studio Icon", "108": "BiRefNet Model", "110": "SDXL 2D Pose Editor I2I Workflow", "111": "ComfyUI Manager", "112": "Tagger Tab Screenshot (WD Tagger/DeepDanbooru)", "113": "Models Tab UI Screenshot", "114": "Workflow Studio Topbar Icon Strip", "115": "GenerateUI LoRA Stack Tab Screenshot", "116": "Workflow Studio Favicon Icon", "117": "2D Pose Editor to Image Edit (FireRed) Workflow", "118": "3D Pose Editor to Image Edit (Flux.2 Klein) Workflow", "119": "SDXL DWPose ControlNet Workflow", "120": "SDXL From Metadata T2I Workflow", "121": "SDXL Img2Img + FaceDetailer Workflow", "122": "SDXL Image Feeder Img2Img Workflow", "123": "SDXL T2I + FaceDetailer Workflow", "124": "GenerateUI Batch Tab Screenshot", "125": "Multiple Select Menu Screenshot", "126": "Image Edit Tab Screenshot", "127": "Workflow Tab Screenshot", "128": "Prompt Tab Input Assistance Screenshot", "129": "GenerateUI Feeder Tab Screenshot", "130": "Workflow Studio Library Panel (Lora Info View)", "131": "Library Panel I Tab (Prompts) Screenshot", "132": "Settings Tab Screenshot (Language, Theme)", "133": "ComfyUI Workflow Studio Thumbnail", "135": "Feeder Subtab", "137": "Help & Support Tab", "140": "Metadata Tab", "144": "comfyui-workflow-studio", "146": "py/__init__.py", "147": "nodes/__init__.py", "148": "routes/__init__.py", "149": "services/__init__.py", "150": "python-dotenv", "155": "SD1.5 Basic Text-to-Image Workflow", "156": "SDXL Text-to-Image Basic Workflow Screenshot", "9": "Backend API Routes", "22": "External Plugin Ecosystem", "38": "Registry Publish & Docs", "40": "Generate & Export Utilities", "43": "ComfyUI Client & Mask Bridge", "64": "Workflow Analyzer Internals", "80": "Doc Index Automation", "83": "Project Directory Layout", "86": "Data Storage Files", "87": "AI Tool Version History", "90": "Windows Long Path Handling", "91": "Route Registration", "92": "Caching & Unique IDs", "93": "Service Layer", "94": "Lazy Input Evaluation", "95": "HuggingFace Config", "96": "Node Cache Invalidation", "98": "Mask Editor One Release", "99": "PowerShell Encoding", "109": "Chinese Locale", "134": "English Locale", "136": "ComfyUI folder_paths API", "138": "i18n System", "139": "Japanese Locale", "141": "Node Class Mappings", "142": "OrderedDict Usage", "143": "Output Directory API", "145": "ComfyUI PromptServer", "151": "Silent Failure Diagnosis", "152": "Temp Directory API", "153": "Path Utility", "154": "Input Validation Hook"}
{
"0": "escapeHtml",
"1": "prompt-table.js",
"2": "models_routes.py",
"3": "generate-tab.js",
"4": "_openCellModal",
"5": "gallery_routes.py",
"6": "gallery-tab.js",
"7": "ImageEditTab",
"8": "ai-tab.js",
"9": "eagle_routes.py",
"10": "feeder-tab.js",
"11": "NodesService",
"12": "settings_routes.py",
"13": "metadata-tab.js",
"14": "node_sets_menu.js",
"15": "GalleryService",
"16": "settings-tab.js",
"17": "tagger_routes.py",
"18": "WildcardService",
"19": "tagger-tab.js",
"20": "renderContent",
"21": "comfyui-editor.js",
"22": "ComfyUI-Workflow-Studio",
"23": "TaggerService",
"24": "top_menu_extension.js",
"25": "nodes-tab.js",
"26": "setupAiHandlers",
"27": "workflow-tab.js",
"28": "workflow_routes.py",
"29": "GalleryMetadataStore",
"30": "WorkflowService",
"31": "LabPlanService",
"32": "skill_routes.py",
"33": "LayerManager",
"34": "SelectTool",
"35": "CivitaiService",
"36": "DrawTool",
"37": "MaskTool",
"38": "index.html Template",
"39": "gallery_service.py",
"40": "FileExport",
"41": "image-prompt-tab.js",
"42": "KSampler Node",
"43": "image-edit-tab.js",
"44": "style-catalog-tab.js",
"45": "add",
"46": "comfyui-workflow.js",
"47": "BlurTool",
"48": "MaskShapeTool",
"49": "MaskVectorTool",
"50": "ShapeTool",
"51": "gmic_routes.py",
"52": "ollama_routes.py",
"53": "TextTool",
"54": "analyze_workflow",
"55": "MaskTextTool",
"56": "lab-tab.js",
"57": ".list_images",
"58": "MaskAlphaTool",
"59": "MaskColorTool",
"60": "gallery_feeder_extension.js",
"61": "createPanel",
"62": "_runLabBatch",
"63": "BgRemove",
"64": "Workflow JSON",
"65": "WFS_GalleryFeeder",
"66": "initGenerateTab",
"67": "InpaintI2IActions",
"68": "Sam3Segmentation",
"69": "fromWorkflow",
"70": "_extractPromptsAPI",
"71": "generate_doc_index.py",
"72": "WS Inpaint Basic Workflow",
"73": "._bg_index_folder",
"74": "aiohttp",
"75": "import_style_prompt_seed.py",
"76": "Image Edit (FireRed Image Edit 1.1) node",
"77": "Version 0.3.9",
"78": "DWPose Image Feeder Workflow",
"79": "wfm.py",
"80": "README.index.md",
"81": "WFS_PromptText",
"82": "workflow_service.py",
"83": "SPA",
"84": "prompt-ai-chat.js",
"85": "Tagger Tab requirements.txt",
"86": "data directory",
"87": "t",
"88": "Chinese Language Support",
"89": "Version 0.3.95",
"90": "Windows",
"91": "add_routes",
"92": "Bounded Cache",
"93": "Business Logic",
"94": "check_lazy_status",
"95": "HF_HOME",
"96": "IS_CHANGED",
"97": "Lab Subtab",
"98": "lab_routes.py",
"99": "PowerShell",
"100": "prestartup_script.py",
"101": ".get_image_prompt_root",
"102": ".get_style_catalog_root",
"103": ".start_background_index",
"104": ".update_workflows_dir",
"105": "Version 0.4.2",
"106": "Workflow Studio Banner",
"107": "Workflow Studio Icon",
"108": "BiRefNet Model",
"109": "Chinese",
"110": "SDXL 2D Pose Editor I2I Workflow",
"111": "ComfyUI Manager",
"112": "Tagger Tab Screenshot (WD Tagger/DeepDanbooru)",
"113": "Models Tab UI Screenshot",
"114": "Workflow Studio Topbar Icon Strip",
"115": "GenerateUI LoRA Stack Tab Screenshot",
"116": "Workflow Studio Favicon Icon",
"117": "2D Pose Editor to Image Edit (FireRed) Workflow",
"118": "3D Pose Editor to Image Edit (Flux.2 Klein) Workflow",
"119": "SDXL DWPose ControlNet Workflow",
"120": "SDXL From Metadata T2I Workflow",
"121": "SDXL Img2Img + FaceDetailer Workflow",
"122": "SDXL Image Feeder Img2Img Workflow",
"123": "SDXL T2I + FaceDetailer Workflow",
"124": "GenerateUI Batch Tab Screenshot",
"125": "Multiple Select Menu Screenshot",
"126": "Image Edit Tab Screenshot",
"127": "Workflow Tab Screenshot",
"128": "Prompt Tab Input Assistance Screenshot",
"129": "GenerateUI Feeder Tab Screenshot",
"130": "Workflow Studio Library Panel (Lora Info View)",
"131": "Library Panel I Tab (Prompts) Screenshot",
"132": "Settings Tab Screenshot (Language, Theme)",
"133": "ComfyUI Workflow Studio Thumbnail",
"134": "English",
"135": "Feeder Subtab",
"136": "folder_paths",
"137": "Help & Support Tab",
"138": "i18n",
"139": "Japanese",
"140": "Metadata Tab",
"141": "NODE_CLASS_MAPPINGS",
"142": "OrderedDict",
"143": "get_output_directory",
"144": "comfyui-workflow-studio",
"145": "ComfyUI PromptServer",
"146": "py/__init__.py",
"147": "nodes/__init__.py",
"148": "routes/__init__.py",
"149": "services/__init__.py",
"150": "python-dotenv",
"151": "Silent Failure Diagnosis",
"152": "get_temp_directory",
"153": "prompts_routes.py",
"154": "VALIDATE_INPUTS",
"155": "SD1.5 Basic Text-to-Image Workflow",
"156": "SDXL Text-to-Image Basic Workflow Screenshot",
"157": "SettingsService",
"158": "on_doc_edit.py",
"159": "ComfyUI-Custom-Scripts",
"160": "ComfyUI-Gallery",
"161": "ComfyUI-Lora-Manager",
"162": "Eagle",
"163": "Fooocus",
"164": "Gallery Tab",
"165": "GenerateUI Tab",
"166": "Image Edit Tab",
"167": "infinite-image-browsing",
"168": "Lemonade Server",
"169": "LM Studio",
"170": "Ollama",
"171": "Settings Tab",
"172": "Tagger Tab",
"173": "Unsloth",
"174": "app.js",
"175": "PromptsService",
"176": "util.js",
"177": "civitai_service.py",
"178": "config.py",
"179": "createModelItem",
"180": "_renderBatchPreview"
}
+242 -183
View File
@@ -1,59 +1,64 @@
# Graph Report - ComfyUI-Workflow-Studio (2026-08-22)
## Corpus Check
- 20 files · ~567,102 words
- 113 files · ~567,985 words
- Verdict: corpus is large enough that graph structure adds value.
## Summary
- 2320 nodes · 5560 edges · 157 communities (79 shown, 78 thin omitted)
- Extraction: 94% EXTRACTED · 6% INFERRED · 0% AMBIGUOUS · INFERRED: 328 edges (avg confidence: 0.87)
- Token cost: 22,191 input · 55,365 output
- 2314 nodes · 5664 edges · 181 communities (87 shown, 94 thin omitted)
- Extraction: 95% EXTRACTED · 5% INFERRED · 0% AMBIGUOUS · INFERRED: 302 edges (avg confidence: 0.88)
- Token cost: 0 input · 0 output
## Graph Freshness
- Built from commit: `ad9d06d3`
- Run `git rev-parse HEAD` and compare to check if the graph is stale.
- Run `graphify update .` after code changes (no API cost).
## Community Hubs (Navigation)
- models-tab.js
- prompt-tab.js
- escapeHtml
- prompt-table.js
- models_routes.py
- generate-tab.js
- lab-tab.js
- _openCellModal
- gallery_routes.py
- gallery-tab.js
- ImageEditTab
- ai-tab.js
- Backend API Routes
- eagle_routes.py
- feeder-tab.js
- NodesService
- settings_routes.py
- metadata-tab.js
- node_sets_menu.js
- GalleryService
- workflow-tab.js
- settings-tab.js
- tagger_routes.py
- WildcardService
- t
- tagger-tab.js
- renderContent
- comfyui-editor.js
- External Plugin Ecosystem
- ComfyUI-Workflow-Studio
- TaggerService
- top_menu_extension.js
- settings-tab.js
- nodes-tab.js
- setupAiHandlers
- PromptsService
- workflow-tab.js
- workflow_routes.py
- GalleryMetadataStore
- WorkflowService
- lab_routes.py
- SkillService
- LabPlanService
- skill_routes.py
- LayerManager
- SelectTool
- CivitaiService
- DrawTool
- MaskTool
- Registry Publish & Docs
- index.html Template
- gallery_service.py
- Generate & Export Utilities
- FileExport
- image-prompt-tab.js
- KSampler Node
- ComfyUI Client & Mask Bridge
- image-edit-tab.js
- style-catalog-tab.js
- add
- comfyui-workflow.js
@@ -66,17 +71,17 @@
- TextTool
- analyze_workflow
- MaskTextTool
- i18n.js
- lab-tab.js
- .list_images
- MaskAlphaTool
- MaskColorTool
- gallery_feeder_extension.js
- createPanel
- util.js
- _runLabBatch
- BgRemove
- Workflow Analyzer Internals
- Workflow JSON
- WFS_GalleryFeeder
- app.js
- initGenerateTab
- InpaintI2IActions
- Sam3Segmentation
- fromWorkflow
@@ -84,32 +89,32 @@
- generate_doc_index.py
- WS Inpaint Basic Workflow
- ._bg_index_folder
- SettingsService
- aiohttp
- import_style_prompt_seed.py
- Image Edit (FireRed Image Edit 1.1) node
- Version 0.3.9
- DWPose Image Feeder Workflow
- civitai_service.py
- Doc Index Automation
- wfm.py
- README.index.md
- WFS_PromptText
- workflow_service.py
- Project Directory Layout
- config.py
- SPA
- prompt-ai-chat.js
- Tagger Tab requirements.txt
- Data Storage Files
- AI Tool Version History
- data directory
- t
- Chinese Language Support
- Version 0.3.95
- Windows Long Path Handling
- Route Registration
- Caching & Unique IDs
- Service Layer
- Lazy Input Evaluation
- HuggingFace Config
- Node Cache Invalidation
- Windows
- add_routes
- Bounded Cache
- Business Logic
- check_lazy_status
- HF_HOME
- IS_CHANGED
- Lab Subtab
- Mask Editor One Release
- PowerShell Encoding
- lab_routes.py
- PowerShell
- prestartup_script.py
- .get_image_prompt_root
- .get_style_catalog_root
@@ -119,7 +124,7 @@
- Workflow Studio Banner
- Workflow Studio Icon
- BiRefNet Model
- Chinese Locale
- Chinese
- SDXL 2D Pose Editor I2I Workflow
- ComfyUI Manager
- Tagger Tab Screenshot (WD Tagger/DeepDanbooru)
@@ -144,127 +149,149 @@
- Library Panel I Tab (Prompts) Screenshot
- Settings Tab Screenshot (Language, Theme)
- ComfyUI Workflow Studio Thumbnail
- English Locale
- English
- Feeder Subtab
- ComfyUI folder_paths API
- folder_paths
- Help & Support Tab
- i18n System
- Japanese Locale
- i18n
- Japanese
- Metadata Tab
- Node Class Mappings
- OrderedDict Usage
- Output Directory API
- NODE_CLASS_MAPPINGS
- OrderedDict
- get_output_directory
- comfyui-workflow-studio
- ComfyUI PromptServer
- python-dotenv
- Silent Failure Diagnosis
- Temp Directory API
- Path Utility
- Input Validation Hook
- get_temp_directory
- prompts_routes.py
- VALIDATE_INPUTS
- SD1.5 Basic Text-to-Image Workflow
- SDXL Text-to-Image Basic Workflow Screenshot
- SettingsService
- on_doc_edit.py
- ComfyUI-Custom-Scripts
- ComfyUI-Gallery
- ComfyUI-Lora-Manager
- Eagle
- Fooocus
- Gallery Tab
- GenerateUI Tab
- Image Edit Tab
- infinite-image-browsing
- Lemonade Server
- LM Studio
- Ollama
- Settings Tab
- Tagger Tab
- Unsloth
- app.js
- PromptsService
- util.js
- civitai_service.py
- config.py
- createModelItem
- _renderBatchPreview
## God Nodes (most connected - your core abstractions)
1. `t()` - 226 edges
2. `showToast()` - 186 edges
3. `ImageEditTab` - 53 edges
4. `escapeHtml()` - 53 edges
1. `t()` - 233 edges
2. `showToast()` - 192 edges
3. `escapeHtml()` - 73 edges
4. `ImageEditTab` - 53 edges
5. `GalleryService` - 45 edges
6. `ComfyUI-Workflow-Studio` - 41 edges
7. `initPromptTab()` - 33 edges
8. `setup_routes()` - 32 edges
9. `initSettingsTab()` - 31 edges
10. `add()` - 31 edges
6. `setup_routes()` - 32 edges
7. `initSettingsTab()` - 31 edges
8. `add()` - 31 edges
9. `renderModelGrid()` - 29 edges
10. `TaggerService` - 26 edges
## Surprising Connections (you probably didn't know these)
- `ComfyUI-Workflow-Studio` --references--> `ImagePrompt Gallery Subtab` [INFERRED]
CLAUDE.md → README.index.md
- `ComfyUI-Workflow-Studio` --references--> `Prompt Tab` [INFERRED]
CLAUDE.md → README.index.md
- `ComfyUI-Workflow-Studio` --references--> `Gallery Tab` [INFERRED]
CLAUDE.md → README.index.md
- `ComfyUI-Workflow-Studio` --references--> `GenerateUI Tab` [INFERRED]
CLAUDE.md → README.index.md
- `ComfyUI-Workflow-Studio` --references--> `Image Edit Tab` [INFERRED]
CLAUDE.md → README.index.md
- `beforeRegisterNodeDef()` --indirect_call--> `saveSelectedAsNodeSet()` [INFERRED]
web/comfyui/top_menu_extension.js → web/comfyui/node_sets_menu.js
- `Publish to Comfy Registry Workflow` --conceptually_related_to--> `index.html Template` [INFERRED]
.github/workflows/publish.yml → templates/index.html
- `Version 0.3.9` --references--> `Models Tab` [EXTRACTED]
DEVLOG.index.md → README.index.md
- `Version 0.3.9` --references--> `Nodes Tab` [EXTRACTED]
DEVLOG.index.md → README.index.md
- `Version 0.3.9` --references--> `Prompt Tab` [EXTRACTED]
DEVLOG.index.md → README.index.md
## Import Cycles
- 3-file cycle: `static/js/app.js -> static/js/image-edit-tab.js -> static/js/image-edit/Sam3Segmentation.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/image-edit-tab.js -> static/js/image-edit/GmicIntegration.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/image-edit-tab.js -> static/js/image-edit/BgRemove.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/generate-tab.js -> static/js/feeder-tab.js -> static/js/app.js`
- 3-file cycle: `static/js/feeder-tab.js -> static/js/gallery-tab.js -> static/js/generate-tab.js -> static/js/feeder-tab.js`
- 3-file cycle: `static/js/app.js -> static/js/gallery-tab.js -> static/js/image-prompt-tab.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/gallery-tab.js -> static/js/style-catalog-tab.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/prompt-tab.js -> static/js/prompt-presets.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/prompt-tab.js -> static/js/prompt-ai-chat.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/prompt-tab.js -> static/js/prompt-styles.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/prompt-tab.js -> static/js/prompt-wildcards.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/models-tab.js -> static/js/models/badges.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/models-tab.js -> static/js/comfyui-editor.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/image-edit-tab.js -> static/js/image-edit/InpaintI2IActions.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/image-edit-tab.js -> static/js/image-edit/MaskEditorOneBridge.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/image-edit-tab.js -> static/js/image-edit/BlurTool.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/gallery-tab.js -> static/js/image-prompt-tab.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/image-edit-tab.js -> static/js/image-edit/Sam3Segmentation.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/image-edit-tab.js -> static/js/image-edit/GmicIntegration.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/image-edit-tab.js -> static/js/image-edit/FileExport.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/image-edit-tab.js -> static/js/image-edit/MaskEditorOneBridge.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/models-tab.js -> static/js/comfyui-editor.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/image-edit-tab.js -> static/js/comfyui-editor.js -> static/js/app.js`
- 3-file cycle: `static/js/ai-tab.js -> static/js/app.js -> static/js/gallery-tab.js -> static/js/ai-tab.js`
- 3-file cycle: `static/js/app.js -> static/js/gallery-tab.js -> static/js/comfyui-editor.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/image-edit-tab.js -> static/js/image-edit/BgRemove.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/image-edit-tab.js -> static/js/image-edit/BlurTool.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/image-edit-tab.js -> static/js/image-edit/InpaintI2IActions.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/gallery-tab.js -> static/js/style-catalog-tab.js -> static/js/app.js`
- 3-file cycle: `static/js/app.js -> static/js/generate-tab.js -> static/js/comfyui-editor.js -> static/js/app.js`
- 4-file cycle: `static/js/app.js -> static/js/workflow-tab.js -> static/js/generate-tab.js -> static/js/feeder-tab.js -> static/js/app.js`
- 4-file cycle: `static/js/app.js -> static/js/gallery-tab.js -> static/js/generate-tab.js -> static/js/feeder-tab.js -> static/js/app.js`
- 4-file cycle: `static/js/app.js -> static/js/prompt-tab.js -> static/js/generate-tab.js -> static/js/feeder-tab.js -> static/js/app.js`
- 3-file cycle: `static/js/ai-tab.js -> static/js/app.js -> static/js/gallery-tab.js -> static/js/ai-tab.js`
## Hyperedges (group relationships)
- **Architecture Layers** — workflowstudio, add_routes, py_wfm, py_routes, py_services, business_logic, web_comfyui, static, templates, data, settings_json, metadata_json, node_metadata_json [EXTRACTED 0.80]
- **Graphify Index Generation** — readme_index, devlog_index, generate_doc_index, graphifyignore, readme, devlog, claude_hooks, git_hooks [EXTRACTED 0.85]
- **Workflow Studio UI Navigation Tabs** — templates_index_html_workflow, templates_index_html_nodes, templates_index_html_models, templates_index_html_generate, templates_index_html_prompt, templates_index_html_gallery, templates_index_html_image_edit, templates_index_html_tagger, templates_index_html_settings, templates_index_html_help, templates_index_html_ai [EXTRACTED 0.85]
- **Workflow JSON Consistency Group** — last_node_id, last_link_id, links, workflow_json [EXTRACTED 0.85]
- **i18n Languages** — i18n, english, japanese, chinese [EXTRACTED 0.90]
- **Graphify Index Generation** — readme_index, devlog_index, generate_doc_index, graphifyignore, readme, devlog, claude_hooks, git_hooks [EXTRACTED 0.85]
- **AI Feature Backends** — ollama, lm_studio, lemonade_server, unsloth [INFERRED 0.80]
- **Image/Gallery Implementation References** — comfyui_custom_scripts, comfyui_gallery, infinite_image_browsing [INFERRED 0.70]
- **Workflow Studio UI Navigation Tabs** — templates_index_html_workflow, templates_index_html_nodes, templates_index_html_models, templates_index_html_generate, templates_index_html_prompt, templates_index_html_gallery, templates_index_html_image_edit, templates_index_html_tagger, templates_index_html_settings, templates_index_html_help, templates_index_html_ai [EXTRACTED 0.85]
- **Mask Editor One Inpainting Pipeline** — comfyui-workflow-studio_workflows_ws_inpaint_mask_editor_one_load_checkpoint_node, comfyui-workflow-studio_workflows_ws_inpaint_mask_editor_one_mask_editor_one_node, comfyui-workflow-studio_workflows_ws_inpaint_mask_editor_one_clip_text_encode_positive_node, comfyui-workflow-studio_workflows_ws_inpaint_mask_editor_one_clip_text_encode_negative_node, comfyui-workflow-studio_workflows_ws_inpaint_mask_editor_one_vae_encode_for_inpainting_node, comfyui-workflow-studio_workflows_ws_inpaint_mask_editor_one_save_image_node [INFERRED]
## Communities (157 total, 78 thin omitted)
## Communities (181 total, 94 thin omitted)
### Community 0 - "models-tab.js"
Cohesion: 0.06
Nodes (120): openModal(), t(), badgeHtml(), bindBadgeModalEvents(), bindBadgeRowEvents(), getBadgePalette(), modelBadgesHtml(), _onGridChange() (+112 more)
### Community 0 - "escapeHtml"
Cohesion: 0.09
Nodes (80): openModal(), comfyUI, badgeHtml(), bindBadgeModalEvents(), bindBadgeRowEvents(), getBadgePalette(), modelBadgesHtml(), _onGridChange() (+72 more)
### Community 1 - "prompt-tab.js"
### Community 1 - "prompt-table.js"
Cohesion: 0.06
Nodes (107): closeModal(), refreshStylesList(), addChatMessage(), apiCreatePreset(), apiDeletePreset(), apiUpdatePreset(), applyToGenerateUI(), attachFile() (+99 more)
Nodes (99): closeModal(), refreshStylesList(), apiCreatePreset(), apiDeletePreset(), apiUpdatePreset(), clearBatchPresets(), createPmItem(), esc() (+91 more)
### Community 2 - "models_routes.py"
Cohesion: 0.06
Nodes (55): handle_change_preview(), handle_civitai_batch(), handle_civitai_cache(), handle_civitai_fetch(), handle_delete_models(), handle_get_disabled(), handle_get_filepath(), handle_get_groups() (+47 more)
### Community 3 - "generate-tab.js"
Cohesion: 0.06
Nodes (64): _applyNamedStyle(), _applyStyleToWorkflow(), _batchGroupState, _batchStyleSelected, _blobToDataUrl(), _buildFolderTree(), _buildSimpleGroupList(), _ckptBatch (+56 more)
Cohesion: 0.09
Nodes (41): _applyNamedStyle(), _applyStyleToWorkflow(), _batchGroupState, _batchStyleSelected, _blobToDataUrl(), _buildFolderTree(), _ckptBatch, _ckptState (+33 more)
### Community 4 - "lab-tab.js"
Cohesion: 0.08
Nodes (67): _expandWildcardsInWorkflow(), _annotatedImageRef(), _applyLabLoraToWorkflow(), _applyPlanData(), _applyStyleToText(), _buildIndexImageDataUrl(), _buildLoraPromptInjection(), _buildPlanData() (+59 more)
### Community 4 - "_openCellModal"
Cohesion: 0.24
Nodes (12): _applyStyleToText(), _cellHtml(), _cellLabel(), _effectiveDisplayValue(), _isEmptyValue(), _isLiveDisplay(), _liveValueFor(), _openCellModal() (+4 more)
### Community 5 - "gallery_routes.py"
Cohesion: 0.10
Nodes (54): add_to_group(), bulk_favorite(), bulk_group(), clear_group_images(), create_folder_route(), create_group(), delete_folder_route(), delete_group() (+46 more)
### Community 6 - "gallery-tab.js"
Cohesion: 0.09
Nodes (54): addTag(), API, apiFetch(), _appendNextPage(), _applySelectionToDOM(), _attachScrollSentinel(), bindEvents(), bulkAddToGroup() (+46 more)
Cohesion: 0.10
Nodes (53): addTag(), API, apiFetch(), _appendNextPage(), _applySelectionToDOM(), _attachScrollSentinel(), bindEvents(), bulkAddToGroup() (+45 more)
### Community 8 - "ai-tab.js"
Cohesion: 0.09
Nodes (51): appendChatBubble(), _appendSkillSaveButton(), _appendSvgPreview(), _applyGenOptions(), buildTranslationMessages(), callChat(), callLLM(), callVLM() (+43 more)
Nodes (52): appendChatBubble(), _appendSkillSaveButton(), _appendSvgPreview(), _applyGenOptions(), buildTranslationMessages(), callChat(), callLLM(), callVLM() (+44 more)
### Community 9 - "Backend API Routes"
Cohesion: 0.05
Nodes (46): aiohttp, Jinja2, py/routes, _eagle_add(), _eagle_add_from_path(), _eagle_test(), handle_add(), handle_test() (+38 more)
### Community 9 - "eagle_routes.py"
Cohesion: 0.14
Nodes (20): _eagle_add(), _eagle_add_from_path(), _eagle_test(), handle_add(), handle_test(), Application, Request, Response (+12 more)
### Community 10 - "feeder-tab.js"
Cohesion: 0.10
Nodes (49): _applyGalToWorkflow(), _applyPreset(), _applyToGalNode(), _applyToNode(), _applyToWorkflow(), _deletePreset(), _deselectAll(), _feederNodes() (+41 more)
Nodes (50): _applyGalToWorkflow(), _applyPreset(), _applyToGalNode(), _applyToNode(), _applyToWorkflow(), _deletePreset(), _deselectAll(), _feederNodes() (+42 more)
### Community 11 - "NodesService"
Cohesion: 0.09
Nodes (28): handle_create_set(), handle_delete_set(), handle_export_set(), handle_get_groups(), handle_get_metadata(), handle_list_sets(), handle_save_groups(), handle_save_metadata() (+20 more)
Nodes (27): handle_create_set(), handle_delete_set(), handle_export_set(), handle_get_groups(), handle_get_metadata(), handle_list_sets(), handle_save_groups(), handle_save_metadata() (+19 more)
### Community 12 - "settings_routes.py"
Cohesion: 0.09
@@ -276,15 +303,15 @@ Nodes (40): buildLoRAItem(), buildModelItem(), buildPromptItem(), collectAllNode
### Community 14 - "node_sets_menu.js"
Cohesion: 0.08
Nodes (37): AI_BACKEND_DEFAULT_URLS, AI_LANG_NAMES, convertApiToUiWorkflow(), _extractAllMetadata(), _extractWorkflowFromEXIF(), fetchGroups(), fetchMetadata(), fetchNodeSets() (+29 more)
Nodes (38): AI_BACKEND_DEFAULT_URLS, AI_LANG_NAMES, convertApiToUiWorkflow(), _extractAllMetadata(), _extractWorkflowFromEXIF(), fetchGroups(), fetchMetadata(), fetchNodeSets() (+30 more)
### Community 15 - "GalleryService"
Cohesion: 0.10
Nodes (13): GalleryService, Path, 許可するルートパスを更新する(Settings変更時に呼ぶ), ComfyUI実outputフォルダの不変ルートを設定する(起動時に一度だけ呼ぶ), パスが許可ルート配下かチェック(パストラバーサル防止)。 Output ギャラリーの _allowed_root、またはComfyUI実outputフォルダの…, outputフォルダのフォルダツリーを返す, 画像と同名の.txtサイドカーにプロンプトテキストを保存する, ワークフローを抽出する。 優先順位: PNG[workflow] > PNG[prompt] > gallery_metadata.json[workflow] (+5 more)
### Community 16 - "workflow-tab.js"
Cohesion: 0.13
Nodes (35): readJsonStorage(), badgeHtml(), _buildStructuredSummaryText(), _buildSummarySourceText(), clearBatch(), closeSidePanel(), deleteWorkflow(), fetchWorkflows() (+27 more)
### Community 16 - "settings-tab.js"
Cohesion: 0.09
Nodes (40): getLang(), getLanguageOptions(), getSummaryLang(), getSummaryLanguageOptions(), getSummaryPrompt(), LANGUAGE_OPTIONS, LANGUAGES, setLang() (+32 more)
### Community 17 - "tagger_routes.py"
Cohesion: 0.14
@@ -294,41 +321,41 @@ Nodes (24): Connection, handle_batch_start(), handle_batch_status(), handle_batc
Cohesion: 0.12
Nodes (21): handle_create_link(), handle_delete(), handle_get_content(), handle_link_status(), handle_list(), handle_remove_link(), handle_save(), Application (+13 more)
### Community 19 - "t"
Cohesion: 0.12
Nodes (35): _applyI18n(), _batchStart(), _batchStop(), _dbDelete(), _dbExport(), _dbLoad(), _dbSave(), _dbSearch() (+27 more)
### Community 19 - "tagger-tab.js"
Cohesion: 0.14
Nodes (29): _applyI18n(), _batchStart(), _batchStop(), _dbDelete(), _dbExport(), _dbLoad(), _dbSave(), _dbSearch() (+21 more)
### Community 20 - "renderContent"
Cohesion: 0.14
Nodes (35): createDraggableItem(), createDraggablePromptItem(), createDraggableWfItem(), createModelItem(), esc(), extractPackageName(), fetchModelList(), getNodeCategory() (+27 more)
Cohesion: 0.16
Nodes (28): createDraggableItem(), createDraggablePromptItem(), createDraggableWfItem(), esc(), extractPackageName(), getNodeCategory(), getNodePackage(), getWfBadges() (+20 more)
### Community 21 - "comfyui-editor.js"
Cohesion: 0.08
Nodes (28): _applyLoraToNode(), _attachPromptWeightControl(), _buildLoraManagerSyntax(), _buildLoraSyntax(), _buildPresetOptions(), _compositeImageWithMask(), _I2I_PLACEHOLDER_DEFAULT, _imageInputToDataURL() (+20 more)
### Community 22 - "External Plugin Ecosystem"
Cohesion: 0.06
Nodes (33): Canvas Snapshot, CivitAI, ComfyUI-Custom-Scripts, ComfyUI-Gallery, ComfyUI-Lora-Manager, comfyui-mask-editor-one, README Index — ComfyUI-Workflow-Studio, ComfyUI-Workflow-Studio (+25 more)
### Community 22 - "ComfyUI-Workflow-Studio"
Cohesion: 0.50
Nodes (4): CivitAI, ComfyUI-Workflow-Studio, Mask Editor One, Version 0.3.65
### Community 23 - "TaggerService"
Cohesion: 0.14
Nodes (5): Image, Path, WD Tagger / DeepDanbooru / Ollama VLM 推論サービス。, パストラバーサル防止: セパレータ・NUL・相対参照を拒否, TaggerService
### Community 24 - "top_menu_extension.js"
Cohesion: 0.13
Nodes (29): ../../scripts/ui/components/button.js, ../../scripts/ui/components/buttonGroup.js, getNodeSetsIcon(), injectStyles(), NODE_SETS_TOOLTIP, saveSelectedAsNodeSet(), attachTopMenuButton(), beforeRegisterNodeDef() (+21 more)
Cohesion: 0.14
Nodes (27): ../../scripts/ui/components/button.js, ../../scripts/ui/components/buttonGroup.js, getNodeSetsIcon(), NODE_SETS_TOOLTIP, attachTopMenuButton(), beforeRegisterNodeDef(), captureCanvasSnapshot(), compareVersions() (+19 more)
### Community 25 - "settings-tab.js"
Cohesion: 0.12
Nodes (29): applyCustomFont(), applyCustomOverrides(), applyTheme(), BG_PATTERNS, buildLangOptions(), clearCustomOverrides(), COLOR_TARGETS, FONT_OPTIONS (+21 more)
### Community 25 - "nodes-tab.js"
Cohesion: 0.11
Nodes (40): _applyNodeSelectionToDOM(), bulkNodeAddToGroup(), bulkNodeCreateAndAddToGroup(), bulkNodeRemoveFromGroup(), bulkNodeSetFavorite(), categoryBadgeHtml(), createNodeCard(), createNodeSet() (+32 more)
### Community 26 - "setupAiHandlers"
Cohesion: 0.11
Nodes (28): _aiApplyGenOptions(), aiCallChat(), aiCallLLM(), aiCallVLM(), aiFetchModels(), aiFileToBase64(), aiLooksUntranslated(), aiSkillDeleteFile() (+20 more)
### Community 27 - "PromptsService"
### Community 27 - "workflow-tab.js"
Cohesion: 0.13
Nodes (16): handle_create(), handle_delete(), handle_list(), handle_update(), Application, Request, Response, Prompt presets API routes. (+8 more)
Nodes (34): readJsonStorage(), badgeHtml(), _buildStructuredSummaryText(), _buildSummarySourceText(), clearBatch(), closeSidePanel(), deleteWorkflow(), fetchWorkflows() (+26 more)
### Community 28 - "workflow_routes.py"
Cohesion: 0.15
@@ -342,11 +369,11 @@ Nodes (9): GalleryMetadataStore, Path, グループ名を変更し、全画像
Cohesion: 0.13
Nodes (13): Get raw workflow JSON content., Save metadata (tags, memo, summary, etc.) for a workflow., Manages workflow files and metadata., Import workflow files. Returns list of results., Rename workflow and its associated thumbnail., Delete workflow JSON and associated thumbnail., Re-analyze a workflow and save results to metadata., Re-analyze all workflows and update metadata. (+5 more)
### Community 31 - "lab_routes.py"
Cohesion: 0.15
Nodes (14): handle_delete(), handle_get_content(), handle_list(), handle_save(), handle_save_index_to_output(), Application, Request, Response (+6 more)
### Community 31 - "LabPlanService"
Cohesion: 0.23
Nodes (4): LabPlanService, Path, Lab tab plan file management service (JSON plan + optional PNG index thumbnail)., Saves the contact-sheet index image into ComfyUI's own output folder, alongside…
### Community 32 - "SkillService"
### Community 32 - "skill_routes.py"
Cohesion: 0.14
Nodes (16): handle_delete(), handle_get_content(), handle_list(), handle_save(), Application, Request, Response, AI skill (.md system prompt) file management API routes. (+8 more)
@@ -354,7 +381,7 @@ Nodes (16): handle_delete(), handle_get_content(), handle_list(), handle_save(),
Cohesion: 0.15
Nodes (11): CivitaiService, Build request headers, optionally including Bearer token., Calculate SHA256 hash of a file., Fetch model version info from CivitAI by SHA256 hash (GET). 429/5xx…, POST /model-versions/by-hash でハッシュリストを一括取得(最大100件/リクエスト)。 レスポンスの…, Extract relevant fields from CivitAI API response., Batch fetch CivitAI info for multiple model files. Phase 1: SHA256…, Clear cache for a specific hash or all. (+3 more)
### Community 38 - "Registry Publish & Docs"
### Community 38 - "index.html Template"
Cohesion: 0.10
Nodes (22): actions/checkout@v4, Comfy-Org/publish-node-action@main, DEVLOG.md, Publish to Comfy Registry Workflow, graphifyignore, main Branch, pyproject.toml, README.md (+14 more)
@@ -362,21 +389,17 @@ Nodes (22): actions/checkout@v4, Comfy-Org/publish-node-action@main, DEVLOG.md,
Cohesion: 0.10
Nodes (13): Gallery Metadata Store - ギャラリー画像のメタデータ永続化, _clean_vault_tags(), _decode_image_data_url(), _FolderCache, _parse_vault_yaml_leaves(), Gallery Service - outputフォルダの画像管理、メタデータ閲覧, フォルダ単位の画像スキャン結果キャッシュ。 フォルダのmtimeが変わった場合、またはTTL超過時に再スキャンする。, data URL (data:<mime>;base64,<data>) をデコードし (バイト列, 拡張子) を返す。 ヘッダが無ければPNG扱い(旧互換)。 (+5 more)
### Community 40 - "Generate & Export Utilities"
Cohesion: 0.17
Nodes (8): showToast(), _applyDefaultCheckpointIfEnabled(), loadWorkflowIntoEditor(), saveCurrentWorkflow(), FileExport, GmicIntegration, _loadPlanWorkflow(), onLoadGenUIClick()
### Community 41 - "image-prompt-tab.js"
Cohesion: 0.20
Nodes (21): activateImagePromptTab(), addSelectedToChips(), API, apiFetch(), cleanPromptText(), clearAllChips(), copyFinalPrompt(), createThumbCard() (+13 more)
Cohesion: 0.21
Nodes (20): activateImagePromptTab(), addSelectedToChips(), API, apiFetch(), cleanPromptText(), clearAllChips(), copyFinalPrompt(), createThumbCard() (+12 more)
### Community 42 - "KSampler Node"
Cohesion: 0.19
Nodes (20): CLIP Text Encode Negative Prompt Node, CLIP Text Encode Positive Prompt Node, Inpaint with Mask Editor One (Workflow Screenshot), Load Checkpoint Node, Mask Editor One Node, Save Image Node, VAE Encode (for Inpainting) Node, 3D Pose Editor Node (comfyui-vrm-pose-editor) (+12 more)
### Community 43 - "ComfyUI Client & Mask Bridge"
Cohesion: 0.16
Nodes (8): comfyUI, comfyEditor, comfyWorkflow, MaskEditorOneBridge, MASK_TEXT_FONTS, fitToCanvas(), TOOL_DEFS, TEXT_FONTS
### Community 43 - "image-edit-tab.js"
Cohesion: 0.12
Nodes (8): comfyEditor, comfyWorkflow, GmicIntegration, MaskEditorOneBridge, MASK_TEXT_FONTS, fitToCanvas(), TOOL_DEFS, TEXT_FONTS
### Community 44 - "style-catalog-tab.js"
Cohesion: 0.22
@@ -402,9 +425,9 @@ Nodes (14): _get_ollama_config(), handle_chat(), handle_models(), handle_test(),
Cohesion: 0.20
Nodes (13): analyze_workflow(), _clip_type_from_ui_node(), _collect_all_ui_nodes(), _detect_model_type_from_name(), _model_name_from_api_node(), _model_name_from_ui_node(), Workflow analyzer - detects model types and counts input/output nodes., Analyze workflow JSON and return model types, input/output node counts. (+5 more)
### Community 56 - "i18n.js"
Cohesion: 0.17
Nodes (12): getLang(), getLanguageOptions(), getSummaryLang(), getSummaryLanguageOptions(), getSummaryPrompt(), LANGUAGE_OPTIONS, LANGUAGES, setLang() (+4 more)
### Community 56 - "lab-tab.js"
Cohesion: 0.12
Nodes (41): _applyPlanData(), _buildIndexImageDataUrl(), _buildPlanData(), _clearPlan(), COLUMN_KEYS, _defaultValueFor(), _emptyColumns(), _emptyLabState() (+33 more)
### Community 57 - ".list_images"
Cohesion: 0.17
@@ -415,14 +438,14 @@ Cohesion: 0.36
Nodes (11): beforeRegisterNodeDef(), fetchGroupImages(), getInputWidget(), getOrCreate(), _ns, setWidgetValue(), startLoop(), stopLoop() (+3 more)
### Community 61 - "createPanel"
Cohesion: 0.24
Nodes (12): applyTheme(), buildThemePanel(), createPanel(), fetchModelGroups(), fetchModelMetadata(), fetchPrompts(), fetchWorkflows(), loadModelsData() (+4 more)
Cohesion: 0.22
Nodes (13): applyTheme(), buildThemePanel(), createPanel(), fetchModelGroups(), fetchModelMetadata(), fetchPrompts(), fetchWorkflows(), injectStyles() (+5 more)
### Community 62 - "util.js"
Cohesion: 0.31
Nodes (10): AI_BACKEND_DEFAULT_URLS, _bytesToDataUrl(), _dataUrlToBytes(), embedPngTextChunk(), getEagleSettings(), getSettings(), _joinBytes(), _n2b() (+2 more)
### Community 62 - "_runLabBatch"
Cohesion: 0.20
Nodes (10): _annotatedImageRef(), _applyLabLoraToWorkflow(), _buildLoraPromptInjection(), _buildWorkflowForIteration(), _fetchLabLoraMetadataCache(), _labTriggerWordsFor(), _runLabBatch(), _setRunUiState() (+2 more)
### Community 64 - "Workflow Analyzer Internals"
### Community 64 - "Workflow JSON"
Cohesion: 0.20
Nodes (10): EXTRA_PNGINFO, last_link_id, last_node_id, links array, Position Index, PROMPT, widgets_values, workflow_analyzer.py (+2 more)
@@ -430,9 +453,9 @@ Nodes (10): EXTRA_PNGINFO, last_link_id, last_node_id, links array, Position Ind
Cohesion: 0.27
Nodes (4): Path, WFS_GalleryFeeder – Feeds images from a gallery group into a workflow., Gallery グループ内の画像をインデックス順に1枚ずつ出力するノード。, WFS_GalleryFeeder
### Community 66 - "app.js"
### Community 66 - "initGenerateTab"
Cohesion: 0.22
Nodes (7): applyI18nToHtml(), initModal(), _onHelpSearch(), initI18n(), applyJsonColors(), applyModelTabActiveColor(), applyTextareaFontSize()
Nodes (7): initGenerateTab(), _loadStyles(), _renderStyleDropdown(), updateStatus(), highlightJSON(), syncJsonHighlight(), syncScroll()
### Community 69 - "fromWorkflow"
Cohesion: 0.36
@@ -443,8 +466,8 @@ Cohesion: 0.33
Nodes (10): _extractPrompts(), _extractPromptsAPI(), _extractPromptsFromNodeSet(), _extractPromptsLiteGraph(), _isPromptStylerNode(), _isSamplerNode(), _isTextEncoderNode(), _resolveEditPlusText() (+2 more)
### Community 71 - "generate_doc_index.py"
Cohesion: 0.31
Nodes (7): main(), PostToolUse hook: regenerate README.index.md / DEVLOG.index.md right after…, Path, generate_devlog_index(), generate_readme_index(), main(), Regenerate README.index.md / DEVLOG.index.md from README.md / DEVLOG.md.…
Cohesion: 0.53
Nodes (5): generate_devlog_index(), generate_readme_index(), main(), Path, Regenerate README.index.md / DEVLOG.index.md from README.md / DEVLOG.md.…
### Community 72 - "WS Inpaint Basic Workflow"
Cohesion: 0.53
@@ -454,9 +477,9 @@ Nodes (9): CLIP Text Encode (Prompt) - negative conditioning, CLIP Text Encode (
Cohesion: 0.25
Nodes (5): Event, バックグラウンドスレッドで未キャッシュ画像のprompt_cacheを構築する。 10枚処理するたびに50msスリープしてメインスレッドへの影響を最小化。, PNG/JPEGからメタデータを抽出し、保存済みメタと合わせて返す, PNGのtEXtチャンクからメタデータを抽出, JPEGのEXIF/commentからメタデータを抽出(簡易)
### Community 74 - "SettingsService"
Cohesion: 0.28
Nodes (4): Return CivitAI API key. Env var CIVITAI_API_KEY takes priority over…, Merge updates into existing settings., Manages application settings (data/settings.json)., SettingsService
### Community 74 - "aiohttp"
Cohesion: 0.16
Nodes (14): aiohttp, py/routes, _get_api_key(), handle_proxy(), _is_allowed_base_url(), Application, Request, Response (+6 more)
### Community 75 - "import_style_prompt_seed.py"
Cohesion: 0.36
@@ -467,18 +490,18 @@ Cohesion: 0.32
Nodes (8): 3D Pose Editor node, FireRed-Image-Edit-1.1_fp8mixed_comfy.safetensors, FireRed-Image-Edit-1.0-Lightning-8steps-v1.0.safetensors (LoRA), Image Edit (FireRed Image Edit 1.1) node, qwen_2.5_vl_7b_fp8_scaled.safetensors (CLIP), qwen_image_vae.safetensors (VAE), Save Image node, 3D Pose Editor to Image Edit (Fire Red) Workflow
### Community 77 - "Version 0.3.9"
Cohesion: 0.25
Nodes (8): Models Tab, Nodes Tab, Prompt Tab, Version 0.1.2, Version 0.1.7, Version 0.2.3, Version 0.3.9, Workflow Tab
Cohesion: 0.18
Nodes (11): AI TOOL Tab, Models Tab, Nodes Tab, Prompt Tab, Version 0.1.2, Version 0.1.7, Version 0.2.3, Version 0.3.14 (+3 more)
### Community 78 - "DWPose Image Feeder Workflow"
Cohesion: 0.52
Nodes (7): DWPose Image Feeder Workflow, Apply ControlNet Node, DWPose Estimator Node (comfyui-controlnet-aux), Image Feeder Node (comfyui-image-feeder), KSampler Node, Load Checkpoint Node (animagineXLRealistic_v6), Load ControlNet Model Node (OpenPoseXL2)
### Community 79 - "civitai_service.py"
Cohesion: 0.33
Nodes (5): _get_ssl_context(), _make_ssl_context(), CivitAI API integration service., Return an SSL context with CA verification. 1. certifi CA bundle (available in…, Download an image from URL and save to save_path. Returns True on success.
### Community 79 - "wfm.py"
Cohesion: 0.21
Nodes (12): Jinja2, Request, Response, Serve the main SPA page., Serve files from the current workflows directory (dynamic path)., Serve files (index thumbnails) from the Lab plan directory., Main entry point for Workflow Studio plugin., Register all routes with ComfyUI's server. (+4 more)
### Community 80 - "Doc Index Automation"
### Community 80 - "README.index.md"
Cohesion: 0.40
Nodes (6): on_doc_edit.py, DEVLOG.index.md, generate_doc_index.py, pre-commit, graphify, README.index.md
@@ -490,25 +513,25 @@ Nodes (3): WFS_PromptText – Prompt preset node with positive/negative STRING o
Cohesion: 0.40
Nodes (4): extract_png_workflow(), Extract ComfyUI workflow JSON from PNG metadata., Extract ComfyUI workflow JSON from PNG byte data. Returns dict or None., Workflow CRUD and metadata management service.
### Community 83 - "Project Directory Layout"
### Community 83 - "SPA"
Cohesion: 0.40
Nodes (5): ComfyUI, SPA, static, templates, web/comfyui
### Community 84 - "config.py"
Cohesion: 0.40
Nodes (3): Resolve workflows dir from settings, falling back to default., _resolve_workflows_dir(), Settings management service.
### Community 84 - "prompt-ai-chat.js"
Cohesion: 0.34
Nodes (14): addChatMessage(), applyToGenerateUI(), attachFile(), chatWithAi(), clearChat(), fetchAiModels(), getPromptAiConfig(), initAiChatUI() (+6 more)
### Community 85 - "Tagger Tab requirements.txt"
Cohesion: 0.40
Nodes (5): Tagger Tab requirements.txt, onnxruntime (WD Tagger / SwinV2), piexif (JPEG EXIF tag writing), python-dotenv (Unsloth .env loading), tensorflow (optional, DeepDanbooru)
### Community 86 - "Data Storage Files"
### Community 86 - "data directory"
Cohesion: 0.50
Nodes (4): data directory, metadata.json, node_metadata.json, settings.json
### Community 87 - "AI Tool Version History"
Cohesion: 0.67
Nodes (3): AI TOOL Tab, Version 0.3.14, Version 0.3.99
### Community 87 - "t"
Cohesion: 0.25
Nodes (20): showToast(), _applyDefaultCheckpointIfEnabled(), loadWorkflowIntoEditor(), saveCurrentWorkflow(), t(), _initPlanDropZone(), _loadPlanFromFile(), _loadPlanFromIndexImage() (+12 more)
### Community 88 - "Chinese Language Support"
Cohesion: 1.00
@@ -518,29 +541,65 @@ Nodes (3): Chinese Language Support, English Language Support, Japanese Language
Cohesion: 0.67
Nodes (3): ImagePrompt Gallery Subtab, Style_Catalog Subtab, Version 0.3.95
### Community 90 - "Windows Long Path Handling"
### Community 90 - "Windows"
Cohesion: 0.67
Nodes (3): LongPathsEnabled, MAX_PATH, Windows
### Community 98 - "lab_routes.py"
Cohesion: 0.42
Nodes (10): handle_delete(), handle_get_content(), handle_list(), handle_save(), handle_save_index_to_output(), Application, Request, Response (+2 more)
### Community 153 - "prompts_routes.py"
Cohesion: 0.25
Nodes (13): handle_create(), handle_delete(), handle_list(), handle_update(), Application, Request, Response, Prompt presets API routes. (+5 more)
### Community 157 - "SettingsService"
Cohesion: 0.28
Nodes (4): Return CivitAI API key. Env var CIVITAI_API_KEY takes priority over…, Merge updates into existing settings., Manages application settings (data/settings.json)., SettingsService
### Community 174 - "app.js"
Cohesion: 0.22
Nodes (8): applyI18nToHtml(), initModal(), _onHelpSearch(), initI18n(), applyJsonColors(), applyModelTabActiveColor(), applyTextareaFontSize(), getSettings()
### Community 176 - "util.js"
Cohesion: 0.43
Nodes (7): AI_BACKEND_DEFAULT_URLS, _bytesToDataUrl(), _dataUrlToBytes(), embedPngTextChunk(), _joinBytes(), _n2b(), _pngCrc32()
### Community 177 - "civitai_service.py"
Cohesion: 0.33
Nodes (5): _get_ssl_context(), _make_ssl_context(), CivitAI API integration service., Return an SSL context with CA verification. 1. certifi CA bundle (available in…, Download an image from URL and save to save_path. Returns True on success.
### Community 178 - "config.py"
Cohesion: 0.22
Nodes (5): Resolve workflows dir from settings, falling back to default., _resolve_workflows_dir(), Node metadata and node sets management service., Prompt presets management service., Settings management service.
### Community 179 - "createModelItem"
Cohesion: 0.57
Nodes (7): createModelItem(), fetchModelList(), matchesModelSearch(), renderModelAll(), renderModelByType(), renderModelFavorites(), renderModelGroups()
### Community 180 - "_renderBatchPreview"
Cohesion: 0.20
Nodes (18): _buildSimpleGroupList(), _getGroupSelCount(), _getGroupSelCountFrom(), initBatchTab(), _loadBatchCheckpointGroups(), _loadBatchLoraGroups(), _loadPromptGroupsForBatch(), _loadWorkflowGroupsForBatch() (+10 more)
## Knowledge Gaps
- **228 isolated node(s):** `state`, `groups`, `state`, `WF_RESERVED_GROUPS`, `AI_BACKEND_DEFAULT_URLS` (+223 more)
- **216 isolated node(s):** `comfyui-workflow-studio`, `LANG_NAMES`, `VLM_PROMPTS`, `IMAGE_GEN_TOOLS`, `skillFiles` (+211 more)
These have ≤1 connection - possible missing edges or undocumented components.
- **78 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes.
- **94 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes.
## Suggested Questions
_Questions this graph is uniquely positioned to answer:_
- **Why does `showToast()` connect `Generate & Export Utilities` to `models-tab.js`, `prompt-tab.js`, `generate-tab.js`, `lab-tab.js`, `gallery-tab.js`, `ImageEditTab`, `ai-tab.js`, `feeder-tab.js`, `workflow-tab.js`, `t`, `comfyui-editor.js`, `settings-tab.js`, `LayerManager`, `image-prompt-tab.js`, `ComfyUI Client & Mask Bridge`, `style-catalog-tab.js`, `BlurTool`, `BgRemove`, `app.js`, `InpaintI2IActions`, `Sam3Segmentation`?**
_High betweenness centrality (0.062) - this node is a cross-community bridge._
- **Why does `t()` connect `models-tab.js` to `prompt-tab.js`, `app.js`, `generate-tab.js`, `lab-tab.js`, `gallery-tab.js`, `ai-tab.js`, `Generate & Export Utilities`, `feeder-tab.js`, `image-prompt-tab.js`, `style-catalog-tab.js`, `metadata-tab.js`, `workflow-tab.js`, `t`, `comfyui-editor.js`, `i18n.js`, `settings-tab.js`?**
_High betweenness centrality (0.048) - this node is a cross-community bridge._
- **Why does `GalleryService` connect `GalleryService` to `gallery_routes.py`, `.get_image_prompt_root`, `gallery_service.py`, `.get_style_catalog_root`, `._bg_index_folder`, `.start_background_index`, `.list_images`, `GalleryMetadataStore`?**
_High betweenness centrality (0.027) - this node is a cross-community bridge._
- **What connects `state`, `groups`, `state` to the rest of the system?**
_228 weakly-connected nodes found - possible documentation gaps or missing edges._
- **Should `models-tab.js` be split into smaller, more focused modules?**
_Cohesion score 0.06185919343814081 - nodes in this community are weakly interconnected._
- **Should `prompt-tab.js` be split into smaller, more focused modules?**
_Cohesion score 0.05572545022086307 - nodes in this community are weakly interconnected._
- **Why does `showToast()` connect `t` to `escapeHtml`, `prompt-table.js`, `generate-tab.js`, `_openCellModal`, `gallery-tab.js`, `ImageEditTab`, `ai-tab.js`, `feeder-tab.js`, `settings-tab.js`, `tagger-tab.js`, `comfyui-editor.js`, `nodes-tab.js`, `workflow-tab.js`, `FileExport`, `image-prompt-tab.js`, `image-edit-tab.js`, `style-catalog-tab.js`, `app.js`, `BlurTool`, `lab-tab.js`, `_runLabBatch`, `BgRemove`, `initGenerateTab`, `InpaintI2IActions`, `Sam3Segmentation`, `prompt-ai-chat.js`?**
_High betweenness centrality (0.071) - this node is a cross-community bridge._
- **Why does `t()` connect `t` to `escapeHtml`, `prompt-table.js`, `generate-tab.js`, `_openCellModal`, `gallery-tab.js`, `ai-tab.js`, `feeder-tab.js`, `metadata-tab.js`, `settings-tab.js`, `tagger-tab.js`, `comfyui-editor.js`, `nodes-tab.js`, `workflow-tab.js`, `image-prompt-tab.js`, `style-catalog-tab.js`, `app.js`, `lab-tab.js`, `_runLabBatch`, `initGenerateTab`, `prompt-ai-chat.js`?**
_High betweenness centrality (0.058) - this node is a cross-community bridge._
- **Why does `ImageEditTab` connect `ImageEditTab` to `image-edit-tab.js`, `app.js`?**
_High betweenness centrality (0.028) - this node is a cross-community bridge._
- **What connects `comfyui-workflow-studio`, `LANG_NAMES`, `VLM_PROMPTS` to the rest of the system?**
_216 weakly-connected nodes found - possible documentation gaps or missing edges._
- **Should `escapeHtml` be split into smaller, more focused modules?**
_Cohesion score 0.09288389513108614 - nodes in this community are weakly interconnected._
- **Should `prompt-table.js` be split into smaller, more focused modules?**
_Cohesion score 0.06366691560866318 - nodes in this community are weakly interconnected._
- **Should `models_routes.py` be split into smaller, more focused modules?**
_Cohesion score 0.0554954954954955 - nodes in this community are weakly interconnected._
File diff suppressed because one or more lines are too long
+10121 -8776
View File
File diff suppressed because it is too large Load Diff
+42 -18
View File
@@ -294,10 +294,10 @@
"semantic_hash": "0144bbe48e21eccc498714404e29e29e"
},
"static/js/generate-tab.js": {
"mtime": 1787369336.5249329,
"seen": 1787380810.3284276,
"ast_hash": "14b3ced4743af977596001606be49000",
"semantic_hash": "14b3ced4743af977596001606be49000"
"mtime": 1787401222.9019487,
"seen": 1787401432.6967273,
"ast_hash": "dbfc96b6400bd780990725e390f275c9",
"semantic_hash": ""
},
"static/js/i18n.js": {
"mtime": 1787377822.448605,
@@ -474,10 +474,10 @@
"semantic_hash": "3467d4682a8c20a2b209b5db224ce6e2"
},
"static/js/prompt-tab.js": {
"mtime": 1787373450.5713615,
"seen": 1787380810.352496,
"ast_hash": "6d2e3cd1bbf2e99a5298cfb502a18d9e",
"semantic_hash": "6d2e3cd1bbf2e99a5298cfb502a18d9e"
"mtime": 1787399045.1690862,
"seen": 1787399276.0028682,
"ast_hash": "184961647ceccdf98c8c031c4da96889",
"semantic_hash": ""
},
"static/js/settings-tab.js": {
"mtime": 1787227602.6323576,
@@ -624,15 +624,15 @@
"semantic_hash": "0706c31d93f980b581e0e6eb376c0bcc"
},
"DEVLOG.index.md": {
"mtime": 1787294395.7691903,
"seen": 1787294443.2937605,
"ast_hash": "34f4730b81cef4d6393b5867945e41de",
"mtime": 1787378424.0888915,
"seen": 1787399276.0029197,
"ast_hash": "f5e13974b9f8770e6f49bf74fc2c421e",
"semantic_hash": ""
},
"README.index.md": {
"mtime": 1787294395.7601545,
"seen": 1787294443.293762,
"ast_hash": "ccb030b076d60806eaff45744274cdfe",
"mtime": 1787378423.9177885,
"seen": 1787399276.0029216,
"ast_hash": "4eaa4581c6f969c663176b216fde4596",
"semantic_hash": ""
},
"requirements.txt": {
@@ -858,9 +858,33 @@
"semantic_hash": "639c4691eb3439d1707cd972bbed1402"
},
"static/js/prompt-table.js": {
"mtime": 1787376568.1601257,
"seen": 1787380810.3524997,
"ast_hash": "ca7fa878074a6fd12d5a478109c929d9",
"semantic_hash": "ca7fa878074a6fd12d5a478109c929d9"
"mtime": 1787400288.156035,
"seen": 1787400419.0870566,
"ast_hash": "bb722a8d63b1a7578f136bf99798f679",
"semantic_hash": ""
},
"static/js/prompt-ai-chat.js": {
"mtime": 1787398970.5236483,
"seen": 1787399276.0028632,
"ast_hash": "cdb87c58d22faa43d64b4f71a8d8e0f7",
"semantic_hash": ""
},
"static/js/prompt-presets.js": {
"mtime": 1787398926.1807213,
"seen": 1787399276.0028653,
"ast_hash": "7fd37f214f881138d21559c267241c5d",
"semantic_hash": ""
},
"static/js/prompt-styles.js": {
"mtime": 1787399033.0976152,
"seen": 1787399276.0028667,
"ast_hash": "800e1d042f6800d057b60801461d80aa",
"semantic_hash": ""
},
"static/js/prompt-wildcards.js": {
"mtime": 1787399711.3928645,
"seen": 1787399943.1509204,
"ast_hash": "0e1312911fa197ab5a1858fa449dfc69",
"semantic_hash": ""
}
}
+106 -2
View File
@@ -88,6 +88,10 @@ def setup_routes(app: web.Application):
app.router.add_post("/wfm/gallery/images/delete", delete_images_route)
app.router.add_post("/wfm/gallery/images/move", move_images_route)
app.router.add_post("/wfm/gallery/images/export-zip", export_images_zip)
app.router.add_post("/wfm/gallery/images/export-psd", export_images_psd)
app.router.add_post("/wfm/gallery/image/export-psd-layers", export_psd_from_layers)
app.router.add_post("/wfm/gallery/image/import-psd-layers", import_psd_layers)
app.router.add_get("/wfm/gallery/image/psd-layers", get_psd_layers)
# ──────────────────────────────────────────────────────────────
@@ -181,7 +185,10 @@ async def serve_image(request: web.Request) -> web.Response:
if not path:
return web.Response(status=400)
img_path = _service.serve_image(path)
# PSDの合成処理はCPU負荷が高く同期実行するとイベントループ全体をブロックする
# (他の並行リクエスト、例えば別画像のサムネイル配信も止まってしまう)ためexecutorで実行する
loop = asyncio.get_event_loop()
img_path = await loop.run_in_executor(None, _service.serve_image, path)
if img_path is None:
return web.Response(status=404)
@@ -203,7 +210,10 @@ async def serve_thumb(request: web.Request) -> web.Response:
except ValueError:
width = 256
thumb_path = _service.serve_thumbnail(path, width)
# PSD/MP4のサムネイル生成はCPU負荷が高く同期実行するとイベントループ全体をブロックするため
# executorで実行する(他画像のサムネイル配信が巻き添えで遅延・停止するのを防ぐ)
loop = asyncio.get_event_loop()
thumb_path = await loop.run_in_executor(None, _service.serve_thumbnail, path, width)
if thumb_path is None:
return web.Response(status=404)
@@ -574,3 +584,97 @@ async def export_images_zip(request: web.Request) -> web.Response:
except Exception as e:
logger.error("Error exporting images to ZIP: %s", e)
return web.json_response({"error": str(e)}, status=500)
async def export_images_psd(request: web.Request) -> web.Response:
"""POST /wfm/gallery/images/export-psd - 複数画像を1つのPSD(レイヤー分割)にしてダウンロード"""
try:
body = await request.json()
paths = body.get("paths", [])
if not paths:
return web.json_response({"error": "paths required"}, status=400)
psd_bytes = _service.build_psd_from_images(paths)
return web.Response(
body=psd_bytes,
content_type="image/vnd.adobe.photoshop",
headers={"Content-Disposition": "attachment; filename=gallery_export.psd"}
)
except RuntimeError as e:
logger.error("PSD export dependency missing: %s", e)
return web.json_response({"error": str(e)}, status=500)
except ValueError as e:
return web.json_response({"error": str(e)}, status=400)
except Exception as e:
logger.error("Error exporting images to PSD: %s", e)
return web.json_response({"error": str(e)}, status=500)
async def export_psd_from_layers(request: web.Request) -> web.Response:
"""POST /wfm/gallery/image/export-psd-layers - Image Editタブのレイヤー配列を1つのPSDにしてダウンロード"""
try:
body = await request.json()
width = int(body.get("width", 0))
height = int(body.get("height", 0))
layers = body.get("layers", [])
if not layers:
return web.json_response({"error": "layers required"}, status=400)
psd_bytes = _service.build_psd_from_layers(width, height, layers)
return web.Response(
body=psd_bytes,
content_type="image/vnd.adobe.photoshop",
headers={"Content-Disposition": "attachment; filename=image_edit_export.psd"}
)
except RuntimeError as e:
logger.error("PSD export dependency missing: %s", e)
return web.json_response({"error": str(e)}, status=500)
except ValueError as e:
return web.json_response({"error": str(e)}, status=400)
except Exception as e:
logger.error("Error exporting Image Edit layers to PSD: %s", e)
return web.json_response({"error": str(e)}, status=500)
async def import_psd_layers(request: web.Request) -> web.Response:
"""POST /wfm/gallery/image/import-psd-layers - アップロードされたPSDをレイヤー配列(JSON)に分解して返す"""
try:
reader = await request.multipart()
field = await reader.next()
if field is None:
return web.json_response({"error": "file required"}, status=400)
psd_bytes = await field.read(decode=False)
loop = asyncio.get_event_loop()
result = await loop.run_in_executor(None, _service.import_psd_layers, psd_bytes)
return web.json_response(result)
except RuntimeError as e:
logger.error("PSD import dependency missing: %s", e)
return web.json_response({"error": str(e)}, status=500)
except ValueError as e:
return web.json_response({"error": str(e)}, status=400)
except Exception as e:
logger.error("Error importing PSD layers: %s", e)
return web.json_response({"error": str(e)}, status=500)
async def get_psd_layers(request: web.Request) -> web.Response:
"""GET /wfm/gallery/image/psd-layers - サーバー上のPSDファイルをレイヤー配列(JSON)に分解して返す
(Galleryから直接Image Editへ送る際、アップロードの往復を挟まずに済ませるため)"""
path = request.rel_url.query.get("path", "")
if not path:
return web.json_response({"error": "path required"}, status=400)
try:
loop = asyncio.get_event_loop()
result = await loop.run_in_executor(None, _service.get_psd_layers_from_path, path)
return web.json_response(result)
except RuntimeError as e:
logger.error("PSD import dependency missing: %s", e)
return web.json_response({"error": str(e)}, status=500)
except ValueError as e:
return web.json_response({"error": str(e)}, status=400)
except Exception as e:
logger.error("Error reading PSD layers: %s", e)
return web.json_response({"error": str(e)}, status=500)
+22
View File
@@ -27,6 +27,7 @@ def setup_routes(app: web.Application):
app.router.add_get("/wfm/tagger/db/search", handle_db_search)
app.router.add_put("/wfm/tagger/db/{id}", handle_db_update)
app.router.add_delete("/wfm/tagger/db/{id}", handle_db_delete)
app.router.add_delete("/wfm/tagger/db", handle_db_delete_bulk)
app.router.add_get("/wfm/tagger/db/export", handle_db_export)
app.router.add_post("/wfm/tagger/db/save", handle_db_save)
app.router.add_post("/wfm/tagger/write_meta", handle_write_meta)
@@ -168,6 +169,27 @@ async def handle_db_delete(request: web.Request) -> web.Response:
except Exception as e:
return web.json_response({"error": str(e)}, status=500)
async def handle_db_delete_bulk(request: web.Request) -> web.Response:
try:
data = await request.json()
ids = data.get("ids", [])
if not ids:
return web.json_response(
{"error": "No IDs specified"},
status=400,
)
ids = [int(row_id) for row_id in ids]
deleted_count = await asyncio.to_thread(_db.delete_bulk, ids)
return web.json_response({
"ok": True,
"count": deleted_count,
})
except Exception as e:
return web.json_response({"error": str(e)}, status=500)
async def handle_db_export(request: web.Request) -> web.Response:
try:
+19
View File
@@ -19,6 +19,7 @@ _plan_service = VideoPlanService(VIDEO_PLAN_DIR)
def setup_routes(app: web.Application):
app.router.add_post("/api/wfm/video/frame/save-to-output", handle_save_frame)
app.router.add_post("/api/wfm/video/to-gif", handle_to_gif)
app.router.add_get("/api/wfm/video/edit/probe", handle_probe_video)
app.router.add_get("/api/wfm/video/plans", handle_list_plans)
app.router.add_get("/api/wfm/video/plans/content", handle_get_plan_content)
@@ -69,6 +70,24 @@ async def handle_to_gif(request: web.Request) -> web.Response:
return web.json_response({"error": str(e)}, status=500)
async def handle_probe_video(request: web.Request) -> web.Response:
filename = request.rel_url.query.get("filename", "")
subfolder = request.rel_url.query.get("subfolder", "")
type_ = request.rel_url.query.get("type", "input")
if not filename:
return web.json_response({"error": "filename required"}, status=400)
try:
result = await asyncio.to_thread(_service.probe_video, filename, subfolder, type_)
return web.json_response(result)
except FileNotFoundError as e:
return web.json_response({"error": str(e)}, status=404)
except ValueError as e:
return web.json_response({"error": str(e)}, status=400)
except Exception as e:
logger.error("Error probing video: %s", e)
return web.json_response({"error": str(e)}, status=500)
async def handle_list_plans(request: web.Request) -> web.Response:
try:
result = await asyncio.to_thread(_plan_service.list_plans)
+55 -16
View File
@@ -1,6 +1,7 @@
"""
Gallery Metadata Store - ギャラリー画像のメタデータ永続化
"""
import copy
import json
import logging
import threading
@@ -38,6 +39,9 @@ class GalleryMetadataStore:
def __init__(self, file_path: Path):
self.file_path = file_path
self._lock = threading.RLock()
# ディスクへの実書き込み(JSONシリアライズ+ファイルI/O)を直列化するための
# 別ロック。_save_to_disk() を参照。
self._write_lock = threading.Lock()
self._data: dict = {"images": {}, "groups": []}
self._load()
@@ -70,22 +74,39 @@ class GalleryMetadataStore:
def _save_to_disk(self):
# 呼び出し元(save/create_group等)が既にself._lockを保持している前提の内部メソッド。
# 一時ファイルに書き出してから置き換える(os.replace相当のPath.replace)ことで書き込みを
# アトミックにする。素朴な open(path, "w") での直接上書きだと、書き込み完了前に他プロセス
# が読むと不完全なJSONを掴む(torn read)うえ、書き込み中にComfyUIプロセスが終了すると
# ファイルが壊れたまま残る — 大量画像フォルダのBGインデックス処理(10枚ごとに保存)で
# 書き込み頻度が高い環境ほど発生しやすく、次回起動時のロード失敗→空データでの
# 全上書きという形でユーザーの登録済みグループ/タグ/メモが消失する原因になっていた。
try:
self.file_path.parent.mkdir(parents=True, exist_ok=True)
tmp_path = self.file_path.with_name(self.file_path.name + ".tmp")
with open(tmp_path, "w", encoding="utf-8") as f:
json.dump(self._data, f, ensure_ascii=False, indent=2)
tmp_path.replace(self.file_path)
return True
except Exception as e:
logger.error("GalleryMetadataStore: save error: %s", e)
return False
# ここではself._lock配下でスナップショット(deepcopy)を取るだけに留め、実際のJSON
# シリアライズ+ファイルI/Oはロックの外、別途self._write_lockで直列化して行う。
# 理由: gallery_metadata.jsonは画像数が多い環境では1MBを超えることがあり、
# self._lockを保持したままjson.dump+ファイル書き込みまで行うと、その間
# 他スレッドのget()(検索リクエストなど)が丸ごとブロックされてしまう
# (実際に発生した不具合: バックグラウンドインデックス処理が10枚ごとに保存する際、
# 検索リクエストのget()呼び出しがロック待ちになり、50枚程度のフォルダに対する
# 検索でも数秒〜十数秒かかっていた)。deepcopy自体はメモリ内操作でファイルI/Oより
# 大幅に軽いため、ロック内に残しても実用上のブロック時間は無視できるレベルになる。
snapshot = copy.deepcopy(self._data)
return self._write_snapshot(snapshot)
def _write_snapshot(self, snapshot: dict) -> bool:
"""self._lockの外から呼ばれる。一時ファイルに書き出してから置き換える
(os.replace相当のPath.replace)ことで書き込みをアトミックにする。素朴な
open(path, "w") での直接上書きだと、書き込み完了前に他プロセスが読むと
不完全なJSONを掴む(torn read)うえ、書き込み中にComfyUIプロセスが終了すると
ファイルが壊れたまま残る — 大量画像フォルダのBGインデックス処理で書き込み
頻度が高い環境ほど発生しやすく、次回起動時のロード失敗→空データでの全上書き
という形でユーザーの登録済みグループ/タグ/メモが消失する原因になっていた。
self._write_lockで直列化し、複数スレッドの書き込みが競合して古いスナップショット
が新しいものを上書きしないようにする。"""
with self._write_lock:
try:
self.file_path.parent.mkdir(parents=True, exist_ok=True)
tmp_path = self.file_path.with_name(self.file_path.name + ".tmp")
with open(tmp_path, "w", encoding="utf-8") as f:
json.dump(snapshot, f, ensure_ascii=False, indent=2)
tmp_path.replace(self.file_path)
return True
except Exception as e:
logger.error("GalleryMetadataStore: save error: %s", e)
return False
def _normalize_path(self, image_path: str) -> str:
return str(Path(image_path)).replace("\\", "/")
@@ -105,6 +126,24 @@ class GalleryMetadataStore:
self._data["images"][key] = existing
return self._save_to_disk()
def save_batch(self, entries: dict[str, dict]) -> bool:
"""複数画像のメタデータを1回のディスク書き込みでまとめて保存する。
バックグラウンドインデックス処理のように多数の画像を連続して保存する場合、
1件ずつsave()を呼ぶと画像の数だけJSONシリアライズ+ファイルI/Oが発生してしまう
(実際に発生した不具合: gallery_metadata.jsonが1MBを超える環境で10枚ごとに
個別save()していたため、検索リクエストが完了するまで数秒〜十数秒かかっていた)。"""
if not entries:
return True
allowed = {"favorite", "tags", "memo", "groups", "workflow"}
with self._lock:
for image_path, data in entries.items():
key = self._normalize_path(image_path)
existing = self._data["images"].get(key, {})
existing.update(data)
existing = {k: v for k, v in existing.items() if k in allowed}
self._data["images"][key] = existing
return self._save_to_disk()
# ── グループ管理 ──────────────────────────────────────────────
def list_groups(self) -> list[dict]:
+329 -23
View File
@@ -16,8 +16,34 @@ from typing import Any
logger = logging.getLogger(__name__)
# サポートする画像拡張子(.mp4は動画だがGalleryでは静止画と同じ一覧・配信経路を共有する)
IMAGE_EXTENSIONS = {".png", ".jpg", ".jpeg", ".webp", ".gif", ".svg", ".mp4"}
# サポートする画像拡張子(.mp4は動画だがGalleryでは静止画と同じ一覧・配信経路を共有する。
# .psdはブラウザが直接レンダリングできないため、配信時に合成済みPNGへ変換する)
IMAGE_EXTENSIONS = {".png", ".jpg", ".jpeg", ".webp", ".gif", ".svg", ".mp4", ".psd"}
# Canvas2D の globalCompositeOperation 文字列 -> psd_tools.constants.BlendMode 名
# (Image Edit タブの Layer.blendMode はCanvas2Dの合成モード文字列をそのまま保持している)
_PSD_BLEND_MODE_MAP = {
"source-over": "NORMAL",
"multiply": "MULTIPLY",
"screen": "SCREEN",
"overlay": "OVERLAY",
"darken": "DARKEN",
"lighten": "LIGHTEN",
"color-dodge": "COLOR_DODGE",
"color-burn": "COLOR_BURN",
"hard-light": "HARD_LIGHT",
"soft-light": "SOFT_LIGHT",
"difference": "DIFFERENCE",
"exclusion": "EXCLUSION",
"hue": "HUE",
"saturation": "SATURATION",
"color": "COLOR",
"luminosity": "LUMINOSITY",
}
# 逆引き: psd_tools.constants.BlendMode 名 -> Canvas2D 文字列(PSDインポート用)。
# CSSに対応物が無いPSD側のブレンドモード(Dissolve, Linear Burn/Dodge, Vivid/Linear/Pin Light,
# Hard Mix, Subtract, Divide, Darker/Lighter Color, Pass Through)は "source-over" にフォールバックする。
_CSS_BLEND_MODE_REVERSE = {v: k for k, v in _PSD_BLEND_MODE_MAP.items()}
# data URL の MIME タイプ -> 拡張子(save_image_to_gallery / save_image_to_folder共用)
_SAVE_EXT_BY_MIME = {
@@ -160,8 +186,14 @@ class GalleryService:
self._folder_cache = _FolderCache()
self._bg_cancel = threading.Event()
self._bg_cancel.set() # 初期状態: キャンセル済み
# ponyxlWildcardsVault形式フォールバック用キャッシュ: category_root文字列 -> (yamlシグネチャ, {leaf: tags})
self._vault_leaf_cache: dict[str, tuple[tuple, dict]] = {}
# ponyxlWildcardsVault形式フォールバック用キャッシュ: category_root文字列 -> (キャッシュ時刻, {leaf: tags})
self._vault_leaf_cache: dict[str, tuple[float, dict]] = {}
# 画像の親フォルダ文字列 -> (キャッシュ時刻, category_root or None)。
# _find_vault_category_root は祖先ディレクトリを最大8階層×2回stat()するため、
# 検索フィルタで全画像に対して毎回呼ぶと(特にVaultでない通常フォルダでも
# 無駄に)遅くなる。同一フォルダ内の画像は結果が同じなのでフォルダ単位で
# キャッシュする。
self._vault_root_cache: dict[str, tuple[float, Path | None]] = {}
def update_output_root(self, root_path: str) -> None:
"""許可するルートパスを更新する(Settings変更時に呼ぶ)"""
@@ -225,13 +257,14 @@ class GalleryService:
batch[abs_path] = {"prompt_cache": prompt_cache}
processed += 1
if len(batch) >= 10:
for p, d in batch.items():
self.metadata_store.save(p, d)
# 1件ずつsave()を呼ぶとバッチ内の枚数分だけJSONシリアライズ+
# ファイルI/Oが発生してしまう(大量画像フォルダのメタデータでは
# 1回あたり数百ms〜になりうる)ため、まとめて1回で保存する。
self.metadata_store.save_batch(batch)
batch = {}
time.sleep(0.05) # 50ms 他の処理に譲る
if batch and not cancel.is_set():
for p, d in batch.items():
self.metadata_store.save(p, d)
self.metadata_store.save_batch(batch)
if processed:
logger.debug("BG index done: %s (%d indexed)", folder_path, processed)
except Exception as e:
@@ -411,8 +444,12 @@ class GalleryService:
# recursive=False(非再帰スキャン)の場合、existing_pathsにはfolder直下の
# ファイルしか含まれないため、cleanup側にもrecursive=Falseを伝えて対象範囲を
# 直下のみに限定する(でないとサブフォルダ内ファイルのメタデータを誤削除する)。
existing_paths = {abs_path for _, abs_path, _, _ in raw_entries}
self.metadata_store.cleanup_stale_images(str(folder), existing_paths, recursive=recursive)
# 検索文字列入力中はキー入力のたびに呼ばれるため、ここではスキップする
# (全メタデータ走査+該当時はJSON全体のディスク書き込みを伴い重く、検索の
# 度に繰り返す必要はない。通常の検索なしロード時に実行されれば十分)。
if not search:
existing_paths = {abs_path for _, abs_path, _, _ in raw_entries}
self.metadata_store.cleanup_stale_images(str(folder), existing_paths, recursive=recursive)
results = []
for name, abs_path, size, mtime in raw_entries:
@@ -536,32 +573,45 @@ class GalleryService:
def _find_vault_category_root(self, image_path: Path) -> Path | None:
"""image_path の祖先を辿り、直下に thumbnails(_option2) を持つフォルダ
(=ponyxlWildcardsVaultのカテゴリルート) を探す"""
(=ponyxlWildcardsVaultのカテゴリルート) を探す。
同一フォルダ内の画像は結果が同じなので、フォルダ単位でTTLキャッシュする。"""
parent_key = str(image_path.parent)
cached = self._vault_root_cache.get(parent_key)
if cached is not None and time.monotonic() - cached[0] <= _CACHE_TTL:
return cached[1]
cur = image_path.parent
result: Path | None = None
for _ in range(_VAULT_ROOT_SEARCH_DEPTH):
if any((cur / name).is_dir() for name in _VAULT_THUMB_DIR_NAMES):
return cur
result = cur
break
if cur.parent == cur:
break
cur = cur.parent
return None
self._vault_root_cache[parent_key] = (time.monotonic(), result)
return result
def _load_vault_leaves(self, category_root: Path) -> dict[str, str]:
yaml_files = sorted(category_root.glob("*.yaml")) + sorted(category_root.glob("*.yml"))
if not yaml_files:
return {}
try:
signature = tuple(sorted((str(f), f.stat().st_mtime) for f in yaml_files))
except OSError:
signature = ()
"""category_root直下のyamlをパースしたleaf辞書をTTLキャッシュする。
以前はキャッシュの妥当性確認のため毎回 category_root.glob("*.yaml") を実行して
いたが、category_root は「thumbnails(_option2)という名前のフォルダを直下に持つ
祖先」というゆるい条件で決まるため、Vaultとは無関係な通常の画像出力フォルダ
(例: 直下にComfyUIが作る空のthumbnailsキャッシュフォルダがあるだけ)が誤検出
されることがある。そのフォルダに数千〜数万枚のファイルがあると、glob自体が
1回数十ms〜になり、検索フィルタで画像ごとに呼ばれると数秒単位まで積み上がって
いた(実際に発生した不具合: 1万枚超のルート直下に誤検出されたフォルダがあり、
53枚のサブフォルダを検索するだけで約3秒かかっていた)。TTL内はglobを省略する。"""
cache_key = str(category_root)
cached = self._vault_leaf_cache.get(cache_key)
if cached is not None and cached[0] == signature:
if cached is not None and time.monotonic() - cached[0] <= _CACHE_TTL:
return cached[1]
yaml_files = sorted(category_root.glob("*.yaml")) + sorted(category_root.glob("*.yml"))
leaves: dict[str, str] = {}
for yf in yaml_files:
leaves.update(_parse_vault_yaml_leaves(yf))
self._vault_leaf_cache[cache_key] = (signature, leaves)
self._vault_leaf_cache[cache_key] = (time.monotonic(), leaves)
return leaves
def _read_vault_prompt(self, image_path: Path) -> str | None:
@@ -740,6 +790,10 @@ class GalleryService:
info["height"] = stream.height
if container.duration:
info["duration"] = container.duration / 1_000_000
elif ext == ".psd":
from psd_tools import PSDImage
psd = PSDImage.open(path)
info["width"], info["height"] = psd.width, psd.height
elif ext != ".svg":
from PIL import Image
with Image.open(path) as img:
@@ -1007,8 +1061,215 @@ class GalleryService:
errors.append(f"{p.name}: {e}")
return {"moved": moved, "errors": errors}
def build_psd_from_images(self, paths: list) -> bytes:
"""複数画像を各1レイヤーとして1つのPSDにまとめ、バイナリを返す。
画像サイズが異なる場合はキャンバスを最大サイズに合わせ、各レイヤーは左上(0,0)基準で配置する。
"""
try:
from psd_tools import PSDImage
from psd_tools.api.layers import PixelLayer
except ImportError as e:
raise RuntimeError(
"psd-tools is not installed. Run: "
"python_embeded\\python.exe -m pip install psd-tools"
) from e
from PIL import Image
import io
layers_data = []
for img_path in paths:
p = Path(img_path).resolve()
if not p.is_file() or p.suffix.lower() not in IMAGE_EXTENSIONS:
continue
if p.suffix.lower() == ".mp4":
continue # 動画はPSDレイヤーにできない
if not self._check_path_allowed(p):
continue
try:
im = Image.open(p).convert("RGBA")
except Exception as e:
logger.warning("build_psd_from_images: failed to open %s: %s", p, e)
continue
layers_data.append((p.stem, im))
if not layers_data:
raise ValueError("No valid images to export")
max_w = max(im.width for _, im in layers_data)
max_h = max(im.height for _, im in layers_data)
base = Image.new("RGBA", (max_w, max_h), (0, 0, 0, 0))
psd = PSDImage.frompil(base)
for name, im in layers_data:
PixelLayer.frompil(im, psd, name=name, top=0, left=0)
buf = io.BytesIO()
psd.save(buf)
return buf.getvalue()
def build_psd_from_layers(self, width: int, height: int, layers: list) -> bytes:
"""Image Edit タブのレイヤー配列(dataURL+メタデータ)から1つのPSDを組み立てる。
各レイヤー画像は既にフロントエンド側で回転・反転・拡縮をベイクしたキャンバス全体サイズの
PNGとして渡される前提のため位置は常に(0,0)。opacity/blendModeはPSDレイヤー属性として渡す。
"""
try:
from psd_tools import PSDImage
from psd_tools.api.layers import PixelLayer
from psd_tools.constants import BlendMode
except ImportError as e:
raise RuntimeError(
"psd-tools is not installed. Run: "
"python_embeded\\python.exe -m pip install psd-tools"
) from e
from PIL import Image
import base64
import io
import re
if not layers:
raise ValueError("No layers to export")
if width <= 0 or height <= 0:
raise ValueError("Invalid canvas size")
base = Image.new("RGBA", (width, height), (0, 0, 0, 0))
psd = PSDImage.frompil(base)
added = 0
for layer_data in layers:
data_url = layer_data.get("imageData", "")
m = re.match(r"^data:image/\w+;base64,(.+)$", data_url)
if not m:
continue
try:
im = Image.open(io.BytesIO(base64.b64decode(m.group(1)))).convert("RGBA")
except Exception as e:
logger.warning("build_psd_from_layers: failed to decode layer image: %s", e)
continue
name = str(layer_data.get("name") or "Layer")[:255]
opacity = int(max(0.0, min(1.0, float(layer_data.get("opacity", 1.0)))) * 255)
visible = bool(layer_data.get("visible", True))
blend_key = _PSD_BLEND_MODE_MAP.get(layer_data.get("blendMode", "source-over"), "NORMAL")
blend_mode = getattr(BlendMode, blend_key)
pixel_layer = PixelLayer.frompil(im, psd, name=name, top=0, left=0)
pixel_layer.opacity = opacity
pixel_layer.blend_mode = blend_mode
pixel_layer.visible = visible
added += 1
if added == 0:
raise ValueError("No valid layer images to export")
buf = io.BytesIO()
psd.save(buf)
return buf.getvalue()
def _extract_psd_layers(self, psd) -> dict:
"""PSDImageインスタンスからレイヤー配列(dataURL+メタデータ)を抽出する共通ロジック。
グループ自体・ラスタ化できないレイヤー(調整レイヤー等)はスキップする。
戻り値のlayersはフロントエンドのLayer配列規約(先頭=最前面)に合わせて並べる。
"""
from psd_tools.constants import BlendMode
import base64
import io
layers_out = []
for layer in psd.descendants():
if layer.is_group():
continue
try:
im = layer.topil()
except Exception as e:
logger.warning("_extract_psd_layers: failed to rasterize layer %r: %s", layer.name, e)
continue
if im is None:
continue
im = im.convert("RGBA")
left, top, right, bottom = layer.bbox
w, h = right - left, bottom - top
if w <= 0 or h <= 0:
continue
buf = io.BytesIO()
im.save(buf, format="PNG")
data_url = "data:image/png;base64," + base64.b64encode(buf.getvalue()).decode()
blend_value = layer.blend_mode
try:
blend_name = BlendMode(blend_value.value if hasattr(blend_value, "value") else blend_value).name
except ValueError:
blend_name = "NORMAL"
css_blend = _CSS_BLEND_MODE_REVERSE.get(blend_name, "source-over")
layers_out.append({
"name": layer.name or "Layer",
"x": left,
"y": top,
"width": w,
"height": h,
"opacity": (layer.opacity if layer.opacity is not None else 255) / 255.0,
"visible": bool(layer.visible),
"blendMode": css_blend,
"imageData": data_url,
})
if not layers_out:
raise ValueError("No importable layers found in this PSD")
# descendants()は背面→前面(下から上)の順で返るため、
# フロントエンドのLayer配列規約(先頭=最前面)に合わせて反転する
layers_out.reverse()
return {"width": psd.width, "height": psd.height, "layers": layers_out}
def import_psd_layers(self, psd_bytes: bytes) -> dict:
"""アップロードされたPSDファイル(バイト列)をレイヤー配列(dataURL+メタデータ)に分解する。"""
try:
from psd_tools import PSDImage
except ImportError as e:
raise RuntimeError(
"psd-tools is not installed. Run: "
"python_embeded\\python.exe -m pip install psd-tools"
) from e
import io
try:
psd = PSDImage.open(io.BytesIO(psd_bytes))
except Exception as e:
raise ValueError(f"Failed to read PSD file: {e}") from e
return self._extract_psd_layers(psd)
def get_psd_layers_from_path(self, image_path: str) -> dict:
"""サーバー上に既にあるPSDファイル(Gallery上のパス)をレイヤー配列に分解する。
Galleryから直接Image Editへ送る際、アップロードの往復無しで済ませるために使う。
"""
p = Path(image_path).resolve()
if not p.is_file() or p.suffix.lower() != ".psd":
raise ValueError("Not a PSD file")
if not self._check_path_allowed(p):
raise ValueError("Access denied")
try:
from psd_tools import PSDImage
except ImportError as e:
raise RuntimeError(
"psd-tools is not installed. Run: "
"python_embeded\\python.exe -m pip install psd-tools"
) from e
try:
psd = PSDImage.open(p)
except Exception as e:
raise ValueError(f"Failed to read PSD file: {e}") from e
return self._extract_psd_layers(psd)
def serve_image(self, image_path: str):
"""画像のPathオブジェクトを返す(ルートで使用)"""
"""画像のPathオブジェクトを返す(ルートで使用)。
PSDはブラウザが直接レンダリングできないため、合成済みPNGにキャッシュ変換して返す。"""
p = Path(image_path).resolve()
if not p.is_file():
return None
@@ -1017,8 +1278,34 @@ class GalleryService:
if not self._check_path_allowed(p):
logger.warning("serve_image: path not allowed: %s", p)
return None
if p.suffix.lower() == ".psd":
return self._get_psd_composite_cache(p)
return p
def _get_psd_composite_cache(self, p: Path) -> Path | None:
"""PSDの全レイヤー合成結果をフル解像度PNGとしてディスクキャッシュし、そのPathを返す。"""
try:
mtime = int(p.stat().st_mtime * 1000)
except OSError:
return None
cache_key = hashlib.md5(f"{p}:{mtime}:full".encode()).hexdigest()
cache_dir = self.data_dir / "thumb_cache"
cache_dir.mkdir(exist_ok=True)
out_path = cache_dir / f"{cache_key}_psdfull.png"
if out_path.exists():
return out_path
try:
from psd_tools import PSDImage
psd = PSDImage.open(p)
img = psd.composite()
if img is None:
return None
img.convert("RGBA").save(out_path, "PNG")
return out_path
except Exception as e:
logger.warning("serve_image: psd composite failed for %s: %s", p, e)
return None
def serve_thumbnail(self, image_path: str, width: int = 256) -> Path | None:
"""縮小サムネイルのPathを返す。
ディスクキャッシュがあればそれを返し、なければPillowで生成して保存する。
@@ -1026,6 +1313,7 @@ class GalleryService:
Pillowが使えない場合は元ファイルにフォールバック。
MP4はPillowで開けないためPyAVで先頭フレームを抽出しJPEGとしてキャッシュする
(元ファイルへのフォールバックはできないため、失敗時はNoneを返す)。
PSDはpsd_toolsでレイヤーを合成してからJPEGとしてキャッシュする(同様にフォールバック不可)。
"""
p = Path(image_path).resolve()
if not p.is_file():
@@ -1076,6 +1364,24 @@ class GalleryService:
logger.warning("serve_thumbnail: mp4 frame extraction failed for %s: %s", p, e)
return None
# PSDはPillowで直接開けない(内部のマージ画像がPhotoshop側の実装依存で信頼できない)ため
# psd_toolsでレイヤーを正しく合成してからサムネイル化する。
if p.suffix.lower() == ".psd":
try:
from psd_tools import PSDImage
from PIL import Image
psd = PSDImage.open(p)
img = psd.composite()
if img is None:
return None
img = img.convert("RGB")
img.thumbnail((width, width), Image.LANCZOS)
img.save(thumb_path, "JPEG", quality=85, optimize=True)
return thumb_path
except Exception as e:
logger.warning("serve_thumbnail: psd composite failed for %s: %s", p, e)
return None
try:
from PIL import Image
with Image.open(p) as img:
+15
View File
@@ -5,6 +5,7 @@ import io
import logging
import sqlite3
from pathlib import Path
from typing import List
logger = logging.getLogger(__name__)
@@ -85,6 +86,20 @@ class TaggerDbService:
conn.execute("DELETE FROM images WHERE id=?", (row_id,))
conn.commit()
def delete_bulk(self, row_ids: List[int]) -> int:
if not row_ids:
return 0
placeholders = ",".join("?" for _ in row_ids)
with self._conn() as conn:
cur = conn.execute(
f"DELETE FROM images WHERE id IN ({placeholders})",
row_ids,
)
conn.commit()
return cur.rowcount
def export_csv(self) -> str:
with self._conn() as conn:
rows = conn.execute(
+32
View File
@@ -57,6 +57,38 @@ class VideoService:
save_path.write_bytes(image_bytes)
return {"filename": save_name, "subfolder": subfolder}
def probe_video(self, filename: str, subfolder: str, type_: str) -> dict:
"""Reads duration/dimensions/fps/audio presence via PyAV only (no ffmpeg
subprocess) — used by the Video Edit tab right after a clip is added, so
the timeline UI can show its length and the export-time resolution-match
check has real numbers to compare against."""
import av # type: ignore
src_path = self._resolve_media_path(filename, subfolder, type_)
container = av.open(str(src_path))
try:
stream = container.streams.video[0]
fps = float(stream.average_rate) if stream.average_rate else 0.0
if stream.duration is not None and stream.time_base is not None:
duration = float(stream.duration * stream.time_base)
elif container.duration is not None:
duration = float(container.duration) / 1_000_000
else:
duration = 0.0
width = stream.codec_context.width
height = stream.codec_context.height
has_audio = len(container.streams.audio) > 0
finally:
container.close()
return {
"duration": duration,
"width": width,
"height": height,
"fps": fps,
"has_audio": has_audio,
}
def convert_to_gif(
self,
filename: str,
+1 -1
View File
@@ -1,7 +1,7 @@
[project]
name = "comfyui-workflow-studio"
description = "A comprehensive workflow, asset management, and generation UI plugin for ComfyUI. Manage workflows, models, images, and prompts; batch generation and Image Feeder in the GenerateUI tab; library side panel with canvas drag & drop and AI tools."
version = "0.5.7"
version = "0.7.0"
license = { file = "LICENSE" }
requires-python = ">= 3.10"
dependencies = ["jinja2"]
+4
View File
@@ -23,6 +23,10 @@ piexif>=1.1.3
# -- Required to load UNSLOTH_API_KEY from a local .env file (Unsloth backend, AI TOOL tab) --
python-dotenv>=1.0,<2.0
# -- Multi-layer PSD export (Gallery tab bulk action) --
# Pure-Python, ships prebuilt wheels (no C compiler required on Windows).
psd-tools>=1.10
# -- MP4 thumbnail generation (Gallery tab) --
# Uses PyAV (av) to decode the first frame. ComfyUI core already requires av>=17.0.0,
# so it is normally pre-installed in python_embeded and no action is needed here.
+9 -3
View File
@@ -311,8 +311,8 @@
.ie-layers-header {
display: flex;
align-items: center;
gap: 2px;
flex-direction: column;
gap: 4px;
padding: 5px 6px;
border-bottom: 1px solid var(--wfm-border);
font-size: 11px;
@@ -323,7 +323,13 @@
flex-shrink: 0;
}
.ie-layers-header > span {
.ie-layers-header-row {
display: flex;
align-items: center;
gap: 2px;
}
.ie-layers-header-row > span {
flex: 1;
}
+8
View File
@@ -250,6 +250,14 @@
z-index: 1;
}
#wfm-tagger-db-th-select, td.wfm-tagger-db-select {
text-align: center;
}
#wfm-tagger-db-th-select input, .wfm-tagger-db-select input {
vertical-align: middle;
}
.wfm-tagger-db-table tbody tr {
cursor: pointer;
transition: background 0.1s;
+285 -19
View File
@@ -275,15 +275,85 @@
flex-direction: column;
}
/* ── Asset: 素材グリッド・詳細パネル ── */
/* ── Asset: 中央下部サブタブ。左=一覧(サムネイル/テーブル切替) / 右=詳細 ── */
.wfm-video-asset-content { padding: 0 16px 16px; }
.wfm-video-asset-layout {
display: flex;
gap: 16px;
align-items: flex-start;
}
.wfm-video-asset-list-col {
flex: 2;
min-width: 0;
display: flex;
flex-direction: column;
gap: 8px;
}
.wfm-video-asset-detail-col {
flex: 1;
min-width: 220px;
max-width: 320px;
border-left: 1px solid var(--wfm-border);
padding-left: 16px;
}
.wfm-video-asset-toolbar {
display: flex;
gap: 6px;
align-items: center;
flex-wrap: wrap;
}
.wfm-video-asset-view-btn.active {
background: var(--wfm-primary);
color: #fff;
}
.wfm-video-asset-grid {
display: grid;
grid-template-columns: repeat(2, 1fr);
grid-template-columns: repeat(auto-fill, minmax(110px, 1fr));
gap: 8px;
max-height: 320px;
max-height: 420px;
overflow-y: auto;
}
.wfm-video-asset-table-wrap {
max-height: 420px;
overflow-y: auto;
border: 1px solid var(--wfm-border);
border-radius: 4px;
}
.wfm-video-asset-table {
width: 100%;
border-collapse: collapse;
font-size: 12px;
}
.wfm-video-asset-table th,
.wfm-video-asset-table td {
padding: 6px 8px;
text-align: left;
border-bottom: 1px solid var(--wfm-border);
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
max-width: 240px;
}
.wfm-video-asset-table thead th {
position: sticky;
top: 0;
background: var(--wfm-bg-secondary);
}
.wfm-video-asset-row { cursor: pointer; }
.wfm-video-asset-row:hover { background: var(--wfm-bg-hover); }
.wfm-video-asset-row.selected { outline: 2px solid var(--wfm-primary); outline-offset: -2px; }
.wfm-video-asset-card {
cursor: pointer;
border: 1px solid var(--wfm-border);
@@ -315,8 +385,211 @@
display: flex;
flex-direction: column;
gap: 6px;
border-top: 1px solid var(--wfm-border);
padding-top: 10px;
}
/* ── Edit: クリップタイムライン(Planタブと同じ横トラック+共有ツールバー方式)・
トリムパネル・書き出しパネル ──
Planの.wfm-video-timeline-trackはブロックをflex-grow(duration比率)で幅一杯に
引き伸ばすのに対し、Editのブロックは実秒数×px/秒の固定幅で「左詰め」に並べる
(空きトラックはそのまま空く)ため、専用クラスに分けている。 */
.wfm-video-edit-panel { padding: 0 16px 16px; }
.wfm-video-edit-timeline-track {
display: flex;
align-items: stretch;
gap: 4px;
width: 100%;
box-sizing: border-box;
height: 48px;
padding: 4px;
border-radius: 4px;
border: 1px solid var(--wfm-border);
overflow-x: auto;
position: relative;
flex: none; /* stay a fixed-height full-width bar; never shrink/stretch with clip content */
}
.wfm-video-edit-timeline-placeholder {
display: flex;
align-items: center;
}
.wfm-video-edit-timeline-block {
flex: none;
display: flex;
flex-direction: column;
justify-content: center;
padding: 2px 6px;
border: 1px solid var(--wfm-border);
border-radius: 3px;
background: var(--wfm-bg-hover, rgba(255, 255, 255, 0.04));
cursor: grab;
overflow: hidden;
transition: outline 0.1s;
}
.wfm-video-edit-timeline-block:active { cursor: grabbing; }
.wfm-video-edit-timeline-block.selected { outline: 2px solid var(--wfm-primary); outline-offset: -2px; }
.wfm-video-edit-timeline-block-name {
font-size: 11px;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.wfm-video-edit-timeline-block-meta {
font-size: 10px;
color: var(--wfm-text-secondary);
}
.wfm-video-edit-main-row {
display: flex;
gap: 16px;
align-items: flex-start;
margin-top: 10px;
}
.wfm-video-edit-trim-panel {
flex: 1;
min-width: 0;
}
.wfm-video-edit-trim-row {
display: grid;
grid-template-columns: repeat(2, minmax(0, 160px));
gap: 10px;
}
.wfm-video-edit-trim-row label {
display: block;
font-size: 12px;
color: var(--wfm-text-secondary);
margin-bottom: 4px;
}
/* 開始/終了の入力欄+「現在位置を使用」ボタンを縦積みにする。以前は横並びで
ボタンのラベルがはみ出し、かつ入力欄とボタンの見分けがつきにくかった。 */
.wfm-video-edit-trim-field {
display: flex;
flex-direction: column;
gap: 4px;
}
.wfm-video-edit-trim-field input { width: 100%; box-sizing: border-box; }
.wfm-video-edit-playhead-btn {
align-self: flex-start;
font-size: 10px;
padding: 2px 6px;
}
.wfm-video-edit-total-duration {
font-size: 12px;
color: var(--wfm-text-secondary);
white-space: nowrap;
}
/* ── トリムスクラバー: clipchamp風の時間目盛り+シークバー+トリムハンドル。
すべて%位置指定(clip.duration基準)にすることでpx/秒換算を持たずに済ませている。 */
.wfm-video-trim-scrubber {
margin-top: 10px;
user-select: none;
}
.wfm-video-trim-ruler {
position: relative;
height: 16px;
font-size: 10px;
color: var(--wfm-text-secondary);
}
.wfm-video-trim-ruler-tick {
position: absolute;
top: 0;
transform: translateX(-50%);
white-space: nowrap;
}
.wfm-video-trim-track {
position: relative;
height: 36px;
margin-top: 4px;
background: var(--wfm-bg-hover, #111);
border: 1px solid var(--wfm-border);
border-radius: 4px;
cursor: pointer;
}
.wfm-video-trim-range {
position: absolute;
top: 0;
bottom: 0;
background: rgba(70, 130, 230, 0.3);
border-top: 2px solid var(--wfm-primary);
border-bottom: 2px solid var(--wfm-primary);
pointer-events: none;
}
.wfm-video-trim-handle {
position: absolute;
top: 0;
bottom: 0;
width: 10px;
margin-left: -5px;
background: var(--wfm-primary);
border-radius: 2px;
cursor: ew-resize;
z-index: 3;
}
.wfm-video-trim-playhead {
position: absolute;
top: -4px;
bottom: -4px;
width: 2px;
margin-left: -1px;
background: #fff;
/* Below the trim handles (z-index:3) so a handle sitting at the same
position (e.g. right after "Set from playhead") stays grabbable instead
of the playhead's hit area stealing the pointer. */
z-index: 2;
cursor: ew-resize;
}
.wfm-video-trim-playhead::before {
content: "";
position: absolute;
top: -4px;
left: 50%;
transform: translateX(-50%);
width: 10px;
height: 10px;
border-radius: 50%;
background: #fff;
}
.wfm-video-trim-badge {
position: absolute;
top: -22px;
left: 50%;
transform: translateX(-50%);
background: #111;
color: #fff;
font-size: 10px;
padding: 1px 5px;
border-radius: 3px;
white-space: nowrap;
pointer-events: none;
}
.wfm-video-trim-badge-playhead {
background: #000;
}
.wfm-video-edit-export-panel {
width: 220px;
flex: none;
}
.wfm-video-asset-detail label {
@@ -383,7 +656,7 @@
.wfm-video-preview-frame {
flex: 1;
min-width: 0;
min-height: 260px;
height: 260px;
display: flex;
align-items: center;
justify-content: center;
@@ -391,11 +664,16 @@
border-radius: 6px;
background: var(--wfm-bg-hover, #111);
text-align: center;
overflow: hidden;
}
/* ソース動画/画像のネイティブサイズがフレームより大きい場合のみ縮小し、
小さい場合は拡大しない(枠のheightを固定にしてPlan/Editの位置がずれないようにするため) */
.wfm-video-preview-el {
max-width: 100%;
max-height: 60vh;
max-height: 100%;
width: auto;
height: auto;
border-radius: 6px;
}
@@ -417,18 +695,6 @@
margin: 0 0 8px 0;
}
/* 将来の動画編集機能(トリミング等)用のプレースホルダー領域 */
.wfm-video-edit-panel {
flex: 1;
min-height: 160px;
display: flex;
align-items: center;
justify-content: center;
border: 1px dashed var(--wfm-border);
border-radius: 6px;
color: var(--wfm-text-secondary);
font-size: 13px;
}
/* ── 右ペイン: プロパティ (Frame抽出 / GIF変換タブ) ── */
.wfm-video-properties-panel {
+9
View File
@@ -245,6 +245,10 @@ function applyI18nToHtml() {
if (galleryBulkMove) galleryBulkMove.textContent = t("galleryBulkMoveTo");
const galleryBulkExport = document.getElementById("wfm-gallery-bulk-export");
if (galleryBulkExport) galleryBulkExport.textContent = t("galleryBulkExport");
const galleryBulkPsd = document.getElementById("wfm-gallery-bulk-psd");
if (galleryBulkPsd) galleryBulkPsd.textContent = t("galleryBulkPsd");
const galleryBulkEditLayers = document.getElementById("wfm-gallery-bulk-edit-layers");
if (galleryBulkEditLayers) galleryBulkEditLayers.textContent = t("galleryBulkEditLayers");
const galleryBulkDelete = document.getElementById("wfm-gallery-bulk-delete");
if (galleryBulkDelete) galleryBulkDelete.textContent = t("galleryBulkDelete");
const galleryOpenTaggerBtn = document.getElementById("wfm-gallery-open-tagger-btn");
@@ -574,6 +578,8 @@ function applyI18nToHtml() {
"wfm-help-gallery-22": "helpGallery22", "wfm-help-gallery-23": "helpGallery23",
"wfm-help-gallery-24": "helpGallery24", "wfm-help-gallery-25": "helpGallery25",
"wfm-help-gallery-26": "helpGallery26",
"wfm-help-gallery-28": "helpGallery28", "wfm-help-gallery-29": "helpGallery29",
"wfm-help-gallery-30": "helpGallery30",
"wfm-help-gallery-card-styleprompt-title": "helpGalleryCardStyleprompt",
"wfm-help-gallery-card-stylecatalog-title": "helpGalleryCardStylecatalog",
"wfm-help-tagger-title": "helpTaggerTitle",
@@ -629,6 +635,8 @@ function applyI18nToHtml() {
"wfm-help-imageedit-26": "helpImageEdit26", "wfm-help-imageedit-27": "helpImageEdit27",
"wfm-help-imageedit-28": "helpImageEdit28", "wfm-help-imageedit-29": "helpImageEdit29",
"wfm-help-imageedit-30": "helpImageEdit30",
"wfm-help-imageedit-31": "helpImageEdit31", "wfm-help-imageedit-32": "helpImageEdit32",
"wfm-help-imageedit-33": "helpImageEdit33", "wfm-help-imageedit-34": "helpImageEdit34",
"wfm-help-imageedit-7b": "helpImageEdit7b", "wfm-help-imageedit-7c": "helpImageEdit7c",
"wfm-help-imageedit-7d": "helpImageEdit7d", "wfm-help-imageedit-7e": "helpImageEdit7e",
"wfm-help-imageedit-8b": "helpImageEdit8b",
@@ -737,6 +745,7 @@ function applyI18nToHtml() {
"wfm-help-video-5": "helpVideo5", "wfm-help-video-6": "helpVideo6",
"wfm-help-video-7": "helpVideo7", "wfm-help-video-8": "helpVideo8",
"wfm-help-video-9": "helpVideo9", "wfm-help-video-10": "helpVideo10",
"wfm-help-video-11": "helpVideo11", "wfm-help-video-12": "helpVideo12",
};
for (const [id, key] of Object.entries(helpIdMap)) {
const el = document.getElementById(id);
+127 -9
View File
@@ -43,6 +43,7 @@ const API = {
imagesDelete: `/wfm/gallery/images/delete`,
imagesMove: `/wfm/gallery/images/move`,
imagesExportZip: `/wfm/gallery/images/export-zip`,
imagesExportPsd: `/wfm/gallery/images/export-psd`,
};
export const FEEDER_GROUP = "__Feeder__";
@@ -59,7 +60,7 @@ function _isReservedGroup(name) {
// 拡張子から動画ファイル(mp4)かどうかを判定する。
// 一覧アイテムは path/filename、詳細メタ(get_image_metadata)は ext フィールドを持つため両対応。
function isVideoFile(img) {
export function isVideoFile(img) {
const source = img?.ext || img?.filename || img?.path || "";
return source.toLowerCase().endsWith(".mp4");
}
@@ -232,6 +233,9 @@ window._wfmReceiveGenerateRequest = async (prompt, width, height, negative, work
const PAGE_SIZE = 50;
let _renderedCount = 0;
let _scrollObserver = null;
let _loadImagesAbortController = null;
let _searchDebounceTimer = null;
const SEARCH_DEBOUNCE_MS = 300;
// ── 状態 ─────────────────────────────────────────────────────
@@ -333,6 +337,30 @@ async function exportSelectedImagesToZip(paths) {
}
}
async function exportSelectedImagesToPsd(paths) {
if (paths.length === 0) return;
try {
const res = await fetch(API.imagesExportPsd, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ paths }),
});
if (!res.ok) throw new Error((await res.json()).error || `HTTP ${res.status}`);
const blob = await res.blob();
const url = URL.createObjectURL(blob);
const a = document.createElement("a");
a.href = url;
a.download = `gallery_export_${Date.now()}.psd`;
document.body.appendChild(a);
a.click();
document.body.removeChild(a);
URL.revokeObjectURL(url);
showToast(t("psdExportCompleted"), "success");
} catch (e) {
showToast(t("errorWithMsg", e.message), "error");
}
}
// ── フォルダツリー ────────────────────────────────────────────
function _getExpandedPaths() {
@@ -498,6 +526,16 @@ function renderTreeNode(node, container, depth, isRoot) {
async function loadImages() {
if (!state.currentFolder) return;
// 前回のリクエストがまだ処理中なら中断する。中断せず並行させると、後から
// 返ってきた古いレスポンス(例: クリア直前に打っていた検索文字列の結果)が
// 最新の表示を上書きしてしまい、「クリアしても検索結果のまま/読み込み中の
// まま」に見える不具合の原因になっていた。
if (_loadImagesAbortController) {
_loadImagesAbortController.abort();
}
const controller = new AbortController();
_loadImagesAbortController = controller;
const grid = document.getElementById("wfm-gallery-grid");
grid.innerHTML = `<p class="wfm-placeholder">${t("loading")}</p>`;
@@ -519,14 +557,19 @@ async function loadImages() {
}
try {
const images = (await apiFetch(API.images(params))).images || [];
const images = (await apiFetch(API.images(params), { signal: controller.signal })).images || [];
state.images = images;
state.lastSelectionIndex = -1;
document.getElementById("wfm-gallery-count").textContent = `${state.images.length} images`;
renderImages();
updateTagFilter(state.images);
} catch (e) {
if (e.name === "AbortError") return;
grid.innerHTML = `<p class="wfm-placeholder">Error: ${escapeHtml(e.message)}</p>`;
} finally {
if (_loadImagesAbortController === controller) {
_loadImagesAbortController = null;
}
}
}
@@ -1836,17 +1879,32 @@ function bindEvents() {
});
// 選択画像を Image Edit タブへ送信
document.getElementById("wfm-gallery-send-image-edit-btn")?.addEventListener("click", () => {
document.getElementById("wfm-gallery-send-image-edit-btn")?.addEventListener("click", async () => {
if (!state.selectedImage) {
showToast("Please select an image first", "info");
return;
}
const url = API.serveImage(state.selectedImage.path);
if (!window._wfmImageEditTab) return;
const path = state.selectedImage.path;
const name = (state.selectedImage.filename || "gallery-image").replace(/\.[^.]+$/, "");
if (window._wfmImageEditTab) {
document.querySelector('[data-tab="image-edit"]')?.click();
window._wfmImageEditTab.loadFromUrl(url, name);
// PSDはフラット画像1枚ではなくレイヤー分解して送る(Open PSDボタンと同じ経路)
if (/\.psd$/i.test(path)) {
try {
const r = await fetch(`/wfm/gallery/image/psd-layers?path=${encodeURIComponent(path)}`);
if (!r.ok) throw new Error((await r.json().catch(() => ({}))).error || r.statusText);
const data = await r.json();
document.querySelector('[data-tab="image-edit"]')?.click();
await window._wfmImageEditTab.loadPsdLayersData(data, name);
} catch (err) {
showToast(`PSD import failed: ${err.message}`, "error");
}
return;
}
const url = API.serveImage(path);
document.querySelector('[data-tab="image-edit"]')?.click();
window._wfmImageEditTab.loadFromUrl(url, name);
});
// 選択画像を GenerateUI Image タブへ送信
@@ -1928,6 +1986,7 @@ function bindEvents() {
return;
}
const url = API.serveImage(state.selectedImage.path);
const isVideo = isVideoFile(state.selectedImage);
// I2I送信元がImageタブだった場合はそちらへ画像を読み込ませる(_ccI2ITargetModeはComic Creater側が
// 「I2Iへ送る」ボタン押下時にセットするフラグ。undefined/'layout'なら従来通りコマ/オーバーレイへ挿入)
@@ -1938,6 +1997,11 @@ function bindEvents() {
targetMode = null;
}
if (targetMode === "image") {
// Imageタブは動画未対応(Comic Creator側の動画ツールはレイアウトタブのみ対応)
if (isVideo) {
showToast(t("galleryVideoNotSupportedInImageTab"), "info");
return;
}
let imageTab = null;
try {
if (window.parent && window.parent !== window && typeof window.parent._ccImageTab?.loadFromUrl === "function") {
@@ -1955,6 +2019,26 @@ function bindEvents() {
return;
}
// レイアウトタブのコマ/オーバーレイへ(デフォルト経路)。動画(.mp4)はComic Creator側の
// 動画ツール専用の受け口(insertVideoFromUrl)へ、それ以外は従来通り画像として送る
if (isVideo) {
let insertVideoFn = null;
try {
if (window.parent && window.parent !== window && typeof window.parent.insertVideoFromUrl === "function") {
insertVideoFn = window.parent.insertVideoFromUrl;
}
} catch (e) {
insertVideoFn = null;
}
if (!insertVideoFn) {
showToast(t("galleryCCNotAvailable"), "info");
return;
}
insertVideoFn(url, state.selectedImage.filename || "video.mp4");
showToast(t("gallerySentCC"), "success");
return;
}
let insertFn = null;
try {
if (window.parent && window.parent !== window && typeof window.parent.insertImageFromUrl === "function") {
@@ -1972,12 +2056,15 @@ function bindEvents() {
});
}
// 検索
// 検索(連続キー入力のたびにリクエストを飛ばすと、50枚程度のフォルダでも
// ファイルI/Oの重いサーバー処理が積み重なって読み込みが遅延するためdebounceする)
document.getElementById("wfm-gallery-search")?.addEventListener("input", (e) => {
state.search = e.target.value;
loadImages();
clearTimeout(_searchDebounceTimer);
_searchDebounceTimer = setTimeout(loadImages, SEARCH_DEBOUNCE_MS);
});
setupSearchClearBtn("wfm-gallery-search", "wfm-gallery-search-clear-btn", () => {
clearTimeout(_searchDebounceTimer);
state.search = "";
loadImages();
});
@@ -2131,6 +2218,36 @@ function bindEvents() {
exportSelectedImagesToZip([...state.selectedImages]);
});
document.getElementById("wfm-gallery-bulk-psd")?.addEventListener("click", () => {
if (state.selectedImages.size === 0) return;
exportSelectedImagesToPsd([...state.selectedImages]);
});
document.getElementById("wfm-gallery-bulk-edit-layers")?.addEventListener("click", () => {
if (state.selectedImages.size === 0) return;
if (!window._wfmImageEditTab) return;
const allPaths = [...state.selectedImages];
const paths = allPaths.filter(p => !/\.mp4$/i.test(p));
if (paths.length === 0) {
showToast(t("editLayersNoImages"), "error");
return;
}
const items = paths.map(p => {
const img = state.images.find(i => i.path === p);
const filename = img?.filename || p.split(/[\\/]/).pop() || "layer";
return { url: API.serveImage(p), name: filename.replace(/\.[^.]+$/, "") };
});
document.querySelector('[data-tab="image-edit"]')?.click();
window._wfmImageEditTab.loadLayersFromUrls(items);
if (paths.length < allPaths.length) {
showToast(t("editLayersSkippedVideo", allPaths.length - paths.length), "info");
}
});
document.getElementById("wfm-gallery-bulk-delete")?.addEventListener("click", () => {
if (state.selectedImages.size === 0) return;
const count = state.selectedImages.size;
@@ -2225,6 +2342,7 @@ function bindEvents() {
if (galleryClearBtn) {
galleryClearBtn.textContent = t("clearFilters");
galleryClearBtn.addEventListener("click", () => {
clearTimeout(_searchDebounceTimer);
state.search = "";
state.favoriteOnly = false;
state.tagFilter = "";
+178 -34
View File
@@ -586,6 +586,7 @@ const LANGUAGES = {
sendToLiNodeSuccess: (filename) => `Sent "${filename}" to LI node`,
galleryCCNotAvailable: "Open this Gallery from ComfyUI Comic Creator to use Send CC",
gallerySentCC: "Sent to ComfyUI Comic Creator",
galleryVideoNotSupportedInImageTab: "Sending a video to the Image tab is not supported yet",
galleryNoEmbeddedWorkflow: "No ComfyUI workflow embedded in this image.",
galleryTabOutput: "Output",
galleryTabImagePrompt: "ImagePrompt",
@@ -624,6 +625,8 @@ const LANGUAGES = {
galleryBulkCompare: "Compare",
galleryBulkMoveTo: "Move To...",
galleryBulkExport: "Export",
galleryBulkPsd: "Create PSD",
galleryBulkEditLayers: "Edit as Layers",
galleryBulkDelete: "Delete File",
nodesBulkSelected: "selected",
nodesBulkDeselect: "Deselect All",
@@ -636,6 +639,9 @@ const LANGUAGES = {
nodesBulkUnfavAll: "☆ Unfavorite All",
downloadStarted: "Download started",
exportCompleted: "Export completed. ZIP file is downloading.",
psdExportCompleted: "PSD created. File is downloading.",
editLayersNoImages: "No editable images in selection (video files are not supported)",
editLayersSkippedVideo: (n) => `Skipped ${n} video file(s)`,
tabAi: "AI TOOL",
tabTagger: "Tagger",
@@ -691,6 +697,9 @@ const LANGUAGES = {
taggerWrittenToFile: "Written to file",
taggerSavedToDB: "Saved to DB",
taggerSelectGalleryImage: "Select an image in the Gallery tab",
taggerDbNoSelection: "Please select rows to delete",
taggerDbDeleteConfirm: (count) => `Delete ${count} database records?`,
taggerDbDeletedCount: (count) => `${count} database records deleted`,
// -- AI Tab --
aiSubTabTranslate: "Translate",
@@ -946,17 +955,20 @@ const LANGUAGES = {
helpGallery3: "Thumbnail and Table view modes; double-click any image to open fullscreen lightbox",
helpGallery4: "Toolbar filters: favorites (★), text search (filename / tag / prompt), tag filter, group filter, sort by date/name",
helpGallery5: "Folder tree: click to load images, expand with ▶; '+ New' creates a subfolder inside the selected folder, 'Del' deletes it with all contents",
helpGallery6: "Multi-select: Ctrl+click to toggle individual images; Shift+click to range-select from the last clicked item — bulk bar: select group → 'Add to Group' / 'Remove from Group'; 'Favorite All' / 'Unfavorite All'; 'Compare' (2–4 images); 'Move To...'; 'Delete File'",
helpGallery6: "Multi-select: Ctrl+click to toggle individual images; Shift+click to range-select from the last clicked item — bulk bar: select group → 'Add to Group' / 'Remove from Group'; 'Favorite All' / 'Unfavorite All'; 'Compare' (2–4 images); 'Move To...'; 'Export' (downloads all selected images as a ZIP file); 'Create PSD' (combines the selected images into one layered PSD file); 'Edit as Layers' (opens the selected images in the Image Edit tab, each as its own layer); 'Delete File'",
helpGallery7: "Detail panel — Info tab: filename, size, dimensions (image width×height) or video duration, date, tags (add/remove), memo; 'Move To...' moves the image to another folder, 'Delete File' removes it permanently",
helpGallery8: "Detail panel — JSON tab: displays workflow JSON from PNG embedded data (prompt / workflow keys) or from metadata saved by the Generate UI tab; 'Copy & Send Canvas' button copies to clipboard and sends the workflow directly to the ComfyUI canvas (requires Workflow Studio to be opened from the ComfyUI toolbar; UI-format only falls back to title drag if opened from a bookmark)",
helpGallery9: "Detail panel — Groups tab: create, assign, remove, rename, and delete groups per image",
helpGallery10: "Workflow auto-save: images generated in the Generate UI tab automatically have their workflow saved to gallery metadata and shown in the JSON tab",
helpGallery11: "Supports PNG (tEXt/iTXt), JPEG, WebP, GIF, MP4; workflow extraction reads ComfyUI prompt/workflow keys embedded in PNG metadata or in MP4 container tags (as written by SaveVideo, e.g. MiniMax H3 output)",
helpGallery11: "Supports PNG (tEXt/iTXt), JPEG, WebP, GIF, MP4, PSD; workflow extraction reads ComfyUI prompt/workflow keys embedded in PNG metadata or in MP4 container tags (as written by SaveVideo, e.g. MiniMax H3 output)",
helpGallery28: "Create PSD bulk button: combines all selected images into a single layered PSD file and downloads it — each image becomes its own layer (named after the file), positioned top-left on a canvas sized to the largest selected image; the last selected image ends up on top",
helpGallery29: "Edit as Layers bulk button: switches to the Image Edit tab and opens all selected images at once, each as an independent layer (video files in the selection are skipped); the last selected image ends up on top",
helpGallery30: "PSD files: thumbnails and full-size previews show all layers merged together (hidden layers excluded); the underlying PSD file itself is left untouched — only the preview shown in Gallery is a flattened rendering",
helpGallery12: "Metadata button (green, in the detail panel tab bar): opens the selected image in the Metadata tab for full embedded-data inspection; Alt+click on any image thumbnail has the same effect",
helpGallery13: "Load GenUI button (blue, in the detail panel tab bar): loads the embedded ComfyUI workflow from the selected image directly into the GenerateUI tab and switches to it; shows a warning toast if no workflow is embedded or the format is not supported",
helpGallery14: "Tagger button (purple, in the detail panel action row): opens the selected image directly in the Tagger tab's Single mode for instant tagging",
helpGallery15: "F button (cyan overlay, top-left of each thumbnail): toggle the image in/out of the __Feeder__ group with a single click; cyan and always visible when in group, visible on hover only when not; quickly queue images for the Feeder tab Gallery mode",
helpGallery16: "Image Edit button (toolbar, next to Refresh): sends the currently selected image to the Image Edit tab; if layers already exist the image is added as a new layer scaled to fit the canvas, otherwise it becomes Layer 1",
helpGallery16: "Image Edit button (toolbar, next to Refresh): sends the currently selected image to the Image Edit tab; if layers already exist the image is added as a new layer scaled to fit the canvas, otherwise it becomes Layer 1; PSD files are fully decomposed into their original layers instead of being flattened into one image",
helpGallery17: "Send GenUI Image button (toolbar, next to Image Edit): uploads the selected image to ComfyUI and sets it as the input for the first LoadImage node in the GenerateUI tab; automatically switches to GenerateUI → Input → Image; requires a workflow with at least one LoadImage node to be loaded first",
helpGallery27: "Send to LI node button (toolbar, next to Send GenUI Image): uploads the selected image and writes its filename into the image widget of the currently selected node on the ComfyUI canvas (falling back to the first LoadImage-type node found) — same destination as Image Edit tab's Send to LI node; requires Workflow Studio to have been opened from ComfyUI's top menu button",
helpGallery18: "Second sub-tab next to Output (top of the Gallery tab) for browsing a visual prompt library — manages the ws_image_prompt folder inside the ComfyUI output directory (created automatically)",
@@ -1078,7 +1090,9 @@ const LANGUAGES = {
helpTroubleCardTagger: "Tagger & Model Issues",
helpImageEditTitle: "Image Edit Tab",
helpImageEdit1: "Layer-based image editor — compose images with multiple layers (Image, Text, Draw, Mask types) and export the composite",
helpImageEdit2: "Loading images: drag & drop onto the canvas, Upload button, or send from the Gallery tab via the Image Edit button in the Gallery toolbar; the first image becomes Layer 1 (auto-locked); subsequent images are added as new layers scaled to fit the canvas",
helpImageEdit2: "Loading images: drag & drop onto the canvas, File Open button, or send from the Gallery tab via the Image Edit button in the Gallery toolbar; the first image becomes Layer 1 (auto-locked); subsequent images are added as new layers scaled to fit the canvas",
helpImageEdit31: "Open PSD button (next to File Open): loads a layered PSD file from disk and decomposes it into individual layers — position, size, visibility, opacity, and blend mode are restored for each layer; groups and non-raster layers (adjustment layers, etc.) are flattened into their rendered appearance",
helpImageEdit32: "Close button (next to Open PSD): closes the current document after a confirmation prompt, discarding all layers and unsaved edits and returning to the empty placeholder view",
helpImageEdit3: "New button: create a blank canvas — prompts for WxH size (e.g. 512x768); clears all existing layers and automatically adds an empty Layer 1",
helpImageEditToolsTitle: "Tools",
helpImageEdit4: "Select (V): click to select a layer; drag to move; drag corner handles to resize; drag the circle above the top edge to rotate; double-click a text layer to re-edit its content; Tool Options bar shows Flip H / Flip V / Rotate field",
@@ -1090,7 +1104,6 @@ const LANGUAGES = {
helpImageEdit9: "👁 / 🚫 button: toggle layer visibility",
helpImageEdit10: "🔒 / 🔓 button: toggle layer lock — a locked layer cannot be moved, resized, or rotated (orange bounding box is shown); Layer 1 is locked automatically when the first image is loaded to prevent accidental moves",
helpImageEdit11: "Opacity slider at the bottom adjusts the active layer's transparency",
helpImageEdit12: "Type icons: 🖼 = image layer, T = text layer, ✏ = draw layer",
helpImageEdit13: "Delete key: removes the selected layer (only when 2+ layers exist)",
helpImageEditTextTitle: "Text Object Quality",
helpImageEdit14: "Text layers are sized exactly to the measured text bounding box — no extra whitespace",
@@ -1099,6 +1112,7 @@ const LANGUAGES = {
helpImageEditExportTitle: "Export & Navigation",
helpImageEdit17: "Save PNG: composites all visible layers and downloads the result as a PNG file",
helpImageEdit18: "Save to Gallery: prompts for a filename (default: wfs-image-YYYYMMDDHHmmss) and saves the composite PNG directly to the Gallery root folder (configured in Settings > Gallery Output Folder); requires the Gallery tab to have been opened at least once to set the root",
helpImageEdit34: "Save PSD: downloads a layered PSD file with every layer preserved separately — position, rotation, flip, and scale are baked into each layer's pixels (PSD layers cannot store a rotation angle), while opacity, blend mode, and visibility are kept as real, editable PSD layer attributes; clipping masks are merged into their target layer since PSD's native layer-mask mechanism is not used",
helpImageEdit19b: "Send to LI node: uploads the composite PNG to ComfyUI's input folder via /upload/image and writes the resulting filename into the image widget of the currently selected node in the ComfyUI graph, falling back to the first LoadImage-type node found; requires Workflow Studio to have been opened from ComfyUI's top menu button so the ComfyUI tab is reachable",
helpImageEdit20: "Canvas navigation: scroll wheel to zoom, Space + drag to pan",
helpImageEdit21: "Undo / Redo: Ctrl+Z / Ctrl+Y (or toolbar buttons ↩ ↪)",
@@ -1114,12 +1128,13 @@ const LANGUAGES = {
helpImageEdit30: "Double-click (Select tool on text layer): Re-edit text",
helpImageEdit7b: "Blur (≈): apply Gaussian blur or mosaic to the active layer — whole-layer or region-based (drag a rectangle); see the Blur Tool card below for details",
helpImageEdit7c: "BG Remove (⬚): remove the background from the active layer using Lightweight (@imgly, runs in browser) or BiRefNet (requires Mask Editor One + birefnet.safetensors in ComfyUI/models/background_removal/); see the BG Remove Tool card below for details",
helpImageEdit7d: "Mask (🎭): paint masks on a mask layer using 6 sub-tools — Paint (freehand), Color (flood-select by similar color), Alpha (extract from image transparency), Text (stamp text), Vector (Catmull-Rom spline polygon), Shape (rect / ellipse); SAM3 text-prompt segmentation is also available when Mask Editor One is installed; click \"M\" in the Layers header to add a mask layer; see the Mask Tool card below for details",
helpImageEdit7d: "Mask (🎭): paint masks on a mask layer using 6 sub-tools — Paint (freehand), Color (flood-select by similar color), Alpha (extract from image transparency), Text (stamp text), Vector (Catmull-Rom spline polygon), Shape (rect / ellipse); SAM3 text-prompt segmentation is also available when Mask Editor One is installed; click \"Mask\" (second row of the Layers header) to add a mask layer; see the Mask Tool card below for details",
helpImageEdit7e: "Inpaint (🩹): composites the visible layers plus a Mask layer into one RGBA image (mask baked into the alpha channel) and applies it to the first inpaint-capable LoadImage node in the workflow currently loaded in GenerateUI (a node whose MASK output feeds something like VAEEncodeForInpaint); enter Positive/Negative prompts, Grow Mask By (applied to the VAE Encode (for Inpainting) node), and Denoise (applied to KSampler) in the properties panel, then click Run to upload and generate without leaving the Image Edit tab — the result is shown back in the properties panel when done; requires a Mask layer to be painted first and an inpaint-capable workflow loaded in GenerateUI; also works with workflows built around the Mask Editor One custom node (comfyui-mask-editor-one) instead of LoadImage — image/mask are pushed to it via its node_id-keyed server cache and layer_data widget; \"Use dedicated workflow\" checkbox: when off, the workflow currently loaded in GenerateUI is used (unchanged); when on, pick a saved workflow from the dropdown — it is loaded, edited, and generated entirely in the background without disturbing the workflow shown in GenerateUI",
helpImageEdit8b: "\"M\" button in the Layers header: adds a new mask layer above the current layer and automatically switches to the Mask tool",
helpImageEdit8b: "The Layers header has two rows: the top row has +, ⧉ (Duplicate), −, ↑, ↓; the \"Mask\" button sits alone on the second row — it adds a new mask layer above the current layer and automatically switches to the Mask tool",
helpImageEdit33: "⧉ (Duplicate layer) button: copies the active layer — including its pixels, position, size, opacity, blend mode, and visibility — and inserts the copy directly above the original as the new active layer; works on any layer type (image, draw, text, mask)",
helpImageEdit12: "Type icons: 🖼 = image layer, T = text layer, ✏ = draw layer, ⬚ = mask layer",
helpImageEditMaskTitle: "Mask Tool (🎭)",
helpImageEditMask1: "Add a mask layer: click the \"M\" button in the Layers panel header; the new mask layer is inserted above the active layer and the Mask tool activates automatically",
helpImageEditMask1: "Add a mask layer: click the \"Mask\" button on the second row of the Layers panel header; the new mask layer is inserted above the active layer and the Mask tool activates automatically",
helpImageEditMask2: "Clicking a mask layer in the layer list automatically switches to the Mask tool",
helpImageEditMask3: "Tool Options bar — sub-tools: Paint / Color / Alpha / Text / Vector / Shape (all work without Mask Editor One) / SAM3 (requires Mask Editor One, disabled if not installed); Invert checkbox inverts the overlay preview; Overlay color picker changes the preview color (default red); Blur slider (0–50 px) softens the overlay edge; the overlay is only shown for the currently active mask layer — inactive mask layers stay hidden until selected",
helpImageEditMask4: "Properties pane — Paint mode: Mode (Add / Erase), Size (1–200 px), Hardness (0–100%); MASK EDITOR ONE section (always visible — header text is green when ABR brushes are available, gray when none are imported yet): Select button opens the ABR brush library (disabled until at least one brush exists) — choosing a brush replaces the default circle brush; ✕ clears the brush back to Circle; when an image brush is active, Hardness is disabled and additional controls appear: Spacing (stamp interval 5–100%), Angle (rotation 0–359°), Sz Jitter (random size reduction per stamp 0–100%), Rot. Jitter (random rotation per stamp on/off)",
@@ -1330,7 +1345,37 @@ const LANGUAGES = {
// -- Video Tab (MiniMax H3 / LTX-2.5 / Wan2.2, independent of GenerateUI) --
tabVideo: "Video",
loadInVideo: "Load in Video",
videoEditPlaceholder: "Editing tools coming soon",
videoEditNoClipsHint: "No clips yet — select an Asset or drop a video into Video Source above, then \"Add to Edit\"",
videoEditNoClips: "Add at least one clip first",
videoEditStillProbing: "Please wait for clip analysis to finish",
videoEditResolutionMismatch: (a, b) => `Clip resolutions don't match (${a} vs ${b}). Trim/crop to the same size before exporting.`,
videoEditProbing: "Analyzing...",
videoEditSelectClipHint: "Select a clip to trim",
videoEditImageDuration: "Duration (s)",
videoEditTrimStart: "Start (s)",
videoEditTrimEnd: "End (s)",
videoEditSetFromPlayhead: "Use current position",
videoEditMoveLeft: "Move left",
videoEditMoveRight: "Move right",
videoEditClearBtn: "Clear",
videoEditTotalDuration: (time) => `Total: ${time}`,
videoEditPreviewPlay: "▶ Preview",
videoEditPreviewStop: "■ Stop",
videoEditConfirmClear: "Clear the entire edit timeline?",
videoSourceAddToEdit: "Add to Edit",
videoEditDuplicate: "Duplicate",
videoEditDelete: "Delete",
videoEditExportBtn: "Export",
videoEditExporting: "Exporting...",
videoEditExportDone: (name) => `Exported: ${name}`,
videoEditSendToEdit: "Send to Edit",
videoEditClipSent: (name) => `Added "${name}" to Edit timeline`,
videoAssetSetAsFirst: "Set as First Image",
videoAssetSetAsLast: "Set as Last Image",
videoAssetSetAsFirstDone: (name) => `Set "${name}" as First Image`,
videoAssetSetAsLastDone: (name) => `Set "${name}" as Last Image`,
videoNoBlockSelected: "No block selected in Plan",
videoBlockImageUploadFailed: "Failed to upload image to Plan block",
videoNoWorkflowLoaded: "No workflow loaded",
videoUnsupportedWorkflow: "This workflow does not contain a supported video model node (MiniMax H3, LTX-2.5 Text/Image/First&Last-Frame to Video, or Wan2.2 Text to Video)",
videoWorkflowLoadFailed: "Failed to load workflow",
@@ -1375,17 +1420,19 @@ const LANGUAGES = {
videoProjectDeleteFailed: "Failed to delete plan",
videoProjectLoadListFailed: "Failed to load plan list",
helpVideoTitle: "Video Tab",
helpVideoDesc: "A dedicated video generation tab for MiniMax H3 (Image to Video), LTX-2.5 (Text / Image / First & Last Frame to Video), and Wan2.2 (Text to Video) workflows, independent of the GenerateUI tab. The center panel's Plan / Edit subtabs handle batch generation and (future) editing; the sidebar's Asset / Project subtabs handle browsing generated videos and saved plans.",
helpVideoDesc: "A dedicated video generation tab for MiniMax H3 (Image to Video), LTX-2.5 (Text / Image / First & Last Frame to Video), and Wan2.2 (Text to Video) workflows, independent of the GenerateUI tab. The center panel's Plan / Edit / Asset subtabs handle batch generation, clip editing, and browsing generated videos; the sidebar's Project subtab handles saved plans.",
helpVideo1: "Plan subtab: the topbar's settings row holds Aspect Ratio / Megapixels / Multiple / Duration (seconds) / Noise Seed as this plan's base settings — Duration always reflects the currently selected block (each block keeps its own value), the rest are plan-wide. A second row below adds Width / Height / Turbo Mode / Strength / Steps / Prompt Enhance, each enabled only for workflows that actually support it (see helpVideo2). Split the timeline into blocks with the + Split / + Block / Delete buttons — each block has its own Prompt, Duration, and First/Last Image — First Image can be None, an explicit image, or \"use previous block's last frame\" (an explicit Last Image on the previous block always wins over extracting one from its generated video). Click Run to generate every block in order; Pause/Cancel work mid-run.",
helpVideo2: "A plan with a single block behaves exactly like the old one-shot form. Model selection (UNet / CLIP / VAE / Audio VAE) is fixed to the loaded workflow's defaults. For workflows with no ResolutionSelector node (e.g. Wan2.2, LTX-2.5 First & Last Frame to Video), the Aspect Ratio / Megapixels / Multiple fields are disabled and the workflow's own Width / Height become directly editable instead. Turbo Mode / Strength / Steps only apply to MiniMax H3's turbo LoRA, and Prompt Enhance only to LTX-2.5 — both stay disabled for other model families. Noise Seed is disabled for the one workflow that doesn't expose it: Wan2.2 Text-to-Video.",
helpVideo3: "Use the \"Load in Video\" button in the Workflow tab's detail modal to load a workflow containing a MiniMax H3 Image-to-Video node, an LTX-2.5 Text/Image/First&Last-Frame-to-Video node, or a Wan2.2 Text-to-Video node — this starts a fresh single-block plan seeded from the workflow's own current values. Unsupported workflows show an error instead.",
helpVideo4: "Generated videos (mp4) automatically appear in the Asset subtab's Video Temp group, and can also be browsed and played back in the Gallery tab. Organizing keepers into Video Assets is entirely up to you, on your own schedule.",
helpVideo5: "The center panel shows two previews: the left one shows either the video you select in the Asset subtab or whatever you drop/pick in the Video Source panel on its left (Clear resets it to empty), letting you use the Frame/GIF tools without running the loaded video workflow first; the right one always shows the most recently generated clip.",
helpVideo6: "Frame tab (right panel): play/seek the preview video to the position you want, click Capture Frame to grab that frame client-side, then Save to Output to write it as a PNG into ComfyUI's output folder.",
helpVideo6: "Frame tab (right panel): play/seek the preview video to the position you want, click Capture Frame to grab that frame client-side, then Save to Output to write it as a PNG into ComfyUI's output folder — check \"Add to Video Assets group\" first to also tag the saved frame into Gallery's Video Assets group.",
helpVideo7: "GIF tab (right panel): set Start/End (seconds), FPS, and an optional Max Width, then Convert to GIF — the server decodes the video and encodes an animated GIF into ComfyUI's output folder.",
helpVideo8: "Chaining: setting a block's First Image to \"use previous block's last frame\" continues smoothly from the previous clip — if that previous block has its own explicit Last Image, that image is used directly; otherwise the actual last frame of its generated video is extracted automatically.",
helpVideo9: "Project tab (sidebar, next to Asset): browse every saved plan file (thumbnail, block count, last updated), click one to load it into the Plan editor, or delete it with the × button; clicking the same tab again collapses the panel.",
helpVideo9: "Project tab (sidebar): browse every saved plan file (thumbnail, block count, last updated), click one to load it into the Plan editor, or delete it with the × button; clicking the same tab again collapses the panel.",
helpVideo10: "Highlight color: the Prompt / Duration / First Image / Last Image / Aspect Ratio / Megapixels / Multiple / Noise Seed / Width / Height / Turbo Mode / Strength / Steps / Prompt Enhance labels turn the same highlight color as the GenerateUI Model tab (customizable in the Settings tab) when the loaded workflow actually supports that field — e.g. for a Wan2.2 workflow (no ResolutionSelector node), the Aspect Ratio / Megapixels / Multiple labels stay unhighlighted while Width / Height light up instead.",
helpVideo11: "Edit subtab: a lightweight clip timeline for trimming and concatenating video/image clips outside of generation. Add clips via the Video Source panel's \"Add to Edit\" button or the Asset subtab's \"Send to Edit\" button, then drag blocks to reorder (or use the ◀/▶ toolbar buttons), Duplicate/Delete the selected clip, and Clear to empty the timeline. The trim panel for the selected video clip shows a time ruler, a draggable playhead synced to the Source preview, and draggable in/out handles with time badges — image clips instead get a simple hold-duration field. ▶ Preview plays every ready clip back-to-back (trimmed to its in/out points) in the right-hand result preview; Export builds and runs the actual ComfyUI graph (trim → concatenate if more than one clip → save), tagging the result into the Video Temp group automatically. Exporting more than one clip currently drops audio, since ComfyUI's concatenation node requires uniform audio across all inputs.",
helpVideo12: "Asset subtab (center panel, next to Plan/Edit): browses every video/image tagged into Video Assets or Video Temp (via the group dropdown, or \"All Video Assets\" for both). Search filters by filename; the ▦/☰ buttons switch between a thumbnail grid and a table (filename/updated/tags). Selecting an item shows its tags/memo, loads it into the center preview, and offers \"Send to Edit\" (queues it as a clip in the Edit subtab) plus, for images only, \"Set as First Image\"/\"Set as Last Image\" (uploads it straight into the currently-selected Plan block, switching to the Plan subtab).",
},
ja: {
@@ -1968,6 +2015,7 @@ const LANGUAGES = {
sendToLiNodeSuccess: (filename) => `"${filename}" をLIノードへ送信しました`,
galleryCCNotAvailable: "Send CCはComfyUI Comic Creator内のギャラリーから開いた場合のみ使用できます",
gallerySentCC: "ComfyUI Comic Creatorへ送信しました",
galleryVideoNotSupportedInImageTab: "動画のImageタブへの送信は未対応です",
galleryNoEmbeddedWorkflow: "この画像にはComfyUIワークフローが埋め込まれていません。",
galleryTabOutput: "Output",
galleryTabImagePrompt: "ImagePrompt",
@@ -2006,6 +2054,8 @@ const LANGUAGES = {
galleryBulkCompare: "比較",
galleryBulkMoveTo: "移動先...",
galleryBulkExport: "エクスポート",
galleryBulkPsd: "PSD作成",
galleryBulkEditLayers: "レイヤーとして編集",
galleryBulkDelete: "ファイル削除",
nodesBulkSelected: "件選択中",
nodesBulkDeselect: "選択解除",
@@ -2018,6 +2068,9 @@ const LANGUAGES = {
nodesBulkUnfavAll: "☆ お気に入り解除(全件)",
downloadStarted: "ダウンロード開始",
exportCompleted: "エクスポート完了。ZIPファイルをダウンロード中です。",
psdExportCompleted: "PSDを作成しました。ファイルをダウンロード中です。",
editLayersNoImages: "選択範囲に編集可能な画像がありません(動画ファイルは非対応)",
editLayersSkippedVideo: (n) => `動画ファイルを${n}件スキップしました`,
tabAi: "AI TOOL",
tabTagger: "Tagger",
@@ -2073,6 +2126,9 @@ const LANGUAGES = {
taggerWrittenToFile: "ファイルに書き込みました",
taggerSavedToDB: "DBに保存しました",
taggerSelectGalleryImage: "Galleryタブで画像を選択してください",
taggerDbNoSelection: "削除する行を選択してください",
taggerDbDeleteConfirm: (count) => `${count}件のDBレコードを削除しますか?`,
taggerDbDeletedCount: (count) => `${count}件のDBレコードを削除しました`,
// -- AI Tab --
aiSubTabTranslate: "翻訳",
@@ -2328,17 +2384,20 @@ const LANGUAGES = {
helpGallery3: "サムネイル・テーブル表示モード切替;ダブルクリックで全画面ライトボックス表示",
helpGallery4: "ツールバーフィルタ:お気に入り(★)、テキスト検索(ファイル名・タグ・プロンプト)、タグフィルタ、グループフィルタ、日付・名前ソート",
helpGallery5: "フォルダツリー:クリックで画像を読み込み;▶で展開;「+ New」で選択フォルダ内にサブフォルダを作成;「Del」でそのフォルダとすべての内容を削除",
helpGallery6: "複数選択:Ctrl+クリックで個別トグル;Shift+クリックで最後にクリックした位置から範囲選択 — 一括操作バー:グループを選択して「グループに追加」/「グループから削除」;「お気に入り追加(全件)」/「お気に入り解除(全件)」;「比較」(2〜4枚選択時);「移動先...」;「ファイル削除」",
helpGallery6: "複数選択:Ctrl+クリックで個別トグル;Shift+クリックで最後にクリックした位置から範囲選択 — 一括操作バー:グループを選択して「グループに追加」/「グループから削除」;「お気に入り追加(全件)」/「お気に入り解除(全件)」;「比較」(2〜4枚選択時);「移動先...」;「エクスポート」(選択画像をZIPファイルとしてダウンロード);「PSD作成」(選択画像を1つのレイヤー付きPSDファイルにまとめる);「レイヤーとして編集」(選択画像をImage Editタブで各画像を独立レイヤーとして開く);「ファイル削除」",
helpGallery7: "詳細パネル — Infoタブ:ファイル名、サイズ、寸法(画像は幅×高さ、動画は再生時間)、日付、タグ(追加/削除)、メモ;「Move To...」で他フォルダへ移動;「ファイル削除」で完全削除",
helpGallery8: "詳細パネル — JSONタブ:PNGの埋め込みデータ(prompt / workflow キー)またはGenerateUIタブで保存したメタデータからワークフローJSONを表示;「Copy & Send Canvas」ボタンでクリップボードにコピーしてComfyUIキャンバスへ直接送信(UI形式・API形式どちらも対応);ComfyUIツールバーから開いていない場合はUI形式のみタイトルドラッグのフォールバック",
helpGallery9: "詳細パネル — Groupsタブ:画像ごとのグループ作成、割り当て、解除、名前変更、削除",
helpGallery10: "ワークフロー自動保存:GenerateUIタブで生成した画像はワークフローが自動でギャラリーメタデータに保存され、JSONタブで確認可能",
helpGallery11: "PNG (tEXt/iTXt)、JPEG、WebP、GIF、MP4対応;PNG形式はComfyUIの埋め込みJSON(prompt / workflow キー)、MP4形式はSaveVideoが書き込むコンテナタグ(同キー、MiniMax H3出力等)からワークフロー抽出が可能",
helpGallery11: "PNG (tEXt/iTXt)、JPEG、WebP、GIF、MP4、PSD対応;PNG形式はComfyUIの埋め込みJSON(prompt / workflow キー)、MP4形式はSaveVideoが書き込むコンテナタグ(同キー、MiniMax H3出力等)からワークフロー抽出が可能",
helpGallery28: "「PSD作成」一括操作ボタン:選択中の全画像を1つのレイヤー付きPSDファイルにまとめてダウンロードする — 各画像はファイル名を冠した独立レイヤーとなり、選択画像中の最大サイズに合わせたキャンバスに左上基準で配置される;最後に選択した画像が最前面になる",
helpGallery29: "「レイヤーとして編集」一括操作ボタン:Image Editタブに切り替え、選択中の全画像を一度に開き、それぞれ独立したレイヤーとして展開する(選択中に動画ファイルが含まれる場合はスキップされる);最後に選択した画像が最前面になる",
helpGallery30: "PSDファイル:サムネイル・フルサイズプレビューは全レイヤーを合成した結果を表示する(非表示レイヤーは除外される);元のPSDファイル自体は変更されず、Gallery上のプレビューのみが合成済みの表示になる",
helpGallery12: "Metadataボタン(緑、詳細パネルのタブバー内):選択画像をMetadataタブで開いて埋め込みデータを詳細確認。画像サムネイルのAlt+クリックでも同じ操作が可能",
helpGallery13: "Load GenUIボタン(青、詳細パネルのタブバー内):選択画像に埋め込まれたComfyUIワークフローをGenerateUIタブへ直接読み込んで切り替え。ワークフローが埋め込まれていない場合や非対応形式の場合は警告トーストを表示",
helpGallery14: "Taggerボタン(紫、詳細パネルのアクション行):選択画像をTaggerタブのSingleモードで直接開き、即座にタグ付けを開始できる",
helpGallery15: "Fボタン(シアン色オーバーレイ、各サムネイル左上):クリック一つで画像を __Feeder__ グループに追加/削除;グループ内の場合は常にシアン色で表示、非グループ時はホバー時のみ表示;FeederタブのGalleryモードへ素早く画像を追加できる",
helpGallery16: "Image Editボタン(ツールバー、Refreshボタン横):選択中の画像をImage Editタブに送信;既にレイヤーが存在する場合はキャンバスに合わせてスケールして新規レイヤーとして追加、存在しない場合はLayer 1になる",
helpGallery16: "Image Editボタン(ツールバー、Refreshボタン横):選択中の画像をImage Editタブに送信;既にレイヤーが存在する場合はキャンバスに合わせてスケールして新規レイヤーとして追加、存在しない場合はLayer 1になる;PSDファイルの場合は1枚に統合せず元のレイヤー構成のまま完全に分解して開く",
helpGallery17: "Send GenUI Imageボタン(ツールバー、Image Editボタン横):選択画像をComfyUIにアップロードし、GenerateUIタブの最初のLoadImageノードへ入力として設定;GenerateUI → Input → Imageへ自動切り替え;事前にLoadImageノードを含むワークフローの読み込みが必要",
helpGallery27: "Send to LI nodeボタン(ツールバー、Send GenUI Imageボタン横):選択画像をアップロードし、そのファイル名をComfyUIキャンバス上で選択中のノード(無ければ最初に見つかったLoadImage系ノード)のimageウィジェットへ書き込む — Image EditタブのSend to LI nodeと同じ送信先;ComfyUIのトップメニューボタンからWorkflow Studioを起動している必要がある",
helpGallery18: "GalleryタブのOutputと並ぶ2つ目のサブタブ。視覚的なプロンプトライブラリを閲覧できる — ComfyUI outputフォルダ内のws_image_promptフォルダを管理(未作成時は自動生成)",
@@ -2348,6 +2407,7 @@ const LANGUAGES = {
helpGallery22: "Galleryタブ先頭にある3つ目のサブタブ。登録済みStyleをプレビュー画像から視覚的に選べる — ComfyUI outputフォルダ内のws_style_catalogフォルダを管理(未作成時は自動生成)。GenerateUIタブの「カタログ作成」ボタンで生成される(GenerateUIタブのヘルプ参照)",
helpGallery23: "同じ3カラムレイアウト:フォルダツリー(左)|サムネイル一覧(中央)|Positive/Negativeプロンプトパネル(右)。サムネイルクリックで、その生成画像に実際に埋め込まれているPositive/Negativeプロンプトを表示、それぞれ個別のCopyボタン付き",
helpGallery24: "Select as Styleボタン:選択中の画像のファイル名(拡張子除く)と同名の登録済みStyleを探し、GenerateUIタブのStyleドロップダウンをそれに切り替える — 既存Styleシステムへの視覚的なショートカットであり、埋め込みプロンプトをその場限りで適用するものではない(カタログ画像作成後にStyleがリネーム・削除されていた場合は「一致するスタイルが見つかりません」トーストを表示)",
helpGallery25: "Load in GenerateUI / Open in Metadata Tabボタン:カタログ画像自体に埋め込まれたワークフロー(カタログのコピーは元の出力画像と同じPNGメタデータを保持している)を読み取り、GenerateUIエディタへ直接読み込むか、Metadataタブで画像を開いて確認できる — Outputフォルダ内で元ファイルを探す必要がない",
helpGallery26: "Galleryタブ上部の4つのサブタブ:Output(このブラウザ)・ImagePrompt・Style_Catalog・Metadata — 最後のMetadataは独立したMetadataタブ(該当ヘルプページ参照)をそのまま内包しているため、Galleryを離れずに画像をドロップして埋め込みモデル/プロンプト情報を確認できます",
// -- Tagger Tab --
@@ -2459,7 +2519,9 @@ const LANGUAGES = {
helpTroubleCardTagger: "Tagger・モデルの問題",
helpImageEditTitle: "Image Edit タブ",
helpImageEdit1: "レイヤーベースの画像エディタ — 複数のレイヤー(画像・テキスト・描画・マスク)を重ね合わせて画像を合成・エクスポート",
helpImageEdit2: "画像の読み込み:キャンバスへのドラッグ&ドロップ、Uploadボタン、またはGalleryタブのImage Editボタンから送信;最初の画像はLayer 1として自動ロック;以降の画像はキャンバスサイズに合わせてスケールされ新規レイヤーとして追加",
helpImageEdit2: "画像の読み込み:キャンバスへのドラッグ&ドロップ、File Openボタン、またはGalleryタブのImage Editボタンから送信;最初の画像はLayer 1として自動ロック;以降の画像はキャンバスサイズに合わせてスケールされ新規レイヤーとして追加",
helpImageEdit31: "Open PSDボタン(File Openの隣):ディスク上のレイヤー付きPSDファイルを読み込み、各レイヤーに分解する — 位置・サイズ・表示状態・不透明度・ブレンドモードはレイヤーごとに復元される;グループやラスタ化できないレイヤー(調整レイヤー等)はその見た目のままフラット化される",
helpImageEdit32: "Closeボタン(Open PSDの隣):確認ダイアログの後、現在のドキュメントを閉じる — 全レイヤーと未保存の変更を破棄し、空のプレースホルダー表示に戻る",
helpImageEdit3: "Newボタン:空白キャンバスを作成 — W×Hサイズを入力(例: 512x768);既存レイヤーは全て削除し、空のLayer 1を自動追加",
helpImageEditToolsTitle: "ツール",
helpImageEdit4: "Select (V):クリックでレイヤーを選択、ドラッグで移動、コーナーハンドルでリサイズ、上辺の円ハンドルで回転;テキストレイヤーをダブルクリックすると再編集可能;ツールオプションバーにFlip H / Flip V / 回転角度入力を表示",
@@ -2480,6 +2542,7 @@ const LANGUAGES = {
helpImageEditExportTitle: "エクスポートとナビゲーション",
helpImageEdit17: "Save PNG:全可視レイヤーを合成してPNGファイルとしてダウンロード",
helpImageEdit18: "Save to Gallery:ファイル名を入力(デフォルト: wfs-image-YYYYMMDDHHmmss)してギャラリーのルートフォルダに合成PNGを保存(設定 > Gallery Output Folderで設定);Galleryタブを一度開いてルートフォルダを設定する必要あり",
helpImageEdit34: "Save PSD:全レイヤーを個別に保持したPSDファイルをダウンロードする — 位置・回転・反転・拡縮は各レイヤーのピクセルにベイクされる(PSDのレイヤーは回転角度を保持できないため)一方、不透明度・ブレンドモード・表示状態は編集可能な実際のPSDレイヤー属性として保持される;クリッピングマスクはPSD本来のレイヤーマスク機構を使わないため、対象レイヤーと合成した状態で書き出される",
helpImageEdit19b: "Send to LI node:合成PNGをComfyUIのinputフォルダに /upload/image でアップロードし、さらにそのファイル名をComfyUIグラフ内で選択中のノード(無ければ最初に見つかったLoadImage系ノード)のimageウィジェットへ書き込む;ComfyUIのトップメニューボタンからWorkflow Studioを起動している必要がある",
helpImageEdit20: "キャンバスナビゲーション:スクロールホイールでズーム、Space + ドラッグでパン",
helpImageEdit21: "Undo / Redo:Ctrl+Z / Ctrl+Y(またはツールバーの ↩ ↪ ボタン)",
@@ -2495,11 +2558,12 @@ const LANGUAGES = {
helpImageEdit30: "ダブルクリック(Selectツールでテキストレイヤー):テキストを再編集",
helpImageEdit7b: "Blur (≈):アクティブレイヤーにガウスぼかしまたはモザイクを適用 — 全体またはドラッグで矩形範囲指定;詳細は下の「Blur Tool」カードを参照",
helpImageEdit7c: "BG Remove (⬚):Lightweight(@imgly、ブラウザ内処理)またはBiRefNet(Mask Editor One + ComfyUI/models/background_removal/にbirefnet.safetensors必須)でアクティブレイヤーの背景を除去;詳細は下の「BG Remove Tool」カードを参照",
helpImageEdit7d: "Mask (🎭):6つのサブツールでマスクレイヤーにマスクを描画 — Paint(フリーハンド)・Color(色類似度フラッドセレクト)・Alpha(画像の透過チャンネル抽出)・Text(テキストスタンプ)・Vector(Catmull-Romスプライン多角形)・Shape(矩形/楕円);Mask Editor OneインストールでSAM3テキストプロンプトセグメンテーションも利用可能;レイヤーヘッダーの「M」でマスクレイヤーを追加;詳細は下の「Mask Tool」カードを参照",
helpImageEdit7d: "Mask (🎭):6つのサブツールでマスクレイヤーにマスクを描画 — Paint(フリーハンド)・Color(色類似度フラッドセレクト)・Alpha(画像の透過チャンネル抽出)・Text(テキストスタンプ)・Vector(Catmull-Romスプライン多角形)・Shape(矩形/楕円);Mask Editor OneインストールでSAM3テキストプロンプトセグメンテーションも利用可能;レイヤーヘッダー2段目の「Mask」ボタンでマスクレイヤーを追加;詳細は下の「Mask Tool」カードを参照",
helpImageEdit7e: "Inpaint (🩹):表示中のレイヤーとマスクレイヤーを1枚のRGBA画像に合成(マスクをアルファチャンネルに焼き込み)し、GenerateUIで読み込み中のワークフロー内でインペイント対応の最初のLoadImageノード(MASK出力がVAEEncodeForInpaint等に接続されているノード)へ適用;プロパティパネルでポジ/ネガプロンプト、Grow Mask By(VAE Encode (for Inpainting)ノードへ反映)、Denoise(KSamplerへ反映)を入力してRunを押すと、Image Editタブに留まったままアップロード・生成を実行;完了後は結果画像がプロパティパネルに表示される;事前にマスクレイヤーの描画とインペイント対応ワークフローの読み込みが必要;LoadImageの代わりにMask Editor Oneカスタムノード(comfyui-mask-editor-one)を使ったワークフローにも対応(node_idキーのサーバーキャッシュとlayer_dataウィジェット経由で画像/マスクを反映);「Use dedicated workflow」チェックボックス:OFF時はGenerateUIで読み込み中のワークフローを使用(従来通り)、ON時はドロップダウンから保存済みワークフローを選択すると、GenerateUIの表示状態には触れずバックグラウンドで読み込み・編集・生成を実行",
helpImageEdit8b: "レイヤーヘッダーの「M」ボタン:アクティブレイヤーの上に新しいマスクレイヤーを追加し、自動的にMaskツールに切り替える",
helpImageEdit8b: "レイヤーヘッダーは2段構成:1段目に +、⧉(複製)、−、↑、↓;2段目には「Mask」ボタンのみを配置 — アクティブレイヤーの上に新しいマスクレイヤーを追加し、自動的にMaskツールに切り替える",
helpImageEdit33: "⧉(レイヤー複製)ボタン:アクティブレイヤーをピクセル・位置・サイズ・不透明度・ブレンドモード・表示状態ごと複製し、元のレイヤーの直前(重なり順で1つ上)に新しいアクティブレイヤーとして挿入する;画像・描画・テキスト・マスクいずれのレイヤー種別でも動作する",
helpImageEditMaskTitle: "Mask ツール (🎭)",
helpImageEditMask1: "マスクレイヤーの追加:レイヤーパネルヘッダーの「M」ボタンをクリック;新しいマスクレイヤーはアクティブレイヤーの上に挿入され、Maskツールが自動的に有効化される",
helpImageEditMask1: "マスクレイヤーの追加:レイヤーパネルヘッダー2段目の「Mask」ボタンをクリック;新しいマスクレイヤーはアクティブレイヤーの上に挿入され、Maskツールが自動的に有効化される",
helpImageEditMask2: "レイヤーリストでマスクレイヤーをクリックすると自動的にMaskツールに切り替わる",
helpImageEditMask3: "ツールオプションバー — サブツール:Paint / Color / Alpha / Text / Vector / Shape(全てMask Editor One不要)/ SAM3(Mask Editor One必須・未インストール時は無効);Invertチェックボックスでオーバーレイプレビューを反転;Overlayカラーピッカーでプレビューカラーを変更(デフォルト赤);Blurスライダー(0〜50 px)でオーバーレイ輪郭をぼかす;オーバーレイは選択中(アクティブ)のマスクレイヤーのみ表示され、非アクティブなマスクは選択するまで非表示",
helpImageEditMask4: "プロパティペイン — Paintモード:Mode(Add / Erase)・Size(1〜200 px)・Hardness(0〜100%);MASK EDITOR ONEセクション(常時表示 — ABRブラシが利用可能な場合は見出しが緑、未インポートの場合はグレー):Selectボタンでブラシピッカーを開く(ブラシが1つも無い間は無効)(選択したブラシがデフォルト円形に代わる);✕でCircle(デフォルト)に戻す;画像ブラシ選択中はHardnessが無効になり追加コントロールが表示:Spacing(スタンプ間隔 5〜100%)・Angle(回転角 0〜359°)・Sz Jitter(スタンプごとのサイズランダム変動 0〜100%)・Rot. Jitter(スタンプごとの角度ランダム変動 on/off)",
@@ -2710,7 +2774,37 @@ const LANGUAGES = {
// -- Video タブ(MiniMax H3 / LTX-2.5 / Wan2.2対応、GenerateUIタブとは独立) --
tabVideo: "Video",
loadInVideo: "Videoに読み込み",
videoEditPlaceholder: "編集機能は今後追加予定",
videoEditNoClipsHint: "クリップがありません — 上の動画ソースでAssetを選択/動画をドロップし「Editに追加」してください",
videoEditNoClips: "まずクリップを1つ以上追加してください",
videoEditStillProbing: "クリップの解析が完了するまでお待ちください",
videoEditResolutionMismatch: (a, b) => `クリップの解像度が一致しません(${a} と ${b})。書き出し前に同じサイズにトリム/クロップしてください。`,
videoEditProbing: "解析中...",
videoEditSelectClipHint: "トリムするクリップを選択してください",
videoEditImageDuration: "表示時間(秒)",
videoEditTrimStart: "開始(秒)",
videoEditTrimEnd: "終了(秒)",
videoEditSetFromPlayhead: "現在位置を使用",
videoEditMoveLeft: "左へ移動",
videoEditMoveRight: "右へ移動",
videoEditClearBtn: "クリア",
videoEditTotalDuration: (time) => `合計: ${time}`,
videoEditPreviewPlay: "▶ プレビュー",
videoEditPreviewStop: "■ 停止",
videoEditConfirmClear: "編集タイムラインを全てクリアしますか?",
videoSourceAddToEdit: "Editに追加",
videoEditDuplicate: "複製",
videoEditDelete: "削除",
videoEditExportBtn: "書き出し",
videoEditExporting: "書き出し中...",
videoEditExportDone: (name) => `書き出し完了: ${name}`,
videoEditSendToEdit: "Editへ送る",
videoEditClipSent: (name) => `"${name}" をEditタイムラインに追加しました`,
videoAssetSetAsFirst: "First Imageに設定",
videoAssetSetAsLast: "Last Imageに設定",
videoAssetSetAsFirstDone: (name) => `"${name}" をFirst Imageに設定しました`,
videoAssetSetAsLastDone: (name) => `"${name}" をLast Imageに設定しました`,
videoNoBlockSelected: "Planでブロックが選択されていません",
videoBlockImageUploadFailed: "Planブロックへの画像アップロードに失敗しました",
videoNoWorkflowLoaded: "ワークフローが読み込まれていません",
videoUnsupportedWorkflow: "このワークフローには対応する動画モデルノード(MiniMax H3、LTX-2.5のText/Image/First&Last-Frame to Video、またはWan2.2のText to Video)が含まれていません",
videoWorkflowLoadFailed: "ワークフローの読み込みに失敗しました",
@@ -2755,17 +2849,19 @@ const LANGUAGES = {
videoProjectDeleteFailed: "Planの削除に失敗しました",
videoProjectLoadListFailed: "Plan一覧の読み込みに失敗しました",
helpVideoTitle: "Video タブ",
helpVideoDesc: "MiniMax H3 (Image to Video)、LTX-2.5 (Text / Image / First & Last Frame to Video)、Wan2.2 (Text to Video) ワークフロー対応の動画生成タブ。GenerateUIタブとは独立して動作します。中央パネルのPlan/Editサブタブがバッチ生成と(将来の)編集を、左サイドバーのAsset/Projectサブタブが生成済み動画の閲覧と保存済みPlanの一覧を扱います。",
helpVideoDesc: "MiniMax H3 (Image to Video)、LTX-2.5 (Text / Image / First & Last Frame to Video)、Wan2.2 (Text to Video) ワークフロー対応の動画生成タブ。GenerateUIタブとは独立して動作します。中央パネルのPlan/Edit/Assetサブタブがバッチ生成・クリップ編集・生成済み動画の閲覧を、左サイドバーのProjectサブタブが保存済みPlanの一覧を扱います。",
helpVideo1: "Planサブタブ: 上部の設定行にAspect Ratio/Megapixels/Multiple/Duration(秒)/Noise SeedがこのPlanの基本設定として並びます——Durationは常に現在選択中のブロックの値を表示・編集します(各ブロックが独自の値を持つ)が、それ以外はPlan全体で共通の値です。その下の2行目にはWidth/Height/Turbo Mode/Strength/Steps/Prompt Enhanceが並び、読み込んだワークフローが実際に対応する項目だけ入力可能になります(詳細はhelpVideo2)。「+ Split」「+ Block」「Delete」ボタンでタイムラインをブロックに分割すると、各ブロックは独自のPrompt・Duration・First/Last Imageを持ちます(First Imageは「なし」「画像を指定」「前ブロックの最終フレームを使用」から選択可能。前ブロックに明示的なLast Imageが設定されていれば、フレーム抽出よりそちらが優先されます)。Runを押すと全ブロックを順番に生成します。実行中もPause/Cancelが使えます。",
helpVideo2: "ブロックが1個だけのPlanは、以前の単発生成フォームと同じ動作になります。モデル選択(UNet/CLIP/VAE/Audio VAE)は読み込んだワークフローの既定値に固定されます。ResolutionSelectorノードを持たないワークフロー(Wan2.2、LTX-2.5のFirst & Last Frame to Videoなど)はAspect Ratio/Megapixels/Multiple欄が無効化される代わりに、ワークフロー自体のWidth/Heightを直接編集できるようになります。Turbo Mode/Strength/StepsはMiniMax H3のturbo LoRA専用、Prompt EnhanceはLTX-2.5専用で、他のモデルファミリーでは無効のままです。Noise SeedはWan2.2のText to Videoのみ公開入力を持たないため無効化されます。",
helpVideo3: "Workflowタブの詳細モーダルにある「Videoに読み込み」ボタンから、MiniMax H3のImage to Videoノード、LTX-2.5のText/Image/First&Last-Frame to Videoノード、またはWan2.2のText to Videoノードを含むワークフローを読み込めます。この操作でワークフローの現在値を反映したブロック1個の新規Planが作成されます。対応していないワークフローはエラー表示になります。",
helpVideo4: "生成した動画(mp4)はAssetサブタブのVideo Tempグループに自動的に反映されるほか、Galleryタブでも閲覧・再生できます。残したい動画をVideo Assetsへ整理するタイミングはユーザー任意です。",
helpVideo5: "中央パネルには2つのプレビューがあります。左側はAssetサブタブで選択した動画、または左隣の「Video Source」パネルにドロップ/選択した任意のローカル動画を表示し(Clearでリセット)、読み込んだワークフローを実行せずにFrame/GIF機能を使えます。右側は常に直近で生成されたクリップを表示します。",
helpVideo6: "Frameタブ(右パネル): プレビュー動画を再生・シークして止めたい位置で「Capture Frame」を押すとその場でフレームをキャプチャし、「Save to Output」でPNGとしてComfyUIのOutputフォルダに保存します。",
helpVideo6: "Frameタブ(右パネル): プレビュー動画を再生・シークして止めたい位置で「Capture Frame」を押すとその場でフレームをキャプチャし、「Save to Output」でPNGとしてComfyUIのOutputフォルダに保存します。保存前に「Add to Video Assets group」にチェックを入れると、保存したフレームをGalleryのVideo Assetsグループにも自動登録できます。",
helpVideo7: "GIFタブ(右パネル): Start/End(秒)・FPS・Max Width(任意)を指定して「Convert to GIF」を押すと、サーバー側で動画をデコードしアニメーションGIFとしてComfyUIのOutputフォルダに保存します。",
helpVideo8: "チェイン機能: ブロックのFirst Imageを「前ブロックの最終フレームを使用」に設定すると、前のクリップから連続した映像になります。前ブロックに明示的なLast Imageが設定されていればそれがそのまま使われ、無ければ生成された動画から実際の最終フレームが自動抽出されます。",
helpVideo9: "Projectタブ(左サイドバー、Assetの隣): 保存済みの全Planファイル(サムネイル・ブロック数・更新日時)を一覧表示し、クリックでPlanエディタへ読み込み、×ボタンで削除できます。同じタブをもう一度押すとパネルを閉じます。",
helpVideo9: "Projectタブ(左サイドバー): 保存済みの全Planファイル(サムネイル・ブロック数・更新日時)を一覧表示し、クリックでPlanエディタへ読み込み、×ボタンで削除できます。同じタブをもう一度押すとパネルを閉じます。",
helpVideo10: "ハイライト表示: 読み込んだワークフローが実際にサポートしているフィールドに応じて、Prompt/Duration/First Image/Last Image/Aspect Ratio/Megapixels/Multiple/Noise Seed/Width/Height/Turbo Mode/Strength/Steps/Prompt Enhanceのラベルが、GenerateUI ModelタブのハイライトとSettingsタブで共通設定できる色に変わります。例えばWan2.2ワークフロー(ResolutionSelectorノードが無い)ではAspect Ratio/Megapixels/Multipleはハイライトされない代わりに、Width/Heightがハイライトされます。",
helpVideo11: "Editサブタブ: 生成とは独立して動画/画像クリップをトリム・結合できる簡易タイムラインです。Video Sourceパネルの「Editに追加」ボタン、またはAssetサブタブの「Editへ送る」ボタンでクリップを追加し、ブロックをドラッグ(または◀/▶ツールバーボタン)で並べ替え、選択中クリップをDuplicate/Delete、Clearでタイムラインを空にできます。選択中の動画クリップのトリムパネルには時間目盛り・Sourceプレビューと同期するドラッグ可能な再生ヘッド・時刻バッジ付きのドラッグ可能なイン/アウトハンドルが表示されます(画像クリップは代わりにシンプルな保持時間の入力欄)。「▶ プレビュー」は準備済みの全クリップをイン/アウト点でトリムして右側の結果プレビューで連続再生し、「書き出し」は実際のComfyUIグラフ(トリム→2クリップ以上ならConcatenate→保存)を構築・実行して、結果をVideo Tempグループへ自動登録します。複数クリップの書き出しは現状音声が失われます(ComfyUIの結合ノードが全入力で音声形式の統一を要求するため)。",
helpVideo12: "Assetサブタブ(中央パネル、Plan/Editの隣): グループ切替(または「All Video Assets」で両方まとめて)でVideo AssetsまたはVideo Tempに登録された動画/画像を一覧表示します。検索欄はファイル名でフィルタし、▦/☰ボタンでサムネイルグリッドとテーブル表示(ファイル名・更新日時・タグ)を切り替えられます。項目を選択するとタグ・メモが表示され中央プレビューに読み込まれ、「Editへ送る」(Editサブタブのクリップとして追加)に加え、画像の場合のみ「First Imageに設定」「Last Imageに設定」(選択中のPlanブロックへ直接アップロードし、Planサブタブへ切り替え)が使えます。",
},
zh: {
@@ -3348,6 +3444,7 @@ const LANGUAGES = {
sendToLiNodeSuccess: (filename) => `已将"${filename}"发送到LI节点`,
galleryCCNotAvailable: "仅当从ComfyUI Comic Creator内的图库打开时才能使用Send CC",
gallerySentCC: "已发送至ComfyUI Comic Creator",
galleryVideoNotSupportedInImageTab: "暂不支持将视频发送到Image标签",
galleryNoEmbeddedWorkflow: "此图像中未嵌入ComfyUI工作流。",
galleryTabOutput: "Output",
galleryTabImagePrompt: "ImagePrompt",
@@ -3386,6 +3483,8 @@ const LANGUAGES = {
galleryBulkCompare: "对比",
galleryBulkMoveTo: "移动到...",
galleryBulkExport: "导出",
galleryBulkPsd: "创建PSD",
galleryBulkEditLayers: "作为图层编辑",
galleryBulkDelete: "删除文件",
nodesBulkSelected: "项已选择",
nodesBulkDeselect: "取消全选",
@@ -3398,6 +3497,9 @@ const LANGUAGES = {
nodesBulkUnfavAll: "☆ 全部取消收藏",
downloadStarted: "下载开始",
exportCompleted: "导出完成。正在下载 ZIP 文件。",
psdExportCompleted: "PSD 已创建。正在下载文件。",
editLayersNoImages: "所选内容中没有可编辑的图片(不支持视频文件)",
editLayersSkippedVideo: (n) => `已跳过 ${n} 个视频文件`,
tabAi: "AI TOOL",
tabTagger: "Tagger",
@@ -3453,6 +3555,9 @@ const LANGUAGES = {
taggerWrittenToFile: "已写入文件",
taggerSavedToDB: "已保存到DB",
taggerSelectGalleryImage: "请在图库标签中选择图像",
taggerDbNoSelection: "请选择要删除的行",
taggerDbDeleteConfirm: (count) => `确定要删除 ${count} 条数据库记录吗?`,
taggerDbDeletedCount: (count) => `已删除 ${count} 条数据库记录`,
// -- AI Tab --
aiSubTabTranslate: "翻译",
@@ -3708,17 +3813,20 @@ const LANGUAGES = {
helpGallery3: "缩略图和表格视图模式;双击任何图像可在全屏灯箱中打开",
helpGallery4: "工具栏过滤器:收藏 (★)、文本搜索(文件名・标签・提示词)、标签过滤、分组过滤、按日期/名称排序",
helpGallery5: "文件夹树:点击加载图像,▶展开;'+ New'在选定文件夹内创建子文件夹;'Del'删除该文件夹及其所有内容",
helpGallery6: "多选:Ctrl+点击切换单张图像;Shift+点击从上次点击位置进行范围选择 — 批量操作栏:选择分组 → 「添加到分组」/「从分组中删除」;全部收藏/取消收藏;「对比」(2–4张);移动到...;删除文件",
helpGallery6: "多选:Ctrl+点击切换单张图像;Shift+点击从上次点击位置进行范围选择 — 批量操作栏:选择分组 → 「添加到分组」/「从分组中删除」;全部收藏/取消收藏;「对比」(2–4张);移动到...;「导出」(将所选图像下载为ZIP文件);「创建PSD」(将所选图像合并为一个带图层的PSD文件);「作为图层编辑」(在Image Edit标签中打开所选图像,每张作为独立图层);删除文件",
helpGallery7: "详情面板 — 信息(Info)标签:文件名、大小、尺寸(图片为宽×高,视频为时长)、日期、标签(添加/移除)、备注;'移动到...'将图像移至另一文件夹;'删除文件'永久删除",
helpGallery8: "详情面板 — JSON标签:显示来自PNG嵌入数据(prompt / workflow键)或Generate UI标签保存的工作流JSON;「Copy & Send Canvas」按钮将工作流复制到剪贴板并直接发送到ComfyUI画布(UI和API格式均支持);若Workflow Studio不是从ComfyUI工具栏打开,UI格式将回退到标题拖拽",
helpGallery9: "详情面板 — 分组(Groups)标签:对每个图像进行组的创建、分配、移除、重命名和删除",
helpGallery10: "工作流自动保存:在Generate UI标签生成的图像,其工作流会自动保存到图库元数据,并在JSON标签中显示",
helpGallery11: "支持PNG(tEXt/iTXt)、JPEG、WebP、GIF、MP4;PNG格式读取ComfyUI嵌入的JSON(prompt / workflow键)提取工作流,MP4格式读取SaveVideo写入的容器标签(同名键,如MiniMax H3输出)",
helpGallery11: "支持PNG(tEXt/iTXt)、JPEG、WebP、GIF、MP4、PSD;PNG格式读取ComfyUI嵌入的JSON(prompt / workflow键)提取工作流,MP4格式读取SaveVideo写入的容器标签(同名键,如MiniMax H3输出)",
helpGallery28: "「创建PSD」批量操作按钮:将所有选中的图像合并为一个带图层的PSD文件并下载 — 每张图像成为独立图层(以文件名命名),以左上对齐方式放置在按所选最大图像尺寸创建的画布上;最后选中的图像位于最上层",
helpGallery29: "「作为图层编辑」批量操作按钮:切换到Image Edit标签并一次性打开所有选中的图像,每张作为独立图层(所选内容中的视频文件会被跳过);最后选中的图像位于最上层",
helpGallery30: "PSD文件:缩略图与完整预览显示所有图层合并后的效果(隐藏图层不参与合并);原始PSD文件本身不会被修改,Gallery中显示的仅是合并渲染后的预览",
helpGallery12: "Metadata按钮(绿色,位于详情面板标签栏):在Metadata标签中打开所选图像以全面查看嵌入数据;Alt+点击任意图像缩略图效果相同",
helpGallery13: "Load GenUI按钮(蓝色,位于详情面板标签栏):将所选图像中嵌入的ComfyUI工作流直接加载到GenerateUI标签并切换过去;如果没有嵌入工作流或格式不受支持,则显示警告提示",
helpGallery14: "Tagger按钮(紫色,位于详情面板操作行):将所选图像直接在Tagger标签的Single模式中打开,即可立即进行标注",
helpGallery15: "F按钮(青色悬浮按钮,每个缩略图左上角):单击即可将图像添加到/从__Feeder__组中移除;图像在组中时始终显示青色,不在组中时仅悬停时可见;可快速为Feeder标签Gallery模式添加队列图像",
helpGallery16: "Image Edit按钮(工具栏,Refresh按钮旁):将当前选中的图像发送到Image Edit标签;如果已有图层则按比例缩放添加为新图层,否则将成为Layer 1",
helpGallery16: "Image Edit按钮(工具栏,Refresh按钮旁):将当前选中的图像发送到Image Edit标签;如果已有图层则按比例缩放添加为新图层,否则将成为Layer 1;PSD文件会完整分解为原始图层,而不是合并为一张图像",
helpGallery17: "Send GenUI Image按钮(工具栏,Image Edit按钮旁):将选中图像上传至ComfyUI并设置为GenerateUI标签中第一个LoadImage节点的输入;自动切换至GenerateUI → Input → Image;需要预先加载包含至少一个LoadImage节点的工作流",
helpGallery27: "Send to LI node按钮(工具栏,Send GenUI Image按钮旁):上传选中图像并将其文件名写入ComfyUI画布上当前选中节点(若无选中节点则回退到找到的第一个LoadImage类节点)的image部件 — 与Image Edit标签的Send to LI node发送到同一目标;需要通过ComfyUI顶部菜单按钮打开Workflow Studio",
helpGallery18: "Gallery标签页中与Output并列的第二个子标签,用于浏览可视化提示词库 — 管理ComfyUI output文件夹内的ws_image_prompt文件夹(未创建时自动生成)",
@@ -3840,7 +3948,9 @@ const LANGUAGES = {
helpTroubleCardTagger: "Tagger 与模型问题",
helpImageEditTitle: "图像编辑选项卡",
helpImageEdit1: "基于图层的图像编辑器 — 通过多个图层(图像、文字、绘制、遮罩类型)合成图像并导出",
helpImageEdit2: "加载图像:拖放到画布、点击Upload按钮、或通过Gallery标签工具栏的Image Edit按钮发送;第一张图像成为图层1(自动锁定);后续图像缩放至画布大小作为新图层添加",
helpImageEdit2: "加载图像:拖放到画布、点击File Open按钮、或通过Gallery标签工具栏的Image Edit按钮发送;第一张图像成为图层1(自动锁定);后续图像缩放至画布大小作为新图层添加",
helpImageEdit31: "Open PSD按钮(File Open旁):从磁盘加载带图层的PSD文件并分解为各个图层 — 每个图层的位置、尺寸、可见性、不透明度和混合模式都会被还原;分组和无法栅格化的图层(调整图层等)将按其渲染外观扁平化",
helpImageEdit32: "Close按钮(Open PSD旁):在确认提示后关闭当前文档,丢弃所有图层和未保存的修改,返回空白占位视图",
helpImageEdit3: "New按钮:创建空白画布 — 输入宽高(如512x768);清除所有现有图层并自动添加空白Layer 1",
helpImageEditToolsTitle: "工具",
helpImageEdit4: "Select (V):点击选择图层;拖动移动;拖动角点手柄调整大小;拖动顶边圆形手柄旋转;双击文字图层可重新编辑;工具选项栏显示翻转H / 翻转V / 旋转角度",
@@ -3861,6 +3971,7 @@ const LANGUAGES = {
helpImageEditExportTitle: "导出与导航",
helpImageEdit17: "Save PNG:合并所有可见图层并下载为PNG文件",
helpImageEdit18: "Save to Gallery:输入文件名(默认:wfs-image-YYYYMMDDHHmmss)将合成PNG保存到Gallery根文件夹(在设置 > Gallery Output Folder中配置);需要至少打开过一次Gallery标签以设置根目录",
helpImageEdit34: "Save PSD:下载一个保留每个图层独立信息的PSD文件 — 位置、旋转、翻转和缩放会被烘焙进各图层的像素中(因为PSD图层无法保存旋转角度),而不透明度、混合模式和可见性则作为可编辑的真实PSD图层属性保留;由于未使用PSD原生的图层蒙版机制,剪贴蒙版会与其目标图层合并后导出",
helpImageEdit19b: "Send to LI node:通过 /upload/image 将合成PNG上传到ComfyUI的输入文件夹,并将上传结果的文件名写入 ComfyUI 图中当前选中节点(若无选中节点则回退到找到的第一个 LoadImage 类节点)的 image 部件;需要通过 ComfyUI 顶部菜单按钮打开 Workflow Studio",
helpImageEdit20: "画布导航:滚轮缩放,Space+拖动平移",
helpImageEdit21: "撤销/重做:Ctrl+Z / Ctrl+Y(或工具栏的 ↩ ↪ 按钮)",
@@ -3876,11 +3987,12 @@ const LANGUAGES = {
helpImageEdit30: "双击(Select工具点击文字图层):重新编辑文字",
helpImageEdit7b: "Blur (≈):对活动图层应用高斯模糊或马赛克 — 整层或拖动矩形区域;详细内容参见下方「Blur Tool」卡片",
helpImageEdit7c: "BG Remove (⬚):使用Lightweight(@imgly,在浏览器中运行)或BiRefNet(需要Mask Editor One + ComfyUI/models/background_removal/中的birefnet.safetensors)去除活动图层背景;详细内容参见下方「BG Remove Tool」卡片",
helpImageEdit7d: "Mask (🎭):使用6种子工具在遮罩图层上绘制遮罩 — Paint(徒手绘制)、Color(按颜色相似度泛选)、Alpha(从图像透明度提取)、Text(文字图章)、Vector(Catmull-Rom样条多边形)、Shape(矩形/椭圆);安装Mask Editor One后还可使用SAM3文本提示分割;点击图层标题栏的「M」添加遮罩图层;详细内容参见下方「Mask Tool」卡片",
helpImageEdit7d: "Mask (🎭):使用6种子工具在遮罩图层上绘制遮罩 — Paint(徒手绘制)、Color(按颜色相似度泛选)、Alpha(从图像透明度提取)、Text(文字图章)、Vector(Catmull-Rom样条多边形)、Shape(矩形/椭圆);安装Mask Editor One后还可使用SAM3文本提示分割;点击图层标题栏第二行的「Mask」按钮添加遮罩图层;详细内容参见下方「Mask Tool」卡片",
helpImageEdit7e: "Inpaint (🩹):将可见图层与遮罩图层合成为一张RGBA图像(遮罩烘焙进alpha通道),并应用到GenerateUI当前加载的工作流中第一个支持内绘的LoadImage节点(其MASK输出连接到VAEEncodeForInpaint等节点);在属性面板中输入正/负向提示词、Grow Mask By(应用到VAE Encode (for Inpainting)节点)、Denoise(应用到KSampler)后点击Run,即可在不离开Image Edit标签的情况下完成上传与生成;完成后结果图像会显示在属性面板中;需先绘制遮罩图层并在GenerateUI中加载支持内绘的工作流;同样支持基于Mask Editor One自定义节点(comfyui-mask-editor-one)而非LoadImage构建的工作流(通过其按node_id缓存的服务端图像与layer_data组件写入图像/遮罩);「Use dedicated workflow」复选框:关闭时使用GenerateUI当前加载的工作流(与之前相同);开启时可从下拉列表选择已保存的工作流,将在后台加载、编辑并生成,不影响GenerateUI中显示的工作流",
helpImageEdit8b: "图层标题栏的「M」按钮:在当前活动图层上方添加新的遮罩图层,并自动切换至Mask工具",
helpImageEdit8b: "图层标题栏分为两行:第一行为 +、⧉(复制)、−、↑、↓;第二行单独放置「Mask」按钮 — 在当前活动图层上方添加新的遮罩图层,并自动切换至Mask工具",
helpImageEdit33: "⧉(复制图层)按钮:复制活动图层——包括像素、位置、尺寸、不透明度、混合模式和可见性——并将副本作为新的活动图层插入到原图层的正上方;适用于任意图层类型(图像、绘制、文字、遮罩)",
helpImageEditMaskTitle: "Mask 工具 (🎭)",
helpImageEditMask1: "添加遮罩图层:点击图层面板标题栏的「M」按钮;新遮罩图层插入到活动图层上方,Mask工具自动激活",
helpImageEditMask1: "添加遮罩图层:点击图层面板标题栏第二行的「Mask」按钮;新遮罩图层插入到活动图层上方,Mask工具自动激活",
helpImageEditMask2: "在图层列表中点击遮罩图层会自动切换至Mask工具",
helpImageEditMask3: "顶部工具栏 — 子工具:Paint / Color / Alpha / Text / Vector / Shape(均无需Mask Editor One)/ SAM3(需要Mask Editor One,未安装时不可用);Invert复选框反转叠加预览;Overlay拾色器更改预览颜色(默认红色);Blur滑块(0–50 px)柔化叠加边缘;叠加显示仅在当前激活的蒙版图层上显示,未激活的蒙版图层在被选中前保持隐藏",
helpImageEditMask4: "属性面板 — Paint模式:Mode(Add / Erase)、Size(1–200 px)、Hardness(0–100%);MASK EDITOR ONE区域(始终显示 — 有可用的ABR笔刷时标题为绿色,尚未导入笔刷时为灰色):Select按钮打开ABR笔刷库(没有任何笔刷时禁用) — 选择笔刷将替换默认圆形笔刷;✕恢复Circle(默认);选择图像笔刷后Hardness禁用,并显示额外控件:Spacing(印章间距 5–100%)、Angle(旋转角度 0–359°)、Sz Jitter(每个印章的随机大小变化 0–100%)、Rot. Jitter(每个印章的随机旋转 on/off)",
@@ -4091,7 +4203,37 @@ const LANGUAGES = {
// -- Video 标签页(支持 MiniMax H3 / LTX-2.5 / Wan2.2,独立于 GenerateUI) --
tabVideo: "Video",
loadInVideo: "加载到Video",
videoEditPlaceholder: "编辑功能即将推出",
videoEditNoClipsHint: "暂无片段 — 请在上方选择素材或拖放视频后点击“添加到Edit”",
videoEditNoClips: "请先添加至少一个片段",
videoEditStillProbing: "请等待片段分析完成",
videoEditResolutionMismatch: (a, b) => `片段分辨率不一致(${a} 与 ${b})。导出前请裁剪为相同尺寸。`,
videoEditProbing: "分析中...",
videoEditSelectClipHint: "选择一个片段进行裁剪",
videoEditImageDuration: "显示时长(秒)",
videoEditTrimStart: "开始(秒)",
videoEditTrimEnd: "结束(秒)",
videoEditSetFromPlayhead: "使用当前位置",
videoEditMoveLeft: "左移",
videoEditMoveRight: "右移",
videoEditClearBtn: "清空",
videoEditTotalDuration: (time) => `总计: ${time}`,
videoEditPreviewPlay: "▶ 预览",
videoEditPreviewStop: "■ 停止",
videoEditConfirmClear: "确定清空整个编辑时间线吗?",
videoSourceAddToEdit: "添加到Edit",
videoEditDuplicate: "复制",
videoEditDelete: "删除",
videoEditExportBtn: "导出",
videoEditExporting: "导出中...",
videoEditExportDone: (name) => `已导出: ${name}`,
videoEditSendToEdit: "发送到Edit",
videoEditClipSent: (name) => `已将 "${name}" 添加到Edit时间线`,
videoAssetSetAsFirst: "设为First Image",
videoAssetSetAsLast: "设为Last Image",
videoAssetSetAsFirstDone: (name) => `已将 "${name}" 设为First Image`,
videoAssetSetAsLastDone: (name) => `已将 "${name}" 设为Last Image`,
videoNoBlockSelected: "Plan中未选择区块",
videoBlockImageUploadFailed: "上传图片到Plan区块失败",
videoNoWorkflowLoaded: "尚未加载工作流",
videoUnsupportedWorkflow: "该工作流不包含受支持的视频模型节点(MiniMax H3、LTX-2.5 的 Text/Image/First&Last-Frame to Video,或 Wan2.2 的 Text to Video)",
videoWorkflowLoadFailed: "工作流加载失败",
@@ -4136,17 +4278,19 @@ const LANGUAGES = {
videoProjectDeleteFailed: "Plan 删除失败",
videoProjectLoadListFailed: "Plan 列表加载失败",
helpVideoTitle: "Video 标签页",
helpVideoDesc: "支持 MiniMax H3(Image to Video)、LTX-2.5(Text / Image / First & Last Frame to Video)、Wan2.2(Text to Video)工作流的视频生成标签页,独立于 GenerateUI 标签页运行。中央面板的 Plan/Edit 子标签负责批量生成和(未来的)编辑;侧边栏的 Asset/Project 子标签负责浏览已生成的视频和已保存的 Plan。",
helpVideoDesc: "支持 MiniMax H3(Image to Video)、LTX-2.5(Text / Image / First & Last Frame to Video)、Wan2.2(Text to Video)工作流的视频生成标签页,独立于 GenerateUI 标签页运行。中央面板的 Plan/Edit/Asset 子标签负责批量生成、片段剪辑和浏览已生成的视频;侧边栏的 Project 子标签负责已保存的 Plan。",
helpVideo1: "Plan 子标签:顶部设置行包含 Aspect Ratio/Megapixels/Multiple/Duration(秒)/Noise Seed,作为该 Plan 的基础设置——Duration 始终显示并可编辑当前选中区块的值(每个区块保留自己的值),其余字段则是整个 Plan 共用的。下方第二行是 Width/Height/Turbo Mode/Strength/Steps/Prompt Enhance,仅当所加载的工作流实际支持该项时才可输入(详见 helpVideo2)。用「+ Split」「+ Block」「Delete」按钮把时间线分割成多个区块后,每个区块都有自己的 Prompt、Duration 以及 First/Last Image(First Image 可选择“无”、“指定图片”或“使用前一个区块的最后一帧”——若前一个区块已明确设置了 Last Image,则优先使用该图片而非提取帧)。点击 Run 会按顺序生成所有区块,运行中也可以 Pause/Cancel。",
helpVideo2: "只有一个区块的 Plan 与旧版单次生成表单效果完全相同。模型选择(UNet/CLIP/VAE/Audio VAE)固定为所加载工作流的默认值。没有 ResolutionSelector 节点的工作流(如 Wan2.2、LTX-2.5 的 First & Last Frame to Video)会禁用 Aspect Ratio/Megapixels/Multiple 字段,改为可以直接编辑工作流自身的 Width/Height。Turbo Mode/Strength/Steps 仅适用于 MiniMax H3 的 turbo LoRA,Prompt Enhance 仅适用于 LTX-2.5——其他模型系列中这些字段保持禁用。Noise Seed 仅在 Wan2.2 的 Text to Video 中会被禁用,因为该变体未公开此输入。",
helpVideo3: "在 Workflow 标签页的详情弹窗中使用「加载到Video」按钮,可以加载包含 MiniMax H3 的 Image to Video 节点、LTX-2.5 的 Text/Image/First&Last-Frame to Video 节点、或 Wan2.2 的 Text to Video 节点的工作流——此操作会创建一个仅含一个区块、并以该工作流当前值为初始值的新 Plan。不受支持的工作流会显示错误提示。",
helpVideo4: "生成的视频(mp4)会自动出现在 Asset 子标签的 Video Temp 组中,也可以在 Gallery 标签页中浏览和播放。是否整理到 Video Assets,由您自行决定时机。",
helpVideo5: "中间面板有两个预览区:左侧显示您在 Asset 子标签中选择的视频,或拖放/选择到左边「Video Source」面板中的任意本地视频(点击 Clear 可重置),无需先运行已加载的视频工作流即可使用 Frame/GIF 工具;右侧始终显示最近一次生成的片段。",
helpVideo6: "Frame标签页(右侧面板):播放/拖动预览视频到想要的位置,点击「Capture Frame」在客户端截取该帧,再点击「Save to Output」将其保存为PNG到ComfyUI的输出文件夹。",
helpVideo6: "Frame标签页(右侧面板):播放/拖动预览视频到想要的位置,点击「Capture Frame」在客户端截取该帧,再点击「Save to Output」将其保存为PNG到ComfyUI的输出文件夹——保存前勾选「Add to Video Assets group」还可以把保存的帧同时标记进 Gallery 的 Video Assets 分组。",
helpVideo7: "GIF标签页(右侧面板):设置Start/End(秒)、FPS和可选的Max Width,点击「Convert to GIF」后,服务器会解码视频并将动画GIF保存到ComfyUI的输出文件夹。",
helpVideo8: "链接功能:将某个区块的 First Image 设置为“使用前一个区块的最后一帧”,即可与上一个片段流畅衔接——如果前一个区块已明确设置了 Last Image,将直接使用该图片;否则会自动从其生成的视频中提取实际的最后一帧。",
helpVideo9: "Project标签页(左侧边栏,与Asset并列):浏览所有已保存的 Plan 文件(缩略图、区块数、最后更新时间),点击即可加载到 Plan 编辑器,或用 × 按钮删除;再次点击同一标签会收起面板。",
helpVideo9: "Project标签页(左侧边栏):浏览所有已保存的 Plan 文件(缩略图、区块数、最后更新时间),点击即可加载到 Plan 编辑器,或用 × 按钮删除;再次点击同一标签会收起面板。",
helpVideo10: "高亮颜色:当所加载的工作流实际支持该字段时,Prompt / Duration / First Image / Last Image / Aspect Ratio / Megapixels / Multiple / Noise Seed / Width / Height / Turbo Mode / Strength / Steps / Prompt Enhance 标签会变为与 GenerateUI Model 标签页相同的高亮颜色(可在 Settings 标签页自定义)——例如 Wan2.2 工作流(没有 ResolutionSelector 节点)中,Aspect Ratio / Megapixels / Multiple 不会高亮,取而代之的是 Width / Height 会高亮。",
helpVideo11: "Edit 子标签:独立于生成流程的轻量剪辑时间线,用于裁剪和拼接视频/图片片段。通过 Video Source 面板的「Add to Edit」按钮,或 Asset 子标签的「Send to Edit」按钮添加片段,拖动区块(或使用 ◀/▶ 工具栏按钮)重新排序,对选中片段执行 Duplicate/Delete,Clear 可清空时间线。选中视频片段的裁剪面板会显示时间刻度尺、与 Source 预览同步的可拖动播放头,以及带时间标签的可拖动入/出点手柄(图片片段则只有一个简单的保持时长输入框)。「▶ Preview」会按入/出点依次裁剪并在右侧结果预览区连续播放所有就绪片段;「Export」会构建并运行实际的 ComfyUI 图(裁剪→若多于一个片段则拼接→保存),并自动把结果标记进 Video Temp 分组。目前导出多个片段会丢失音频,因为 ComfyUI 的拼接节点要求所有输入的音频格式一致。",
helpVideo12: "Asset 子标签(中央面板,位于 Plan/Edit 旁):浏览标记到 Video Assets 或 Video Temp 分组的所有视频/图片(通过分组下拉框选择,或选择「All Video Assets」同时浏览两者)。搜索框按文件名过滤,▦/☰ 按钮可在缩略图网格和表格视图(文件名/更新时间/标签)之间切换。选中一项会显示其标签/备注并加载到中央预览,此外还提供「Send to Edit」(作为片段加入 Edit 子标签);仅图片还额外提供「Set as First Image」「Set as Last Image」(直接上传到当前选中的 Plan 区块,并切换到 Plan 子标签)。",
},
};
+536 -54
View File
@@ -9,6 +9,7 @@ import { DrawTool } from "./image-edit/DrawTool.js";
import { TextTool, TEXT_FONTS } from "./image-edit/TextTool.js";
import { SelectTool } from "./image-edit/SelectTool.js";
import { ShapeTool } from "./image-edit/ShapeTool.js";
import { FillTool } from "./image-edit/FillTool.js";
import { MaskTool } from "./image-edit/MaskTool.js";
import { MaskColorTool, MaskAlphaTool, MaskTextTool, MaskVectorTool, MaskShapeTool, MASK_TEXT_FONTS } from "./image-edit/MaskEditorOneTools.js";
import { GmicIntegration } from "./image-edit/GmicIntegration.js";
@@ -28,6 +29,7 @@ const TOOL_DEFS = [
{ id: "draw", icon: "✏", label: "Draw", ready: true },
{ id: "text", icon: "T", label: "Text", ready: true },
{ id: "shape", icon: "□", label: "Shape", ready: true },
{ id: "fill", icon: "🪣", label: "Fill", ready: true },
{ id: "mask", icon: "🎭", label: "Mask", ready: true },
{ id: "blur", icon: "≈", label: "Blur", ready: true },
{ id: "filter", icon: "★", label: "Filter", ready: true },
@@ -63,6 +65,7 @@ class ImageEditTab {
this._editingTextLayer = null;
this._initialized = false;
this._shapeTool = new ShapeTool();
this._fillTool = new FillTool();
// Blur ツール
this._blurTool = new BlurTool({
getLayerManager: () => this._layerMgr,
@@ -241,6 +244,11 @@ class ImageEditTab {
if (this._activeTool === "text") this._textTool?.deactivate();
if (this._activeTool === "select") this._selectTool?.deactivate();
if (this._activeTool === "shape") this._shapeTool?.deactivate();
if (this._activeTool === "fill") {
this._fillTool?.deactivate();
const overlay = document.getElementById("ie-canvas-overlay");
if (overlay) overlay.style.cursor = "";
}
if (this._activeTool === "mask") this._deactivateMaskSubtool();
if (this._activeTool === "filter") {
this._gmic.abort();
@@ -248,8 +256,8 @@ class ImageEditTab {
if (this._activeTool === "blur") {
this._blurTool.deactivate();
}
// Draw/Mask/Inpaint以外に切り替えたらプロパティペインを非表示
if (toolId !== "mask" && toolId !== "draw" && toolId !== "inpaint") {
// Draw/Mask/Fill/Inpaint以外に切り替えたらプロパティペインを非表示
if (toolId !== "mask" && toolId !== "draw" && toolId !== "fill" && toolId !== "inpaint") {
const pane = document.getElementById("ie-props-pane");
if (pane) pane.style.display = "none";
}
@@ -282,6 +290,11 @@ class ImageEditTab {
this._shapeTool.setCanvas(overlayCanvas);
this._shapeTool.activate();
if (overlayCanvas) overlayCanvas.style.cursor = "crosshair";
} else if (this._activeTool === "fill" && this._fillTool) {
const activeLayer = this._layerMgr?.activeLayer;
if (activeLayer) this._fillTool.setCanvas(activeLayer.canvas);
this._fillTool.activate();
if (overlayCanvas) overlayCanvas.style.cursor = "crosshair";
} else if (this._activeTool === "mask") {
this._initMaskEditorOneTools();
this._activateMaskSubtool();
@@ -344,6 +357,10 @@ class ImageEditTab {
el.innerHTML = "";
this._renderDrawProps();
} else if (toolId === "fill" && this._fillTool) {
el.innerHTML = "";
this._renderFillProps();
} else if (toolId === "text" && this._textTool) {
el.innerHTML = `
<div class="ie-opt-group">
@@ -968,6 +985,271 @@ class ImageEditTab {
});
}
// ── Fill Tool (bucket fill) props ─────────────────────────────────────
_renderFillProps() {
const pane = document.getElementById("ie-props-pane");
const body = document.getElementById("ie-props-body");
const title = document.getElementById("ie-props-title");
if (!pane || !body) return;
pane.style.display = "flex";
if (title) title.textContent = "Fill";
const t = this._fillTool;
const isGradient = t.fillMode === "gradient";
body.innerHTML = `
<div class="ie-props-row">
<label>Mode</label>
<div style="display:flex;gap:4px;">
<button class="wfm-btn wfm-btn-sm${!isGradient ? " ie-opt-active" : ""}" id="ie-fill-mode-solid" style="flex:1;">Solid</button>
<button class="wfm-btn wfm-btn-sm${isGradient ? " ie-opt-active" : ""}" id="ie-fill-mode-gradient" style="flex:1;">Gradient</button>
</div>
</div>
${!isGradient ? `
<div class="ie-props-row">
<label>Color</label>
<input type="color" id="ie-fill-color" value="${t.color}"
style="width:36px;height:24px;padding:0;border:1px solid var(--wfm-border);cursor:pointer;border-radius:3px;flex-shrink:0;">
</div>` : `
<div class="ie-props-row">
<label>Shape</label>
<div style="display:flex;gap:4px;">
<button class="wfm-btn wfm-btn-sm${t.gradientShape === "linear" ? " ie-opt-active" : ""}" id="ie-fill-shape-linear" style="flex:1;">Linear</button>
<button class="wfm-btn wfm-btn-sm${t.gradientShape === "radial" ? " ie-opt-active" : ""}" id="ie-fill-shape-radial" style="flex:1;">Radial</button>
</div>
</div>
<div class="ie-props-row" style="align-items:flex-start;">
<label>Ramp</label>
<div style="display:flex;flex-direction:column;gap:10px;flex:1;min-width:0;">
<canvas id="ie-fill-ramp" width="130" height="24" style="display:block;width:130px;height:24px;border:1px solid var(--wfm-border);border-radius:3px;cursor:pointer;"></canvas>
<div style="display:flex;align-items:center;gap:4px;">
<input type="color" id="ie-fill-stop-color" value="${t.gradientStops[t.selectedStopIdx]?.color ?? "#ffffff"}"
style="width:28px;height:22px;padding:0;border:1px solid var(--wfm-border);cursor:pointer;border-radius:3px;">
<button class="wfm-btn wfm-btn-sm" id="ie-fill-stop-add" title="Add stop">+</button>
<button class="wfm-btn wfm-btn-sm" id="ie-fill-stop-remove" title="Remove stop">-</button>
</div>
</div>
</div>
<div class="ie-props-row" style="align-items:flex-start;">
<label>Direction</label>
<div style="display:flex;align-items:center;gap:6px;">
<canvas id="ie-fill-dir" width="70" height="70" style="width:70px;height:70px;border:1px solid var(--wfm-border);border-radius:3px;cursor:crosshair;"></canvas>
<span id="ie-fill-strength-lbl" style="font-size:11px;color:var(--wfm-text-secondary);">${t.gradientStrength.toFixed(1)}</span>
</div>
</div>`}
<div class="ie-props-row">
<label>Tolerance</label>
<input type="range" id="ie-fill-tolerance" min="0" max="255" value="${t.tolerance}">
<span id="ie-fill-tolerance-lbl">${t.tolerance}</span>
</div>
<div class="ie-props-row">
<label>Opacity</label>
<input type="range" id="ie-fill-opacity" min="1" max="100" value="${Math.round(t.opacity * 100)}">
<span id="ie-fill-opacity-lbl">${Math.round(t.opacity * 100)}%</span>
</div>
`;
document.getElementById("ie-fill-mode-solid")?.addEventListener("click", () => {
t.fillMode = "solid";
this._renderFillProps();
});
document.getElementById("ie-fill-mode-gradient")?.addEventListener("click", () => {
t.fillMode = "gradient";
this._renderFillProps();
});
document.getElementById("ie-fill-color")?.addEventListener("input", e => { t.color = e.target.value; });
document.getElementById("ie-fill-tolerance")?.addEventListener("input", e => {
t.tolerance = parseInt(e.target.value);
document.getElementById("ie-fill-tolerance-lbl").textContent = e.target.value;
});
document.getElementById("ie-fill-opacity")?.addEventListener("input", e => {
t.opacity = parseInt(e.target.value) / 100;
document.getElementById("ie-fill-opacity-lbl").textContent = e.target.value + "%";
});
if (isGradient) {
document.getElementById("ie-fill-shape-linear")?.addEventListener("click", () => {
t.gradientShape = "linear";
this._renderFillProps();
});
document.getElementById("ie-fill-shape-radial")?.addEventListener("click", () => {
t.gradientShape = "radial";
this._renderFillProps();
});
document.getElementById("ie-fill-stop-color")?.addEventListener("input", e => {
t.gradientStops[t.selectedStopIdx].color = e.target.value;
this._drawFillGradientRamp();
});
document.getElementById("ie-fill-stop-add")?.addEventListener("click", () => {
t.addStop();
this._renderFillProps();
});
document.getElementById("ie-fill-stop-remove")?.addEventListener("click", () => {
t.removeStop();
this._renderFillProps();
});
this._setupFillGradientRamp();
this._setupFillGradientDir();
}
}
/** カラーランプ(複数ストップの線形プレビュー)の描画とドラッグ操作。particle_widget.jsのカラーランプUIを移植。 */
_drawFillGradientRamp() {
const canvas = document.getElementById("ie-fill-ramp");
if (!canvas) return;
const ctx = canvas.getContext("2d");
const w = canvas.width, h = canvas.height;
const t = this._fillTool;
ctx.clearRect(0, 0, w, h);
const barH = h - 10; // 下部にハンドル用の余白を確保
const grad = ctx.createLinearGradient(0, 0, w, 0);
[...t.gradientStops].sort((a, b) => a.pos - b.pos).forEach(s => grad.addColorStop(s.pos, s.color));
ctx.fillStyle = grad;
ctx.fillRect(0, 0, w, barH);
ctx.strokeStyle = "#666";
ctx.strokeRect(0.5, 0.5, w - 1, barH - 1);
t.gradientStops.forEach((s, i) => {
// ハンドル(三角形)がcanvas端で切れて見えなくならないようクランプする
const x = Math.max(5, Math.min(w - 5, s.pos * w));
ctx.beginPath();
ctx.moveTo(x, h);
ctx.lineTo(x - 5, barH);
ctx.lineTo(x + 5, barH);
ctx.closePath();
ctx.fillStyle = i === t.selectedStopIdx ? "#0077ff" : "#999";
ctx.fill();
});
}
_setupFillGradientRamp() {
const canvas = document.getElementById("ie-fill-ramp");
if (!canvas) return;
this._drawFillGradientRamp();
canvas.style.touchAction = "none";
const t = this._fillTool;
const hitTestStop = mx => {
let best = -1, bestDist = 9;
t.gradientStops.forEach((s, i) => {
const d = Math.abs(s.pos * canvas.width - mx);
if (d < bestDist) { bestDist = d; best = i; }
});
return best;
};
canvas.addEventListener("pointerdown", e => {
const rect = canvas.getBoundingClientRect();
const mx = (e.clientX - rect.left) * (canvas.width / rect.width);
const idx = hitTestStop(mx);
if (idx < 0) return;
canvas.setPointerCapture(e.pointerId);
t.selectStop(idx);
// ドラッグ中onMove/onUpが参照し続けるcanvas要素が入れ替わらないよう、
// DOM全体を再構築する_renderFillProps()は使わず、選択状態の見た目だけを部分更新する
this._drawFillGradientRamp();
const colorInput = document.getElementById("ie-fill-stop-color");
if (colorInput) colorInput.value = t.gradientStops[idx].color;
const onMove = ev => {
const r = canvas.getBoundingClientRect();
const x = (ev.clientX - r.left) * (canvas.width / r.width);
t.gradientStops[t.selectedStopIdx].pos = Math.max(0, Math.min(1, x / canvas.width));
this._drawFillGradientRamp();
};
const onUp = () => {
canvas.removeEventListener("pointermove", onMove);
canvas.removeEventListener("pointerup", onUp);
canvas.removeEventListener("pointercancel", onUp);
};
canvas.addEventListener("pointermove", onMove);
canvas.addEventListener("pointerup", onUp);
canvas.addEventListener("pointercancel", onUp);
});
}
/** グラデーション方向(linear)/半径(radial)を指定するミニコンパスUI。particle_widget.jsの矢印方向ハンドルを移植。 */
_drawFillGradientDir() {
const canvas = document.getElementById("ie-fill-dir");
if (!canvas) return;
const ctx = canvas.getContext("2d");
const w = canvas.width, h = canvas.height, cx = w / 2, cy = h / 2;
const maxR = Math.min(w, h) / 2 - 6;
const t = this._fillTool;
const distFrac = (Math.max(0.2, Math.min(3.0, t.gradientStrength)) - 0.2) / 2.8;
const dist = 6 + distFrac * (maxR - 6);
ctx.clearRect(0, 0, w, h);
ctx.strokeStyle = "#888";
ctx.lineWidth = 1;
ctx.beginPath();
ctx.moveTo(cx - 4, cy); ctx.lineTo(cx + 4, cy);
ctx.moveTo(cx, cy - 4); ctx.lineTo(cx, cy + 4);
ctx.stroke();
ctx.setLineDash([3, 3]);
ctx.strokeStyle = "#0077ff";
if (t.gradientShape === "radial") {
ctx.beginPath();
ctx.arc(cx, cy, dist, 0, Math.PI * 2);
ctx.stroke();
ctx.setLineDash([]);
this._fillDirHandlePos = { x: cx + dist, y: cy };
} else {
const rad = t.gradientAngleDeg * Math.PI / 180;
const ex = cx + Math.cos(rad) * dist, ey = cy + Math.sin(rad) * dist;
ctx.beginPath();
ctx.moveTo(cx, cy); ctx.lineTo(ex, ey);
ctx.stroke();
ctx.setLineDash([]);
this._fillDirHandlePos = { x: ex, y: ey };
}
ctx.beginPath();
ctx.arc(this._fillDirHandlePos.x, this._fillDirHandlePos.y, 4, 0, Math.PI * 2);
ctx.fillStyle = "#ffcc00";
ctx.fill();
}
_setupFillGradientDir() {
const canvas = document.getElementById("ie-fill-dir");
if (!canvas) return;
this._drawFillGradientDir();
canvas.style.touchAction = "none";
const t = this._fillTool;
const w = canvas.width, h = canvas.height, cx = w / 2, cy = h / 2;
const maxR = Math.min(w, h) / 2 - 6;
const applyDrag = (mx, my) => {
const dx = mx - cx, dy = my - cy;
const dist = Math.max(6, Math.min(maxR, Math.hypot(dx, dy)));
t.gradientStrength = 0.2 + ((dist - 6) / (maxR - 6)) * 2.8;
if (t.gradientShape === "linear") t.gradientAngleDeg = Math.atan2(dy, dx) * 180 / Math.PI;
this._drawFillGradientDir();
const lbl = document.getElementById("ie-fill-strength-lbl");
if (lbl) lbl.textContent = t.gradientStrength.toFixed(1);
};
canvas.addEventListener("pointerdown", e => {
canvas.setPointerCapture(e.pointerId);
const rect = canvas.getBoundingClientRect();
applyDrag((e.clientX - rect.left) * (w / rect.width), (e.clientY - rect.top) * (h / rect.height));
const onMove = ev => {
const r = canvas.getBoundingClientRect();
applyDrag((ev.clientX - r.left) * (w / r.width), (ev.clientY - r.top) * (h / r.height));
};
const onUp = () => {
canvas.removeEventListener("pointermove", onMove);
canvas.removeEventListener("pointerup", onUp);
canvas.removeEventListener("pointercancel", onUp);
};
canvas.addEventListener("pointermove", onMove);
canvas.addEventListener("pointerup", onUp);
canvas.addEventListener("pointercancel", onUp);
});
}
// ── Mask Editor One 追加ツール: 初期化・切り替え ──────────────────────────
_initMaskEditorOneTools() {
@@ -1107,11 +1389,19 @@ class ImageEditTab {
e.target.value = "";
});
document.getElementById("ie-open-psd-input")?.addEventListener("change", e => {
const file = e.target.files?.[0];
if (file) this._loadPsdFile(file);
e.target.value = "";
});
document.getElementById("ie-new-btn")?.addEventListener("click", () => this._newCanvas());
document.getElementById("ie-close-btn")?.addEventListener("click", () => this._closeDocument());
document.getElementById("ie-undo-btn")?.addEventListener("click", () => this._undo());
document.getElementById("ie-redo-btn")?.addEventListener("click", () => this._redo());
document.getElementById("ie-save-btn")?.addEventListener("click", () => this._fileExport.savePng());
document.getElementById("ie-save-gallery-btn")?.addEventListener("click", () => this._fileExport.saveToGallery());
document.getElementById("ie-save-psd-btn")?.addEventListener("click", () => this._fileExport.saveAsPsd());
document.getElementById("ie-send-workflow-btn")?.addEventListener("click", () => this._fileExport.sendToWorkflow());
document.getElementById("ie-zoom-fit")?.addEventListener("click", () => this._fitToView());
document.getElementById("ie-zoom-100")?.addEventListener("click", () => {
@@ -1140,7 +1430,7 @@ class ImageEditTab {
this._setZoom(this._zoom * (e.deltaY > 0 ? 0.9 : 1.1));
}, { passive: false });
wrap.addEventListener("mousedown", e => {
wrap.addEventListener("pointerdown", e => {
if (e.button === 1 || (e.button === 0 && this._spaceDown)) {
e.preventDefault();
this._panning = true;
@@ -1159,7 +1449,7 @@ class ImageEditTab {
if (!this._layerMgr || !drawCanvas) return;
this._onToolMouseDown(e, drawCanvas);
});
window.addEventListener("mousemove", e => {
window.addEventListener("pointermove", e => {
if (this._panning) {
this._panOffset.x = e.clientX - this._panStart.x;
this._panOffset.y = e.clientY - this._panStart.y;
@@ -1178,7 +1468,7 @@ class ImageEditTab {
}
}
});
window.addEventListener("mouseup", e => {
window.addEventListener("pointerup", e => {
if (this._panning && (e.button === 1 || e.button === 0)) {
this._panning = false;
wrap.style.cursor = this._spaceDown ? "grab" : "";
@@ -1191,22 +1481,24 @@ class ImageEditTab {
}
});
// draw / text 用 mousedown
// draw / text 用 pointerdown(ペンタブレット筆圧対応のため Pointer Events を使用)
const drawCanvas = document.getElementById("ie-canvas-draw");
if (drawCanvas) {
drawCanvas.addEventListener("mousedown", e => this._onToolMouseDown(e, drawCanvas));
drawCanvas.addEventListener("mousemove", e => this._onToolMouseMove(e, drawCanvas));
drawCanvas.addEventListener("mouseup", e => this._onToolMouseUp(e));
drawCanvas.addEventListener("mouseleave", () => this._onToolMouseLeave());
drawCanvas.style.touchAction = "none";
drawCanvas.addEventListener("pointerdown", e => this._onToolMouseDown(e, drawCanvas));
drawCanvas.addEventListener("pointermove", e => this._onToolMouseMove(e, drawCanvas));
drawCanvas.addEventListener("pointerup", e => this._onToolMouseUp(e));
drawCanvas.addEventListener("pointerleave", () => this._onToolMouseLeave());
}
// select 用 mousedown(overlayCanvas)
// select 用 pointerdown(overlayCanvas)
const overlay = document.getElementById("ie-canvas-overlay");
if (overlay) {
overlay.addEventListener("mousedown", e => this._onToolMouseDown(e, overlay));
overlay.addEventListener("mousemove", e => this._onToolMouseMove(e, overlay));
overlay.addEventListener("mouseup", e => this._onToolMouseUp(e));
overlay.addEventListener("mouseleave", () => this._onToolMouseLeave());
overlay.style.touchAction = "none";
overlay.addEventListener("pointerdown", e => this._onToolMouseDown(e, overlay));
overlay.addEventListener("pointermove", e => this._onToolMouseMove(e, overlay));
overlay.addEventListener("pointerup", e => this._onToolMouseUp(e));
overlay.addEventListener("pointerleave", () => this._onToolMouseLeave());
// テキストオブジェクトのダブルクリックで再編集
overlay.addEventListener("dblclick", e => this._onOverlayDblClick(e, overlay));
}
@@ -1214,16 +1506,27 @@ class ImageEditTab {
_onToolMouseDown(e, refCanvas) {
if (!this._layerMgr || e.button !== 0 || this._spaceDown) return;
const pos = DrawTool.getCanvasPos(refCanvas, e);
const pos = DrawTool.getCanvasPos(refCanvas, e);
// PointerEvent.pressure: pen -> actual pressure, mouse -> 0.5 while a button is held.
const pressure = e.pressure || 0.5;
if (this._activeTool === "draw" && this._drawTool) {
const activeLayer = this._layerMgr.activeLayer;
if (!activeLayer) return;
this._saveUndo();
this._drawTool.setCanvas(activeLayer.canvas);
this._drawTool.onMouseDown(pos.x, pos.y);
this._drawTool.onMouseDown(pos.x, pos.y, pressure);
this._updateCompositeView();
} else if (this._activeTool === "fill" && this._fillTool) {
const activeLayer = this._layerMgr.activeLayer;
if (!activeLayer) return;
this._saveUndo();
this._fillTool.setCanvas(activeLayer.canvas);
this._fillTool.onMouseDown(pos.x, pos.y);
this._updateCompositeView();
this._refreshLayerList();
} else if (this._activeTool === "mask") {
const activeLayer = this._layerMgr.activeLayer;
if (!activeLayer || activeLayer.type !== "mask") {
@@ -1234,7 +1537,7 @@ class ImageEditTab {
if (sub === "paint" && this._maskTool) {
this._saveUndo();
this._maskTool.setCanvas(activeLayer.canvas);
this._maskTool.onMouseDown(pos.x, pos.y);
this._maskTool.onMouseDown(pos.x, pos.y, pressure);
this._updateCompositeView();
} else if (sub === "color" && this._maskColorTool) {
this._saveUndo();
@@ -1279,15 +1582,16 @@ class ImageEditTab {
_onToolMouseMove(e, refCanvas) {
if (!this._layerMgr) return;
const pos = DrawTool.getCanvasPos(refCanvas, e);
const pos = DrawTool.getCanvasPos(refCanvas, e);
const pressure = e.pressure || 0.5;
if (this._activeTool === "draw") {
this._drawTool?.onMouseMove(pos.x, pos.y);
this._drawTool?.onMouseMove(pos.x, pos.y, pressure);
if (this._drawTool?._drawing) this._updateCompositeView();
}
if (this._activeTool === "mask") {
const sub = this._maskSubtool;
if (sub === "paint") {
this._maskTool?.onMouseMove(pos.x, pos.y);
this._maskTool?.onMouseMove(pos.x, pos.y, pressure);
if (this._maskTool?._drawing) this._updateCompositeView();
} else if (sub === "vector") {
this._maskVectorTool?.onMouseMove(pos.x, pos.y);
@@ -1401,6 +1705,102 @@ class ImageEditTab {
showToast(`Loaded: ${img.width}×${img.height}`, "success");
}
// PSDファイルをアップロードし、レイヤーを分解して新規ドキュメントとして読み込む。
async _loadPsdFile(file) {
const form = new FormData();
form.append("file", file);
let data;
try {
const r = await fetch("/wfm/gallery/image/import-psd-layers", { method: "POST", body: form });
if (!r.ok) {
const e = await r.json().catch(() => ({}));
throw new Error(e.error || r.statusText);
}
data = await r.json();
} catch (err) {
showToast(`PSD import failed: ${err.message}`, "error");
return;
}
await this.loadPsdLayersData(data, file.name.replace(/\.[^.]+$/, ""));
}
/** バックエンドの import-psd-layers / psd-layers が返すレイヤー配列(dataURL+メタデータ)を
* 新規ドキュメントとして読み込む。グループ・調整レイヤー等はバックエンド側で既にスキップ
* 済みのフラットな画像レイヤー配列が渡される想定(ギャラリーからの直接送信でも使う共通経路)。
*/
async loadPsdLayersData(data, baseName = "psd-image") {
const { width, height, layers } = data || {};
if (!width || !height || !layers?.length) {
showToast("No importable layers found in this PSD", "error");
return;
}
this._canvasW = width;
this._canvasH = height;
this._baseName = baseName;
this._initCanvases();
// レイヤーはバックエンド側で先頭=最前面の順に並べ替え済み
const loaded = await Promise.all(layers.map(ld => new Promise(resolve => {
const img = new Image();
img.onload = () => {
const layer = new Layer(ld.name || "Layer", "image", ld.width, ld.height);
layer.x = ld.x;
layer.y = ld.y;
layer.displayW = ld.width;
layer.displayH = ld.height;
layer.opacity = ld.opacity;
layer.blendMode = ld.blendMode;
layer.visible = ld.visible;
layer.ctx.drawImage(img, 0, 0);
resolve(layer);
};
img.onerror = () => resolve(null);
img.src = ld.imageData;
})));
this._layerMgr.layers = loaded.filter(Boolean);
this._layerMgr.activeIndex = 0;
this._undoStack = [];
this._redoStack = [];
this._setActiveTool("select");
this._selectTool?.setLayer(this._layerMgr.activeLayer);
this._refreshLayerList();
this._updateCompositeView();
this._fitToView();
document.getElementById("ie-placeholder").style.display = "none";
showToast(`PSD imported: ${this._layerMgr.layers.length} layer(s)`, "success");
}
// 現在のドキュメントを閉じ、未保存の変更を破棄してプレースホルダー表示に戻す
_closeDocument() {
if (!this._layerMgr) return;
if (!confirm("Close the current document? Unsaved changes will be lost.")) return;
this._layerMgr = null;
this._undoStack = [];
this._redoStack = [];
this._canvasW = 512;
this._canvasH = 512;
this._baseName = "image";
this._zoom = 1.0;
this._panOffset = { x: 0, y: 0 };
const drawCanvas = document.getElementById("ie-canvas-draw");
const overlayCanvas = document.getElementById("ie-canvas-overlay");
drawCanvas?.getContext("2d").clearRect(0, 0, drawCanvas.width, drawCanvas.height);
overlayCanvas?.getContext("2d").clearRect(0, 0, overlayCanvas.width, overlayCanvas.height);
const layerList = document.getElementById("ie-layer-list");
if (layerList) layerList.innerHTML = "";
const placeholder = document.getElementById("ie-placeholder");
if (placeholder) placeholder.style.display = "";
}
_newCanvas() {
const current = `${this._canvasW || 512}x${this._canvasH || 512}`;
const input = prompt("Canvas size (WxH):", current);
@@ -1539,6 +1939,8 @@ class ImageEditTab {
this._refreshLayerList();
});
this._fillTool = new FillTool();
this._compositeMode = false;
}
@@ -1750,6 +2152,45 @@ class ImageEditTab {
// ── レイヤーパネル ────────────────────────────
// 指定レイヤーをアクティブ化し、種別・現在のツールに応じてキャンバス/ツールを同期する
// (レイヤーリストのクリック選択・複製直後のアクティブ化などで共用)
_activateLayerById(id) {
if (!this._layerMgr) return;
this._syncActiveLayerFromCanvas();
this._layerMgr.setActive(id);
const layer = this._layerMgr.activeLayer;
if (layer?.type === "mask") {
if (this._activeTool !== "mask") {
this._setActiveTool("mask");
} else {
// すでにマスクツール選択中 → canvas だけ切り替え
this._maskTool?.setCanvas(layer.canvas);
this._maskTool?.activate();
}
// operation に合わせて MaskTool の mode を同期
if (this._maskTool) {
this._maskTool.mode = layer.operation === "subtract" ? "erase" : "paint";
this._renderToolOptions("mask");
}
this._updateCompositeView();
} else if (this._activeTool === "draw" && layer) {
this._drawTool?.setCanvas(layer.canvas);
this._updateCompositeView();
} else if (this._activeTool === "select" && layer) {
this._selectTool?.setLayer(layer);
this._updateCompositeView();
} else {
this._updateCompositeView();
}
this._refreshLayerList();
if (layer) {
const sl = document.getElementById("ie-layer-opacity");
const lb = document.getElementById("ie-layer-opacity-label");
if (sl) sl.value = Math.round(layer.opacity * 100);
if (lb) lb.textContent = Math.round(layer.opacity * 100) + "%";
}
}
_setupLayerPanel() {
document.getElementById("ie-add-layer-btn")?.addEventListener("click", () => {
if (!this._layerMgr) return;
@@ -1764,6 +2205,24 @@ class ImageEditTab {
this._activateCurrentTool();
});
document.getElementById("ie-dup-layer-btn")?.addEventListener("click", async () => {
if (!this._layerMgr) return;
const active = this._layerMgr.activeLayer;
if (!active) return;
this._syncActiveLayerFromCanvas();
this._saveUndo();
const json = active.toJSON();
json.name = `${active.name} copy`;
const dup = await Layer.fromJSON(json);
dup.id = crypto.randomUUID();
const idx = this._layerMgr.layers.indexOf(active);
this._layerMgr.layers.splice(idx, 0, dup);
this._activateLayerById(dup.id);
});
document.getElementById("ie-add-mask-btn")?.addEventListener("click", () => {
if (!this._layerMgr) { showToast("Open an image first", "info"); return; }
this._syncActiveLayerFromCanvas();
@@ -1873,39 +2332,7 @@ class ImageEditTab {
if (sel?.id === id) this._selectTool?.setLayer(sel);
this._refreshLayerList();
} else if (action === "select") {
this._syncActiveLayerFromCanvas();
this._layerMgr.setActive(id);
const layer = this._layerMgr.activeLayer;
if (layer?.type === "mask") {
if (this._activeTool !== "mask") {
this._setActiveTool("mask");
} else {
// すでにマスクツール選択中 → canvas だけ切り替え
this._maskTool?.setCanvas(layer.canvas);
this._maskTool?.activate();
}
// operation に合わせて MaskTool の mode を同期
if (this._maskTool) {
this._maskTool.mode = layer.operation === "subtract" ? "erase" : "paint";
this._renderToolOptions("mask");
}
this._updateCompositeView();
} else if (this._activeTool === "draw" && layer) {
this._drawTool?.setCanvas(layer.canvas);
this._updateCompositeView();
} else if (this._activeTool === "select" && layer) {
this._selectTool?.setLayer(layer);
this._updateCompositeView();
} else {
this._updateCompositeView();
}
this._refreshLayerList();
if (layer) {
const sl = document.getElementById("ie-layer-opacity");
const lb = document.getElementById("ie-layer-opacity-label");
if (sl) sl.value = Math.round(layer.opacity * 100);
if (lb) lb.textContent = Math.round(layer.opacity * 100) + "%";
}
this._activateLayerById(id);
}
});
});
@@ -1962,6 +2389,60 @@ class ImageEditTab {
}
}
/** ギャラリーなど外部から複数画像URLをまとめてレイヤーとして新規ドキュメントに読み込む
* @param {Array<{url: string, name?: string}>} items 先頭=最背面, 末尾=最前面として重ねる
*/
async loadLayersFromUrls(items) {
if (!items || items.length === 0) return;
let imgs;
try {
imgs = await Promise.all(items.map(({ url }) => new Promise((resolve, reject) => {
const img = new Image();
img.onload = () => resolve(img);
img.onerror = () => reject(new Error(`Failed to load: ${url}`));
img.src = url;
})));
} catch (err) {
showToast(err.message || "Failed to load images", "error");
return;
}
const w = Math.max(...imgs.map(i => i.width));
const h = Math.max(...imgs.map(i => i.height));
this._canvasW = w;
this._canvasH = h;
this._baseName = "gallery-layers";
this._initCanvases();
const layers = imgs.map((img, i) => {
const fit = fitToCanvas(img.width, img.height, w, h);
const layer = new Layer(items[i].name || `Layer ${i + 1}`, "image", img.width, img.height);
layer.displayW = fit.w;
layer.displayH = fit.h;
layer.x = Math.round((w - fit.w) / 2);
layer.y = Math.round((h - fit.h) / 2);
layer.ctx.drawImage(img, 0, 0);
return layer;
});
// items は先頭=最背面の順で渡される想定のため、Layer配列規約(先頭=最前面)に合わせて反転する
this._layerMgr.layers = layers.reverse();
this._layerMgr.activeIndex = 0;
this._undoStack = [];
this._redoStack = [];
this._setActiveTool("select");
this._selectTool?.setLayer(this._layerMgr.activeLayer);
this._refreshLayerList();
this._updateCompositeView();
this._fitToView();
document.getElementById("ie-placeholder").style.display = "none";
showToast(`Loaded ${layers.length} image(s) as layers`, "success");
}
// ── キーボードショートカット ──────────────────
_setupKeyboard() {
@@ -1983,6 +2464,7 @@ class ImageEditTab {
if (e.key === "b") this._setActiveTool("draw");
if (e.key === "t") this._setActiveTool("text");
if (e.key === "s") this._setActiveTool("shape");
if (e.key === "g") this._setActiveTool("fill");
// Delete/Backspaceで選択オブジェクト削除
if ((e.key === "Delete" || e.key === "Backspace") && this._activeTool === "select") {
const layer = this._selectTool?.getSelectedLayer();
+57 -41
View File
@@ -20,6 +20,11 @@ export class DrawTool {
this.sizeJitterAmount = 0.5;
this.rotationJitter = false;
// Pen pressure (0–1, from PointerEvent.pressure; mouse reports 0.5).
// pressure=0.5 maps to a 1.0x multiplier so mouse behavior is unchanged.
this.pressureEnabled = true;
this._lastPressure = 0.5;
// Image brush from ABR library (null = default circle brush)
this.brushImage = null;
this.brushName = "Circle";
@@ -80,29 +85,31 @@ export class DrawTool {
if (this.canvas) this.canvas.style.cursor = "";
}
onMouseDown(x, y) {
this._drawing = true;
this._lastX = x;
this._lastY = y;
onMouseDown(x, y, pressure = 0.5) {
this._drawing = true;
this._lastX = x;
this._lastY = y;
this._lastPressure = pressure;
if (this.brushImage) {
this._initStrokeBuffer();
this._paintToStroke(x, y);
this._paintToStroke(x, y, pressure);
this._mergeStroke();
} else {
this._paint(x, y);
this._paint(x, y, pressure);
}
}
onMouseMove(x, y) {
onMouseMove(x, y, pressure = 0.5) {
if (!this._drawing) return;
if (this.brushImage) {
this._paintLineToStroke(this._lastX, this._lastY, x, y);
this._paintLineToStroke(this._lastX, this._lastY, x, y, this._lastPressure, pressure);
this._mergeStroke();
} else {
this._paintLine(this._lastX, this._lastY, x, y);
this._paintLine(this._lastX, this._lastY, x, y, this._lastPressure, pressure);
}
this._lastX = x;
this._lastY = y;
this._lastX = x;
this._lastY = y;
this._lastPressure = pressure;
}
onMouseUp() {
@@ -117,6 +124,20 @@ export class DrawTool {
if (this._drawing) this.onMouseUp();
}
// ── Pressure response ──────────────────────────────────────────────
_effectiveSize(pressure) {
if (!this.pressureEnabled) return this.brushSize;
const p = Math.max(0, Math.min(1, pressure ?? 0.5));
return Math.max(1, this.brushSize * (0.3 + p * 1.4)); // p=0.5 -> 1.0x
}
_effectiveOpacity(pressure) {
if (!this.pressureEnabled) return this.opacity;
const p = Math.max(0, Math.min(1, pressure ?? 0.5));
return Math.max(0, Math.min(1, this.opacity * (0.4 + p * 1.2))); // p=0.5 -> 1.0x
}
// ── Stroke buffer (image brush only) ─────────────────────────────
_initStrokeBuffer() {
@@ -155,54 +176,48 @@ export class DrawTool {
ctx.restore();
}
_paintToStroke(x, y) {
_paintToStroke(x, y, pressure = 0.5) {
const saved = this.ctx;
this.ctx = this._strokeCtx;
if (this.sizeJitter || this.rotationJitter) {
const savedSize = this.brushSize;
const savedAngle = this.angle;
const savedStamp = this._imgStamp;
const savedStampSize = this._imgStampSize;
if (this.sizeJitter) {
this.brushSize = Math.max(1, savedSize * (1 - Math.random() * this.sizeJitterAmount));
}
if (this.rotationJitter) {
this.angle = Math.random() * 360;
}
this._paintImageBrush(x, y);
this.brushSize = savedSize;
this.angle = savedAngle;
this._imgStamp = savedStamp;
this._imgStampSize = savedStampSize;
let size = this._effectiveSize(pressure);
if (this.sizeJitter) {
size = Math.max(1, size * (1 - Math.random() * this.sizeJitterAmount));
}
if (this.rotationJitter) {
const savedAngle = this.angle;
this.angle = Math.random() * 360;
this._paintImageBrush(x, y, size);
this.angle = savedAngle;
} else {
this._paintImageBrush(x, y);
this._paintImageBrush(x, y, size);
}
this.ctx = saved;
}
_paintLineToStroke(x0, y0, x1, y1) {
_paintLineToStroke(x0, y0, x1, y1, p0 = 0.5, p1 = 0.5) {
const dist = Math.hypot(x1 - x0, y1 - y0);
const step = Math.max(1, this.brushSize * this.spacing);
const steps = Math.ceil(dist / step);
for (let i = 1; i <= steps; i++) {
const t = i / steps;
this._paintToStroke(x0 + (x1 - x0) * t, y0 + (y1 - y0) * t);
this._paintToStroke(x0 + (x1 - x0) * t, y0 + (y1 - y0) * t, p0 + (p1 - p0) * t);
}
}
// ── Circle brush ─────────────────────────────────────────────────
_getStamp() {
_getStamp(size) {
size = Math.max(1, Math.round(size));
if (
this._stamp &&
this._stampSize === this.brushSize &&
this._stampSize === size &&
this._stampHard === this.hardness &&
this._stampColor === this.color
) return this._stamp;
const size = Math.max(1, Math.round(this.brushSize));
const sc = document.createElement("canvas");
sc.width = size;
sc.height = size;
@@ -225,11 +240,12 @@ export class DrawTool {
return sc;
}
_paint(x, y) {
const stamp = this._getStamp();
_paint(x, y, pressure = 0.5) {
const size = this._effectiveSize(pressure);
const stamp = this._getStamp(size);
const s = stamp.width;
this.ctx.save();
this.ctx.globalAlpha = this.opacity;
this.ctx.globalAlpha = this._effectiveOpacity(pressure);
if (this.mode === "erase") {
this.ctx.globalCompositeOperation = "destination-out";
}
@@ -237,13 +253,13 @@ export class DrawTool {
this.ctx.restore();
}
_paintLine(x0, y0, x1, y1) {
_paintLine(x0, y0, x1, y1, p0 = 0.5, p1 = 0.5) {
const dist = Math.hypot(x1 - x0, y1 - y0);
const spacing = Math.max(1, this.brushSize * 0.2);
const steps = Math.max(1, Math.ceil(dist / spacing));
for (let i = 1; i <= steps; i++) {
const t = i / steps;
this._paint(x0 + (x1 - x0) * t, y0 + (y1 - y0) * t);
this._paint(x0 + (x1 - x0) * t, y0 + (y1 - y0) * t, p0 + (p1 - p0) * t);
}
}
@@ -319,8 +335,8 @@ export class DrawTool {
return sc;
}
_paintImageBrush(x, y) {
const stamp = this._getImageStamp(Math.round(this.brushSize));
_paintImageBrush(x, y, size = this.brushSize) {
const stamp = this._getImageStamp(Math.round(size));
this.ctx.globalCompositeOperation = "source-over";
if (this.angle) {
this.ctx.save();
+86
View File
@@ -63,6 +63,92 @@ export class FileExport {
}
}
// 保存用レイヤー配列を構築: 各レイヤーを個別のcanvas(ドキュメント全体サイズ)に
// 回転・反転・拡縮のみベイクして描画する。opacity/blendModeはピクセルに焼き込まず
// PSDレイヤー属性として渡すためメタデータのまま残す。
// maskApply=true のクリッピングマスクは対象レイヤーと合成して1枚にベイクする
// (PSDの本物のレイヤーマスクとしては書き出さない簡略化)。
_buildLayerExportList(layerMgr, w, h) {
const layers = layerMgr.layers;
const maskedIndices = new Set();
for (let i = 0; i < layers.length; i++) {
if (layers[i].type === "mask" && layers[i].maskApply && layers[i].visible && i + 1 < layers.length) {
maskedIndices.add(i + 1);
}
}
const exportLayers = [];
// 背面→前面の順(PSD側で後から追加したレイヤーほど上に重なるため、この順で送る)
for (let i = layers.length - 1; i >= 0; i--) {
const layer = layers[i];
if (maskedIndices.has(i)) continue; // マスク側の処理でまとめて扱う
if (layer.type === "mask") {
if (!(layer.maskApply && layer.visible && i + 1 < layers.length)) continue;
const target = layers[i + 1];
const canvas = document.createElement("canvas");
canvas.width = w;
canvas.height = h;
this._cb.renderMaskedLayer(canvas.getContext("2d"), canvas, layer, target, false);
exportLayers.push({
name: target.name || "Layer",
visible: target.visible,
opacity: 1,
blendMode: "source-over",
imageData: canvas.toDataURL("image/png"),
});
continue;
}
const canvas = document.createElement("canvas");
canvas.width = w;
canvas.height = h;
const ctx = canvas.getContext("2d");
ctx.save();
Layer.applyTransform(ctx, layer);
ctx.drawImage(layer.canvas, -layer.canvas.width / 2, -layer.canvas.height / 2);
ctx.restore();
exportLayers.push({
name: layer.name || "Layer",
visible: layer.visible,
opacity: layer.opacity,
blendMode: layer.blendMode,
imageData: canvas.toDataURL("image/png"),
});
}
return exportLayers;
}
async saveAsPsd() {
if (!this._cb.getLayerManager()) { showToast("No image loaded", "error"); return; }
const layerMgr = this._cb.getLayerManager();
const { w, h } = this._cb.getCanvasSize();
const exportLayers = this._buildLayerExportList(layerMgr, w, h);
if (exportLayers.length === 0) { showToast("No layers to export", "error"); return; }
try {
const r = await fetch("/wfm/gallery/image/export-psd-layers", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ width: w, height: h, layers: exportLayers }),
});
if (!r.ok) {
const e = await r.json().catch(() => ({}));
throw new Error(e.error || r.statusText);
}
const blob = await r.blob();
const url = URL.createObjectURL(blob);
const a = document.createElement("a");
a.href = url;
a.download = (this._cb.getBaseName() || "wfs-edit") + ".psd";
a.click();
URL.revokeObjectURL(url);
showToast("PSD saved", "success");
} catch (err) {
showToast(`PSD save failed: ${err.message}`, "error");
}
}
savePng() {
if (!this._cb.getLayerManager()) { showToast("No image loaded", "error"); return; }
const canvas = this._buildCompositeCanvas();
+228
View File
@@ -0,0 +1,228 @@
/**
* Image Edit Tab - Fill Tool (bucket fill)
* Flood-fills a contiguous same-color region on the active layer canvas,
* either with a solid color or a linear/radial gradient.
* Gradient ramp math (evalGradient / hex<->rgb) is ported from
* comfyUI-particle-pixijs's particle_engine.js.
*/
function _hexToRgb01(hex) {
const m = /^#?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})$/i.exec(hex || "#000000");
if (!m) return { r: 0, g: 0, b: 0 };
return { r: parseInt(m[1], 16) / 255, g: parseInt(m[2], 16) / 255, b: parseInt(m[3], 16) / 255 };
}
function _rgb01ToHex({ r, g, b }) {
const h = v => Math.round(Math.max(0, Math.min(1, v)) * 255).toString(16).padStart(2, "0");
return `#${h(r)}${h(g)}${h(b)}`;
}
function _lerp(a, b, t) { return a + (b - a) * t; }
export class FillTool {
constructor() {
// fill settings
this.tolerance = 32; // 0-255
this.fillMode = "solid"; // "solid" | "gradient"
this.color = "#ff0000"; // solid fill color
this.opacity = 1.0;
// gradient settings
this.gradientShape = "linear"; // "linear" | "radial"
this.gradientAngleDeg = 0; // linear direction
this.gradientStrength = 1.0; // 0.2-3.0, length/radius multiplier
this.gradientStops = [
{ pos: 0.0, color: "#ffffff" },
{ pos: 1.0, color: "#888888" },
];
this.selectedStopIdx = 0;
// internal state
this._active = false;
this._canvas = null;
this._ctx = null;
this._onChange = null;
}
setCanvas(canvas) {
this._canvas = canvas;
this._ctx = canvas ? canvas.getContext("2d") : null;
}
onChange(cb) { this._onChange = cb; }
activate() { this._active = true; }
deactivate() { this._active = false; }
// ── color ramp evaluation (ported from particle_engine.js evalGradient) ──
static evalGradient(stops, t) {
if (!stops || stops.length === 0) return { r: 0, g: 0, b: 0 };
const sorted = [...stops].sort((a, b) => a.pos - b.pos);
if (t <= sorted[0].pos) return _hexToRgb01(sorted[0].color);
const last = sorted[sorted.length - 1];
if (t >= last.pos) return _hexToRgb01(last.color);
for (let i = 0; i < sorted.length - 1; i++) {
const a = sorted[i], b = sorted[i + 1];
if (t >= a.pos && t <= b.pos) {
const span = b.pos - a.pos;
const localT = span > 0 ? (t - a.pos) / span : 0;
const ca = _hexToRgb01(a.color), cb = _hexToRgb01(b.color);
return {
r: _lerp(ca.r, cb.r, localT),
g: _lerp(ca.g, cb.g, localT),
b: _lerp(ca.b, cb.b, localT),
};
}
}
return _hexToRgb01(last.color);
}
/** Preview swatch color (hex) of the ramp at position t. */
evalGradientHex(t) {
return _rgb01ToHex(FillTool.evalGradient(this.gradientStops, t));
}
// ── stop editing helpers (ported from particle_widget.js addStop/removeStop/selectStop) ──
addStop() {
const sorted = [...this.gradientStops].sort((a, b) => a.pos - b.pos);
let bestGapStart = 0, bestGapSize = 0;
for (let i = 0; i < sorted.length - 1; i++) {
const gap = sorted[i + 1].pos - sorted[i].pos;
if (gap > bestGapSize) { bestGapSize = gap; bestGapStart = sorted[i].pos; }
}
const pos = sorted.length < 2 ? 0.5 : bestGapStart + bestGapSize / 2;
const color = _rgb01ToHex(FillTool.evalGradient(this.gradientStops, pos));
this.gradientStops.push({ pos, color });
this.selectedStopIdx = this.gradientStops.length - 1;
}
removeStop(idx = this.selectedStopIdx) {
if (this.gradientStops.length <= 1) return;
this.gradientStops.splice(idx, 1);
this.selectedStopIdx = Math.max(0, Math.min(this.selectedStopIdx, this.gradientStops.length - 1));
}
selectStop(idx) {
this.selectedStopIdx = idx;
}
// ── flood fill ────────────────────────────────────────
/**
* Flood-fills the contiguous region matching the pixel at (x, y).
* (x, y) are canvas-pixel coordinates (already converted via DrawTool.getCanvasPos).
*/
onMouseDown(x, y) {
if (!this._active || !this._ctx) return;
const w = this._canvas.width, h = this._canvas.height;
const px = Math.floor(x), py = Math.floor(y);
if (px < 0 || py < 0 || px >= w || py >= h) return;
const imgData = this._ctx.getImageData(0, 0, w, h);
const data = imgData.data;
const mask = this._buildFloodMask(data, w, h, px, py, this.tolerance);
if (!mask) return;
if (this.fillMode === "gradient") {
this._fillMaskWithGradient(data, w, h, mask.pixels, mask.bbox);
} else {
this._fillMaskWithSolid(data, mask.pixels, this.color, this.opacity);
}
this._ctx.putImageData(imgData, 0, 0);
}
/** Scanline stack-based flood fill. Returns { pixels: Uint8Array(w*h), bbox } or null. */
_buildFloodMask(data, w, h, startX, startY, tolerance) {
const idx0 = (startY * w + startX) * 4;
const tr = data[idx0], tg = data[idx0 + 1], tb = data[idx0 + 2], ta = data[idx0 + 3];
const tol2 = tolerance * tolerance;
const matches = (i) => {
const dr = data[i] - tr, dg = data[i + 1] - tg, db = data[i + 2] - tb, da = data[i + 3] - ta;
return (dr * dr + dg * dg + db * db + da * da) <= tol2 * 4;
};
const pixels = new Uint8Array(w * h);
const stack = [[startX, startY]];
let minX = startX, maxX = startX, minY = startY, maxY = startY;
while (stack.length) {
let [x, y] = stack.pop();
while (x >= 0 && matches((y * w + x) * 4)) x--;
x++;
let spanUp = false, spanDown = false;
while (x < w && matches((y * w + x) * 4) && !pixels[y * w + x]) {
pixels[y * w + x] = 1;
if (x < minX) minX = x; if (x > maxX) maxX = x;
if (y < minY) minY = y; if (y > maxY) maxY = y;
if (y > 0) {
const above = matches((( y - 1) * w + x) * 4) && !pixels[(y - 1) * w + x];
if (above && !spanUp) { stack.push([x, y - 1]); spanUp = true; }
else if (!above) spanUp = false;
}
if (y < h - 1) {
const below = matches(((y + 1) * w + x) * 4) && !pixels[(y + 1) * w + x];
if (below && !spanDown) { stack.push([x, y + 1]); spanDown = true; }
else if (!below) spanDown = false;
}
x++;
}
}
return { pixels, bbox: { minX, minY, maxX, maxY } };
}
_fillMaskWithSolid(data, pixels, colorHex, opacity) {
const { r, g, b } = _hexToRgb01(colorHex);
const cr = r * 255, cg = g * 255, cb = b * 255;
const alpha = Math.max(0, Math.min(1, opacity));
for (let i = 0; i < pixels.length; i++) {
if (!pixels[i]) continue;
const di = i * 4;
data[di] = _lerp(data[di], cr, alpha);
data[di + 1] = _lerp(data[di + 1], cg, alpha);
data[di + 2] = _lerp(data[di + 2], cb, alpha);
data[di + 3] = Math.max(data[di + 3], alpha * 255);
}
}
/** Reusable with any {pixels, bbox} mask (flood fill today; rect/ellipse selections in the future). */
_fillMaskWithGradient(data, w, h, pixels, bbox) {
const cx = (bbox.minX + bbox.maxX) / 2, cy = (bbox.minY + bbox.maxY) / 2;
const diagW = bbox.maxX - bbox.minX, diagH = bbox.maxY - bbox.minY;
const diag = Math.max(1, Math.hypot(diagW, diagH));
const strength = Math.max(0.2, Math.min(3.0, this.gradientStrength));
const alpha = Math.max(0, Math.min(1, this.opacity));
const angleRad = this.gradientAngleDeg * Math.PI / 180;
const dirX = Math.cos(angleRad), dirY = Math.sin(angleRad);
const halfLen = (diag / 2) * strength;
const radius = (diag / 2) * strength;
for (let y = bbox.minY; y <= bbox.maxY; y++) {
for (let x = bbox.minX; x <= bbox.maxX; x++) {
const i = y * w + x;
if (!pixels[i]) continue;
const dx = x - cx, dy = y - cy;
let t;
if (this.gradientShape === "radial") {
t = Math.hypot(dx, dy) / radius;
} else {
t = (dx * dirX + dy * dirY) / (halfLen * 2) + 0.5;
}
t = Math.max(0, Math.min(1, t));
const c = FillTool.evalGradient(this.gradientStops, t);
const di = i * 4;
data[di] = _lerp(data[di], c.r * 255, alpha);
data[di + 1] = _lerp(data[di + 1], c.g * 255, alpha);
data[di + 2] = _lerp(data[di + 2], c.b * 255, alpha);
data[di + 3] = Math.max(data[di + 3], alpha * 255);
}
}
}
}
+50 -40
View File
@@ -25,6 +25,11 @@ export class MaskTool {
this.sizeJitterAmount = 0.5; // 0–1: fraction of brushSize that can be removed
this.rotationJitter = false;
// Pen pressure (0–1, from PointerEvent.pressure; mouse reports 0.5).
// pressure=0.5 maps to a 1.0x multiplier so mouse behavior is unchanged.
this.pressureEnabled = true;
this._lastPressure = 0.5;
this._drawing = false;
this._lastX = 0;
this._lastY = 0;
@@ -80,29 +85,31 @@ export class MaskTool {
if (this.canvas) this.canvas.style.cursor = "";
}
onMouseDown(x, y) {
this._drawing = true;
this._lastX = x;
this._lastY = y;
onMouseDown(x, y, pressure = 0.5) {
this._drawing = true;
this._lastX = x;
this._lastY = y;
this._lastPressure = pressure;
if (this.brushImage) {
this._initStrokeBuffer();
this._paintToStroke(x, y);
this._paintToStroke(x, y, pressure);
this._mergeStroke();
} else {
this._paint(x, y);
this._paint(x, y, pressure);
}
}
onMouseMove(x, y) {
onMouseMove(x, y, pressure = 0.5) {
if (!this._drawing) return;
if (this.brushImage) {
this._paintLineToStroke(this._lastX, this._lastY, x, y);
this._paintLineToStroke(this._lastX, this._lastY, x, y, this._lastPressure, pressure);
this._mergeStroke();
} else {
this._paintLine(this._lastX, this._lastY, x, y);
this._paintLine(this._lastX, this._lastY, x, y, this._lastPressure, pressure);
}
this._lastX = x;
this._lastY = y;
this._lastX = x;
this._lastY = y;
this._lastPressure = pressure;
}
onMouseUp() {
@@ -117,6 +124,14 @@ export class MaskTool {
if (this._drawing) this.onMouseUp();
}
// ── Pressure response ──────────────────────────────────────────────
_effectiveSize(pressure) {
if (!this.pressureEnabled) return this.brushSize;
const p = Math.max(0, Math.min(1, pressure ?? 0.5));
return Math.max(1, this.brushSize * (0.3 + p * 1.4)); // p=0.5 -> 1.0x
}
// ── Stroke buffer (image brush only) ─────────────────────────────
_initStrokeBuffer() {
@@ -149,54 +164,48 @@ export class MaskTool {
ctx.globalCompositeOperation = "source-over";
}
_paintToStroke(x, y) {
_paintToStroke(x, y, pressure = 0.5) {
const saved = this.ctx;
this.ctx = this._strokeCtx;
if (this.sizeJitter || this.rotationJitter) {
const savedSize = this.brushSize;
const savedAngle = this.angle;
const savedStamp = this._imgStamp;
const savedStampSize = this._imgStampSize;
if (this.sizeJitter) {
this.brushSize = Math.max(1, savedSize * (1 - Math.random() * this.sizeJitterAmount));
}
if (this.rotationJitter) {
this.angle = Math.random() * 360;
}
this._paintImageBrush(x, y);
this.brushSize = savedSize;
this.angle = savedAngle;
this._imgStamp = savedStamp;
this._imgStampSize = savedStampSize;
let size = this._effectiveSize(pressure);
if (this.sizeJitter) {
size = Math.max(1, size * (1 - Math.random() * this.sizeJitterAmount));
}
if (this.rotationJitter) {
const savedAngle = this.angle;
this.angle = Math.random() * 360;
this._paintImageBrush(x, y, size);
this.angle = savedAngle;
} else {
this._paintImageBrush(x, y);
this._paintImageBrush(x, y, size);
}
this.ctx = saved;
}
_paintLineToStroke(x0, y0, x1, y1) {
_paintLineToStroke(x0, y0, x1, y1, p0 = 0.5, p1 = 0.5) {
const dist = Math.hypot(x1 - x0, y1 - y0);
const step = Math.max(1, this.brushSize * this.spacing);
const steps = Math.ceil(dist / step);
for (let i = 1; i <= steps; i++) {
const t = i / steps;
this._paintToStroke(x0 + (x1 - x0) * t, y0 + (y1 - y0) * t);
this._paintToStroke(x0 + (x1 - x0) * t, y0 + (y1 - y0) * t, p0 + (p1 - p0) * t);
}
}
// ── Circle brush ─────────────────────────────────────────────────
_getStamp() {
_getStamp(size) {
size = Math.max(1, Math.round(size));
if (
this._stamp &&
this._stampSize === this.brushSize &&
this._stampSize === size &&
this._stampHard === this.hardness &&
this._stampMode === this.mode
) return this._stamp;
const size = Math.max(1, Math.round(this.brushSize));
const sc = document.createElement("canvas");
sc.width = size;
sc.height = size;
@@ -222,8 +231,9 @@ export class MaskTool {
return sc;
}
_paint(x, y) {
const stamp = this._getStamp();
_paint(x, y, pressure = 0.5) {
const size = this._effectiveSize(pressure);
const stamp = this._getStamp(size);
const s = stamp.width;
this.ctx.save();
if (this.mode === "erase") {
@@ -233,13 +243,13 @@ export class MaskTool {
this.ctx.restore();
}
_paintLine(x0, y0, x1, y1) {
_paintLine(x0, y0, x1, y1, p0 = 0.5, p1 = 0.5) {
const dist = Math.hypot(x1 - x0, y1 - y0);
const spacing = Math.max(1, this.brushSize * 0.2);
const steps = Math.max(1, Math.ceil(dist / spacing));
for (let i = 1; i <= steps; i++) {
const t = i / steps;
this._paint(x0 + (x1 - x0) * t, y0 + (y1 - y0) * t);
this._paint(x0 + (x1 - x0) * t, y0 + (y1 - y0) * t, p0 + (p1 - p0) * t);
}
}
@@ -307,8 +317,8 @@ export class MaskTool {
return sc;
}
_paintImageBrush(x, y) {
const stamp = this._getImageStamp(Math.round(this.brushSize));
_paintImageBrush(x, y, size = this.brushSize) {
const stamp = this._getImageStamp(Math.round(size));
this.ctx.globalCompositeOperation = "source-over";
if (this.angle) {
this.ctx.save();
+66 -2
View File
@@ -110,6 +110,7 @@ function _applyI18n() {
"wfm-tagger-db-edit-vlm-label": "taggerDbVlm",
"wfm-tagger-db-save-btn": "taggerDbSave",
"wfm-tagger-db-delete-btn": "taggerDbDelete",
"wfm-tagger-db-delete-selected-btn": "taggerDbDelete"
};
for (const [id, key] of Object.entries(map)) {
const el = document.getElementById(id);
@@ -514,6 +515,8 @@ function _setupDbActions() {
});
document.getElementById("wfm-tagger-db-save-btn")?.addEventListener("click", _dbSave);
document.getElementById("wfm-tagger-db-delete-btn")?.addEventListener("click", _dbDelete);
document.getElementById("wfm-tagger-db-select").addEventListener("click", _dbToggleSelection);
document.getElementById("wfm-tagger-db-delete-selected-btn").addEventListener("click", _dbDeleteSelected);
}
async function _dbLoad() {
@@ -541,12 +544,20 @@ async function _dbSearch() {
function _renderDbTable(rows) {
const tbody = document.getElementById("wfm-tagger-db-tbody");
if (!tbody) return;
if (!rows.length) {
tbody.innerHTML = `<tr><td colspan="5" style="text-align:center;padding:20px;color:var(--wfm-text-secondary)">${t("taggerDbEmpty")}</td></tr>`;
tbody.innerHTML = `<tr><td colspan="6" style="text-align:center;padding:20px;color:var(--wfm-text-secondary)">${t("taggerDbEmpty")}</td></tr>`;
return;
}
tbody.innerHTML = rows.map(row => `
<tr data-id="${row.id}" title="${_esc(row.all_tags)}">
<td class="wfm-tagger-db-select">
<input
type="checkbox"
data-id="${row.id}"
>
</td>
<td>${row.id}</td>
<td>${_esc(row.filename)}</td>
<td>${_esc(_truncate(row.interrogator_tags, 60))}</td>
@@ -556,9 +567,13 @@ function _renderDbTable(rows) {
`).join("");
tbody.querySelectorAll("tr").forEach(tr => {
tr.addEventListener("click", () => {
tr.addEventListener("click", e => {
// チェックボックスをクリックした場合は行選択を発生させない
if (e.target.closest(".wfm-tagger-db-select")) return;
tbody.querySelectorAll("tr").forEach(r => r.classList.remove("selected"));
tr.classList.add("selected");
const row = rows.find(r => r.id === parseInt(tr.dataset.id));
if (row) _openDbEdit(row);
});
@@ -620,6 +635,55 @@ function _dbExport() {
a.click();
}
async function _dbDeleteSelected() {
const ids = _getSelectedDbIds();
if (!ids.length) {
showToast(t("taggerDbNoSelection"), "warning");
return;
}
if (!confirm(t("taggerDbDeleteConfirm", ids.length))) {
return;
}
try {
const res = await fetch("/wfm/tagger/db", {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ ids }),
});
const data = await res.json();
if (data.error) {
throw new Error(data.error);
}
showToast(t("taggerDbDeletedCount", data.count), "success");
_dbLoad();
} catch (e) {
showToast(e.message, "error");
}
}
function _getSelectedDbIds() {
return [...document.querySelectorAll(".wfm-tagger-db-select input:checked")]
.map(el => parseInt(el.dataset.id))
.filter(Number.isInteger);
}
function _dbToggleSelection(e) {
const checked = e.target.checked;
const checkboxes = document.querySelectorAll(
'#wfm-tagger-db-tbody input[type="checkbox"]'
);
checkboxes.forEach(checkbox => {
checkbox.checked = checked;
});
}
// ── ユーティリティ ───────────────────────────────────────────────
function _esc(str) {
+121 -10
View File
@@ -8,8 +8,12 @@
* to the real Gallery tab via the "Open in Gallery" button.
*/
import { VIDEO_GROUP, VTEMP_GROUP, ensureVideoGroup } from "./gallery-tab.js";
import { VIDEO_GROUP, VTEMP_GROUP, ensureVideoGroup, isVideoFile } from "./gallery-tab.js";
import { setSourcePreview } from "./video-preview.js";
import { showToast } from "./app.js";
import { t } from "./i18n.js";
import { addClipFromFile } from "./video-edit-tab.js";
import { setBlockImageFromFile } from "./video-plan-tab.js";
// Sentinel for the "All Video Assets" option — not a real backend group, since
// Gallery's group filter only ever matches one group at a time. Selecting it
@@ -27,8 +31,20 @@ const _s = {
images: [],
selectedPath: null,
loaded: false, // becomes true once the Asset subtab has been shown at least once
searchQuery: "",
viewMode: "grid", // "grid" | "table"
};
function _formatDate(mtime) {
return new Date(mtime * 1000).toLocaleString();
}
function _filteredImages() {
const q = _s.searchQuery.trim().toLowerCase();
if (!q) return _s.images;
return _s.images.filter((img) => img.filename.toLowerCase().includes(q));
}
async function _fetchOutputDir() {
if (_s.outputDir) return;
try {
@@ -92,7 +108,7 @@ async function _loadImages() {
images = await _fetchGroupImages(_s.group);
}
_s.images = images;
_renderGrid();
_renderList();
if (statusEl) statusEl.textContent = `${_s.images.length} video(s)`;
} catch (err) {
_s.images = [];
@@ -101,15 +117,55 @@ async function _loadImages() {
}
}
// Renders whichever of grid/table is active for the current viewMode — called
// on load, on search input, and after switching view modes.
function _renderList() {
if (_s.viewMode === "table") _renderTable();
else _renderGrid();
}
function _renderGrid() {
const grid = document.getElementById("wfm-video-asset-grid");
if (!grid) return;
if (_s.images.length === 0) {
const images = _filteredImages();
if (images.length === 0) {
grid.innerHTML = `<div class="wfm-placeholder">No videos yet</div>`;
return;
}
grid.innerHTML = "";
for (const img of _s.images) grid.appendChild(_makeCard(img));
for (const img of images) grid.appendChild(_makeCard(img));
}
function _renderTable() {
const body = document.getElementById("wfm-video-asset-table-body");
if (!body) return;
const images = _filteredImages();
if (images.length === 0) {
body.innerHTML = `<tr><td colspan="3" class="wfm-placeholder">No videos yet</td></tr>`;
return;
}
body.innerHTML = "";
for (const img of images) body.appendChild(_makeRow(img));
}
function _makeRow(img) {
const row = document.createElement("tr");
row.className = "wfm-video-asset-row" + (img.path === _s.selectedPath ? " selected" : "");
row.dataset.path = img.path;
const nameCell = document.createElement("td");
nameCell.textContent = img.filename;
nameCell.title = img.filename;
const dateCell = document.createElement("td");
dateCell.textContent = _formatDate(img.mtime);
const tagsCell = document.createElement("td");
tagsCell.textContent = (img.tags || []).join(", ");
row.append(nameCell, dateCell, tagsCell);
row.addEventListener("click", () => _selectImage(img));
return row;
}
function _makeCard(img) {
@@ -135,27 +191,30 @@ function _makeCard(img) {
function _selectImage(img) {
_s.selectedPath = img.path;
document.querySelectorAll(".wfm-video-asset-card").forEach((c) => {
document.querySelectorAll(".wfm-video-asset-card, .wfm-video-asset-row").forEach((c) => {
c.classList.toggle("selected", c.dataset.path === img.path);
});
_renderDetail(img);
_loadIntoSourcePreview(img);
}
// Feeds the selected asset's video into the center panel's Asset/Source preview
// Feeds the selected asset's media into the center panel's Asset/Source preview
// pane (see video-preview.js) so it's visible without switching tabs, and so the
// Frame/GIF property tools can operate on it just like a Video Source drop.
// Fetched as a Blob and wrapped as a "local" source rather than trying to map
// Gallery's arbitrary absolute path onto ComfyUI's filename/subfolder/type
// triple — that keeps the GIF tool's existing upload-on-first-use path working
// unchanged for both cases.
// unchanged for both cases. Still/animated images (this group isn't exclusively
// videos — anything tagged into it shows up here) preview via the pane's <img>
// companion element instead of trying to play them as a <video>.
async function _loadIntoSourcePreview(img) {
try {
const res = await fetch(`/wfm/gallery/image/serve?path=${encodeURIComponent(img.path)}`);
if (!res.ok) throw new Error(String(res.status));
const blob = await res.blob();
const file = new File([blob], img.filename, { type: blob.type || "video/mp4" });
setSourcePreview(URL.createObjectURL(file), { kind: "local", file });
const isVideo = isVideoFile(img);
const file = new File([blob], img.filename, { type: blob.type || (isVideo ? "video/mp4" : "image/png") });
setSourcePreview(URL.createObjectURL(file), { kind: "local", file }, isVideo ? "video" : "image");
} catch (err) {
console.warn("[VideoAsset] failed to load preview:", err);
}
@@ -178,7 +237,12 @@ function _renderDetail(img) {
<label style="margin-top:10px;">Memo</label>
<textarea id="wfm-video-asset-memo" class="wfm-textarea" rows="3"></textarea>
<button type="button" class="wfm-btn wfm-btn-sm" id="wfm-video-asset-memo-save" style="margin-top:6px;">Save Memo</button>
<button type="button" class="wfm-btn wfm-btn-primary wfm-btn-sm" id="wfm-video-asset-open-gallery" style="width:100%;margin-top:12px;">Open in Gallery</button>
<button type="button" class="wfm-btn wfm-btn-sm" id="wfm-video-asset-send-to-edit" style="width:100%;margin-top:12px;">${t("videoEditSendToEdit")}</button>
<div id="wfm-video-asset-set-plan-image-row" style="display:${isVideoFile(img) ? "none" : "flex"};gap:6px;margin-top:6px;">
<button type="button" class="wfm-btn wfm-btn-sm" id="wfm-video-asset-set-first" style="flex:1;">${t("videoAssetSetAsFirst")}</button>
<button type="button" class="wfm-btn wfm-btn-sm" id="wfm-video-asset-set-last" style="flex:1;">${t("videoAssetSetAsLast")}</button>
</div>
<button type="button" class="wfm-btn wfm-btn-primary wfm-btn-sm" id="wfm-video-asset-open-gallery" style="width:100%;margin-top:6px;">Open in Gallery</button>
`;
const nameEl = document.getElementById("wfm-video-asset-name");
@@ -205,6 +269,36 @@ function _renderDetail(img) {
img.memo = memo;
});
panel.querySelector("#wfm-video-asset-send-to-edit")?.addEventListener("click", async () => {
try {
const res = await fetch(`/wfm/gallery/image/serve?path=${encodeURIComponent(img.path)}`);
if (!res.ok) throw new Error(String(res.status));
const blob = await res.blob();
const file = new File([blob], img.filename, { type: blob.type || (isVideoFile(img) ? "video/mp4" : "image/png") });
addClipFromFile(file, img.filename);
document.querySelector('.wfm-video-center-panel .wfm-video-subtab-btn[data-video-subtab="edit"]')?.click();
showToast(t("videoEditClipSent", img.filename), "success");
} catch (err) {
showToast(t("errorWithMsg", err.message), "error");
}
});
const setAsPlanImage = async (which) => {
try {
const res = await fetch(`/wfm/gallery/image/serve?path=${encodeURIComponent(img.path)}`);
if (!res.ok) throw new Error(String(res.status));
const blob = await res.blob();
const file = new File([blob], img.filename, { type: blob.type || "image/png" });
await setBlockImageFromFile(which, file);
document.querySelector('.wfm-video-center-panel .wfm-video-subtab-btn[data-video-subtab="plan"]')?.click();
showToast(t(which === "first" ? "videoAssetSetAsFirstDone" : "videoAssetSetAsLastDone", img.filename), "success");
} catch (err) {
showToast(t("errorWithMsg", err.message), "error");
}
};
panel.querySelector("#wfm-video-asset-set-first")?.addEventListener("click", () => setAsPlanImage("first"));
panel.querySelector("#wfm-video-asset-set-last")?.addEventListener("click", () => setAsPlanImage("last"));
panel.querySelector("#wfm-video-asset-open-gallery")?.addEventListener("click", () => {
document.querySelector('.wfm-tab[data-tab="gallery"]')?.click();
const filterSel = document.getElementById("wfm-gallery-group-filter");
@@ -275,6 +369,17 @@ export async function refreshVideoAssetTab() {
await _loadImages();
}
function _setViewMode(mode) {
_s.viewMode = mode;
document.getElementById("wfm-video-asset-view-grid")?.classList.toggle("active", mode === "grid");
document.getElementById("wfm-video-asset-view-table")?.classList.toggle("active", mode === "table");
const grid = document.getElementById("wfm-video-asset-grid");
const tableWrap = document.getElementById("wfm-video-asset-table-wrap");
if (grid) grid.style.display = mode === "grid" ? "" : "none";
if (tableWrap) tableWrap.style.display = mode === "table" ? "" : "none";
_renderList();
}
export function initVideoAssetTab() {
document.getElementById("wfm-video-asset-group")?.addEventListener("change", (e) => {
_s.group = e.target.value;
@@ -284,6 +389,12 @@ export function initVideoAssetTab() {
_loadImages();
});
document.getElementById("wfm-video-asset-refresh")?.addEventListener("click", () => _loadImages());
document.getElementById("wfm-video-asset-search")?.addEventListener("input", (e) => {
_s.searchQuery = e.target.value;
_renderList();
});
document.getElementById("wfm-video-asset-view-grid")?.addEventListener("click", () => _setViewMode("grid"));
document.getElementById("wfm-video-asset-view-table")?.addEventListener("click", () => _setViewMode("table"));
// Neither reserved group is ever auto-created by a batch run itself (see
// video-plan-tab.js's _ensureVideoAssetGroups, which only ensures
+958
View File
@@ -0,0 +1,958 @@
/**
* Video Tab - Edit subtab: a minimal non-linear-editor-style clip timeline
* (MVP scope: add clips, reorder, trim, concatenate, export).
*
* Design (see VIDEO_EDIT_TAB_PLAN.md at the repo root for the full writeup):
* - Every clip is uploaded to ComfyUI's `input` area on add (same
* upload-on-first-use pattern as video-tab.js's GIF tool), then probed
* via /api/wfm/video/edit/probe (PyAV, no ffmpeg) for duration/width/height.
* - Export builds a ComfyUI API-format prompt directly (LoadVideo -> VideoTrim
* per clip -> ConcatenateVideo (if >1 clip) -> SaveVideo) and runs it through
* the existing comfyUI.queuePrompt()/trackProgress() infra — no new backend
* "build workflow" endpoint needed.
* - Trim/scrub preview reuses the existing Source preview pane (video-preview.js)
* instead of a second <video> element — selecting a clip loads it there,
* exactly like video-asset-tab.js already does for asset selection.
*
* Confirmed against a live ComfyUI 0.36.0 instance (see plan doc "Phase 0"):
* - The class_type for the simple trim node is `"Video Slice"` (WITH A SPACE —
* `/object_info/VideoSlice` looks empty because that's not its real id; its
* node_id is literally "Video Slice"). It takes plain flat inputs
* (video/start_time/duration/strict_duration), no VIDEO_EDIT nesting, and
* is not experimental — this is what's used here, not `VideoTrim`.
* `VideoTrim`'s `trim` input, if ever needed, must be double-nested —
* `{"trim": {"start_time":.., "duration":..}}` — because its execute()
* does `(trim or {}).get("trim")` before reading start_time/duration; a
* flat `{"start_time":..}` value is silently accepted and silently
* no-ops (verified: it does NOT raise, it just doesn't trim anything).
* - `ConcatenateVideo`'s Autogrow `videos` input is addressed via flat,
* dot-joined keys at the top level of `inputs`: "videos.video0",
* "videos.video1", ... (0-indexed) — NOT a nested object and NOT plain
* "video0"/"video1" without the "videos." prefix.
* - ConcatenateVideo hard-errors at execution time if clip frame dimensions
* differ, so mismatched clips are blocked client-side before export —
* but only between VIDEO clips; an image clip is auto-fit (ImageScale,
* center-crop) to match, since it isn't fixed-resolution source footage.
*
* Image clips: a still or animated image dropped in has no inherent video
* duration, so it gets a user-editable "hold" length instead of in/out trim
* points (clip.trimStart stays 0, clip.trimEnd IS the hold length — this
* keeps it a drop-in replacement everywhere the code already reads
* trimEnd-trimStart as "this clip's length in the timeline", e.g. the block
* width calc and the total-duration readout). Export turns it into a real
* VIDEO segment via LoadImage -> (ImageScale, only if resolution needs to
* match) -> RepeatImageBatch(amount = holdSeconds * fps) -> CreateVideo —
* confirmed on a live instance to produce an exact-duration, correctly
* concatenation-compatible clip (see VIDEO_EDIT_TAB_PLAN.md "Image clips").
*/
import { showToast } from "./app.js";
import { t } from "./i18n.js";
import { comfyUI } from "./comfyui-client.js";
import {
setSourcePreview, setResultPreview, getActivePreviewVideoElement, getResultPreviewVideoElement,
} from "./video-preview.js";
import { VTEMP_GROUP, ensureVideoGroup } from "./gallery-tab.js";
const _s = {
clips: [], // { id, name, file, kind:"video"|"image", serverRef:{filename,subfolder,type}|null, duration, width, height, fps, trimStart, trimEnd, probing, error }
selectedId: null,
exporting: false,
nextId: 1,
outputDir: "",
};
// Pixel-per-second scale for the timeline track — clips are laid out at their
// real (trimmed) duration and left-aligned, NOT stretched to fill the track
// width like the Plan tab's blocks (whose widths are relative shares of a
// fixed-length plan) — Edit's timeline represents actual seconds.
const _PX_PER_SEC = 20;
const _MIN_BLOCK_PX = 56;
// Default hold length for a freshly-added image clip; user-adjustable per
// clip afterward in the trim panel.
const _DEFAULT_IMAGE_DURATION = 3.0;
// fps used when turning a held image into a video segment for export/preview
// concatenation — arbitrary but consistent (doesn't need to match other
// clips' native fps; ConcatenateVideo works at the container/frame level).
const _IMAGE_EXPORT_FPS = 24;
let _dragClipId = null; // clip being dragged for timeline reordering
// ============================================
// Output-dir lookup (same small helper video-asset-tab.js / video-plan-tab.js
// each keep their own copy of — needed to build the absolute path Gallery's
// group-tagging API expects).
// ============================================
async function _fetchOutputDir() {
if (_s.outputDir) return;
try {
const res = await fetch("/api/wfm/settings/output-dir");
if (res.ok) {
const data = await res.json();
_s.outputDir = (data.current || "").replace(/\\/g, "/").replace(/\/$/, "");
}
} catch { /* non-critical */ }
}
// ============================================
// Clip list state
// ============================================
function _selectedClip() {
return _s.clips.find((c) => c.id === _s.selectedId) || null;
}
// Exported so video-asset-tab.js's "Send to Edit" button can add an asset
// (already fetched as a Blob/File the same way it feeds the Source preview)
// without either module importing the other's internals.
export function addClipFromFile(file, displayName) {
const kind = file.type.startsWith("video/") ? "video" : "image";
const clip = {
id: _s.nextId++,
name: displayName || file.name,
file,
kind,
serverRef: null,
duration: kind === "image" ? _DEFAULT_IMAGE_DURATION : 0,
width: 0,
height: 0,
fps: 0,
trimStart: 0,
trimEnd: kind === "image" ? _DEFAULT_IMAGE_DURATION : 0,
probing: true,
error: null,
};
_s.clips.push(clip);
_s.selectedId = clip.id;
_renderTimeline();
_renderTrimPanel();
setSourcePreview(URL.createObjectURL(file), { kind: "local", file }, kind);
if (kind === "image") _probeImageClip(clip);
else _probeClip(clip);
}
async function _probeClip(clip) {
try {
const uploaded = await comfyUI.uploadImage(clip.file, clip.file.name);
clip.serverRef = { filename: uploaded.name, subfolder: uploaded.subfolder || "", type: "input" };
const params = new URLSearchParams({
filename: clip.serverRef.filename,
subfolder: clip.serverRef.subfolder,
type: clip.serverRef.type,
});
const res = await fetch(`/api/wfm/video/edit/probe?${params}`);
const json = await res.json();
if (!res.ok) throw new Error(json.error || `HTTP ${res.status}`);
clip.duration = json.duration || 0;
clip.width = json.width || 0;
clip.height = json.height || 0;
clip.fps = json.fps || 0;
clip.trimStart = 0;
clip.trimEnd = clip.duration;
} catch (err) {
clip.error = err.message;
showToast(t("errorWithMsg", err.message), "error");
} finally {
clip.probing = false;
_renderTimeline();
if (_s.selectedId === clip.id) _renderTrimPanel();
}
}
// Image dimensions are read client-side (no server round-trip needed — PyAV
// isn't reliable for opening arbitrary still-image formats as "video" the
// way it is for real video containers) via a throwaway <img>, revoking its
// blob URL once read either way.
function _readImageDimensions(file) {
return new Promise((resolve, reject) => {
const url = URL.createObjectURL(file);
const img = new Image();
img.onload = () => { URL.revokeObjectURL(url); resolve({ width: img.naturalWidth, height: img.naturalHeight }); };
img.onerror = () => { URL.revokeObjectURL(url); reject(new Error("Failed to read image dimensions")); };
img.src = url;
});
}
async function _probeImageClip(clip) {
try {
const uploaded = await comfyUI.uploadImage(clip.file, clip.file.name);
clip.serverRef = { filename: uploaded.name, subfolder: uploaded.subfolder || "", type: "input" };
const dims = await _readImageDimensions(clip.file);
clip.width = dims.width;
clip.height = dims.height;
// duration/trimEnd already hold the default (or a previously-edited)
// hold length — probing an image only needs to fill in serverRef/size.
} catch (err) {
clip.error = err.message;
showToast(t("errorWithMsg", err.message), "error");
} finally {
clip.probing = false;
_renderTimeline();
if (_s.selectedId === clip.id) _renderTrimPanel();
}
}
function _moveClip(id, delta) {
const idx = _s.clips.findIndex((c) => c.id === id);
const target = idx + delta;
if (idx < 0 || target < 0 || target >= _s.clips.length) return;
[_s.clips[idx], _s.clips[target]] = [_s.clips[target], _s.clips[idx]];
_renderTimeline();
}
function _duplicateClip(id) {
const idx = _s.clips.findIndex((c) => c.id === id);
if (idx < 0) return;
const clone = { ..._s.clips[idx], id: _s.nextId++ };
_s.clips.splice(idx + 1, 0, clone);
_s.selectedId = clone.id;
_renderTimeline();
_renderTrimPanel();
}
function _deleteClip(id) {
_stopPreview();
_s.clips = _s.clips.filter((c) => c.id !== id);
if (_s.selectedId === id) {
_s.selectedId = _s.clips.length ? _s.clips[0].id : null;
if (_s.selectedId) _selectClip(_s.selectedId);
else setSourcePreview(null, null);
}
_renderTimeline();
_renderTrimPanel();
}
function _clearTimeline() {
if (_s.clips.length === 0) return;
if (!confirm(t("videoEditConfirmClear"))) return;
_stopPreview();
_s.clips = [];
_s.selectedId = null;
setSourcePreview(null, null);
_renderTimeline();
_renderTrimPanel();
}
function _selectClip(id) {
_s.selectedId = id;
const clip = _selectedClip();
_renderTimeline();
_renderTrimPanel();
if (clip) setSourcePreview(URL.createObjectURL(clip.file), { kind: "local", file: clip.file }, clip.kind);
}
// ============================================
// Resolution-mismatch guard — ConcatenateVideo hard-errors at execution time
// on mismatched frame dimensions (confirmed on a live 0.36.0 instance), so
// this is checked client-side before ever building the export graph. Only
// VIDEO clips are compared: an image clip's resolution is auto-fit at export
// time (see _buildExportWorkflow), so it can never be the thing blocking export.
// ============================================
function _findResolutionMismatch(clips) {
const sized = clips.filter((c) => c.kind === "video" && c.width && c.height);
if (sized.length < 2) return null;
const first = sized[0];
const mismatched = sized.find((c) => c.width !== first.width || c.height !== first.height);
if (!mismatched) return null;
return t("videoEditResolutionMismatch", `${first.name} (${first.width}x${first.height})`, `${mismatched.name} (${mismatched.width}x${mismatched.height})`);
}
// ============================================
// Rendering
// ============================================
function _fmtTime(s) {
if (!s && s !== 0) return "--";
return `${s.toFixed(1)}s`;
}
// M:SS.ds timecode for the trim scrubber's ruler ticks and badges (mirrors
// the "0:01.70" style Clipchamp-like editors use) — distinct from _fmtTime's
// coarser "1.7s" used elsewhere (timeline block meta, total-duration readout).
function _fmtTimecode(s) {
const clamped = Math.max(0, s || 0);
const m = Math.floor(clamped / 60);
const sec = clamped - m * 60;
return `${m}:${sec.toFixed(2).padStart(5, "0")}`;
}
// Horizontal timeline track (see VIDEO_EDIT_TAB_PLAN.md's UI redesign note):
// clips are laid out left-to-right at their real (trimmed) duration on a
// fixed px/sec scale and left-aligned — an empty track stays empty on the
// right rather than stretching clips to fill it. Reordering is done either
// by dragging a block onto another (native HTML5 DnD) or via the shared
// toolbar buttons below the track, which act on whichever clip is selected
// (mirrors the Plan subtab's "+Split/+Block/Delete" toolbar pattern instead
// of giving every row its own set of buttons).
function _renderTimeline() {
const track = document.getElementById("wfm-video-edit-timeline-track");
if (!track) return;
track.innerHTML = "";
if (_s.clips.length === 0) {
const placeholder = document.createElement("span");
placeholder.className = "wfm-placeholder wfm-video-edit-timeline-placeholder";
placeholder.textContent = t("videoEditNoClipsHint");
track.appendChild(placeholder);
_updateToolbarState();
return;
}
_s.clips.forEach((clip) => {
const block = document.createElement("div");
block.className = "wfm-video-edit-timeline-block" + (clip.id === _s.selectedId ? " selected" : "");
const seconds = clip.probing || clip.error ? 0 : Math.max(0.1, clip.trimEnd - clip.trimStart);
block.style.width = `${Math.max(_MIN_BLOCK_PX, Math.round(seconds * _PX_PER_SEC))}px`;
block.title = clip.name;
block.draggable = true;
const nameEl = document.createElement("div");
nameEl.className = "wfm-video-edit-timeline-block-name";
nameEl.textContent = `${clip.kind === "image" ? "🖼" : "🎬"} ${clip.name}`;
const metaEl = document.createElement("div");
metaEl.className = "wfm-video-edit-timeline-block-meta";
if (clip.probing) metaEl.textContent = t("videoEditProbing");
else if (clip.error) metaEl.textContent = "✗";
else metaEl.textContent = _fmtTime(clip.trimEnd - clip.trimStart);
block.append(nameEl, metaEl);
block.addEventListener("click", () => _selectClip(clip.id));
block.addEventListener("dragstart", (e) => {
_dragClipId = clip.id;
e.dataTransfer.effectAllowed = "move";
});
block.addEventListener("dragover", (e) => e.preventDefault());
block.addEventListener("drop", (e) => {
e.preventDefault();
e.stopPropagation();
_reorderByDrop(clip.id);
});
track.appendChild(block);
});
_updateToolbarState();
}
function _reorderByDrop(targetId) {
if (_dragClipId == null || _dragClipId === targetId) { _dragClipId = null; return; }
const fromIdx = _s.clips.findIndex((c) => c.id === _dragClipId);
_dragClipId = null;
if (fromIdx < 0) return;
// Remove first, then look up the target's index in the now-shortened array —
// sidesteps the off-by-one from a naive "look up both indices, then splice
// twice" approach when fromIdx < toIdx. Dropping onto a block inserts the
// dragged clip right before it; dropping past the last block (targetId
// null, from the track's own drop handler) appends to the end.
const [moved] = _s.clips.splice(fromIdx, 1);
if (targetId == null) {
_s.clips.push(moved);
} else {
const toIdx = _s.clips.findIndex((c) => c.id === targetId);
_s.clips.splice(toIdx < 0 ? _s.clips.length : toIdx, 0, moved);
}
_renderTimeline();
}
function _updateToolbarState() {
const idx = _s.clips.findIndex((c) => c.id === _s.selectedId);
const hasSelection = idx >= 0;
const setDisabled = (id, disabled) => {
const el = document.getElementById(id);
if (el) el.disabled = disabled;
};
setDisabled("wfm-video-edit-move-left-btn", !hasSelection || idx === 0);
setDisabled("wfm-video-edit-move-right-btn", !hasSelection || idx === _s.clips.length - 1);
setDisabled("wfm-video-edit-duplicate-btn", !hasSelection);
setDisabled("wfm-video-edit-delete-btn", !hasSelection);
setDisabled("wfm-video-edit-clear-btn", _s.clips.length === 0);
setDisabled("wfm-video-edit-preview-btn", _s.clips.length === 0);
_updateTotalDuration();
}
function _updateTotalDuration() {
const el = document.getElementById("wfm-video-edit-total-duration");
if (!el) return;
const total = _s.clips.reduce((sum, c) => {
if (c.probing || c.error) return sum;
return sum + Math.max(0, c.trimEnd - c.trimStart);
}, 0);
el.textContent = _s.clips.length === 0 ? "" : t("videoEditTotalDuration", _fmtTime(total));
}
// ============================================
// Trim scrubber — Clipchamp-style visual timeline for the selected video
// clip's trim panel: a time ruler, a draggable in/out range, and a playhead
// synced to the Source preview's <video> element. All positions are computed
// as percentages of clip.duration (not px/sec) so no separate zoom/scale
// bookkeeping is needed — the track just fills whatever width the panel gives it.
// ============================================
// Tracks the (element, listener) pair currently wired to a <video>'s
// "timeupdate" so it can be torn down before the next clip selection reuses
// the same persistent preview element (see video-preview.js) — otherwise
// listeners would pile up across every clip switch.
let _scrubVideoEl = null;
let _scrubVideoListener = null;
function _teardownTrimScrubber() {
if (_scrubVideoEl && _scrubVideoListener) {
_scrubVideoEl.removeEventListener("timeupdate", _scrubVideoListener);
}
_scrubVideoEl = null;
_scrubVideoListener = null;
}
// "Nice" tick spacing so the ruler shows roughly 5-8 labeled ticks regardless
// of clip length (a 3s clip gets 0.5s ticks, a 5min clip gets 60s ticks).
function _niceRulerStep(duration) {
const rough = duration / 6;
const candidates = [0.5, 1, 2, 5, 10, 15, 30, 60, 120, 300, 600];
return candidates.find((c) => c >= rough) || candidates[candidates.length - 1];
}
function _renderRuler(ruler, duration) {
ruler.innerHTML = "";
if (!duration) return;
const step = _niceRulerStep(duration);
for (let time = 0; time <= duration + 0.001; time += step) {
const tick = document.createElement("span");
tick.className = "wfm-video-trim-ruler-tick";
tick.style.left = `${Math.min(100, (time / duration) * 100)}%`;
tick.textContent = _fmtTimecode(time).replace(/\.\d+$/, "");
ruler.appendChild(tick);
}
}
// Wires the scrubber DOM (already inserted into the trim panel by
// _renderTrimPanel) for one video clip. `commit` is the trim-panel's own
// start/end-input commit function — the scrubber drives it via the same
// inputs rather than writing clip.trimStart/trimEnd directly, so both paths
// (typed numbers, dragged handles) stay in sync through one code path.
function _wireTrimScrubber(clip, startInput, endInput, commit) {
const track = document.getElementById("wfm-video-trim-track");
const ruler = document.getElementById("wfm-video-trim-ruler");
const rangeEl = document.getElementById("wfm-video-trim-range");
const handleStart = document.getElementById("wfm-video-trim-handle-start");
const handleEnd = document.getElementById("wfm-video-trim-handle-end");
const playhead = document.getElementById("wfm-video-trim-playhead");
const badgeStart = document.getElementById("wfm-video-trim-badge-start");
const badgeEnd = document.getElementById("wfm-video-trim-badge-end");
const badgePlayhead = document.getElementById("wfm-video-trim-badge-playhead");
if (!track || !clip.duration) return;
_renderRuler(ruler, clip.duration);
const pct = (t) => `${Math.min(100, Math.max(0, (t / clip.duration) * 100))}%`;
function updateRange() {
rangeEl.style.left = pct(clip.trimStart);
rangeEl.style.width = `${Math.max(0, ((Math.min(clip.trimEnd, clip.duration) - clip.trimStart) / clip.duration) * 100)}%`;
handleStart.style.left = pct(clip.trimStart);
handleEnd.style.left = pct(clip.trimEnd);
badgeStart.textContent = _fmtTimecode(clip.trimStart);
badgeEnd.textContent = _fmtTimecode(clip.trimEnd);
}
updateRange();
function updatePlayhead(t) {
playhead.style.left = pct(t);
badgePlayhead.textContent = _fmtTimecode(t);
}
const video = getActivePreviewVideoElement();
if (video) {
_scrubVideoEl = video;
_scrubVideoListener = () => updatePlayhead(video.currentTime);
video.addEventListener("timeupdate", _scrubVideoListener);
updatePlayhead(video.currentTime);
} else {
updatePlayhead(0);
}
function seekTo(clientX) {
const rect = track.getBoundingClientRect();
const ratio = Math.min(1, Math.max(0, (clientX - rect.left) / rect.width));
const t = ratio * clip.duration;
const v = getActivePreviewVideoElement();
if (v) v.currentTime = t;
updatePlayhead(t);
}
// Drags a trim handle: while pointer is down, only the scrubber's own
// visuals (range/handle position, badge text) update — clip.trimStart/End
// and the timeline block widths commit once on pointerup, so dragging
// doesn't thrash _renderTimeline() on every mousemove.
function wireHandleDrag(handleEl, isStart) {
handleEl.addEventListener("pointerdown", (e) => {
e.preventDefault();
e.stopPropagation();
handleEl.setPointerCapture(e.pointerId);
const onMove = (ev) => {
const rect = track.getBoundingClientRect();
const ratio = Math.min(1, Math.max(0, (ev.clientX - rect.left) / rect.width));
const t = ratio * clip.duration;
if (isStart) startInput.value = Math.min(t, clip.trimEnd - 0.05).toFixed(2);
else endInput.value = Math.max(t, clip.trimStart + 0.05).toFixed(2);
commit({ skipTimelineRerender: true });
updateRange();
};
const onUp = () => {
handleEl.removeEventListener("pointermove", onMove);
handleEl.removeEventListener("pointerup", onUp);
_renderTimeline();
};
handleEl.addEventListener("pointermove", onMove);
handleEl.addEventListener("pointerup", onUp);
});
}
wireHandleDrag(handleStart, true);
wireHandleDrag(handleEnd, false);
track.addEventListener("pointerdown", (e) => {
if (e.target === handleStart || e.target === handleEnd || e.target === playhead) return;
seekTo(e.clientX);
});
playhead.addEventListener("pointerdown", (e) => {
e.preventDefault();
e.stopPropagation();
playhead.setPointerCapture(e.pointerId);
const onMove = (ev) => seekTo(ev.clientX);
const onUp = () => {
playhead.removeEventListener("pointermove", onMove);
playhead.removeEventListener("pointerup", onUp);
};
playhead.addEventListener("pointermove", onMove);
playhead.addEventListener("pointerup", onUp);
});
}
function _renderTrimPanel() {
const panel = document.getElementById("wfm-video-edit-trim-panel");
if (!panel) return;
_teardownTrimScrubber();
const clip = _selectedClip();
if (!clip) {
panel.innerHTML = `<span class="wfm-placeholder">${t("videoEditSelectClipHint")}</span>`;
return;
}
if (clip.probing) {
panel.innerHTML = `<span class="wfm-placeholder">${t("videoEditProbing")}</span>`;
return;
}
if (clip.error) {
panel.innerHTML = `<span class="wfm-placeholder" style="color:var(--wfm-danger)">✗ ${clip.error}</span>`;
return;
}
// clip.name is a user-controlled filename — kept out of the innerHTML string
// and assigned via textContent afterward (same pattern as video-asset-tab.js's
// _renderDetail()), so it can never be interpreted as markup.
if (clip.kind === "image") {
panel.innerHTML = `
<div class="wfm-video-edit-clip-name" id="wfm-video-edit-trim-clip-name" style="margin-bottom:6px;"></div>
<div class="wfm-video-edit-trim-field" style="max-width:160px;">
<label>${t("videoEditImageDuration")}</label>
<input type="number" id="wfm-video-edit-image-duration" class="wfm-input" step="0.1" min="0.1" value="${clip.trimEnd.toFixed(2)}">
</div>
`;
const nameEl = document.getElementById("wfm-video-edit-trim-clip-name");
if (nameEl) { nameEl.textContent = clip.name; nameEl.title = clip.name; }
const durInput = document.getElementById("wfm-video-edit-image-duration");
durInput.addEventListener("change", () => {
const val = Math.max(0.1, Number(durInput.value) || _DEFAULT_IMAGE_DURATION);
clip.trimEnd = val;
clip.duration = val;
durInput.value = val.toFixed(2);
_renderTimeline();
});
return;
}
panel.innerHTML = `
<div class="wfm-video-edit-clip-name" id="wfm-video-edit-trim-clip-name" style="margin-bottom:6px;"></div>
<div class="wfm-video-trim-scrubber" id="wfm-video-trim-scrubber">
<div class="wfm-video-trim-ruler" id="wfm-video-trim-ruler"></div>
<div class="wfm-video-trim-track" id="wfm-video-trim-track">
<div class="wfm-video-trim-range" id="wfm-video-trim-range"></div>
<div class="wfm-video-trim-handle" id="wfm-video-trim-handle-start">
<span class="wfm-video-trim-badge" id="wfm-video-trim-badge-start"></span>
</div>
<div class="wfm-video-trim-handle" id="wfm-video-trim-handle-end">
<span class="wfm-video-trim-badge" id="wfm-video-trim-badge-end"></span>
</div>
<div class="wfm-video-trim-playhead" id="wfm-video-trim-playhead">
<span class="wfm-video-trim-badge wfm-video-trim-badge-playhead" id="wfm-video-trim-badge-playhead"></span>
</div>
</div>
</div>
<div class="wfm-video-edit-trim-row" style="margin-top:10px;">
<div class="wfm-video-edit-trim-field">
<label>${t("videoEditTrimStart")}</label>
<input type="number" id="wfm-video-edit-trim-start" class="wfm-input" step="0.1" min="0" max="${clip.duration}" value="${clip.trimStart.toFixed(2)}">
<button type="button" class="wfm-btn wfm-btn-xs wfm-video-edit-playhead-btn" id="wfm-video-edit-trim-start-set">${t("videoEditSetFromPlayhead")}</button>
</div>
<div class="wfm-video-edit-trim-field">
<label>${t("videoEditTrimEnd")}</label>
<input type="number" id="wfm-video-edit-trim-end" class="wfm-input" step="0.1" min="0" max="${clip.duration}" value="${clip.trimEnd.toFixed(2)}">
<button type="button" class="wfm-btn wfm-btn-xs wfm-video-edit-playhead-btn" id="wfm-video-edit-trim-end-set">${t("videoEditSetFromPlayhead")}</button>
</div>
</div>
`;
const nameEl = document.getElementById("wfm-video-edit-trim-clip-name");
if (nameEl) { nameEl.textContent = clip.name; nameEl.title = clip.name; }
const startInput = document.getElementById("wfm-video-edit-trim-start");
const endInput = document.getElementById("wfm-video-edit-trim-end");
// skipTimelineRerender: the scrubber's handle-drag calls this on every
// pointermove (see _wireTrimScrubber) — re-running _renderTimeline() that
// often would rebuild every timeline block per mousemove for no visible
// benefit, since the scrubber already redraws its own range live.
const commit = ({ skipTimelineRerender } = {}) => {
let start = Math.max(0, Math.min(Number(startInput.value) || 0, clip.duration));
let end = Math.max(0, Math.min(Number(endInput.value) || 0, clip.duration));
if (end <= start) end = Math.min(clip.duration, start + 0.1);
clip.trimStart = start;
clip.trimEnd = end;
startInput.value = start.toFixed(2);
endInput.value = end.toFixed(2);
if (!skipTimelineRerender) _renderTimeline();
};
startInput.addEventListener("change", commit);
endInput.addEventListener("change", commit);
document.getElementById("wfm-video-edit-trim-start-set")?.addEventListener("click", () => {
const video = getActivePreviewVideoElement();
if (video) { startInput.value = video.currentTime.toFixed(2); commit(); }
});
document.getElementById("wfm-video-edit-trim-end-set")?.addEventListener("click", () => {
const video = getActivePreviewVideoElement();
if (video) { endInput.value = video.currentTime.toFixed(2); commit(); }
});
_wireTrimScrubber(clip, startInput, endInput, commit);
}
// ============================================
// Sequential timeline preview — plays every ready clip back-to-back (each
// trimmed to its in/out point) in the shared "Result" pane (the same one
// Export writes its finished output into), so what plays there is always
// exactly what Export would currently produce. Deliberately reuses that pane
// rather than a third <video> element: the user asked for it to be the same
// slot the exported video lands in, not a separate preview area.
// ============================================
let _previewPlaying = false;
let _previewClips = [];
let _previewIndex = 0;
let _previewImageTimer = null; // holds an image clip on screen for its duration (setTimeout, no video events to hook)
function _onPreviewTimeUpdate() {
const video = getResultPreviewVideoElement();
const clip = _previewClips[_previewIndex];
if (!video || !clip || clip.kind !== "video") return;
if (video.currentTime >= clip.trimEnd) _advancePreview();
}
function _advancePreview() {
_previewIndex += 1;
if (_previewIndex >= _previewClips.length) { _stopPreview(); return; }
_playPreviewClip();
}
function _playPreviewClip() {
const clip = _previewClips[_previewIndex];
if (!clip) { _stopPreview(); return; }
if (clip.kind === "image") {
const video = getResultPreviewVideoElement();
video?.pause();
setResultPreview(URL.createObjectURL(clip.file), { kind: "local", file: clip.file }, "image");
const holdMs = Math.max(50, (clip.trimEnd - clip.trimStart) * 1000);
_previewImageTimer = setTimeout(_advancePreview, holdMs);
return;
}
const video = getResultPreviewVideoElement();
if (!video) { _stopPreview(); return; }
setResultPreview(URL.createObjectURL(clip.file), { kind: "local", file: clip.file }, "video");
// currentTime only reliably applies once the new source has metadata —
// setting it immediately after swapping src is flaky across browsers.
const onReady = () => {
video.removeEventListener("loadedmetadata", onReady);
video.currentTime = clip.trimStart;
video.play().catch(() => {});
};
video.addEventListener("loadedmetadata", onReady);
}
function _startPreview() {
_previewClips = _s.clips.filter((c) => !c.probing && !c.error);
if (_previewClips.length === 0) {
showToast(t("videoEditNoClips"), "error");
return;
}
_previewIndex = 0;
_previewPlaying = true;
const video = getResultPreviewVideoElement();
video?.addEventListener("timeupdate", _onPreviewTimeUpdate);
video?.addEventListener("ended", _advancePreview);
_playPreviewClip();
_updatePreviewBtn();
}
function _stopPreview() {
_previewPlaying = false;
if (_previewImageTimer) { clearTimeout(_previewImageTimer); _previewImageTimer = null; }
const video = getResultPreviewVideoElement();
video?.removeEventListener("timeupdate", _onPreviewTimeUpdate);
video?.removeEventListener("ended", _advancePreview);
video?.pause();
_updatePreviewBtn();
}
function _togglePreview() {
if (_previewPlaying) _stopPreview();
else _startPreview();
}
function _updatePreviewBtn() {
const btn = document.getElementById("wfm-video-edit-preview-btn");
if (btn) btn.textContent = _previewPlaying ? t("videoEditPreviewStop") : t("videoEditPreviewPlay");
}
// ============================================
// Export — builds a ComfyUI API-format prompt directly (see module header for
// the confirmed input formats) and runs it through the existing execution
// infrastructure (comfyui-client.js), exactly like video-plan-tab.js does.
// ============================================
function _buildExportWorkflow(clips) {
const prompt = {};
let nextId = 1;
const alloc = () => String(nextId++);
const trimOutputs = [];
// Auto-fit target for image clips: the first VIDEO clip's resolution, so
// a still dropped alongside real footage doesn't need to be pre-sized by
// hand (see _findResolutionMismatch, which only ever compares VIDEO
// clips against each other — images are exempt because of this fit step).
const videoClip = clips.find((c) => c.kind === "video");
const targetW = videoClip ? videoClip.width : clips[0]?.width;
const targetH = videoClip ? videoClip.height : clips[0]?.height;
// Only strip audio when clips will actually be concatenated — a single
// video clip never goes through ConcatenateVideo, so there's no mixed-
// audio compatibility problem to avoid and its audio can be kept intact.
const needsUniformSilence = clips.length > 1;
for (const clip of clips) {
const file = clip.serverRef.subfolder
? `${clip.serverRef.subfolder}/${clip.serverRef.filename}`
: clip.serverRef.filename;
if (clip.kind === "image") {
const loadId = alloc();
prompt[loadId] = { class_type: "LoadImage", inputs: { image: file } };
let imageOut = [loadId, 0];
if (targetW && targetH && (clip.width !== targetW || clip.height !== targetH)) {
const scaleId = alloc();
prompt[scaleId] = {
class_type: "ImageScale",
inputs: { image: imageOut, upscale_method: "lanczos", width: targetW, height: targetH, crop: "center" },
};
imageOut = [scaleId, 0];
}
const repeatId = alloc();
const amount = Math.max(1, Math.round((clip.trimEnd - clip.trimStart) * _IMAGE_EXPORT_FPS));
prompt[repeatId] = { class_type: "RepeatImageBatch", inputs: { image: imageOut, amount } };
const createId = alloc();
prompt[createId] = {
class_type: "CreateVideo",
inputs: { images: [repeatId, 0], fps: _IMAGE_EXPORT_FPS, codec: "auto" },
};
trimOutputs.push(createId);
continue;
}
const loadId = alloc();
prompt[loadId] = { class_type: "LoadVideo", inputs: { file } };
const trimId = alloc();
prompt[trimId] = {
class_type: "Video Slice",
inputs: {
video: [loadId, 0],
start_time: clip.trimStart,
duration: Math.max(0.05, clip.trimEnd - clip.trimStart),
strict_duration: false,
},
};
if (!needsUniformSilence) {
trimOutputs.push(trimId);
continue;
}
// Strip audio by decomposing/recomposing through GetVideoComponents ->
// CreateVideo (audio input left unset). Verified on a live instance:
// ConcatenateVideo hard-errors mixing a clip with stereo/32kHz audio
// next to a silent image-derived clip ("audio layout: expected None,
// got 'stereo'"), so every clip is made silent whenever more than one
// clip is being concatenated. This means a multi-clip export never
// carries audio — a known MVP limitation, not handled per-clip
// because ConcatenateVideo needs uniform audio across all inputs. A
// lone clip (see needsUniformSilence above) keeps its original audio.
const componentsId = alloc();
prompt[componentsId] = { class_type: "GetVideoComponents", inputs: { video: [trimId, 0] } };
const silentId = alloc();
prompt[silentId] = {
class_type: "CreateVideo",
inputs: { images: [componentsId, 0], fps: [componentsId, 2], codec: "auto" },
};
trimOutputs.push(silentId);
}
let finalOutput;
if (trimOutputs.length === 1) {
finalOutput = [trimOutputs[0], 0];
} else {
const concatId = alloc();
const inputs = { codec: "auto" };
// Autogrow's flat "videos.videoN" key format — see module header.
trimOutputs.forEach((tid, i) => { inputs[`videos.video${i}`] = [tid, 0]; });
prompt[concatId] = { class_type: "ConcatenateVideo", inputs };
finalOutput = [concatId, 0];
}
const saveId = alloc();
prompt[saveId] = {
class_type: "SaveVideo",
inputs: { video: finalOutput, filename_prefix: "video/wfm_edit", format: "auto" },
};
return { prompt, saveId };
}
function _setExportUi(running, pct) {
const btn = document.getElementById("wfm-video-edit-export-btn");
const bar = document.getElementById("wfm-video-edit-progress-bar");
const text = document.getElementById("wfm-video-edit-progress-text");
if (btn) btn.disabled = running;
if (bar) bar.style.width = `${Math.round((pct || 0) * 100)}%`;
if (text) text.textContent = running ? t("videoEditExporting") : "Ready";
}
async function _addOutputToVideoTemp(filename, subfolder) {
await _fetchOutputDir();
if (!_s.outputDir) return;
const parts = [_s.outputDir];
if (subfolder) parts.push(subfolder);
parts.push(filename);
const path = parts.join("/");
try {
await ensureVideoGroup();
await fetch(`/wfm/gallery/groups/${encodeURIComponent(VTEMP_GROUP)}/add`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ path }),
});
} catch (err) {
console.warn("[VideoEdit] failed to tag export into video group:", err);
}
}
async function _exportTimeline() {
if (_s.exporting) return;
_stopPreview();
const readyClips = _s.clips.filter((c) => c.serverRef && !c.error);
if (readyClips.length === 0) {
showToast(t("videoEditNoClips"), "error");
return;
}
if (_s.clips.some((c) => c.probing)) {
showToast(t("videoEditStillProbing"), "error");
return;
}
const mismatch = _findResolutionMismatch(readyClips);
if (mismatch) {
showToast(mismatch, "error");
return;
}
_s.exporting = true;
_setExportUi(true, 0);
try {
const wsOk = await comfyUI.connectWebSocket();
if (!wsOk) throw new Error("Failed to connect WebSocket");
const { prompt, saveId } = _buildExportWorkflow(readyClips);
const result = await comfyUI.queuePrompt(prompt);
await comfyUI.trackProgress(result.prompt_id, (pct) => _setExportUi(true, pct));
const history = await comfyUI.getHistory(result.prompt_id);
const output = history?.outputs?.[saveId]?.images?.[0];
if (!output) throw new Error("No output produced");
const params = new URLSearchParams({ filename: output.filename, subfolder: output.subfolder || "", type: "output" });
setResultPreview(`${comfyUI.baseUrl}/view?${params}`, { kind: "output", filename: output.filename, subfolder: output.subfolder || "", type: "output" });
showToast(t("videoEditExportDone", output.filename), "success");
await _addOutputToVideoTemp(output.filename, output.subfolder);
} catch (err) {
showToast(t("errorWithMsg", err.message), "error");
} finally {
_s.exporting = false;
_setExportUi(false, 0);
}
}
// ============================================
// Init
// ============================================
function _wireToolbar() {
document.getElementById("wfm-video-edit-move-left-btn")?.addEventListener("click", () => {
if (_s.selectedId != null) _moveClip(_s.selectedId, -1);
});
document.getElementById("wfm-video-edit-move-right-btn")?.addEventListener("click", () => {
if (_s.selectedId != null) _moveClip(_s.selectedId, 1);
});
document.getElementById("wfm-video-edit-duplicate-btn")?.addEventListener("click", () => {
if (_s.selectedId != null) _duplicateClip(_s.selectedId);
});
document.getElementById("wfm-video-edit-delete-btn")?.addEventListener("click", () => {
if (_s.selectedId != null) _deleteClip(_s.selectedId);
});
document.getElementById("wfm-video-edit-preview-btn")?.addEventListener("click", _togglePreview);
document.getElementById("wfm-video-edit-clear-btn")?.addEventListener("click", _clearTimeline);
// Dropping a dragged block past the last one (onto empty track space)
// moves it to the end — block-level drop handlers stopPropagation() so
// this only fires for drops that miss every block.
const track = document.getElementById("wfm-video-edit-timeline-track");
track?.addEventListener("dragover", (e) => e.preventDefault());
track?.addEventListener("drop", (e) => {
e.preventDefault();
_reorderByDrop(null);
});
}
export function initVideoEditTab() {
_wireToolbar();
document.getElementById("wfm-video-edit-export-btn")?.addEventListener("click", _exportTimeline);
_renderTimeline();
_renderTrimPanel();
_updatePreviewBtn();
}
+23 -2
View File
@@ -290,10 +290,13 @@ function _wireBlockImageDropZone(which) {
});
}
// Returns true/false so setBlockImageFromFile (called from outside the Plan
// subtab, where this status text may not even be visible) can tell its own
// caller whether the upload actually succeeded instead of just assuming so.
async function _handleBlockImageUpload(which, file) {
if (!file || !file.type.startsWith("image/")) return;
if (!file || !file.type.startsWith("image/")) return false;
const block = _plan.blocks.find((b) => b.id === _selectedBlockId);
if (!block) return;
if (!block) return false;
const statusEl = document.getElementById(`wfm-video-block-${which}-status`);
const previewImg = document.getElementById(`wfm-video-block-${which}-preview`);
const wrap = document.getElementById(`wfm-video-block-${which}-wrap`);
@@ -309,11 +312,29 @@ async function _handleBlockImageUpload(which, file) {
if (which === "first") { block.first_image_filename = result.name; block.first_image_mode = "explicit"; }
else block.last_image_filename = result.name;
if (statusEl) { statusEl.textContent = `✓ ${result.name}`; statusEl.style.color = "var(--wfm-success)"; }
return true;
} catch (err) {
if (statusEl) { statusEl.textContent = `✗ ${err.message}`; statusEl.style.color = "var(--wfm-danger)"; }
return false;
}
}
// Exported so other modules (video-asset-tab.js's "Set as First/Last Image"
// buttons) can seed the currently-selected Plan block's First/Last Image from
// an already-fetched File — reuses the exact upload + first_image_mode
// bookkeeping the drop-zone UI itself uses, then re-renders the block editor
// so its dropdown/preview reflect the change even if the Plan subtab wasn't
// the one visible when this was called. _plan.blocks always has at least one
// entry (see _emptyBlock's initializer), so this only ever fails to find a
// block if _selectedBlockId itself has gone stale somehow.
export async function setBlockImageFromFile(which, file) {
const block = _plan.blocks.find((b) => b.id === _selectedBlockId);
if (!block) throw new Error(t("videoNoBlockSelected"));
const ok = await _handleBlockImageUpload(which, file);
_renderBlockEditor();
if (!ok) throw new Error(t("videoBlockImageUploadFailed"));
}
function _clearBlockImage(which) {
const block = _plan.blocks.find((b) => b.id === _selectedBlockId);
if (!block) return;
+45 -14
View File
@@ -8,25 +8,34 @@
* lets all three depend on it without needing to import each other —
* video-tab.js already imports both of the others for init/refresh, so a
* reverse import from either back into video-tab.js would create a cycle.
*
* Each pane also has a companion <img> element (wfm-video-*-preview-img) so a
* still/animated image (from Asset or a Video Source drop) can be previewed
* without forcing it through a <video> tag, which can't render image formats
* at all. mediaType controls which element is shown; Frame/GIF's
* getActivePreviewVideoElement() returns null while a pane is showing an
* image, since those tools only make sense against real video.
*/
const _PANES = {
source: { video: "wfm-video-source-preview-video", placeholder: "wfm-video-source-preview-placeholder" },
result: { video: "wfm-video-preview-video", placeholder: "wfm-video-preview-placeholder" },
source: { video: "wfm-video-source-preview-video", img: "wfm-video-source-preview-img", placeholder: "wfm-video-source-preview-placeholder" },
result: { video: "wfm-video-preview-video", img: "wfm-video-preview-img", placeholder: "wfm-video-preview-placeholder" },
};
const _objectUrls = { source: null, result: null };
// Whichever pane most recently received a video is what the Frame/GIF property
// Whichever pane most recently received media is what the Frame/GIF property
// tabs act on (see getActivePreviewSource/getActivePreviewVideoElement below) —
// an Asset selection or Video Source drop activates "source", a batch run
// finishing a block activates "result".
// finishing a block (or the Edit tab's export/preview) activates "result".
let _activePane = null; // "source" | "result" | null
let _activeSource = null;
let _activeMediaType = null; // "video" | "image" | null — mirrors _activePane's current content
function _setPreview(pane, url, source) {
function _setPreview(pane, url, source, mediaType = "video") {
const ids = _PANES[pane];
const video = document.getElementById(ids.video);
const img = document.getElementById(ids.img);
const placeholder = document.getElementById(ids.placeholder);
if (!video || !placeholder) return;
@@ -37,31 +46,44 @@ function _setPreview(pane, url, source) {
if (url && url.startsWith("blob:")) _objectUrls[pane] = url;
if (url) {
video.src = url;
video.style.display = "block";
if (mediaType === "image") {
video.pause();
video.removeAttribute("src");
video.load();
video.style.display = "none";
if (img) { img.src = url; img.style.display = "block"; }
} else {
if (img) { img.removeAttribute("src"); img.style.display = "none"; }
video.src = url;
video.style.display = "block";
}
placeholder.style.display = "none";
_activePane = pane;
_activeSource = source;
_activeMediaType = mediaType;
} else {
video.pause();
video.removeAttribute("src");
video.load();
video.style.display = "none";
if (img) { img.removeAttribute("src"); img.style.display = "none"; }
placeholder.style.display = "";
if (_activePane === pane) { _activePane = null; _activeSource = null; }
if (_activePane === pane) { _activePane = null; _activeSource = null; _activeMediaType = null; }
}
}
// Sets (or clears, with url=null) the Asset-selection/Video-Source-drop pane.
export function setSourcePreview(url, source) { _setPreview("source", url, source); }
// mediaType: "video" (default) or "image".
export function setSourcePreview(url, source, mediaType = "video") { _setPreview("source", url, source, mediaType); }
// Sets (or clears) the generated-result pane — called once per block as a
// batch run's video output comes in.
export function setResultPreview(url, source) { _setPreview("result", url, source); }
// batch run's video output comes in, and by the Edit tab's timeline preview
// (which may show either a video clip or a held still image).
export function setResultPreview(url, source, mediaType = "video") { _setPreview("result", url, source, mediaType); }
// What the Frame/GIF property tabs operate on: { kind: "output"|"input", filename,
// subfolder, type } for anything already on the server, or { kind: "local", file }
// for a picked/dropped file not yet uploaded. null if neither pane has a video.
// for a picked/dropped file not yet uploaded. null if neither pane has media.
export function getActivePreviewSource() { return _activeSource; }
// The GIF tab uploads a still-local source on first use and needs to remember
@@ -70,9 +92,10 @@ export function getActivePreviewSource() { return _activeSource; }
export function updateActivePreviewSourceRef(source) { _activeSource = source; }
// The <video> element the Frame/GIF tools should read/capture from, or null if
// neither pane currently has a video loaded.
// neither pane currently has a video loaded (including when the active pane is
// showing a still image instead).
export function getActivePreviewVideoElement() {
if (!_activePane) return null;
if (!_activePane || _activeMediaType === "image") return null;
return document.getElementById(_PANES[_activePane].video);
}
@@ -80,3 +103,11 @@ export function getActivePreviewVideoElement() {
export function getAllPreviewVideoElements() {
return Object.values(_PANES).map((ids) => document.getElementById(ids.video)).filter(Boolean);
}
// Direct access to the "result" pane's <video> element — used by
// video-edit-tab.js's timeline preview, which needs to drive playback
// (seek to a clip's trim-in, listen for the trim-out point, swap to the
// next clip) rather than just set a src via setResultPreview().
export function getResultPreviewVideoElement() {
return document.getElementById(_PANES.result.video);
}
+95 -12
View File
@@ -17,6 +17,8 @@ import { applyStoredVideoVolume } from "./settings-tab.js";
import { initVideoPlanTab, loadWorkflowIntoVideoEditor } from "./video-plan-tab.js";
import { initVideoAssetTab, refreshVideoAssetTab } from "./video-asset-tab.js";
import { initVideoProjectTab, refreshVideoProjectTab } from "./video-project-tab.js";
import { initVideoEditTab, addClipFromFile } from "./video-edit-tab.js";
import { VIDEO_GROUP, ensureVideoGroup } from "./gallery-tab.js";
import {
setSourcePreview, getActivePreviewSource, updateActivePreviewSourceRef,
getActivePreviewVideoElement, getAllPreviewVideoElements,
@@ -26,10 +28,10 @@ export { loadWorkflowIntoVideoEditor };
// ============================================
// Subtab switching — two INDEPENDENT groups sharing the same .wfm-video-subtab-*
// look, kept deliberately uncoupled: the sidebar's Asset/Project pair collapses
// entirely when re-clicked (nothing needs to always be visible there — Video
// Source covers the "load something to work with" case), while the center
// Plan/Edit pair is a "always exactly one visible" 2-way tab. Querying each
// look, kept deliberately uncoupled: the sidebar's Project button collapses its
// panel entirely when re-clicked (nothing needs to always be visible there —
// Video Source covers the "load something to work with" case), while the center
// Plan/Edit/Asset trio is a "always exactly one visible" tab group. Querying each
// scoped to its own container (rather than one global querySelectorAll) is
// what keeps clicking one from affecting the other.
// ============================================
@@ -45,13 +47,14 @@ function _initCenterSubtabToggle() {
scope.querySelectorAll(".wfm-video-subtab-panel").forEach((p) => {
p.style.display = p.dataset.videoSubtabPanel === target ? "" : "none";
});
if (target === "asset") refreshVideoAssetTab();
});
});
}
// Sidebar Asset/Project pair: clicking a button shows its panel and hides the
// other; clicking the already-active button collapses it (both panels hidden),
// letting the video preview reclaim the sidebar's width when neither is needed.
// Sidebar Project button: clicking it shows its panel; clicking it again while
// active collapses it, letting the video preview reclaim the sidebar's width
// when it isn't needed.
function _initSidebarSubtabToggle() {
const sidebar = document.querySelector(".wfm-video-form-panel");
if (!sidebar) return;
@@ -66,8 +69,7 @@ function _initSidebarSubtabToggle() {
if (willShow) {
btn.classList.add("active");
panel.style.display = "";
if (target === "asset") refreshVideoAssetTab();
else if (target === "project") refreshVideoProjectTab();
if (target === "project") refreshVideoProjectTab();
}
});
});
@@ -103,7 +105,17 @@ function _applyVideoI18n() {
const el = document.getElementById(id);
if (el) el.textContent = t(key);
};
setText("wfm-video-edit-placeholder-label", "videoEditPlaceholder");
const setTitle = (id, key) => {
const el = document.getElementById(id);
if (el) el.title = t(key);
};
setText("wfm-video-edit-export-btn", "videoEditExportBtn");
setTitle("wfm-video-edit-move-left-btn", "videoEditMoveLeft");
setTitle("wfm-video-edit-move-right-btn", "videoEditMoveRight");
setText("wfm-video-edit-duplicate-btn", "videoEditDuplicate");
setText("wfm-video-edit-delete-btn", "videoEditDelete");
setText("wfm-video-edit-clear-btn", "videoEditClearBtn");
setText("wfm-video-source-add-to-edit", "videoSourceAddToEdit");
setText("wfm-video-source-label", "videoSourceLabel");
setText("wfm-video-source-hint", "videoSourceHint");
setText("wfm-video-source-drop-label", "videoSourceDropLabel");
@@ -131,12 +143,40 @@ function _applyVideoI18n() {
function _wireVideoSourcePanel() {
_wireDropZone("wfm-video-source-drop", "wfm-video-source-file", (file) => {
if (!file.type.startsWith("video/")) return;
const isVideo = file.type.startsWith("video/");
const isImage = file.type.startsWith("image/");
if (!isVideo && !isImage) return;
const statusEl = document.getElementById("wfm-video-source-status");
setSourcePreview(URL.createObjectURL(file), { kind: "local", file });
setSourcePreview(URL.createObjectURL(file), { kind: "local", file }, isVideo ? "video" : "image");
if (statusEl) { statusEl.textContent = file.name; statusEl.style.color = ""; }
});
// "Add to Edit" — explicit, user-triggered handoff from whatever is loaded
// in the Source pane (a plain drop, an Asset selection, a Frame/GIF-tool
// source) into the Edit subtab's clip timeline. Deliberately NOT automatic
// on every Source drop — Frame/GIF is a single-video tool the user reaches
// for far more often than multi-clip editing, so auto-adding would clutter
// the Edit timeline with videos the user never meant to combine.
document.getElementById("wfm-video-source-add-to-edit")?.addEventListener("click", async () => {
const ref = getActivePreviewSource();
if (!ref) { showToast(t("videoNoSourceLoaded"), "error"); return; }
try {
let file;
if (ref.kind === "local") {
file = ref.file;
} else {
const blob = await comfyUI.getImageBlob(ref);
const isVideoExt = /\.(mp4|webm|mkv|mov)$/i.test(ref.filename || "");
file = new File([blob], ref.filename, { type: blob.type || (isVideoExt ? "video/mp4" : "image/png") });
}
addClipFromFile(file);
document.querySelector('.wfm-video-center-panel .wfm-video-subtab-btn[data-video-subtab="edit"]')?.click();
showToast(t("videoEditClipSent", file.name), "success");
} catch (err) {
showToast(t("errorWithMsg", err.message), "error");
}
});
document.getElementById("wfm-video-source-clear")?.addEventListener("click", () => {
setSourcePreview(null, null);
const statusEl = document.getElementById("wfm-video-source-status");
@@ -170,6 +210,7 @@ function _initPropTabs() {
// ============================================
let _capturedFrameBlob = null;
let _frameOutputDir = "";
function _blobToDataUrl(blob) {
return new Promise((resolve, reject) => {
@@ -180,6 +221,44 @@ function _blobToDataUrl(blob) {
});
}
// Same small output-dir lookup each of video-asset-tab.js/video-plan-tab.js/
// video-edit-tab.js keeps its own copy of — needed to build the absolute path
// Gallery's group-tagging API expects.
async function _fetchFrameOutputDir() {
if (_frameOutputDir) return;
try {
const res = await fetch("/api/wfm/settings/output-dir");
if (res.ok) {
const data = await res.json();
_frameOutputDir = (data.current || "").replace(/\\/g, "/").replace(/\/$/, "");
}
} catch { /* non-critical */ }
}
// Opt-in tagging of a saved frame into Gallery's curated __Video Assets__
// group (see the "Add to Video Assets group" checkbox) — mirrors
// video-edit-tab.js's _addOutputToVideoTemp, but targets the curated group
// directly since a manually-captured frame is a deliberate keep, not the
// every-run scratch output __Video Temp__ exists for.
async function _addFrameToVideoAssets(filename, subfolder) {
await _fetchFrameOutputDir();
if (!_frameOutputDir) return;
const parts = [_frameOutputDir];
if (subfolder) parts.push(subfolder);
parts.push(filename);
const path = parts.join("/");
try {
await ensureVideoGroup();
await fetch(`/wfm/gallery/groups/${encodeURIComponent(VIDEO_GROUP)}/add`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ path }),
});
} catch (err) {
console.warn("[VideoTab] failed to tag frame into video group:", err);
}
}
function _initFrameTab() {
const captureBtn = document.getElementById("wfm-video-frame-capture-btn");
const saveBtn = document.getElementById("wfm-video-frame-save-btn");
@@ -226,6 +305,9 @@ function _initFrameTab() {
if (!res.ok) throw new Error(json.error || `HTTP ${res.status}`);
if (statusEl) { statusEl.textContent = `✓ ${json.filename}`; statusEl.style.color = "var(--wfm-success)"; }
showToast(t("videoFrameSaved", json.filename), "success");
if (document.getElementById("wfm-video-frame-add-to-assets")?.checked) {
await _addFrameToVideoAssets(json.filename, json.subfolder);
}
} catch (err) {
if (statusEl) { statusEl.textContent = `✗ ${err.message}`; statusEl.style.color = "var(--wfm-danger)"; }
showToast(t("errorWithMsg", err.message), "error");
@@ -321,6 +403,7 @@ export function initVideoTab() {
initVideoPlanTab();
initVideoAssetTab();
initVideoProjectTab();
initVideoEditTab();
_wireVideoSourcePanel();
_initPropTabs();
+120 -34
View File
@@ -1760,7 +1760,7 @@
<h3 id="wfm-help-gallery-card-folder-title">Folder &amp; Selection</h3>
<ul>
<li id="wfm-help-gallery-5">Folder tree: click to load images, expand with ▶; "+ New" creates a subfolder inside the selected folder, "Del" deletes it with all contents</li>
<li id="wfm-help-gallery-6">Multi-select with Ctrl+click — bulk bar: select group → 'Add to Group' / 'Remove from Group'; 'Favorite All' / 'Unfavorite All'; 'Compare' (2–4 images); 'Move To...'; '<b>Export</b>' (downloads all selected images as a ZIP file); 'Delete File'</li>
<li id="wfm-help-gallery-6">Multi-select with Ctrl+click — bulk bar: select group → 'Add to Group' / 'Remove from Group'; 'Favorite All' / 'Unfavorite All'; 'Compare' (2–4 images); 'Move To...'; '<b>Export</b>' (downloads all selected images as a ZIP file); '<b>Create PSD</b>' (combines the selected images into one layered PSD file); '<b>Edit as Layers</b>' (opens the selected images in the Image Edit tab, each as its own layer); 'Delete File'</li>
<li id="wfm-help-gallery-15"><b>F button</b> (cyan overlay, top-left of each thumbnail): toggle the image in/out of the <b>__Feeder__</b> group with a single click; active state stays visible (cyan) when the image is already in the group; use this to quickly queue images for the Feeder tab Gallery mode</li>
</ul>
</div>
@@ -1778,16 +1778,19 @@
<li id="wfm-help-gallery-12"><b>Metadata</b> button (green, in the detail panel tab bar): opens the selected image in the Metadata tab for full embedded-data inspection; Alt+click on any image thumbnail has the same effect</li>
<li id="wfm-help-gallery-13"><b>Load GenUI</b> button (blue, in the detail panel tab bar): loads the embedded ComfyUI workflow from the selected image directly into the GenerateUI tab and switches to it; shows a warning toast if no workflow is embedded or the format is not supported</li>
<li id="wfm-help-gallery-14"><b>Tagger</b> button (purple, in the detail panel action row): opens the selected image directly in the Tagger tab's Single mode for instant tagging</li>
<li id="wfm-help-gallery-16"><b>Image Edit</b> button (toolbar, next to Refresh): sends the currently selected image to the Image Edit tab; if layers already exist the image is added as a new layer scaled to fit the canvas, otherwise it becomes Layer 1</li>
<li id="wfm-help-gallery-16"><b>Image Edit</b> button (toolbar, next to Refresh): sends the currently selected image to the Image Edit tab; if layers already exist the image is added as a new layer scaled to fit the canvas, otherwise it becomes Layer 1; PSD files are fully decomposed into their original layers instead of being flattened into one image</li>
<li id="wfm-help-gallery-17"><b>Send GenUI Image</b> button (toolbar, next to Image Edit): uploads the selected image to ComfyUI and sets it as the input for the first LoadImage node in the GenerateUI tab; automatically switches to GenerateUI → Input → Image; requires a workflow with at least one LoadImage node to be loaded first</li>
<li id="wfm-help-gallery-27"><b>Send to LI node</b> button (toolbar, next to Send GenUI Image): uploads the selected image and writes its filename into the image widget of the currently selected node on the ComfyUI canvas (falling back to the first LoadImage-type node found) — same destination as Image Edit tab's Send to LI node; requires Workflow Studio to have been opened from ComfyUI's top menu button</li>
<li id="wfm-help-gallery-28"><b>Create PSD</b> bulk button: combines all selected images into a single layered PSD file and downloads it — each image becomes its own layer (named after the file), positioned top-left on a canvas sized to the largest selected image; the last selected image ends up on top</li>
<li id="wfm-help-gallery-29"><b>Edit as Layers</b> bulk button: switches to the Image Edit tab and opens all selected images at once, each as an independent layer (video files in the selection are skipped); the last selected image ends up on top</li>
</ul>
</div>
<div class="wfm-help-card">
<h3 id="wfm-help-gallery-card-formats-title">Formats &amp; Auto-save</h3>
<ul>
<li id="wfm-help-gallery-10">Workflow auto-save: images generated in the Generate UI tab automatically have their workflow saved to gallery metadata and shown in the JSON tab</li>
<li id="wfm-help-gallery-11">Supports PNG (tEXt/iTXt), JPEG, WebP, GIF, MP4; workflow extraction reads ComfyUI prompt/workflow keys embedded in PNG metadata or in MP4 container tags (as written by SaveVideo, e.g. MiniMax H3 output)</li>
<li id="wfm-help-gallery-11">Supports PNG (tEXt/iTXt), JPEG, WebP, GIF, MP4, PSD; workflow extraction reads ComfyUI prompt/workflow keys embedded in PNG metadata or in MP4 container tags (as written by SaveVideo, e.g. MiniMax H3 output)</li>
<li id="wfm-help-gallery-30">PSD files: thumbnails and full-size previews show all layers merged together (hidden layers excluded); the underlying PSD file itself is left untouched — only the preview shown in Gallery is a flattened rendering</li>
</ul>
</div>
</div>
@@ -1968,8 +1971,10 @@
<h3 id="wfm-help-imageedit-card-overview-title">Overview</h3>
<ul>
<li id="wfm-help-imageedit-1">Layer-based image editor — compose images with multiple layers (Image, Text, Draw, Mask types) and export the composite</li>
<li id="wfm-help-imageedit-2">Loading images: drag &amp; drop onto the canvas, Upload button, or send from the Gallery tab via the Image Edit button in the Gallery toolbar; the first image becomes Layer 1 (auto-locked); subsequent images are added as new layers scaled to fit the canvas</li>
<li id="wfm-help-imageedit-2">Loading images: drag &amp; drop onto the canvas, <b>File Open</b> button, or send from the Gallery tab via the Image Edit button in the Gallery toolbar; the first image becomes Layer 1 (auto-locked); subsequent images are added as new layers scaled to fit the canvas</li>
<li id="wfm-help-imageedit-3">New button: create a blank canvas — prompts for WxH size (e.g. 512x768); clears all existing layers and automatically adds an empty Layer 1</li>
<li id="wfm-help-imageedit-31"><b>Open PSD</b> button (next to File Open): loads a layered PSD file from disk and decomposes it into individual layers — position, size, visibility, opacity, and blend mode are restored for each layer; groups and non-raster layers (adjustment layers, etc.) are flattened into their rendered appearance</li>
<li id="wfm-help-imageedit-32"><b>Close</b> button (next to Open PSD): closes the current document after a confirmation prompt, discarding all layers and unsaved edits and returning to the empty placeholder view</li>
</ul>
</div>
<div class="wfm-help-card">
@@ -1979,9 +1984,10 @@
<li id="wfm-help-imageedit-5">Draw (B): freehand brush drawing onto the active draw layer; Tool Options: color, brush size, blend mode; Properties pane includes a MASK EDITOR ONE (COLOR) section for ABR image brushes — always visible, header text is green when brushes are available, gray when none are imported yet; Select is disabled until at least one brush exists</li>
<li id="wfm-help-imageedit-6">Text (T): click on the canvas to place a text input overlay; configure font family, size, bold/italic, align, color in the Tool Options bar; click OK to place the text as an exact-size Text layer; double-click an existing text layer with the Select tool to re-edit</li>
<li id="wfm-help-imageedit-7">Shape (S): draw geometric shapes onto the canvas; each committed shape becomes an independent draw layer; Tool Options: Shape type (Rect / Ellipse / Line / FreeLine), Rounded checkbox (Rect / Ellipse only), Fill color + None toggle (hidden for Line / FreeLine), Stroke color + width + None toggle (None hidden for Line / FreeLine where stroke is always active), Opacity slider, ↩ Undo button; drag to draw — a blue dashed outline previews the shape; release to commit</li>
<li id="wfm-help-imageedit-7a2">Fill (G): bucket fill — click a contiguous same-color region on the active layer to flood-fill it with a solid color or a linear/radial gradient; Tool Options: Mode (Solid / Gradient), Color (solid) or Shape + Ramp (drag stops to reposition, click a stop then use the color swatch, +/- to add/remove) + Direction dial (drag to set angle/radius, gradient), Tolerance (color-match threshold), Opacity</li>
<li id="wfm-help-imageedit-7b">Blur (≈): apply Gaussian blur or mosaic to the active layer — whole-layer or region-based (drag a rectangle); see the Blur Tool card below for details</li>
<li id="wfm-help-imageedit-7c">BG Remove (⬚): remove the background from the active layer using Lightweight (@imgly, runs in browser) or BiRefNet (requires Mask Editor One + birefnet.safetensors in ComfyUI/models/background_removal/); see the BG Remove Tool card below for details</li>
<li id="wfm-help-imageedit-7d">Mask (🎭): paint masks on a mask layer using 6 sub-tools — Paint (freehand), Color (flood-select by similar color), Alpha (extract from image transparency), Text (stamp text), Vector (Catmull-Rom spline polygon), Shape (rect / ellipse); SAM3 text-prompt segmentation is also available when Mask Editor One is installed; click "M" in the Layers header to add a mask layer; see the Mask Tool card below for details</li>
<li id="wfm-help-imageedit-7d">Mask (🎭): paint masks on a mask layer using 6 sub-tools — Paint (freehand), Color (flood-select by similar color), Alpha (extract from image transparency), Text (stamp text), Vector (Catmull-Rom spline polygon), Shape (rect / ellipse); SAM3 text-prompt segmentation is also available when Mask Editor One is installed; click "Mask" (second row of the Layers header) to add a mask layer; see the Mask Tool card below for details</li>
<li id="wfm-help-imageedit-7e">Inpaint (🩹): composites the visible layers plus a Mask layer into one RGBA image (mask baked into the alpha channel) and applies it to the first inpaint-capable LoadImage node in the workflow currently loaded in GenerateUI (a node whose MASK output feeds something like VAEEncodeForInpaint); enter Positive/Negative prompts, Grow Mask By (applied to the VAE Encode (for Inpainting) node), and Denoise (applied to KSampler) in the properties panel, then click Run to upload and generate without leaving the Image Edit tab — the result is shown back in the properties panel when done; requires a Mask layer to be painted first and an inpaint-capable workflow loaded in GenerateUI; also works with workflows built around the Mask Editor One custom node (comfyui-mask-editor-one) instead of LoadImage — image/mask are pushed to it via its node_id-keyed server cache and layer_data widget; "Use dedicated workflow" checkbox: when off, the workflow currently loaded in GenerateUI is used (unchanged); when on, pick a saved workflow from the dropdown — it is loaded, edited, and generated entirely in the background without disturbing the workflow shown in GenerateUI</li>
</ul>
</div>
@@ -1989,7 +1995,8 @@
<h3 id="wfm-help-imageedit-layer-title">Layer Panel</h3>
<ul>
<li id="wfm-help-imageedit-8">Layers are listed from front (top) to back (bottom); click a layer row to make it active</li>
<li id="wfm-help-imageedit-8b">"M" button in the Layers header: adds a new mask layer above the current layer and automatically switches to the Mask tool</li>
<li id="wfm-help-imageedit-8b">The Layers header has two rows: the top row has +, ⧉ (Duplicate), −, ↑, ↓; the "<b>Mask</b>" button sits alone on the second row — it adds a new mask layer above the current layer and automatically switches to the Mask tool</li>
<li id="wfm-help-imageedit-33">⧉ (Duplicate layer) button: copies the active layer — including its pixels, position, size, opacity, blend mode, and visibility — and inserts the copy directly above the original as the new active layer; works on any layer type (image, draw, text, mask)</li>
<li id="wfm-help-imageedit-9">👁 / 🚫 button: toggle layer visibility</li>
<li id="wfm-help-imageedit-10">🔒 / 🔓 button: toggle layer lock — a locked layer cannot be moved, resized, or rotated (orange bounding box is shown); Layer 1 is locked automatically when the first image is loaded to prevent accidental moves</li>
<li id="wfm-help-imageedit-11">Opacity slider at the bottom adjusts the active layer's transparency</li>
@@ -2021,7 +2028,7 @@
<div class="wfm-help-card">
<h3 id="wfm-help-imageedit-mask-title">Mask Tool (🎭)</h3>
<ul>
<li id="wfm-help-imageedit-mask-1">Add a mask layer: click the "M" button in the Layers panel header; the new mask layer is inserted above the active layer and the Mask tool activates automatically</li>
<li id="wfm-help-imageedit-mask-1">Add a mask layer: click the "Mask" button on the second row of the Layers panel header; the new mask layer is inserted above the active layer and the Mask tool activates automatically</li>
<li id="wfm-help-imageedit-mask-2">Clicking a mask layer in the layer list automatically switches to the Mask tool</li>
<li id="wfm-help-imageedit-mask-3">Tool Options bar — sub-tools: Paint / Color / Alpha / Text / Vector / Shape (all work without Mask Editor One) / SAM3 (requires Mask Editor One, disabled if not installed); Invert checkbox inverts the overlay preview; Overlay color picker changes the preview color (default red); Blur slider (0–50 px) softens the overlay edge; the overlay is only shown for the currently active mask layer — inactive mask layers stay hidden until selected</li>
<li id="wfm-help-imageedit-mask-4">Properties pane — Paint mode: Mode (Add / Erase), Size (1–200 px), Hardness (0–100%); MASK EDITOR ONE section (always visible — header text is green when ABR brushes are available, gray when none are imported yet): Select button opens the ABR brush library (disabled until at least one brush exists) — choosing a brush replaces the default circle brush; ✕ clears the brush back to Circle; when an image brush is active, Hardness is disabled and additional controls appear: Spacing (stamp interval 5–100%), Angle (rotation 0–359°), Sz Jitter (random size reduction per stamp 0–100%), Rot. Jitter (random rotation per stamp on/off)</li>
@@ -2067,6 +2074,7 @@
<ul>
<li id="wfm-help-imageedit-17">Save PNG: composites all visible layers and downloads the result as a PNG file</li>
<li id="wfm-help-imageedit-18">Save to Gallery: prompts for a filename (default: wfs-image-YYYYMMDDHHmmss) and saves the composite PNG directly to the Gallery root folder (configured in Settings &gt; Gallery Output Folder); requires the Gallery tab to have been opened at least once to set the root</li>
<li id="wfm-help-imageedit-34">Save PSD: downloads a layered PSD file with every layer preserved separately — position, rotation, flip, and scale are baked into each layer's pixels (PSD layers cannot store a rotation angle), while opacity, blend mode, and visibility are kept as real, editable PSD layer attributes; clipping masks are merged into their target layer since PSD's native layer-mask mechanism is not used</li>
<li id="wfm-help-imageedit-19b">Send to Workflow: uploads the composite PNG to ComfyUI's input folder via /upload/image and writes the resulting filename into the image widget of the currently selected node in the ComfyUI graph, falling back to the first LoadImage-type node found; requires Workflow Studio to have been opened from ComfyUI's top menu button so the ComfyUI tab is reachable</li>
<li id="wfm-help-imageedit-20">Canvas navigation: scroll wheel to zoom, Space + drag to pan</li>
<li id="wfm-help-imageedit-21">Undo / Redo: Ctrl+Z / Ctrl+Y (or toolbar buttons ↩ ↪)</li>
@@ -2079,6 +2087,7 @@
<li id="wfm-help-imageedit-23">B: Draw tool</li>
<li id="wfm-help-imageedit-24">T: Text tool</li>
<li id="wfm-help-imageedit-25">S: Shape tool</li>
<li id="wfm-help-imageedit-25b">G: Fill tool</li>
<li id="wfm-help-imageedit-26">Delete: Delete selected layer (requires 2+ layers)</li>
<li id="wfm-help-imageedit-27">Ctrl+Z / Ctrl+Y: Undo / Redo</li>
<li id="wfm-help-imageedit-28">Space + drag: Pan canvas</li>
@@ -2090,7 +2099,7 @@
<div class="wfm-help-page" id="wfm-help-page-video">
<h2 id="wfm-help-video-title">Video Tab</h2>
<p id="wfm-help-video-desc">A dedicated video generation tab for MiniMax H3 (Image to Video), LTX-2.5 (Text / Image / First & Last Frame to Video), and Wan2.2 (Text to Video) workflows, independent of the GenerateUI tab. The center panel's Plan / Edit subtabs handle batch generation and (future) editing; the sidebar's Asset / Project subtabs handle browsing generated videos and saved plans.</p>
<p id="wfm-help-video-desc">A dedicated video generation tab for MiniMax H3 (Image to Video), LTX-2.5 (Text / Image / First & Last Frame to Video), and Wan2.2 (Text to Video) workflows, independent of the GenerateUI tab. The center panel's Plan / Edit / Asset subtabs handle batch generation, clip editing, and browsing generated videos; the sidebar's Project subtab handles saved plans.</p>
<div class="wfm-help-card">
<ul>
<li id="wfm-help-video-1">Plan subtab: the topbar's settings row holds Aspect Ratio / Megapixels / Multiple / Duration (seconds) / Noise Seed as this plan's base settings — Duration always reflects the currently selected block (each block keeps its own value), the rest are plan-wide. A second row below adds Width / Height / Turbo Mode / Strength / Steps / Prompt Enhance, each enabled only for workflows that actually support it (see helpVideo2). Split the timeline into blocks with the + Split / + Block / Delete buttons — each block has its own Prompt, Duration, and First/Last Image — First Image can be None, an explicit image, or "use previous block's last frame" (an explicit Last Image on the previous block always wins over extracting one from its generated video). Click Run to generate every block in order; Pause/Cancel work mid-run.</li>
@@ -2098,11 +2107,13 @@
<li id="wfm-help-video-3">Use the "Load in Video" button in the Workflow tab's detail modal to load a workflow containing a MiniMax H3 Image-to-Video node, an LTX-2.5 Text/Image/First&Last-Frame-to-Video node, or a Wan2.2 Text-to-Video node — this starts a fresh single-block plan seeded from the workflow's own current values. Unsupported workflows show an error instead.</li>
<li id="wfm-help-video-4">Generated videos (mp4) automatically appear in the Asset subtab's Video Temp group, and can also be browsed and played back in the Gallery tab. Organizing keepers into Video Assets is entirely up to you, on your own schedule.</li>
<li id="wfm-help-video-5">The center panel shows two previews: the left one shows either the video you select in the Asset subtab or whatever you drop/pick in the Video Source panel on its left (Clear resets it to empty), letting you use the Frame/GIF tools without running the loaded video workflow first; the right one always shows the most recently generated clip.</li>
<li id="wfm-help-video-6">Frame tab (right panel): play/seek the preview video to the position you want, click Capture Frame to grab that frame client-side, then Save to Output to write it as a PNG into ComfyUI's output folder.</li>
<li id="wfm-help-video-6">Frame tab (right panel): play/seek the preview video to the position you want, click Capture Frame to grab that frame client-side, then Save to Output to write it as a PNG into ComfyUI's output folder — check "Add to Video Assets group" first to also tag the saved frame into Gallery's Video Assets group.</li>
<li id="wfm-help-video-7">GIF tab (right panel): set Start/End (seconds), FPS, and an optional Max Width, then Convert to GIF — the server decodes the video and encodes an animated GIF into ComfyUI's output folder.</li>
<li id="wfm-help-video-8">Chaining: setting a block's First Image to "use previous block's last frame" continues smoothly from the previous clip — if that previous block has its own explicit Last Image, that image is used directly; otherwise the actual last frame of its generated video is extracted automatically.</li>
<li id="wfm-help-video-9">Project tab (sidebar, next to Asset): browse every saved plan file (thumbnail, block count, last updated), click one to load it into the Plan editor, or delete it with the × button; clicking the same tab again collapses the panel.</li>
<li id="wfm-help-video-9">Project tab (sidebar): browse every saved plan file (thumbnail, block count, last updated), click one to load it into the Plan editor, or delete it with the × button; clicking the same tab again collapses the panel.</li>
<li id="wfm-help-video-10">Highlight color: the Prompt / Duration / First Image / Last Image / Aspect Ratio / Megapixels / Multiple / Noise Seed / Width / Height / Turbo Mode / Strength / Steps / Prompt Enhance labels turn the same highlight color as the GenerateUI Model tab (customizable in the Settings tab) when the loaded workflow actually supports that field — e.g. for a Wan2.2 workflow (no ResolutionSelector node), the Aspect Ratio / Megapixels / Multiple labels stay unhighlighted while Width / Height light up instead.</li>
<li id="wfm-help-video-11">Edit subtab: a lightweight clip timeline for trimming and concatenating video/image clips outside of generation. Add clips via the Video Source panel's "Add to Edit" button or the Asset subtab's "Send to Edit" button, then drag blocks to reorder (or use the ◀/▶ toolbar buttons), Duplicate/Delete the selected clip, and Clear to empty the timeline. The trim panel for the selected video clip shows a time ruler, a draggable playhead synced to the Source preview, and draggable in/out handles with time badges — image clips instead get a simple hold-duration field. ▶ Preview plays every ready clip back-to-back (trimmed to its in/out points) in the right-hand result preview; Export builds and runs the actual ComfyUI graph (trim → concatenate if more than one clip → save), tagging the result into the Video Temp group automatically. Exporting more than one clip currently drops audio, since ComfyUI's concatenation node requires uniform audio across all inputs.</li>
<li id="wfm-help-video-12">Asset subtab (center panel, next to Plan/Edit): browses every video/image tagged into Video Assets or Video Temp (via the group dropdown, or "All Video Assets" for both). Search filters by filename; the ▦/☰ buttons switch between a thumbnail grid and a table (filename/updated/tags). Selecting an item shows its tags/memo, loads it into the center preview, and offers "Send to Edit" (queues it as a clip in the Edit subtab) plus, for images only, "Set as First Image"/"Set as Last Image" (uploads it straight into the currently-selected Plan block, switching to the Plan subtab).</li>
</ul>
</div>
<button class="wfm-help-jump-btn wfm-btn wfm-btn-sm" data-jump-tab="video">Go to Video Tab</button>
@@ -2128,6 +2139,7 @@
<li id="wfm-help-imageedit-tabkbd-2">B: Draw tool</li>
<li id="wfm-help-imageedit-tabkbd-3">T: Text tool</li>
<li id="wfm-help-imageedit-tabkbd-4">S: Shape tool</li>
<li id="wfm-help-imageedit-tabkbd-4b">G: Fill tool</li>
<li id="wfm-help-imageedit-tabkbd-5">Delete: Delete selected layer (requires 2+ layers)</li>
<li id="wfm-help-imageedit-tabkbd-6">Ctrl+Z / Ctrl+Y: Undo / Redo</li>
<li id="wfm-help-imageedit-tabkbd-7">Space + drag: Pan canvas</li>
@@ -2267,6 +2279,8 @@
<button id="wfm-gallery-bulk-compare" class="wfm-btn wfm-btn-sm" style="display:none;"></button>
<button id="wfm-gallery-bulk-move" class="wfm-btn wfm-btn-sm"></button>
<button id="wfm-gallery-bulk-export" class="wfm-btn wfm-btn-sm"></button>
<button id="wfm-gallery-bulk-psd" class="wfm-btn wfm-btn-sm"></button>
<button id="wfm-gallery-bulk-edit-layers" class="wfm-btn wfm-btn-sm"></button>
<button id="wfm-gallery-bulk-delete" class="wfm-btn wfm-btn-sm wfm-btn-danger"></button>
</div>
</div>
@@ -2609,6 +2623,7 @@
<button class="ie-tool-btn" data-tool="draw" title="Draw (B)">✏</button>
<button class="ie-tool-btn" data-tool="text" title="Text (T)">T</button>
<button class="ie-tool-btn" data-tool="shape" title="Shape (S)">□</button>
<button class="ie-tool-btn" data-tool="fill" title="Fill (G)">🪣</button>
<button class="ie-tool-btn" data-tool="mask" title="Mask">🎭</button>
<button class="ie-tool-btn" data-tool="blur" title="Blur">≈</button>
<button class="ie-tool-btn" data-tool="filter" title="Filter">★</button>
@@ -2621,15 +2636,21 @@
<!-- Action bar -->
<div class="ie-action-bar">
<label class="wfm-btn wfm-btn-sm" style="cursor:pointer;">
Upload
File Open
<input type="file" id="ie-upload-input" accept="image/*" style="display:none;">
</label>
<label class="wfm-btn wfm-btn-sm" style="cursor:pointer;" title="Open a layered PSD file">
Open PSD
<input type="file" id="ie-open-psd-input" accept=".psd" style="display:none;">
</label>
<button class="wfm-btn wfm-btn-sm" id="ie-new-btn">New</button>
<button class="wfm-btn wfm-btn-sm" id="ie-close-btn" title="Close the current document">Close</button>
<span style="flex:1;"></span>
<button class="wfm-btn wfm-btn-sm" id="ie-undo-btn" title="Undo (Ctrl+Z)">↩</button>
<button class="wfm-btn wfm-btn-sm" id="ie-redo-btn" title="Redo (Ctrl+Y)">↪</button>
<button class="wfm-btn wfm-btn-sm" id="ie-save-btn">Save PNG</button>
<button class="wfm-btn wfm-btn-sm" id="ie-save-gallery-btn" title="Save to Gallery root folder">Save to Gallery</button>
<button class="wfm-btn wfm-btn-sm" id="ie-save-psd-btn" title="Save all layers as a layered PSD file">Save PSD</button>
<button class="wfm-btn wfm-btn-sm" id="ie-send-workflow-btn" title="Upload and write this image's filename into the selected node's image widget (e.g. LoadImage)">Send to LI node</button>
</div>
@@ -2670,12 +2691,17 @@
<!-- Right Panel (Layers) -->
<div class="ie-right-panel">
<div class="ie-layers-header">
<span>Layers</span>
<button class="wfm-btn wfm-btn-sm" id="ie-add-layer-btn" title="Add layer">+</button>
<button class="wfm-btn wfm-btn-sm" id="ie-add-mask-btn" title="Add mask layer" style="font-weight:700;color:var(--wfm-accent,#4682e6);">M</button>
<button class="wfm-btn wfm-btn-sm" id="ie-del-layer-btn" title="Delete layer">−</button>
<button class="wfm-btn wfm-btn-sm" id="ie-layer-up-btn" title="Move up">↑</button>
<button class="wfm-btn wfm-btn-sm" id="ie-layer-down-btn" title="Move down">↓</button>
<div class="ie-layers-header-row">
<span>Layers</span>
<button class="wfm-btn wfm-btn-sm" id="ie-add-layer-btn" title="Add layer">+</button>
<button class="wfm-btn wfm-btn-sm" id="ie-dup-layer-btn" title="Duplicate layer">⧉</button>
<button class="wfm-btn wfm-btn-sm" id="ie-del-layer-btn" title="Delete layer">−</button>
<button class="wfm-btn wfm-btn-sm" id="ie-layer-up-btn" title="Move up">↑</button>
<button class="wfm-btn wfm-btn-sm" id="ie-layer-down-btn" title="Move down">↓</button>
</div>
<div class="ie-layers-header-row">
<button class="wfm-btn wfm-btn-sm" id="ie-add-mask-btn" title="Add mask layer" style="font-weight:700;color:var(--wfm-accent,#4682e6);">Mask</button>
</div>
</div>
<div class="ie-layer-list" id="ie-layer-list"></div>
<div class="ie-opacity-row">
@@ -2693,23 +2719,9 @@
<div class="wfm-video-layout">
<div class="wfm-video-form-panel">
<div class="wfm-video-subtab-nav">
<button type="button" class="wfm-video-subtab-btn" data-video-subtab="asset" id="wfm-video-subtab-btn-asset">Asset</button>
<button type="button" class="wfm-video-subtab-btn" data-video-subtab="project" id="wfm-video-subtab-btn-project">Project</button>
</div>
<!-- Asset: このPlanが生成した動画の素材管理(Galleryのグループ機能を再利用) -->
<div id="wfm-video-subtab-asset" class="wfm-video-subtab-panel" data-video-subtab-panel="asset" style="display:none;">
<div style="display:flex;gap:6px;align-items:center;">
<select id="wfm-video-asset-group" class="wfm-input" style="flex:1;"></select>
<button type="button" id="wfm-video-asset-refresh" class="wfm-btn wfm-btn-sm" title="Refresh">↻</button>
</div>
<span id="wfm-video-asset-status" class="wfm-i2i-status"></span>
<div class="wfm-video-asset-grid" id="wfm-video-asset-grid"></div>
<div class="wfm-video-asset-detail" id="wfm-video-asset-detail">
<span class="wfm-placeholder">Select a video</span>
</div>
</div>
<!-- Project: 保存済みVideo Plan一覧(クリックでPlanエディタへ読み込み) -->
<div id="wfm-video-subtab-project" class="wfm-video-subtab-panel" data-video-subtab-panel="project" style="display:none;">
<div style="display:flex;gap:6px;align-items:center;">
@@ -2729,27 +2741,66 @@
<div class="wfm-i2i-drop-zone" id="wfm-video-source-drop">
<label class="wfm-i2i-drop-label">
<span id="wfm-video-source-drop-label">Drop video or click to select</span>
<input type="file" accept="video/*" id="wfm-video-source-file" style="display:none;">
<input type="file" accept="video/*,image/*" id="wfm-video-source-file" style="display:none;">
</label>
</div>
<div style="display:flex;gap:6px;align-items:center;margin-top:6px;">
<span class="wfm-i2i-status" id="wfm-video-source-status" style="flex:1;"></span>
<button type="button" class="wfm-btn wfm-btn-sm" id="wfm-video-source-add-to-edit">Add to Edit</button>
<button type="button" class="wfm-btn wfm-btn-sm" id="wfm-video-source-clear">Clear</button>
</div>
</div>
<div class="wfm-video-preview-frame" id="wfm-video-source-preview-frame">
<span class="wfm-placeholder" id="wfm-video-source-preview-placeholder">Asset / Source Preview</span>
<video id="wfm-video-source-preview-video" class="wfm-video-preview-el" controls style="display:none;"></video>
<img id="wfm-video-source-preview-img" class="wfm-video-preview-el" style="display:none;">
</div>
<div class="wfm-video-preview-frame" id="wfm-video-preview-frame">
<span class="wfm-placeholder" id="wfm-video-preview-placeholder">Generated Video Preview</span>
<video id="wfm-video-preview-video" class="wfm-video-preview-el" controls style="display:none;"></video>
<img id="wfm-video-preview-img" class="wfm-video-preview-el" style="display:none;">
</div>
</div>
<div class="wfm-video-subtab-nav wfm-video-center-subtab-nav">
<button type="button" class="wfm-video-subtab-btn active" data-video-subtab="plan">Plan</button>
<button type="button" class="wfm-video-subtab-btn" data-video-subtab="edit">Edit</button>
<button type="button" class="wfm-video-subtab-btn" data-video-subtab="asset" id="wfm-video-subtab-btn-asset">Asset</button>
</div>
<!-- Asset: このPlanが生成した動画の素材管理(Galleryのグループ機能を再利用)。
左=一覧(サムネイル/テーブル切替可) / 右=選択ファイルの詳細(タグ・メモ等) -->
<div id="wfm-video-subtab-asset" class="wfm-video-subtab-panel wfm-video-asset-content" data-video-subtab-panel="asset" style="display:none;">
<div class="wfm-video-asset-layout">
<div class="wfm-video-asset-list-col">
<div class="wfm-video-asset-toolbar">
<select id="wfm-video-asset-group" class="wfm-input" style="flex:1;"></select>
<input type="text" id="wfm-video-asset-search" class="wfm-input" placeholder="Search filename..." style="flex:1;">
<button type="button" id="wfm-video-asset-view-grid" class="wfm-btn wfm-btn-sm wfm-video-asset-view-btn active" title="Thumbnail view">▦</button>
<button type="button" id="wfm-video-asset-view-table" class="wfm-btn wfm-btn-sm wfm-video-asset-view-btn" title="Table view">☰</button>
<button type="button" id="wfm-video-asset-refresh" class="wfm-btn wfm-btn-sm" title="Refresh">↻</button>
</div>
<span id="wfm-video-asset-status" class="wfm-i2i-status"></span>
<div class="wfm-video-asset-grid" id="wfm-video-asset-grid"></div>
<div class="wfm-video-asset-table-wrap" id="wfm-video-asset-table-wrap" style="display:none;">
<table class="wfm-video-asset-table">
<thead>
<tr>
<th>Filename</th>
<th>Updated</th>
<th>Tags</th>
</tr>
</thead>
<tbody id="wfm-video-asset-table-body"></tbody>
</table>
</div>
</div>
<div class="wfm-video-asset-detail-col">
<div class="wfm-video-asset-detail" id="wfm-video-asset-detail">
<span class="wfm-placeholder">Select a video</span>
</div>
</div>
</div>
</div>
<!-- Plan: バッチ動画生成のタイムライン編集・実行(中央下部、Planタブ選択時のみ表示) -->
@@ -2867,9 +2918,37 @@
</div>
</div>
<!-- Edit: 将来の動画編集機能用プレースホルダー -->
<!-- Edit: 簡易動画編集(クリップのタイムライン配置・トリム・結合書き出し)。
プレビューは上部のSource/Resultペインを再利用する(専用videoは持たない)。
タイムライン+下の共有ツールバーはPlan subtabの.wfm-video-timeline-*と同じ構造
(個別行ボタンではなく「選択中クリップに対して働く」共通ボタン方式)。 -->
<div id="wfm-video-subtab-edit" class="wfm-video-subtab-panel wfm-video-edit-panel" data-video-subtab-panel="edit" style="display:none;">
<span id="wfm-video-edit-placeholder-label" class="wfm-placeholder">Editing tools coming soon</span>
<div class="wfm-video-timeline-wrap">
<div class="wfm-video-edit-timeline-track" id="wfm-video-edit-timeline-track"></div>
<div class="wfm-video-timeline-toolbar">
<button type="button" id="wfm-video-edit-move-left-btn" class="wfm-btn wfm-btn-xs" title="Move left">◀</button>
<button type="button" id="wfm-video-edit-move-right-btn" class="wfm-btn wfm-btn-xs" title="Move right">▶</button>
<button type="button" id="wfm-video-edit-duplicate-btn" class="wfm-btn wfm-btn-xs">Duplicate</button>
<button type="button" id="wfm-video-edit-delete-btn" class="wfm-btn wfm-btn-xs">Delete</button>
<button type="button" id="wfm-video-edit-preview-btn" class="wfm-btn wfm-btn-xs">▶ Preview</button>
<span class="wfm-i2i-status wfm-video-edit-total-duration" id="wfm-video-edit-total-duration" style="margin-left:auto;"></span>
<button type="button" id="wfm-video-edit-clear-btn" class="wfm-btn wfm-btn-xs wfm-btn-danger">Clear</button>
</div>
</div>
<div class="wfm-video-edit-main-row">
<div class="wfm-video-edit-trim-panel" id="wfm-video-edit-trim-panel"></div>
<div class="wfm-video-edit-export-panel">
<button type="button" id="wfm-video-edit-export-btn" class="wfm-btn wfm-btn-primary" style="width:100%;">Export</button>
<div class="wfm-gen-progress-container" style="margin-top:8px;">
<div class="wfm-gen-progress-track">
<div id="wfm-video-edit-progress-bar" class="wfm-gen-progress-bar"></div>
</div>
<span id="wfm-video-edit-progress-text" class="wfm-gen-progress-text">Ready</span>
</div>
</div>
</div>
</div>
</div>
<!-- 右ペイン: プロパティ(Frame抽出 / GIF変換の2タブ)。中央ペインと同様に常時表示 -->
@@ -2885,6 +2964,9 @@
<div class="wfm-i2i-preview-wrap" id="wfm-video-frame-preview-wrap" style="display:none;">
<img class="wfm-i2i-preview-img" id="wfm-video-frame-preview-img">
</div>
<label class="wfm-video-checkbox-inline" style="margin-top:6px;">
<input type="checkbox" id="wfm-video-frame-add-to-assets"> Add to Video Assets group
</label>
<button type="button" id="wfm-video-frame-save-btn" class="wfm-btn wfm-btn-primary wfm-btn-sm" style="width:100%;margin-top:6px;" disabled>Save to Output</button>
<span class="wfm-i2i-status" id="wfm-video-frame-status"></span>
</div>
@@ -3097,11 +3179,15 @@
<button id="wfm-tagger-db-search-btn" class="wfm-btn wfm-btn-sm wfm-btn-primary"></button>
<button id="wfm-tagger-db-show-all-btn" class="wfm-btn wfm-btn-sm"></button>
<button id="wfm-tagger-db-export-btn" class="wfm-btn wfm-btn-sm"></button>
<button id="wfm-tagger-db-delete-selected-btn" class="wfm-btn wfm-btn-sm wfm-btn-danger"></button>
</div>
<div id="wfm-tagger-db-table-wrap" class="wfm-tagger-db-table-wrap">
<table id="wfm-tagger-db-table" class="wfm-table wfm-tagger-db-table">
<thead>
<tr>
<th id="wfm-tagger-db-th-select">
<input type="checkbox" id="wfm-tagger-db-select">
</th>
<th>ID</th>
<th id="wfm-tagger-db-th-file"></th>
<th id="wfm-tagger-db-th-interrogator"></th>