运行环境
检查并配置应用 Python、Micromamba 和 Git。
运行环境页显示 Hanafubuki 自己依赖的 Python、Micromamba 和 Git。它们属于应用级运行时,与每个 WebUI 实例自己的 Python 和 Core 相互独立。
阅读状态面板
每个面板会显示当前状态、准备步骤、错误和已检测信息:
| 面板 | 重点信息 |
|---|---|
| 应用运行环境 | Python 版本、可执行文件、Python 目录、Launcher Code 和应用 API |
| Micromamba | 内置版本、检测版本、可执行文件和 SHA-256 |
| Git | 检测版本、可执行文件、安装任务和 Conda 根修复状态 |
状态为“准备中”时查看当前步骤,不要连续点击重试。状态为“失败”时先展开错误,记录失败阶段和详细信息;面板允许重试时再使用重试按钮。
选择应用 Python
“应用 Python 版本”支持当前界面列出的 Python 版本。修改会立即保存,但只在下次启动时切换应用运行时。
完成正在运行的安装、管理和 Agent 任务。
选择需要的应用 Python 版本,等待保存完成。
正常退出并重新启动 Hanafubuki。
返回运行环境页,确认版本、可执行文件和应用 API 均为就绪状态。
切换应用 Python 不会重装实例 Python,也不会改变实例选用的 Python 版本。实例环境问题应在对应实例的管理页处理。
选择 Git 来源
| 来源 | 行为 |
|---|---|
| 优先使用系统 Git | 下次启动时检查系统 PATH 中的 Git;不可用时自动回退到 Micromamba Git |
| 使用 Micromamba Git | 跳过系统 Git,始终使用应用托管的 Git |
Git 来源同样在下次应用启动时生效。系统已经安装可用 Git 时通常保留默认选择;需要固定、隔离的 Git 环境时再选择 Micromamba。
失败排查
- Python 下载或校验失败:检查网络、代理、镜像、磁盘空间和受管运行时目录权限。
- Micromamba 失败:确认没有第二个应用进程占用运行时,并检查目标磁盘是否可写。
- Git 等待 Micromamba:先让 Micromamba 完成准备,这不是独立的 Git 卡死。
- 状态订阅不可用:使用面板重试;仍失败时生成应用诊断包。
不要直接替换受管文件
不要从外部覆盖受管 Python、Micromamba、Conda 或 Launcher Code。应用会按自己的版本和校验规则准备这些组件,手动修改可能在下次检查时被判定为损坏。