Extensions/comfyui-flower-tools

ComfyUI Extension

comfyui-flower-tools

ComfyUI 強大的萬用提示詞編輯、組合、替換、分割、刪除功能，檔案名稱自訂管理以及繁體/簡體中文轉換工具。 powerful wildcards prompt editing, combining, replacing, splitting, and deleting functions, custom file name management, and a Traditional/Simplified Chinese conversion tool in ComfyUI.

By weichenglin0215·Created 7 months ago·Updated 21 days ago· 0

weichenglin0215/comfyui-flower-tools

Nodes—

On cloudLocal install

Stars0

Updated21 days ago

Readme

🌸 ComfyUI Flower Tools

這是一組專為 ComfyUI 設計的實用工具節點，專注於提示詞管理 (Prompt Management) 與 檔案命名管理 (File Naming)。原本是為了個人需求開發，現在整理開源給社群使用。

適合對象：

需要大量管理 Wildcards 或隨機提示詞的使用者。
需要自動化與標準化輸出檔名、路徑的使用者。
喜歡整潔、直觀操作介面的使用者。

📥 安裝說明 (Installation)

方法 1: 使用 ComfyUI Manager (推薦)

開啟 ComfyUI Manager。
搜尋 Comfyui Flower Tools*。
或點擊 "Install via Git URL"。
輸入本專案網址: https://github.com/weichenglin0215/comfyui-flower-tools
安裝完成後重啟 ComfyUI。

方法 2: 手動安裝(使用CMD視窗)

進入您的 ComfyUI custom_nodes 目錄。
執行 git clone https://github.com/weichenglin0215/comfyui-flower-tools.git
重啟 ComfyUI。

🛠️ 節點介紹 (Nodes)

請參考工作流位於 comfyui-flower-tools\workflows\Flower-Tools-Workflow.json

1. 🌸 Flower Multiline Prompt Selector (多行提示詞選擇器)

這是本工具包的核心節點，用於管理與選擇 Wildcards 檔案內容。它會自動讀取指定目錄下的 .txt 檔案，並產生直觀的按鈕介面。

功能特色：

自動讀取: 指定目錄路徑，自動列出所有 .txt 檔案。
- 支援絕對/相對路徑: 可輸入空白（預設目錄）、絕對路徑（如 C:\Prompt）或相對路徑（如 woman 或 ..\other）。
三種模式: 針對每個檔案，可獨立設定：
- 🎲 Random: 隨機選取一個單位。
- 🔢 Ordered: 依序選取每一個單位 (搭配 Seed)。
- ✅ Picked: 手動指定固定使用某一個單位。
{...} 多行區塊語法: 在 .txt 檔案中，以 { 開頭、} 或 }, 結尾（全形半形皆支援）包住的多行文字，整個區塊視為一個單位輸出；區塊以外的非空行則各自為一個單位。
/**/ 註解支援: 在文字檔或提示詞中可用 /* 說明文字 */ 撰寫行內/跨行備註。
- 勾選 「輸出時刪除 /**/ 註解」（預設啟用）時，最終輸出會自動移除所有 /*..*/ 區段，保持提示詞乾淨。
- 節點內的預覽框永遠保留原始文字（含註解符號），方便確認內容。
兩種輸出模式 (Output Mode):
- 循序模式 (Sequential): 將所有啟用的檔案內容合併後，依序輸出一個單位（傳統模式）。
- 組合模式 (Combination): 每個啟用的檔案各自輸出一個單位，並組合為一個長句子。
視覺化介面: 每個檔案都有獨立按鈕，點擊即可開啟詳細設定視窗。
即時預覽: 點擊 Refresh 後，預覽框會立即顯示目前設定下節點會產生的文字，無需執行節點即可確認結果。
連續處理 (Continuous Processing): 可設定 "每 N 張圖換一次提示詞"，適合生成同一個提示詞的多張變體 (Variations)。
自然排序: 檔案清單支援自然的數字與中文排序，保證 UI 顯示與執行順序一致。
兩種輸出模式 (Output Mode):
- 循序模式 (Sequential): 將所有啟用的檔案內容合併後，依序輸出一行（傳統模式）。通常用在產出多張預先寫好的分類提示詞，自己構思或在網路上學習的提示詞，分門別類記錄在不同文字檔案中。例如在wildcards目錄下的幾個範本文字檔"咒語列表_普級_日式少女寫真.txt"、"咒語列表_普級_可愛清新.txt" 透過這個節點可以連續產出相關圖檔。
- 組合模式 (Combination): 每個啟用的檔案各自輸出一行，並組合為一個長句子。通常用於多變化的組合，例如每張圖片使用不同國籍的女性、年紀、表情與體型。搭配🌸 Flower Keyword Replacer (關鍵字替換器)，可以輸出多變化的提示詞。請參考"wildcards\女人"目錄下的多個提示詞文檔。

