实例终端
在当前实例的 Python、Git 和受管环境中执行检查或维护命令。
实例终端会使用当前实例的工作目录和受管环境,并将独立 Python、Git、Micromamba/Conda 工具加入正确的 PATH。普通应用终端不自动绑定某个实例,排查 WebUI 时应优先使用实例终端。
打开并检查环境
进入“运行 → 终端”时,应用会创建或重新订阅当前实例的终端会话,并恢复保留的输出。状态变为“运行中”后即可输入命令。
常用的只读检查:
python --version
git --version
python -m pip list还可以在 Core 仓库中使用 git status 检查未提交修改。路径显示方式和切换目录命令取决于 Windows、macOS 或 Linux 当前使用的 Shell。
会话操作
| 操作 | 作用 |
|---|---|
| 离开分区 | 取消当前界面订阅,但不应当被当作已结束进程 |
| 重启终端 | 结束当前 PTY,并为同一实例创建新的终端会话 |
| 关闭终端 | 确认终止并释放当前终端进程 |
| 重新进入 | 订阅已有会话,恢复保留输出并继续接收新输出 |
终端状态为“已退出”时可以重启;状态为“关闭失败”时,后端仍保留原会话的清理义务,应再次使用“关闭终端进程”,不要连续创建替代会话。
安全使用终端
- 执行安装、删除、移动或 Git 命令前,先确认当前目录和目标路径。
- 不要在 WebUI、版本更新、快照恢复或重装任务修改同一环境时手动安装软件包。
- 优先使用
python -m <模块>,确保调用的是当前实例 Python 对应的模块。 - 终端中的手动修改不会自动形成快照,也不保证能被 Hanafubuki 撤销。
- 需要修改受支持的扩展、模型、版本或 PyTorch 时,优先使用对应管理页面,以便获得任务状态和错误输出。
终端具有真实文件修改权限
实例终端不是模拟环境。删除目录、重置 Git 或重装软件包会直接改变实例;重要操作前先创建快照,并单独备份模型、输出和自定义代码。