实例维护
详细了解重命名、迁移、重装、仅删除记录和完整删除的文件影响。
“维护”页不依赖 WebUI 管理 API，可以在管理功能异常时继续打开。迁移、重装和删除属于实例生命周期操作：应用会先停止并确认相关运行资源，再执行文件或记录修改。
操作前准备
| 操作 | 配置记录 | 实例根目录 | 外部组件目录 |
|---|---|---|---|
| 重命名 | 更新名称 | 不移动 | 不改变 |
| 迁移实例 | 更新路径 | 整体移动到新的父目录 | 保持原位置 |
| 重装 | 保留实例 | 按选项重建组件 | 只处理明确选择的组件 |
| 仅删除记录 | 删除 | 完全保留 | 完全保留 |
| 删除实例 | 删除 | 删除精确的实例根目录 | 不删除 |
重命名
重命名只改变 Hanafubuki 中显示的实例名称。实例 ID、身份、实例根目录和所有组件路径保持不变；提交相同名称不会产生新的配置修改。
迁移实例
迁移会移动完整实例根目录，而不是只修改路径设置。页面要求选择一个已经存在的目标父目录；后端会在其下追加当前实例目录名，并要求最终目录尚不存在。
当前实例：D:/WebUI/my-instance
选择父目录：E:/Hanafubuki
最终目录：E:/Hanafubuki/my-instance实例根目录内的 Python、Core、模型和其他文件会随整个目录移动。位于根目录之外的组件路径保持原位置，不会复制、移动或删除。
选择目标父目录
目标父目录必须存在，并且最终实例目录不能已存在。迁移不会合并或覆盖现有目录。
阅读迁移预览
应用会重新验证实例身份、配置、路径重叠和外部组件，并在确认窗口显示最终目录和警告。
开始并等待迁移
确认后，应用依次停止 WebUI、管理服务、WebView 和实例终端，再移动文件并原子更新配置。跨磁盘迁移可能需要完整复制，因此时间取决于实例大小。
验证迁移结果
完成后重新打开实例，检查根目录和受管组件路径，再使用实例终端和一次实际启动验证环境。
迁移不会扫描和改写 .pth、脚本、环境变量或其他文件中的绝对路径。如果某个第三方组件记录了旧位置，需要在迁移后按该组件自己的方式修正。
恢复要求使用同一个目标
出现“迁移需要恢复”时，实例会保持关闭以保护文件一致性。不要手动移动或删除源目录、目标目录或临时目录；选择原来的目标父目录并再次点击“迁移实例”继续恢复。
重装实例
重装会保留实例记录和当前配置，并重新执行完整的 Python 与 WebUI 安装流程。默认尽量复用现有组件；“强制重建 Python”或“强制重建 Core”会在安装前永久删除选中的组件目录。
适合补齐缺失依赖或重新执行安装流程。现有 Python 和 Core 会尽量复用，但安装器仍可能更新依赖或代码状态。Core 位于实例根目录之外时，只要它仍是实例记录指向的同一个现有目录，普通重装也可以继续使用并更新它。
删除实例或只删除记录
只删除 Hanafubuki 中与当前实例身份绑定的记录，不检查、移动或删除任何文件。实例根目录、外部 Python/Core 和其他配置路径全部保留，之后可以重新导入。
删除前最后确认
文件删除无法通过 Hanafubuki 撤销。先核对实例根目录，并确认重要模型、输出、配置和自定义代码已有独立备份。外部组件会保留，但根目录内的同类文件会随完整删除消失。
失败和恢复
维护操作在无法确认进程停止、文件状态或配置提交时，会保留原任务和恢复义务，而不是假装已经完成。此时：
- 打开右下角失败项或任务中心查看准确阶段和错误；
- 不要通过文件管理器手动完成剩余步骤；
- 修复权限、磁盘或占用问题后，使用界面提供的同一操作重试；
- 实例仍被维护锁定时，不要创建同路径的新实例作为替代。