2. 🌸 Flower Keyword Replacer (關鍵字替換器)

簡單直覺的文字替換工具，適合用來微調提示詞或批量測試不同概念。

功能特色：

10 組替換槽: 支援最多 10 組 Keyword (關鍵字) -> Replacement (替換內容) 的設定。
動態輸入: 可將任何字串節點連接到輸入端。

使用情境：

簡化提示詞寫法，搭配 Flower Mulitline Prompt Selector可以衍伸多變化內容。原提示詞："WOMAN，穿著Color短版襯衫。"。輸出提示詞："一位青春洋溢的18歲少女，表情自然帶笑，穿著駝色短版襯衫。"
將提示詞模板中的 keyword 替換成 replacement。
將 *WOMAN* 替換成 一位青春洋溢的18歲少女，表情自然帶笑。
將 *Color* 替換成 駝色。

FlowerKeywordReplacer_demo

3. 🌸 Flower List of Strings (字串清單組合器)

將多個字串合併為一個長字串或列表，適合組合多個提示詞來源。

功能特色：

10 個輸入槽: 支援 10 個多行文字輸入。
自訂分隔符 (Delimiter): 可設定連接字串時的中間符號 (如 , 或 \n)。
雙輸出: 同時輸出 "合併後的單一字串" 與 "字串列表 (List)"。

FlowerListofStrings_demo

4. 🌸 Flower File Name Combination (路徑檔名組合生成器)

專為喜好簡約設計感的使用者製作的路徑與檔名生成器。解決 ComfyUI 預設檔名過於簡單或混亂的問題。

功能特色：

變數系統: 支援使用 %DATE%, %TIME% 等變數自動產生日期時間。
路徑/檔名同步: 勾選 File name same as subfolder name 可讓檔名自動跟隨資料夾名稱，省去重複輸入的麻煩。
非法字元防護: 自動過濾 Windows/Linux 檔名不允許的符號 (如 *, ?, |)，避免存檔失敗。
筆記功能 (Note): 底部附帶筆記欄位，方便紀錄常用的格式參數。

支援變數：

%MainFolderName: 主目錄
%SubFolderName: 子目錄
%FileName: 檔名
%Suffix: 後綴 (如版本號)
%DATE: 日期 (如 2024-02-10)
%TIME: 時間 (如 12-30-59)

FlowerFileNameCombination_demo

5. 🌸 Flower TCSC Converter (繁簡中文轉換器)

專為中文使用者設計的繁簡體轉換工具，支援台灣慣用語彙的轉換 (OpenCC)。

功能特色：

雙向轉換: 支援「繁體 (台灣) -> 簡體」與「簡體 -> 繁體 (台灣)」。
OpenCC 核心: 使用高品質的 OpenCC 字典，非僅僅字對字轉換，包含詞彙轉換 (如: 滑鼠 <-> 鼠标)。
自動安裝: 內建一鍵安裝 OpenCC 依賴庫功能，自動偵測並修復環境問題 (支援 Windows/Linux)。
唯讀預覽: 轉換結果顯示於唯讀文字框，方便直接複製或檢視。

FlowerTCSCConverter_OK

安裝說明：

未安裝或執行錯誤時，請點擊"install_btn"按鍵，會自動安裝OpenCC在ComfyUI_windows_portable_Audio\python_embeded\Lib\site-packages\opencc

FlowerTCSCConverter_error

安裝前會跳出提示視窗，請點擊"確定"

