版本升级流程
版本升级不是单纯替换一个文件，而是下载、校验、等待发布时间、应用内容和验收的一整套流程。机台管理员应把升级当作维护窗口处理。
升级前 24 小时
- 确认机台所有者同意维护时间；
- 记录当前版本、当前侧载版本和订单列表；
- 下载用户缓存和上传缓存列表；
- 准备恢复 U 盘并确认可以识别；
- 确认磁盘剩余空间；
- 确认网络设备稳定；
- 通知现场用户升级时间和预计不可用时间。
升级前 10 分钟
- 停止新增玩家进入机台；
- 等待当前游玩和上传结束；
- 查看健康检查，记录在线、网络和存储指标；
- 截图保存订单进度；
- 关闭不需要的直播、自动刷新和测试功能；
- 确认浏览器页面使用的是目标机台账号。
选择更新内容
更新内容可能来自公共更新、机台专属更新或用户提交的审核内容。选择时核对：
- 适用版本；
- 目标分支；
- 订单名称；
- 总大小和分包数量；
- 发布时间；
- 是否需要重启；
- 是否包含删除项或迁移项。
不要把“列表中能看到”当作“当前机台一定能安装”。权限、分支和版本都必须同时匹配。
小型内容更新和大版本安装可能使用不同介质：页面公告允许在线下载时，仍要等待订单完整应用；需要大版本或恢复时，应使用管理员提供的安装/恢复 U 盘。不要把一个小包文件当作完整安装介质，也不要把大版本更新拆成个人猜测的文件列表。
下载阶段
下载开始后记录：
- 开始时间；
- 当前项目；
- 总进度；
- 下载速度；
- 剩余磁盘空间；
- 是否有失败或重试。
大包可能分成多个安装项。某一个安装项完成并不代表整个订单完成；等待所有安装项达到完成或明确的等待发布时间状态。
聊天经验：不要用显示版本号代替完整验收
群组里曾出现“内容已经更新但屏幕版本号没有变化”和“两台机台只有一台出现新内容”的情况。版本文字可能表示启动分支，不一定代表所有内容订单都已应用。比较机台时，应同时核对：分支、订单可选项、黑名单、下载项、磁盘空间、最后上报时间和重启方式。
如果大型更新拆成多个包，必须等所有包完成后再判断缺失内容。缺少图片、音频或曲目时，先看安装项和磁盘，不要立刻删除缓存或创建同名订单。
等待发布时间
订单可能在全部下载完成后等待指定发布时间：
- 页面显示完成但后续处理没有开始，不一定是错误；
- 不要重复创建同一个订单；
- 确认机台时区和页面时间一致；
- 到时间后刷新一次进度；
- 仍未开始时记录订单名、时间和状态。
应用阶段
应用阶段可能包括解压、镜像处理、目录映射、启动配置和清理旧内容。此时：
- 不要拔掉介质或断电；
- 不要关闭浏览器等待页面；
- 不要同时修改其它配方；
- 观察磁盘写入和订单状态；
- 出现失败时保存错误消息和截图。
重启与验收
第一次启动
- 等待机台完全进入待机页；
- 确认启动页面没有循环重启；
- 刷新 Web 健康检查；
- 确认在线状态和最后上报时间；
- 检查当前版本/侧载版本；
- 检查订单状态和磁盘空间。
普通用户验收
- 使用测试用户完成登录；
- 打开一个普通内容；
- 完成一次最小游玩并退出；
- 检查记录是否出现；
- 检查相片读取；
- 检查缓存和上传状态；
- 再切换回管理员页面确认健康数据。
维护窗口与两次重启经验
历史公告曾建议长期未启动的机台在回退或大更新前先完成两次正常重启，以便应用待处理的控制更新并确认热重载路径正常。该步骤不是强制的永久协议；如果当前公告给出其他顺序，以当前公告为准。
热重载开关已启用但页面仍要求重启，也不一定是失败。启动配置、挂载、运行库和大型资源常常需要冷重启；按页面提示执行一次完整重启，再重新读取健康和订单状态。
升级失败分级
只影响内容
例如某个资源缺失或一条安装项失败。先保存状态，检查分包、Hash、磁盘和发布时间，不要立即恢复整个机台。
影响启动
如果循环重启、无法进入待机或显示严重错误，停止继续下载，使用恢复与回滚。
影响网络
先确认机台本地启动正常，再检查网络设备和健康检查。不要同时更改 Hosts、配方和订单。
影响数据
停止删除或恢复操作，下载当前缓存和上传缓存列表，联系管理员确认数据来源和恢复顺序。
回滚判断
满足以下任一情况时考虑回滚：
- 启动无法恢复且错误明显由新更新引起；
- 关键功能在完整下载后仍然失败；
- 订单映射导致路径或显示异常；
- 数据上传出现无法解释的错误；
- 管理员确认新版本不适合当前机台。
回滚前先保存新版本的错误信息，不要直接删除新版本文件；这些信息可能帮助管理员修复后续包。
升级记录模板
维护日期：
机台本地名称：
升级前版本：
目标版本/分支：
订单名称：
订单项数量：
开始下载：
下载完成：
发布时间：
应用完成：
重启时间：
验收结果：
是否回滚：
备份位置：