导入现有实例
将已有 WebUI 根目录、Core 和独立 Python 接入 Hanafubuki。
导入适合目录结构已经完整、并且当前 WebUI 已经拥有可执行独立 Python 的情况。导入不会复制文件，也不会重新安装依赖；成功后实例直接进入就绪状态。
导入前确认
准备好三个位置：
| 位置 | 是否必需 | 默认查找位置 |
|---|---|---|
| 现有实例根目录 | 必需 | 无，必须选择 |
| Python 目录 | 必须存在且可执行 | <现有实例根目录>/python |
| WebUI Core 目录 | 必须存在 | <现有实例根目录>/core |
Python 目录应是独立 Python 的根目录，而不是只包含激活脚本的普通虚拟环境。Windows 下应能找到 python.exe；Linux 和 macOS 下应能找到 bin/python3 或 bin/python，并且执行版本检查成功。
没有独立 Python 怎么办
如果只有 WebUI Core，没有符合要求的 Python，不要强行导入。使用扫描系统，识别到的 Core 会成为待安装实例，再由 Hanafubuki 准备受管 Python。
导入步骤
选择导入来源
在首页点击“添加实例”，将顶部来源切换为“导入现有实例”。
选择正确的 WebUI 类型
选择现有项目实际使用的类型。该选择决定启动参数和管理能力；Hanafubuki 不会把一种 WebUI 转换成另一种。
设置名称和根目录
实例名称可以留空并自动生成。“现有实例根目录”必须选择一个已经存在的目录。
确认 Python 目录
标准布局可留空并使用 <根目录>/python。Python 位于其他位置时，选择其实际根目录；应用会在保存记录前执行可用性检查。
确认 Core 目录
标准布局可留空并使用 <根目录>/core。如果现有根目录本身就是 WebUI Core，可以将 Core 目录明确选择为根目录。
导入并验证
点击“导入实例”。成功后会进入实例工作区并开始准备管理服务和启动 WebUI。随后可在“实例管理 → 组件路径”核对三个目录。
导入会改变什么
- 创建 Hanafubuki 的实例记录和默认启动参数。
- 保持现有根目录、Python 和 Core 在原位置，不复制、不移动。
- 导入动作本身不安装或更新 Python 包、Core、扩展和模型。
- 导入后的版本切换、扩展管理、终端命令和重装仍可能修改原文件。
以后删除时选择正确操作
“删除实例”会删除经过验证的实例根目录。若只想从 Hanafubuki 中移除记录并保留原文件，请使用“仅删除记录”。详见实例维护。
常见导入错误
| 错误类型 | 处理方式 |
|---|---|
| 根目录、Python 或 Core 不存在 | 重新选择实际存在的目录，不要只填写可执行文件路径 |
| Python 无法执行或版本无法识别 | 选择独立 Python 根目录，或改用扫描后补装 |
| 路径与已有实例冲突 | 打开已有实例核对路径，避免重复导入同一 Core |
| 导入后无法启动 | 核对所选 WebUI 类型、启动参数和现有依赖 |
需要查看完整错误和启动输出时，使用任务中心或安装故障处理。