FlowerTCSCConverter_install1

指令視窗中會顯示安裝過程

FlowerTCSCConverter_install2

安裝成功

FlowerTCSCConverter_install3

6. 🌸 Flower String Comparison (字串比對)

比對B字串是否包含在A字串之中，並輸出位置。(此節點優處是可輸出位置與是否有找到。)

功能特色：

大視窗顯示: 優化了 UI 排版，提供兩個大型文字框方便放入長內容。
多重比對方式: 從前面或後面開始比對、比對次數與區分大小寫。。

FlowerStringComparison_demo

7. 🌸 Flower Remove Commented Text (註解過濾器)

自動偵測並移除文字中的註解（如 // 或 /* ... */ 或 '<...>'），讓您可以直接在 Prompt 檔案中撰寫筆記。

功能特色：

單行註解: 支援過濾預設為 // 開頭的行內註解。
區塊註解: 支援過濾預設由 /* 開頭並由 */ 結尾的區塊註解。
自定義符號: 可自行修改註解的開始與結束符號，相容性高。

FlowerRemoveCommentedText_demo

8. 🌸 Flower Split Sentences (句子分割器)

將長段文字依據標點符號分割成多個句子，並可選擇是否保留標點符號與前後空白。

功能特色：

多標點支援: 自動偵測並分割 。, !, ?, ,, ;, : 等常見標點。
格式化輸出: 可選擇是否保留原始標點符號，以及是否移除每行前後的空白與空行。
預覽功能: 顯示分割後的句子數量與預覽內容，方便確認效果。

FlowerSplitSentences_demo

9. 🌸 Flower Load Text From Folder (資料夾載入文字)

從指定資料夾中依序讀取所有文字檔，並輸出為一個連續的長字串。適用於將多個提示詞檔案合併為單一長文本輸入。

功能特色：

自動讀取: 自動列出指定目錄下的所有 .txt 檔案。
篩選關鍵字: 可設定篩選關鍵字，只讀取包含關鍵字的檔案。 """ 關鍵字模式比對，支援多關鍵字運算： '|' 為 OR 分隔（先切割，任一群組符合即為 True） '&' 為 AND 分隔（群組內所有關鍵字都必須符合）範例：'A&B|C' → (A AND B) OR C 空白模式回傳 True（不篩選） """
自訂分段: 可設定每個檔案最大讀取字數（max_chars），控制輸入長度。
依序輸出: 依檔案順序串接內容，自動加入檔案間的分隔符（separator）。
效能優化: 輸出為單一長字串，避免 ComfyUI 執行階段因過多字串而佔用大量記憶體。
檔案重命名: 可選擇是否在輸出內容前加上檔案名稱作為標題（include_filename），並自訂標題格式。
章節分段下拉選單（split_by_chapter）: 提供三種模式，預設為「根據章編號分章輸出(第一章)」。
- 無：不分章，整篇依 max_chars_per_segment 切段，輸出檔名也不附加 -第X章。
- 根據章編號分章輸出(第一章)：偵測文中「第X章」標題切塊，再於章內依字數細分。
  - 章節偵測支援中文數字與阿拉伯數字（如 第一章、第十二章、第123章），允許前後出現括弧（【】、（）、「」、《》 等）。
  - 首段包含前言與第一章內容，之後每段對應一章，最末章延伸至檔尾。
- 根據字數自編章節輸出(4000字合成一章)：適用於沒有明確章節結構的長文。
  - 依 chars_per_auto_chapter（預設 4000）的字數上限切塊，且必須在換行符號處切斷，避免從句子中間硬砍。
  - 尾段若不足上限的一半（如 < 2000 字）會自動併入前一塊，最後一章實際長度可達約 1.5 倍上限（~6000 字）。
  - 切出的區塊會自動命名為 第一章、第二章… 並附加到輸出檔名。
- 輸出檔名會自動於末尾附加章節標籤，例如：亦舒《喜寶》-V400-AI語音用-001第一章-0001-984。
即時預覽（Refresh 按鈕）：點擊 🔄 Refresh 後，會直接呼叫後端完整跑一次節點邏輯，立即更新 content_preview（依目前 seed 對應的段落內容）與 file_list_display（完整虛擬分段清單），無需執行工作流程即可確認結果。

