Anima Prompt Weaver

Anima Prompt Weaver 是專為 ComfyUI 打造的自訂節點套件，用於輔助 Anima 文生圖的提示詞建構。本工具基於簡單的字串比較與取代，並提供：

• 結構化的提示詞組裝
• Danbooru 標籤驗證功能
• 標籤名稱正規化

---

節點一覽

Prompt Weaver

Anima 提示詞建構器，依照固定欄位順序組合提示詞，並對標籤進行驗證與正規化。

輸出格式

{quality_tags}, {safety}, {character_count}, {image_composition}, {character}, {series}, {artist}, {general_tags}.

{description}

輸入欄位

| 欄位 | 類型 | 說明 | |------|------|------| | quality_tags | STRING | 品質標籤，例如 masterpiece, best quality, score_9 | | safety | 下拉選單 | 內容分級：safe / sensitive / nsfw / explicit | | character_count | STRING | 角色數量，例如 1girl、2girls | | image_composition | STRING | 構圖描述，例如 solo focus、portrait | | character | STRING | 角色名稱 | | series | STRING | 作品系列名稱 | | artist | STRING | 畫師名稱（自動加上 @ 前綴，包含 : 者額外加括號） | | general_tags | STRING | 其餘通用標籤 | | description | STRING | 自然語言描述 | | regular_tags | BOOLEAN | 開啟後將所有標籤的 _ 替換為空格 | | verify_group | STRING | 指定要驗證的欄位，逗號分隔，例如 character_count, image_composition, general_tags |

[!Warning] 只有在 verify_group 中指定的標籤群組，且出現不合法標籤時才會從輸出中移除；未指定的標籤群組僅會在 report 中列出不合法標籤，不會改變輸出。

輸出

| 輸出 | 說明 | |------|------| | text | 組裝完成的提示詞字串 | | report | Markdown 格式的驗證報告，包含錯置標籤與不合法標籤清單 |

標籤驗證機制

• 依照 tags/ 資料夾中的 CSV 資料庫進行比對
• Rejected Tags（不合法標籤）：不存在於對應資料庫的標籤，僅列於報告；是否從輸出中移除應由 verify_group 控制
• Misplaced Tags（錯置標籤）：放在錯誤欄位的標籤（如將構圖標籤填入角色數量欄），僅報告，不影響輸出
• 驗證時自動將 _ 轉為空格並統一小寫

模糊比對

驗證採子字串模糊比對，只要輸入標籤中有任何連續片語存在於資料庫，即視為合法。例如輸入 white glove，因為 glove 在資料庫中，所以通過驗證。比對前會自動將 _ 換成空格並轉為小寫。

Rejected Tags（不合法標籤）：標籤的所有子字串均不在對應資料庫中。列於 report；若該欄位在 verify_group 中指定，則同時從輸出中移除，否則標記為 (Ignore) 並保留輸出。

Misplaced Tags（錯置標籤）：標籤通過了其他欄位的資料庫驗證，表示可能填錯欄位。僅列於 report 並標示建議欄位，不影響輸出。

---

Scaled Latent

解析度縮放器，直接輸出空白的 Latent 張量，省去手動換算的步驟。

輸入欄位

| 欄位 | 類型 | 說明 | |------|------|------| | size | 下拉選單 | 縮放比例：Full（100%）/ Half（50%）/ Quarter（25%）| | width | INT | 基礎寬度（64–8192，步進 8） | | height | INT | 基礎高度（64–8192，步進 8） | | batch_size | INT | 批次數量（1–64） |

輸出

| 輸出 | 說明 | |------|------| | latent | 對應解析度的空白 Latent，可直接接至 KSampler |

縮放後的尺寸會自動對齊 8 的倍數（VAE 解碼需求）。

---

安裝

1. 將本資料夾複製至 ComfyUI 的 custom_nodes/ 目錄：

   cd path/to/ComfyUI/custom_nodes
   git clone https://github.com/naukri7707/ComfyUI-AnimaPromptWeaver.git anima_prompt_weaver
   

2. 重新啟動 ComfyUI，節點將出現在 AnimaPromptWeaver 分類下。

---

標籤資料庫

標籤資料存放於 tags/ 資料夾：

| 檔案 | 說明 | |------|------| | character_count.csv | 角色數量相關標籤 | | image_composition.csv | 構圖相關標籤 | | general.csv | 通用標籤 |

可以自行修改後重啟 ComfyUI 來增加額外標籤。

---

範例工作流程

sample-workflow.json 為可直接匯入 ComfyUI 的範例工作流程。