全新安装 WebUI

全新安装会创建实例记录，准备独立 Python，并在 Core 目录中安装所选 WebUI。第一次使用时建议保留全部默认选项。

在首页点击“添加实例”，确认页面顶部的实例来源选择为“全新安装”。点击“返回主页”或“取消”可以退出，不会创建任何文件。

从左侧选择 Stable Diffusion WebUI、ComfyUI、InvokeAI、Fooocus、SD Trainer 或 Qwen TTS WebUI。右侧预览只用于帮助识别产品；真正的安装和管理规则由所选类型决定。

点击“下一步”。应用会同时加载当前可用的分支和 PyTorch 选项；加载失败时可使用“重新加载选项”，不需要重新选择 WebUI。

“实例名称”用于首页和实例管理中的显示，可以留空。留空时，应用会根据 WebUI 产品名生成带随机后缀的名称。

推荐将“安装根目录”留空。应用会使用设置页显示的全局默认目录，并在其下创建以实例 ID 命名的专用目录。

如果手动选择目录，该目录本身就是最终实例根目录，不会再自动创建一层子目录。请使用新的专用目录，不要选择磁盘根目录、用户主目录或包含重要文件的现有目录。

只有支持分支预设的 WebUI 才显示“分支”。普通用户选择“默认分支”；只有明确需要测试版或特定变体时才切换。

展开“高级选项”可以修改 Python/Core 子目录、Python 版本、PyTorch 构建以及预下载设置。默认值已经构成可用安装方案；不了解某一项时不要修改。

Python 必须位于实例根目录内部。新建 Core 目录也应位于实例根目录内；如果明确选择了一个经验证的现有外部 Core，安装器可以继续复用并更新它，但不能强制重建该外部目录。不确定现有 Core 在哪里时应使用扫描系统。

点击“创建并安装”。应用先保存实例记录，再进入该实例的安装工作区，依次准备 Python 和 WebUI Core。不要在安装期间手动移动或删除目录。

安装完成后，工作区会继续准备管理服务并自动启动 WebUI。启动地址捕获成功后即可使用；如果启动需要选择 PyTorch 或处理依赖冲突，工作区会显示对应决定项。

默认目录结构

<全局默认安装目录>/
└── <实例 ID>/             实例根目录
    ├── python/            独立 Python
    └── core/              WebUI Core

模型、扩展和输出目录由不同 WebUI 自己决定，因此不一定都位于相同位置。需要修改高级设置时，先阅读安装选项详解。

创建记录与开始安装是两个动作

极少数情况下，实例记录已经创建，但安装任务未能启动。此时实例不会丢失：重新打开它，在工作区点击“开始安装”即可继续。

安装失败或进度长时间没有变化时，参阅安装进度与故障处理。