FlowerLoadTextFromFolder_demo

進階應用（解決 QwenTTS 記憶體問題）：

本節點專為解決 QwenTTS 讀取超長文本導致崩潰（Out of Memory）的問題而設計。您無須將長篇劇本或小說分割成多個小檔案（每檔案不超過 1000 字），只要配合本節點的 max_chars 設定，自動分段依序輸入，讓 AI 逐段生成語音，有效控制記憶體使用量。搭配 split_by_chapter，更能確保每段語音的章節邊界明確、不會跨章混音。

10. 🌸 Flower Audio Merge (音檔合併器)

從指定目錄中讀取音訊檔案，讓使用者透過視覺化清單勾選目標音檔，並將其串接為單一音訊輸出。

功能特色：

視覺化勾選介面: 點擊 Refresh 後，目錄中的音檔會以 ON/OFF 切換按鈕呈現，點擊即可勾選或取消。
格式篩選: 支援 WAV、MP3、FLAC 個別篩選，或使用 ALL 全選三種格式。
關鍵字篩選: 可輸入關鍵字，只顯示檔名包含關鍵字的音檔。
固定字母排序: 清單與合併順序均以字母排序固定，確保結果可重現。
統一格式轉換: 所有音檔自動重新取樣至 48000 Hz 立體聲 (float32)，確保無縫串接。
音量標準化: 所有音檔音量會先計算整批檔案的音量峰值（Peak Volume），然後將每段音訊依比例放大或縮小，以使整批音量一致。
工作流程持久化: 勾選狀態儲存於 fileConfigs JSON 欄位，重新載入工作流程時自動還原清單與勾選結果。
自動安裝: 若 torchaudio 未安裝，可透過內建的安裝按鈕一鍵完成。
彈性輸出: 輸出標準 ComfyUI AUDIO tensor，可同時連接 WAV 與 MP3 兩個 Save Audio 節點。

輸入： | 欄位 | 說明 | |------|------| | directory | 音檔目錄絕對路徑 | | filterKeyword | 檔名篩選關鍵字（空白 = 全選） | | negativeKeyword | 檔名排除關鍵字（空白 = 全選） | | inputFormatSelector | 輸入格式：ALL / WAV / MP3 / FLAC | | appendOutputName | 附加在 fileName 輸出後的字串，預設 _Merge | | fileConfigs | JSON 勾選狀態（由節點自動維護，無需手動編輯） | | autoOutputMode | 強制自動輸出模式：無強制自動輸出 / 強制自動依章節分段輸出 / 強制自動依檔案數量分段輸出 | | seed | 強制自動輸出時的批次索引（搭配生成後控制 fixed/increment/decrement/randomize） | | autoSegmentCount | 「依檔案數量分段」每批的檔案數，預設 4 | | 全選、全不選、反選 | 這些是按鈕，並非輸入欄位。可利用它們快速反轉目前清單的勾選狀態。|

強制自動輸出模式（autoOutputMode）說明：

無強制自動輸出：使用 fileConfigs 中的手動勾選狀態（原有功能）。
強制自動依章節分段輸出：由 seed 決定章節索引，自動選取檔名中含對應「第X章 / 第1章」的所有檔案。例：seed=0 → 第一章所有音檔合併；seed=1 → 第二章；依此類推。輸出檔名前綴自動附加 -第X章。
強制自動依檔案數量分段輸出：依 autoSegmentCount 將檔案列表分批，seed 決定批次。例：autoSegmentCount=4，seed=0 輸出第 1~4 個檔案、seed=1 輸出第 5~8 個、seed=2 輸出第 9~12 個。

輸出： | 名稱 | 型別 | 說明 | |------|------|------| | audio | AUDIO | 合併後的音訊 tensor（48kHz / 立體聲 / float32） | | count | INT | 成功合併的音檔數量 | | length | FLOAT | 總時長（秒，小數點以下兩位） | | fileName | STRING | 第一個勾選音檔的檔名（不含路徑與副檔名）+ appendOutputName |

建議工作流程：

