安装进度与故障处理
查看安装阶段、日志、取消状态，并正确执行清理和重试。
安装工作区是安装过程的唯一进度页面。它显示实例名称、阶段进度、当前步骤、警告和任务日志；切换到其他页面不会让后端任务自动停止。
理解安装阶段
| 阶段 | 正在做什么 |
|---|---|
| 正在安装 Python | 下载、解压并检查实例独立 Python |
| 正在安装 Core | 下载或恢复 WebUI，安装依赖、模型和扩展选项 |
| 正在删除 Python / Core | 重装时按确认选项清除受管组件 |
| 已完成 | 实例已就绪，工作区将继续准备服务并启动 WebUI |
| 失败 / 已取消 | 安装任务已经结束，可以查看错误、清理或重试 |
进度百分比按已经经过的阶段计算，不是下载字节或文件数量。某个阶段长时间保持同一百分比可能只是正在下载或安装大型依赖，应展开“查看日志”确认是否仍有输出。
查看和保存输出
- 点击“查看日志”在当前页面展开只读终端。
- 点击“在任务中心打开”查看同一个任务的完整状态和保留输出。
- 使用复制按钮保存当前日志；长期保留的任务输出可能因容量限制被截断。
- 失败时日志会自动展开，并显示诊断、清理和重试操作。
诊断包可能包含敏感信息
安装诊断可能包含环境变量、本地路径、命令输出、凭据或令牌。分享前先解压检查并脱敏，详见实例诊断。
取消、清理与重试
请求取消
运行中且允许取消时，点击“取消安装”。取消是一个请求；应等待界面进入“已取消”或失败状态，不要立即删除目录或退出进程。
检查清理状态
如果子进程已经确认结束，界面会释放本次安装的所有权。如果终止或检查失败，错误中会保留待处理的清理义务。
重试进程清理
只有界面显示“重试进程清理”时才使用它。该操作只确认并释放残留进程状态，不会重新安装 Python 或 Core。
重新安装
清理完成后点击“重试安装”。应用会创建新的安装操作，并从当前实例状态重新执行需要的步骤。
不要通过任务管理器强行结束后立刻重复创建同一路径的实例；后端仍可能保留需要确认的进程和实例状态。
按错误类型处理
| 现象或错误 | 优先处理 |
|---|---|
| 安装选项加载失败 | 点击“重新加载选项”，再检查应用运行环境和管理服务 |
| 根目录危险、重叠或经过符号链接 | 选择新的专用实例根目录，并保留默认 Python/Core 子目录 |
| Python 下载、解压或校验失败 | 检查网络、代理、镜像、磁盘空间和“设置 → 运行环境” |
| Git 或 Core 下载失败 | 检查 Git 状态、GitHub 镜像、目录权限和目标目录是否含冲突文件 |
| PyTorch 或依赖安装失败 | 恢复“自动”或类型默认选项，确认显卡驱动和软件包来源 |
| 快照类型或平台不匹配 | 选择快照原本的 WebUI 类型，并在兼容操作系统上恢复 |
| 提示操作仍被其他安装占用 | 等待旧任务结束；出现清理按钮时先重试进程清理 |
| 安装完成但 WebUI 启动失败 | 查看随后的启动阶段、参数、端口、PyTorch 决定和依赖冲突 |
记录已创建但任务未启动
创建或快照恢复分为“保存实例记录”和“启动安装任务”两个动作。如果第二个动作失败，应用仍会进入实例工作区，实例卡片也会保留。重新打开实例并点击“开始安装”即可，不需要创建同名实例或手动删除目录。