WebUI 安装方式
根据现有文件、Python 环境和快照情况选择正确的实例来源。
在 Hanafubuki 中，一个“实例”由实例记录、实例根目录、独立 Python 和 WebUI Core 组成。首页点击“添加实例”后，可以选择四种来源；它们对现有文件的处理方式不同。
安装前检查
开始前建议确认：
- 首次启动的 Python、Micromamba 和 Git 已准备完成；异常时先打开“设置 → 运行环境”。
- 网络能够访问需要的代码仓库和软件包来源，或已经配置可用的网络与代理和镜像。
- 目标磁盘有足够空间，并允许当前用户创建、修改和删除文件。
- 模型、输出和自定义代码已有独立备份；环境快照不包含这些文件的完整副本。
选择实例来源
| 来源 | 适合什么情况 | 是否安装环境 | 对现有文件的影响 |
|---|---|---|---|
| 全新安装 | 没有现成 WebUI，希望从头创建 | 下载独立 Python、Core 和依赖 | 应使用新的专用实例目录 |
| 导入现有实例 | 已知现有根目录、Core 和独立 Python | 不重新安装，导入后直接就绪 | 只引用原路径；后续管理操作可能修改这些文件 |
| 扫描系统 | 不确定 WebUI 位于哪里，或只有 Core | 完整实例直接就绪；缺少 Python 的实例等待安装 | 扫描阶段只读取；后续补装可能修改发现的 Core |
| 从快照恢复 | 已有环境快照 JSON，希望重建环境 | 按快照准备 Python、代码、包和扩展 | 会清理目标环境并强制重置目标 Git 仓库 |
最简单的选择
第一次使用请选择“全新安装”并保留默认选项。已有能运行的独立 Python 和 WebUI 时选择“导入现有实例”；只有代码目录或不确定目录结构时使用“扫描系统”。
支持的 WebUI
| 类型 | 主要用途 |
|---|---|
| Stable Diffusion WebUI | 基于 Gradio 的图像生成界面 |
| ComfyUI | 节点式生成工作流 |
| InvokeAI | 带统一画布的图像创作工具 |
| Fooocus | 简化的图像生成流程 |
| SD Trainer | LoRA 与模型训练 |
| Qwen TTS WebUI | 文本转语音 |
选择的类型决定安装器、默认 Python、PyTorch 选项以及安装后可用的管理功能。不要只按目录名称猜测类型。