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 底部附近的包选择器。导入的包和安装的包都会从这里切换。

下一篇建议

• 系统要求
• 安装自定义节点
• 常见问题