安装选项详解
了解实例路径、Python、PyTorch、分支和预下载设置。
高级选项用于适配特殊目录、显卡或版本需求。选择“类型默认值”“自动”或“安装器默认值”时，Hanafubuki 不会随意猜测，而是把选择权交给当前 WebUI 的安装规则。
路径设置
| 字段 | 留空时的值 | 全新安装要求 |
|---|---|---|
| 安装根目录 | <全局默认安装目录>/<实例 ID> | 必须是安全、独立且不与其他实例重叠的目录 |
| Python 目录 | <实例根目录>/python | 必须位于实例根目录内部，不能等于或包含 Core |
| WebUI Core 目录 | <实例根目录>/core | 新建目录须位于根内；也可复用经验证的现有外部 Core |
应用会拒绝危险路径、符号链接路径、不合法的父级关系，以及与其他实例根目录、Python 或 Core 重叠的路径。最可靠的做法是保留默认 Python/Core 目录。
导入和扫描可以形成不同布局
导入或扫描得到的组件可能位于实例根目录之外。外部组件不会随实例根目录迁移，也不会被“删除实例”的根目录删除操作移除。
各类型可用选项
| WebUI | 默认 Python | 设备选项 | 分支 | 预下载模型 | 预下载扩展 |
|---|---|---|---|---|---|
| Stable Diffusion WebUI | 3.11 | PyTorch 构建 | 支持 | 支持 | 支持 |
| ComfyUI | 3.12 | PyTorch 构建 | — | 支持 | 支持 |
| InvokeAI | 3.12 | 设备系列 | — | 支持 | — |
| Fooocus | 3.12 | PyTorch 构建 | 支持 | 支持 | — |
| SD Trainer | 3.11 | PyTorch 构建 | 支持 | 支持 | — |
| Qwen TTS WebUI | 3.11 | PyTorch 构建 | — | 支持 | — |
分支与设备列表来自当前安装目录，因此具体选项可能随安装器和平台变化。
Python
界面允许选择 Python 3.10 至 3.14，但并不表示每个 WebUI 的每个版本都兼容全部 Python 版本。“类型默认值”是当前项目经过配置的默认版本，通常最稳妥。
更换 Python 版本不会复用系统 Python；应用会在实例的 Python 目录中准备独立运行时。导入现有实例时，所选 Python 目录也必须包含可正常执行的独立 Python。
PyTorch 构建与设备系列
- Stable Diffusion WebUI、ComfyUI、Fooocus、SD Trainer 和 Qwen TTS 使用“PyTorch 构建”。
- InvokeAI 使用更高层的“设备系列”。
- 选择“自动”表示不固定构建，让当前安装器按环境决定。
- 只有明确知道显卡驱动、CUDA、ROCm 或 CPU 需求时，才手动固定选项。
手动选择不匹配的构建可能导致安装成功但启动时无法使用显卡。
分支
Stable Diffusion WebUI、Fooocus 和 SD Trainer 可以选择安装目录返回的分支预设。Stable Diffusion WebUI 的“默认分支”为 sd_webui_forge_neo；Fooocus 和 SD Trainer 的“默认分支”不写入额外覆盖。指定分支会成为实例后续重装和版本管理的基准。
预下载模型与扩展
每个预下载选项有三种状态：
| 选择 | 含义 |
|---|---|
| 使用安装器默认值 | 不强制启用或禁用，由当前 WebUI 安装器决定 |
| 启用 | 明确要求安装器执行预下载 |
| 禁用 | 明确要求安装器跳过预下载 |
预下载可以减少首次启动后的等待，但会增加安装时间、网络流量和磁盘占用。它不是离线安装：代码、Python 包和其他依赖仍可能需要联网下载。
推荐默认值
新用户保留类型默认 Python、自动设备、默认分支和安装器默认预下载。只有遇到明确兼容性要求时，一次修改一个选项并重新验证。