ComfyUI_Dynamic_TagLoader

<h1 align="center"> ComfyUI_Dynamic_TagLoader </h1>

🔗 Quick Links

• English Version
• 日本語版
• 中文版

<img width="1465" height="849" alt="ComfyUI_Dynamic_TagLoader_01" src="https://github.com/user-attachments/assets/517a9b69-e150-4ef6-aec1-b0ffcae43ab7" />

安裝說明 (Installation)

進入 ComfyUI custom_nodes 目錄：

cd ComfyUI/custom_nodes/
git clone https://github.com/NineKey1028/ComfyUI_Dynamic_TagLoader.git

重新啟動 ComfyUI。

⚡Dynamic Tag Loader

快速的讀取、排序 tag 資料夾中整理好的 .txt 文件，同時支持 LoRa 讀取，與 🔄 Dynamic Tag Iterator 連接後可支持 prompt 隨機、批量輸出

<details> <summary><i>更多...</i></summary>

• Global Prompt：輸出時會處於所有組合的第一行。
• + Add Tag Group：點擊新增讀取的資料夾，可依需求添加無數個組合。
• Tag Group：
  • Folder：目前讀取的資料夾，點擊可打開資料夾選單切換資料夾。
  • File：目前資料夾下所讀取的檔案，選擇第一行 ALL 選項時會將此資料夾中所有的 .txt 與其它組的 .txt 進行組合排序並全部輸出。
• LoRA 讀取：支援在 .txt 檔案或 Global Prompt 中直接編寫 lora:lora_name:權重。節點會自動提取語法、加載模型權重，並從最終輸出的提示詞中清理該語法。
• 右鍵選單：在任一 Tag Group 區塊點擊右鍵，可呼叫專屬選單進行「上移/下移」、「置頂/置底」、「向前/向後插入新組」或「刪除該組」等排序操作。

</details>

🔄 Dynamic Tag Iterator

接收來自 Dynamic Tag Loader 的組合列表，並根據設定進行單次迭代或批量輸出。

<details> <summary><i>更多...</i></summary>

• Output Mode：
  • Iterate (One by One)：配合 ComfyUI 的隊列機制，每次執行僅輸出組合中的一項（依據 Seed 進行索引順序切換）。
  • Batch (List)：一次性輸出所有組合（或篩選後的列表），適用於支持 List 處理的後續節點。
• Sample Limit：抽樣限制功能。設為 0 時使用所有組合；若大於 0，則會根據目前的 Seed 從所有組合中隨機抽取指定數量的項進行輸出。
• Seed 控制與記錄：
  • 節點會根據輸入的 Seed 決定迭代的索引或隨機抽樣的順序。
  • ♻️ Reuse Last Seed：UI 面板會自動記錄上一次成功執行時使用的 Seed。點擊按鈕可快速將該數值填回 Seed 輸入框，方便復現特定的隨機組合。

</details>

💾 Dynamic Tag Saver

將 Prompt 文本即時保存為 .txt 標籤檔案，並自動整合所選的 LoRA 語法。此節點能幫助使用者快速建立個人標籤庫，方便未來透過 Dynamic Tag Loader 重新讀取與組合。

<details> <summary><i>更多...</i></summary>

• Text Input：主要的提示詞輸入區塊。存檔時會自動移除前後多餘空格。
• Folder & Filename：
  • Folder Name：指定存檔的資料夾名稱，若目錄不存在會自動創建（位於節點目錄下的 tags 資料夾中）。
  • Filename：指定檔案名稱。若資料夾內已存在同名檔案，會自動添加流水號（如 _1, _2），防止覆蓋既有資料。
• LoRA Auto Merge (▼ LoRA Auto Merge ▼)：
  • + Add LoRA：點擊開啟搜尋選單，從系統中選擇安裝好的 LoRA 檔案。
  • Strength：調整該 LoRA 的權重數值（支援 -10.0 至 10.0）。
  • 自動語法整合：存檔時，節點會將選擇的 LoRA 自動轉換為標準 Prompt 語法 <lora:名稱:權重> 並附加在文本末端。
• 右鍵進階選單：在 LoRA 區塊點擊右鍵，可進行「置頂/置底」、「排序移動」或「插入/刪除」等操作，靈活調整 LoRA 的寫入順序。

</details>

🔍 Workflow Metadata Reader

用於從生成的圖片（PNG）中回溯提取完整的 Workflow JSON 數據與並依工作流ID抓取內容並輸出prompt、圖片。支持單圖解析、資料夾批量隨機選取。

<details> <summary><i>更多...</i></summary>

• image_or_dir：可輸入圖片或資料夾路徑。
• Search By：
  • ID：透過節點 ID 定位並提取該節點的所有 Widget 數值（如 Prompt、Seed 等）。
  • Type：透過節點類型（如 CLIPTextEncode）過濾並提取匹配的文本內容。
• 檔案選取邏輯：
  • 資料夾模式：輸入資料夾路徑，並配合 Seed 進行隨機索引抽樣，適合用於自動化重新讀取不同圖片的提示詞。
  • 單圖模式：直接讀取指定路徑的圖片資訊。

可直接將圖片檔案拖入節點並填寫圖片路徑。

可從剪貼簿直接 Ctrl+V 貼上圖片。

上敘兩項動作會將圖片複製至input資料夾

⚠️ 注意事項： 正確讀取 Prompt 的前提是該流程中需使用類似 Show Text 的節點來顯示提示詞，且 Prompt 必須先於圖片產生（即寫入 Metadata 中），否則可能會讀取到錯誤資訊。若遇到執行順序問題，建議搭配 ⏳ Wait For 節點來強制控制產生順序。

</details>

⏳ Wait For

用於強制控制工作流的執行順序。在 ComfyUI 的非線性執行環境中，確保特定節點必須在「目標節點」完成後才開始運算，解決異步執行導致的順序錯誤問題。

<details> <summary><i>更多...</i></summary>

• Data Input：主要流轉的數據（支援任何類型 AnyType），此數據將被原樣輸出。
• Wait For (Optional)：連接你希望先執行的節點輸出。當此連接點有數據傳入時，Wait For 才會釋放 Data Input 給後續節點。

</details>

範例工作流： 可拖入 comfyUI 讀取範例工作流