路径
管理产物缓存、默认安装目录和受管运行时存储。
路径页包含两类位置:普通下载与实例默认路径,以及应用自己维护的运行时存储。它们用途不同,修改其中一个不会自动迁移其他目录。
缓存与默认安装目录
| 设置 | 影响 |
|---|---|
| 产物缓存目录 | 后续安装和下载任务用于保存、复用下载产物的位置 |
| 默认 WebUI 安装目录 | 新建实例时预填的根目录;不会移动或改写已有实例 |
这两个字段必须手动保存。保存时后端会验证并准备目录,因此不要在输入尚未完成时按 Enter。
修改产物缓存不会移动旧缓存,也不会删除原目录。确认新任务工作正常后,再通过系统文件管理器自行评估旧缓存是否可以清理。
受管运行时存储
受管运行时存储是 Hanafubuki 自己维护的目录,包含:
- 应用 Standalone Python;
- Micromamba 可执行文件;
- Conda 根目录和包缓存;
- 已校验的 Launcher Python 代码。
它不包含 WebUI 实例、模型、普通产物缓存或诊断包。若只是想改变新实例的位置,应修改“默认 WebUI 安装目录”,不要迁移受管运行时。
迁移受管运行时
填写新目录
最终目标必须是一个尚不存在的新目录,不能与应用数据、已有实例或组件路径重叠,也不能经过符号链接。使用浏览按钮定位父目录后,可在输入框末尾补上新的子目录名。
预览组件位置
点击“迁移”,检查确认窗口列出的 Python、Micromamba、Conda 和 Launcher Code 目标位置。此时只生成计划,不会复制文件。
安排迁移
点击“下次重启时迁移”。页面会记录待迁移目标;如果还没有退出应用,可以使用“取消”撤销这个已安排计划。
正常退出并重新启动
先完成正在运行的实例、终端和维护任务,再通过正常方式退出应用。重新启动后,启动页会在加载其他功能前完成迁移。
验证结果
应用打开后回到“路径”和“运行环境”,确认当前运行时根目录以及 Python、Micromamba、Git 状态正常。
不要手动合并或覆盖目录
迁移不会把运行时合并到已有目录。迁移期间不要移动源目录、预先创建目标目录或同时启动第二个 Hanafubuki 进程。
若迁移失败,应用会继续使用仍然有效的原位置,并显示需要恢复的记录。排除磁盘空间、权限或目标冲突后点击“重试”,再正常退出和启动;不要直接删除源目录或目标暂存内容。