订单下载、安装与回滚排障
订单问题通常发生在“配置已保存、下载已完成、应用未完成、启动未切换”几个阶段之间。本页补充订单与 VHDX 配置和自定义订单编辑器，重点处理看起来完成但内容不可用的情况。
订单生命周期
可以把一个订单理解为：
可见 → 选中 → 下载 → 校验 → 等待发布时间
→ 安装/挂载 → 选择分支 → 重启/热重载 → 内容验收任何一个阶段没有完成，内容都可能暂时不可见。订单名称显示在列表里不等于安装项已完成，进度 100% 也不一定等于整个订单已应用。
先保存状态
排障前保存：
- 订单名称和描述；
- 每个安装项名称；
- 状态和进度；
hash/size的脱敏摘要；release_time；- 当前分支和侧载选择；
- 磁盘剩余空间；
- 健康最后上报时间。
不要先删除订单或下载目录，否则会丢失判断“下载失败还是应用失败”的证据。
订单列表为空
检查：
- 当前账号是否是机台账号；
- 目标机台是否正确；
- 健康数据是否能刷新；
- 自定义订单配置是否读取失败；
- 页面是否正在加载；
- 权限是否发生变化。
读取失败时不要把空状态保存为新的订单配置。先重新读取和记录消息。
下载不开始
常见原因：
- 订单被禁用；
- 启动时应用更新被禁用；
release_time未到；- 订单为可选项但未被选择；
- 黑名单排除；
- 网络或磁盘空间不足；
- 目标分支不可见。
一次只核对一项。公告已发布不表示当前机台已经下载。
下载卡住
连续两次刷新记录进度和时间：
- 进度变化：继续等待；
- 状态为校验：检查磁盘读写和校验值；
- 状态为等待发布时间：等到时间后刷新；
- 进度完全不变：暂停创建新订单并联系管理员；
- 多个订单都不动：优先检查网络/服务；
- 只有一个安装项不动：检查该项 URL、Hash、大小和权限。
不要在下载卡住时反复重启。重启可能中断可恢复下载，也可能让状态更难解释。
Hash 和大小问题
size 应是管理员提供的字节数，hash 应与发布值完全一致。下载失败时：
- 保存错误消息；
- 重新读取配置；
- 核对大小和校验值；
- 确认文件没有被中途替换；
- 只在管理员允许时重新下载。
不要关闭校验、修改文件名或用另一个包的 Hash “修复”。
VHDX 订单问题
VHDX 订单要同时核对：
is_vhdx；- 镜像文件名；
- 镜像密码；
- 安装项 Hash/大小；
- 挂载路径；
install_mklink；- 侧载启动入口；
- 磁盘空间。
镜像下载完成但按钮不显示，优先检查订单是否启用侧载、当前分支是否选择目标订单和可选列表是否包含它。不要在公开反馈中写镜像密码。
内容下载完成但不可见
按层判断：
- 列表没有：查权限、分支、索引；
- 列表有但详情没有：查详情包；
- 详情有但资源没有：查资源安装项；
- 资源有但启动错误：查路径、挂载和启动入口；
- 单机台异常：比较目标机台配置和健康状态。
不要复制另一台机台目录或修改文件名。这样可能掩盖发布包本身的问题。
侧载没有切换
检查：
- 自定义订单按钮是否出现；
- 是否点击“使用”而不是只调整排序；
- 保存排序是否成功；
- 当前选择是否持久化；
- 是否按页面提示重启；
- 重启后健康页和内容是否更新。
浏览器中的选择顺序不等于机台已经启动该版本。
可选、黑名单和删除列表
三种列表不要互换：
- 可选列表决定哪些可选安装项可以参与；
- 黑名单阻止指定项；
- 删除列表可能触发数据清理，风险更高。
排查目标内容不见时保存三份原值，确认名称完全匹配，再修改一份并重新读取。不要把黑名单复制到删除列表。
限速导致的假性卡住
限速可以分别作用于下载、校验下载、校验安装和安装阶段。限速过低会让订单长时间处于处理中，0 的含义以当前页面为准。调整前记录原值，使用保守值，观察网络和进度，再决定是否保留。
应用与重启
订单完全下载并不一定立即应用。等待校验和发布时间结束后：
- 让机台空闲；
- 保存当前缓存；
- 按页面提示热重载或冷重启；
- 等待完整启动；
- 刷新健康和订单；
- 做内容最小验收。
热重载允许与执行热重载是两个不同动作。启动配置、挂载、运行库和大型资源通常需要冷重启。
回滚顺序
回滚前确认目标版本和机台匹配，并保留新版本错误画面、订单和数据。回滚后：
- 验证启动；
- 验证网络和 Token；
- 验证只读页面；
- 验证内容和订单；
- 最后恢复缓存和上传队列；
- 记录是否仍需要修复包。
不要直接删除新版本目录模拟回滚，也不要在没有恢复介质时开始高风险回滚。
订单反馈模板
机台别名：
订单名：
安装项：
当前状态：
进度：
release_time：
当前分支/侧载：
磁盘空间摘要：
最后上报时间：
是否重启：
缺失内容：
已尝试动作：不附完整 JSON、URL、密码、Hash 原文、网络文本、Token 或账号备份。