Wonderful Launcher 快速開始

如果你想用最短路徑從 Wonderful Launcher 進入一個可用的 ComfyUI 工作區，這篇就是當前版本的主流程。

這篇會講什麼

• 如何選擇當前要啟動的 ComfyUI 運行時包
• 需要新增或切換包時，如何打開包選擇器
• 如何從 Home 啟動 ComfyUI
• 如何不離開 Launcher 就查看啟動日誌
• 如何打開內嵌的 Workspace

開始前

• 先在 Windows 上安裝 Wonderful Launcher。
• 如果你已經有一個 ComfyUI 文件夾，提前準備好它的路徑，方便需要時從包選擇器添加。
• 如果底部包選擇器裡已經選中了正確的包，可以直接跳過第 2 步，進入啟動流程。

受管包和已有文件夾該怎麼選？

第 1 步：打開 Home

先停留在 Home。當前版本里，確認當前包、啟動 ComfyUI、查看啟動日誌、進入 Workspace 都從這裡開始。

第 2 步：確認當前包

使用 Home 底部附近的包選擇器，確認這次要啟動哪一套 ComfyUI 運行時。

如果需要的包已經在列表裡，選中它繼續即可。如果要添加另一個 ComfyUI 文件夾，打開選擇器並點擊 Add ComfyUI Directory。

在當前 Avalonia 界面裡，包的添加和切換主要從這個選擇器進入，而不是舊版的獨立首次安裝彈窗。

第 3 步：啟動 ComfyUI 並查看啟動日誌

回到 Home，點擊 Launch ComfyUI。Launcher 會留在當前頁，並展開啟動日誌面板，讓你在應用內直接看到啟動過程，而不是再切到外部終端。

第 4 步：打開 Workspace

當標題欄變成 ComfyUI running，並且右側 Toolbox 裡的 Workspace 入口可用時，就可以打開 Workspace。ComfyUI 的網頁界面會內嵌在 Wonderful Launcher 裡。

你看到的具體畫布內容會因環境而異。全新包通常會打開默認工作流；已有包通常會恢復你上次使用的工作流。

什麼叫啟動成功

當 ComfyUI 完整啟動後，你通常會看到：

• 標題欄出現綠色的 ComfyUI running 狀態。
• 底部包選擇器顯示當前活動運行時包。
• Home 日誌面板裡出現 GUI 地址或 ready signal。
• 右側 Toolbox 裡的 Workspace 入口變成可用狀態。
• 打開 Workspace 後，內嵌 ComfyUI 網頁界面正常加載。

如果啟動失敗

先看日誌面板，不要先亂改環境。複製最明顯的錯誤，再去看對應文檔。

• ComfyUI 啟動失敗
• ComfyUI 插件導入失敗
• 依賴衝突

如果 Workspace 打開後出現警告

如果 Launcher 已經啟動成功，但 Workspace 提示缺節點或缺模型，就繼續走工作流層面的修復文檔：

• 安裝自定義節點
• 自定義節點把環境搞壞了
• 下載模型

日誌在哪裡看

如果出問題，日誌仍然是最快的定位入口：

1. Home 日誌面板：展開啟動按鈕下方的日誌區域，直接看實時輸出。
2. Startup Logs：從右側 Toolbox 打開 Startup Logs，可以回到啟動輸出。
3. Task console：從右側 Toolbox 打開 Task console，查看 Launcher 側任務會話。
4. 磁盤上的日誌文件：包目錄裡會保留最新的 .log 文件，方便你做更深的排查。

新手常見問題

能同時運行多個 ComfyUI 包嗎？

不能。Wonderful Launcher 一次只運行一個 ComfyUI 實例。要先停掉當前實例，再從 Home 切換到另一個包。

一定要有 GPU 嗎？

建議至少有一張可用的 NVIDIA GPU。純 CPU 雖然能啟動，但真正生成圖片會非常慢。

包切換入口在哪裡？

在 Home 底部附近的包選擇器。導入的包和安裝的包都會從這裡切換。

下一篇建議

• 系統要求
• 安裝自定義節點
• 常見問題