Hanafubuki

环境工具

配置 uv、启动前环境检查和 CUDA 显存优化。

环境工具决定安装流程和 WebUI 启动时怎样使用实例 Python。它们不会选择应用 Python 版本,也不会代替实例管理中的 PyTorch、扩展或版本操作。

启用 uv

开启后,支持的 Python 软件包安装使用 uv 代替 pip,通常速度更快。某些安装脚本或非标准软件包与 uv 不兼容时,可以临时关闭后重试同一个操作。

关闭 uv 不会卸载已经安装的软件包,也不会自动把环境恢复到之前状态;它只改变后续安装命令使用的工具。

启用环境检查

开启后,应用会在 WebUI 启动前检查并修复其依赖。首次启动、更新 Core、恢复快照或修改依赖后建议保持开启。

环境检查可能增加启动时间。只有确认实例环境已经完整,并且需要对比检查流程是否导致启动失败时,才临时关闭;排查结束后应重新开启。

启用 CUDA 显存优化

该选项在启动 WebUI 时请求 CUDA 异步显存分配器:

  • 只在支持该能力的 NVIDIA 环境中生效;
  • AMD、Intel、Apple 或 CPU 环境会忽略;
  • 某些旧驱动、旧版 CUDA 或特定 WebUI 组合可能不兼容。

遇到启动阶段的 CUDA 分配器错误时,先关闭此项并重新启动实例进行对比,不要同时更换 PyTorch 和多个启动参数。

修改与验证

记录当前设置和需要解决的具体错误。
一次只修改 uv、环境检查或 CUDA 优化中的一项;开关会自动保存。
停止并重新启动相关 WebUI,让新的启动或安装计划读取设置。
在任务输出中确认安装工具、环境检查或 CUDA 错误是否发生变化。
如果没有改善,恢复默认设置,再继续检查实例依赖或显卡环境。

全局设置会影响多个实例

环境工具属于应用级设置。修改后,之后执行相关流程的所有实例都可能受到影响,因此不要为解决单个实例问题长期关闭必要检查。

本页目录