Hanafubuki

路径

管理产物缓存、默认安装目录和受管运行时存储。

路径页包含两类位置:普通下载与实例默认路径,以及应用自己维护的运行时存储。它们用途不同,修改其中一个不会自动迁移其他目录。

缓存与默认安装目录

设置影响
产物缓存目录后续安装和下载任务用于保存、复用下载产物的位置
默认 WebUI 安装目录新建实例时预填的根目录;不会移动或改写已有实例

这两个字段必须手动保存。保存时后端会验证并准备目录,因此不要在输入尚未完成时按 Enter

准备一个有足够空间、当前用户可读写的目录。
输入路径或使用目录选择按钮,检查没有误选系统目录或其他实例的组件目录。
点击“保存”,等待右下角状态完成。
新建一个实例或重新执行下载任务,确认页面使用了新的默认位置。

修改产物缓存不会移动旧缓存,也不会删除原目录。确认新任务工作正常后,再通过系统文件管理器自行评估旧缓存是否可以清理。

受管运行时存储

受管运行时存储是 Hanafubuki 自己维护的目录,包含:

  • 应用 Standalone Python;
  • Micromamba 可执行文件;
  • Conda 根目录和包缓存;
  • 已校验的 Launcher Python 代码。

它不包含 WebUI 实例、模型、普通产物缓存或诊断包。若只是想改变新实例的位置,应修改“默认 WebUI 安装目录”,不要迁移受管运行时。

迁移受管运行时

填写新目录

最终目标必须是一个尚不存在的新目录,不能与应用数据、已有实例或组件路径重叠,也不能经过符号链接。使用浏览按钮定位父目录后,可在输入框末尾补上新的子目录名。

预览组件位置

点击“迁移”,检查确认窗口列出的 Python、Micromamba、Conda 和 Launcher Code 目标位置。此时只生成计划,不会复制文件。

安排迁移

点击“下次重启时迁移”。页面会记录待迁移目标;如果还没有退出应用,可以使用“取消”撤销这个已安排计划。

正常退出并重新启动

先完成正在运行的实例、终端和维护任务,再通过正常方式退出应用。重新启动后,启动页会在加载其他功能前完成迁移。

验证结果

应用打开后回到“路径”和“运行环境”,确认当前运行时根目录以及 Python、Micromamba、Git 状态正常。

不要手动合并或覆盖目录

迁移不会把运行时合并到已有目录。迁移期间不要移动源目录、预先创建目标目录或同时启动第二个 Hanafubuki 进程。

若迁移失败,应用会继续使用仍然有效的原位置,并显示需要恢复的记录。排除磁盘空间、权限或目标冲突后点击“重试”,再正常退出和启动;不要直接删除源目录或目标暂存内容。

本页目录