FlowerAudioMerge
    ├── audio ──→ Save Audio (WAV, 32-bit float)
    ├── audio ──→ Save Audio (MP3, 320k)
    └── fileName ──→ FlowerFileNameCombination（用作存檔路徑的檔名段）

注意：MP3 格式需要系統安裝 ffmpeg。ComfyUI Windows Portable 版通常已內含 ffmpeg，一般無需額外安裝。

📂 目錄結構 (Directory Structure)

您的 Wildcards (提示詞檔案) 預設應放在本插件目錄下的 wildcards 資料夾中：

ComfyUI/
  └── custom_nodes/
      └── comfyui-flower-tools/
          └── wildcards/
              ├── example.txt
              ├── 咒語列表_普級_日式少女寫真_中文.txt
              ├── 咒語列表_普級_日式少女寫真2_中文.txt
              └── 色彩
				  ├── 9-0-0_顏色.txt
                  └── 9-1-0_低彩度傳統色_中文.txt

您也可以在 Prompt Selector 節點的 directory 欄位輸入絕對路徑來讀取其他位置的檔案。

📜 更新日誌 (Changelog)

2026-08-05 (V1.11.0):
- 🌸Flower Audio Merger (音檔合併器)
- 修正"章"數判斷錯誤。
2026-06-26 (V1.10.0):
- 🌸Flower Multiline Prompt Selector
- 新增 filter_keyword 跟 negativeKeyword 功能完全比照 🌸Flower Load Text From Folder
- 新增 "排除純英文檔名" 勾選框(預設不勾)
- 新增 "全部OFF"、"全部Random"、"全部Ordered" 三個按鈕。
2026-06-23 (v1.8.7):
- 🌸Flower Multiline Prompt Selector 新增讀取.md，支援一次輸出整個文字檔功能，檔案清單高度已調整以適應更小的顯示空間。
2026-06-16 (v1.8.6):
- 🌸Flower Load Text From Folder 章節分段輸出檔名中的"第X章"往前移並加入三位數編號。
2026-06-16 (v1.8.5):
- 🌸Flower Multiline Prompt Selector "{}"行首行尾條件更改。
2026-06-10 (v1.8.4):
- 🌸Flower Load Text From Folder 章節分段功能大幅強化：
  - split_by_chapter 由勾選框改為下拉選單三選項：無 / 根據章編號分章輸出(第一章) / 根據字數自編章節輸出(4000字合成一章)，預設「根據章編號分章輸出(第一章)」。
  - 新增 chars_per_auto_chapter（預設 4000）：「字數自編章節」模式的字數上限。
  - 字數自編章節模式會於換行符號處切斷（接近但不超過上限），避免從句子中間硬砍；尾段不足上限一半時自動併入前一塊（最後一章實際長度可達約 1.5 倍上限）。每塊自動命名 第一章、第二章… 並附加到輸出檔名。
- 🌸Flower Load Text From Folder Refresh 預覽強化：按下 🔄 Refresh 會呼叫新的 /flower-tools/preview-text-segments 端點完整模擬節點執行，同時更新 content_preview 與 file_list_display，無需執行工作流程即可預覽分段／章節結果。
- 🌸Flower Audio Merge 新增強制自動輸出模式：
  - 新增下拉選單 autoOutputMode、整數 seed（含 ComfyUI 生成後控制 fixed/increment/decrement/randomize）、整數 autoSegmentCount（預設 4）。
  - 強制自動依章節分段輸出：依 seed 自動選取檔名中含「第X章 / 第1章」的所有音檔合併，輸出檔名前綴附加 -第X章。
  - 強制自動依檔案數量分段輸出：依 autoSegmentCount 分批，seed=0 → 第 1~4 個、seed=1 → 第 5~8 個，依此類推。
