ComfyUI Multi-Workflow Branch Strategy¶
概念概覽
多 Workflow 並存架構¶
核心知識¶
多 Workflow 並存架構¶
當 ComfyUI 專案需要支援多種輸出類型（動漫動畫 vs 遊戲 icon）時，使用 獨立 Git 分支 隔離各類型 workflow，避免互相污染：
main：anime 動畫 workflow（Z-Image + WAN 2.2 i2v）feature/icon-workflow：遊戲 icon 生成 workflow（glossy_gem、casual_match3 等風格）
遊戲 Icon Workflow 已實作風格¶
- glossy_gem：寶石光澤風格，適合三消/RPG 道具 icon
- casual_match3：三消休閒遊戲風格
這些風格在 feature/icon-workflow 分支中已有具體實作，可按需 cherry-pick 或 merge 進主線。
文件管理原則¶
- 使用
runbook.md作為唯一操作文件（已取代 setup-guide，避免雙份文件分歧） - Workflow JSON 只保留 smart 版本，其他變體版本不進倉庫
經驗教訓¶
-
新 workflow 類型要切獨立分支，不要直接在 main 上實驗，避免破壞已驗證的流程
-
多份 setup guide 或多個 workflow JSON 版本是維護噩夢的根源，要有唯一來源原則
-
icon 工作流和動畫工作流在工具選型上差異很大，強行合併一個分支反而難以維護
常見陷阱¶
- 多版本 workflow JSON 共存會讓使用者不知道該用哪個，應明確標示或刪除舊版
最佳實踐¶
-
每種輸出類型對應一個獨立分支，明確分工
-
runbook.md 作為唯一操作文件，setup-guide 類文件應整併或刪除
-
Workflow JSON 只保留 smart（最終）版本，草稿版本不進 Git
相關概念¶
來源 Sessions¶
| 日期 | Session | 貢獻摘要 |
|---|---|---|
| 2026-04-10 | 6a11d50e-fabd-4e49-90a1-34f9d114caff | 確立了多輸出類型 ComfyUI 工作流的分支管理策略：新功能切獨立分支開發，與原有 workflow 並存不衝突。 |