weilin9999/WeiLin-Comfyui-Tools

WeiLin‑ComfyUI‑Tools – ComfyUI用タグ管理拡張機能

機能

• ComfyUIのTag Manager内の各タグカードに120 × 120のサムネイルプレビューを追加します。
• ComfyUIの内部キューAPIを使用して、オンデマンドでプレビュー画像を生成します（単一タグ、再生成、またはグループ全体の一括生成）。
• サムネイルにマウスを合わせるとフローティングウィンドウで拡大表示され、保留中の全ジョブをキャンセルできます。
• 生成パラメータ（モデル、サイズ、サンプラー、ステップ数、CFG、シード、ポジティブ/ネガティブプロンプト）はローカルに保存されるため、毎回入力し直す必要はありません。

仕組み

1. フロントエンド – Vueコンポーネント（GenerateImageDialog.vue、BatchGenerateDialog.vue）で生成設定を行い、ジョブを開始します。
2. バックエンド – 新しいAPIルート（/tag_image/*）が生成リクエストを受け取り、非同期キュー（tag_image_queue.py）に入れ、ComfyUIワークフロー（comfyui_workflow.py）を実行します。
3. キュー – シングルワーカーキューがジョブを順次処理し、ComfyUIから結果を取得して画像をダウンロードし、フルサイズ画像と120 × 120のWebPサムネイルを user_data/tag_images/ および user_data/tag_thumbs/ に保存します。
4. データベース – tag_tags テーブルに image_path と image_status カラムが追加され、UIで現在のサムネイル状態を表示できます。
5. 復旧 – ページを更新しても、UIが /tag_image/status/{t_uuid} を照会してキューの状態を復元します。

主な特徴

• 単一タグ生成 – タグの空のサムネイルをクリックし、パラメータを設定して生成します。
• 再生成 – 既存のサムネイルにマウスを合わせ、更新アイコンをクリックして設定を調整し、画像を置き換えます。
• 一括生成 – グループ内の全タグをワンクリックで生成し、進行状況バーを表示します。
• 全キャンセル – キュー内または実行中の全タスクを中断します。
• 設定の永続化 – 生成オプションは自動的にローカル保存されます。
• フローティングプレビュー – 200 msホバーでフルサイズ画像を表示します。

対象ユーザー ComfyUIで大量のタグを整理し、UIを離れずに各タグの視覚的な手がかりを素早く確認したいアーティストやプロンプトエンジニア。

インストール時の注意

• 本プラグインは現在内部テスト中です。サポートや更新情報については公式QQグループ（ID 905656521）への参加が推奨されています。
• 標準的なComfyUIディレクトリ構造（models/checkpointsにモデルがある状態）で動作します。
• コンパニオンパネルリポジトリ（WeiLin‑Comfyui‑Tools‑panel）を使用すると、古いバージョンからのプロンプト移行が容易になります。

ロードマップ / コミュニティ

• 継続的なバグ修正（通常月2～5回リリース）。
• オープンソースのプロンプトおよびDanbooruタグデータベースは別リポジトリ（WeiLin‑Comfyui‑Tools‑Prompt）でホストされています。
• GitHubで直接Issueや機能リクエストを送信可能です。

---

上記の内容はすべてリポジトリのREADMEから直接引用したものであり、推測は含まれていません。