2026-06-07 (v1.8.3):
- 🌸Flower Load Text From Folder 分段編號改成四位數。
2026-06-07 (v1.8.2):
- 🌸Flower Load Text From Folder 新增**「根據章節來分段」（split_by_chapter）** 勾選框，預設啟用：
  - 先以「第X章」為單位將全文切塊，再於章內依 max_chars_per_segment 細分，避免單一段落跨越兩個章節，徹底解決AI語音生成時前後章節混雜的問題。
  - 章節偵測支援中文數字與阿拉伯數字（第一章、第十二章、第123章），並能容忍前後出現括弧符號（【】、（）、「」、《》 等）。
  - 切塊規則：首段含前言＋第一章，之後每段對應一章，最末章延伸至檔尾。
  - 輸出檔名自動附加章節標籤：例如 亦舒《喜寶》-V400-AI語音用-0001-984-第一章，方便後續存檔時直接辨識所屬章節。
2026-06-02 (v1.8.1):
- 🌸Flower Multiline Prompt Selector 功能強化：
  - 新增 {...} 多行區塊語法：.txt 檔案中以 { 開頭、} 或 },（全形/半形皆支援）結尾的內容，整個區塊視為一個單位；區塊外的非空行仍各自為一個單位。
  - 新增 remove_comments 選項（預設啟用）：輸出時自動移除提示詞中的 /* ... */ 格式註解，讓使用者可在文字檔內自由撰寫備忘說明而不影響生成結果。節點內的預覽框則永遠保留原始文字（含註解），方便核對。
  - Refresh 即時預覽：點擊 Refresh 按鈕後，預覽框會立即呼叫後端計算並顯示目前設定的預期輸出，無需執行節點即可確認選取結果。
2026-05-25 (v1.8.0):
- 新增 🌸Flower Audio Merge 節點，將目錄中的多個音訊檔案串接為單一輸出。
  - 支援 WAV、MP3、FLAC 三種輸入格式（MP3 需系統已安裝 ffmpeg）。
  - 視覺化 ON/OFF 切換按鈕介面，勾選狀態可隨工作流程儲存與還原。
  - 所有音檔統一轉換為 48000 Hz 立體聲 float32，確保無縫串接。
  - 輸出標準 AUDIO tensor，可同時連接多個 Save Audio 節點（如 WAV + MP3 同時存檔）。
  - 額外輸出 fileName（第一個勾選音檔名 + appendOutputName），便於串接 FlowerFileNameCombination 設定存檔路徑。
  - 內建 torchaudio 一鍵安裝按鈕。
2026-05-22 (v1.7.1):
- 優化🌸Flower Load Text From Folder節點，修正 JS 高度計算與 ComfyUI onResize 機制衝突的問題。
  - 原本的 JS 實作會與 ComfyUI 的自動撐大高度機制（onResize → computeSize 迴圈）打架，導致節點尺寸被強行拉回固定值。
  - 修改為完全不干預高度：移除所有自訂 computeSize 與 onResize 攔截，由 ComfyUI 原生系統全權控制節點高度。
- 🌸Flower String Comparison：統一整理 onNodeCreated 與 onExecuted 中的邏輯，避免不必要的執行期干擾。
- 🌸Flower Split Sentences：同上，邏輯統一整理。
2026-05-19 (v1.7.0):
- 新增🌸Flower Load Text From Folder節點，從目錄中依序載入文字檔。
2026-04-10 (v1.1.0):
- 根據ComfyUI官方發布的Node發布規範，更新pyproject.toml檔案。
- 將原本放在GitHub上的Node發布到ComfyUI官方的Node市場。
2026-03-26 (v1.0.0):
- 新增FlowerSplitSentences 將對應的分行符號替換成帶有換行符號的格式，並過濾掉行首行尾的空白與空行。
- 主要是針對AI語音，QwenTTS若單一句(未換行)過長會導致語速變快。同樣文章，單一句長度過長會影響AI無法表達確切的情緒。
2026-02-24:
- 新增 FlowerRemoveCommentedText 節點。
- FlowerMultilinePromptSelector 重大更新：新增「組合模式 (Combination)」、支援絕對/相對目錄輸入、修正中文排序邏輯一致性、修復 F5 重新整理後內容消失的問題。
2026-02-13: 新增 FlowerStringComparison 節點。
2026-02-10: 新增 FlowerFileNameCombination 與 FlowerListOfStrings 節點。介面全面中文化與優化。
2026-02-02: 名稱變更為 Flower Multiline Prompt Selector，優化排序邏輯。

Made with ❤️ by weichenglin0215