现场维护运行手册
本手册面向负责授权机台安装、升级、网络切换和恢复的维护人员。它把安装页、升级页、恢复页和聊天记录中的现场经验组合成一条可执行流程。
本文不提供隐藏地址、私密凭据、命令或内部实现。所有操作都必须在机台所有者和场所管理员授权下进行。
维护前的安全边界
维护人员必须确认：
- 有机台所有者或场所管理员的明确许可；
- 现场没有玩家正在使用目标机台；
- 物理开门、网线、路由器和 U 盘操作由被授权人员执行；
- 账号、二维码、Token、机台标识和备份文件不会进入公开群；
- 有可用的恢复介质和最近一次账号缓存；
- 发生失败时知道联系谁以及如何回滚。
普通用户不应要求现场人员为了安装或网络修改而临时开门，也不应把下载的未知文件交给现场人员直接插入机台。
维护前记录表
开始前填写一份记录：
维护日期：
维护人员/授权来源：
机台本地名称：
目标账号别名：
当前分支/内容版本：
最近一次正常启动：
最近一次正常上传：
健康页最后上报：
当前订单与安装项：
磁盘剩余空间：
网络设备状态：
缓存备份位置：
恢复介质版本与容量：
维护目标：
预计维护窗口：截图中遮挡账号凭据、网络地址、访问码和个人信息；维护记录可以保留错误时间和页面标题。
先判断维护类型
| 类型 | 典型目标 | 首选资料 |
|---|---|---|
| 只读检查 | 查看健康、订单和磁盘 | 机台健康页 |
| 网络维护 | 修复地址分配、物理链路或上游网络 | 网络接入与验证 |
| 小内容更新 | 应用已经发布的少量内容 | 更新/订单页面 |
| 大版本安装 | 更换完整版本或大型资源 | 安装器和 U 盘 |
| 数据恢复 | 账号数据缺失或上传失败 | 缓存与恢复页 |
| 启动恢复 | 黑屏、循环重启、介质损坏 | 恢复 U 盘 |
不要把网络问题、版本更新和数据恢复安排成一次没有记录的连续操作。一次只解决一种问题，才能知道结果来自哪一步。
长期未开机的机台
聊天现场经验显示，长时间未启动的机台在切换版本或回退前，最好先在维护窗口内完成两次正常重启，并确认启动阶段的热重载/冷重启路径能完成。这个经验不是永久强制规则，若当前公告另有顺序，应以当前公告为准。
建议顺序：
- 不插新介质，记录当前健康状态；
- 正常启动并等待进入待机；
- 刷新网页健康数据；
- 做第一次维护窗口内重启；
- 再次确认上报时间、网络和磁盘；
- 做第二次重启或按公告完成一次热重载；
- 若仍停留在旧状态，再决定是否安装/恢复。
“多重启几次”不是故障修复方法。如果两次重启后现象不变，应进入证据收集和恢复判断，不要无限重启。
安装介质工作流
制作前
- 取得与目标版本匹配的安装器；
- 准备独立 U 盘，不要使用唯一备份盘；
- 确认容量、分区、格式和卷标要求；
- 下载后进行完整性检查；
- 记录安装器版本和下载时间。
写入后
- 文件必须位于管理员指定的位置，恢复介质通常要求根目录；
- 不要把多个版本混到同一只盘；
- 不要在恢复盘上叠加未经确认的多启动层；
- 安全弹出后再插入机台；
- 记录 U 盘容量、格式和目标接口。
机台操作
- 让机台完全关机，不是停留在待机；
- 插入管理员指定接口；
- 开机后等待安装/恢复界面；
- 读写期间不拔盘、不断电、不连续按电源键；
- 等待自动重启和首次启动完成；
- 进入待机并完成初步验收后再拔盘。
如果插盘后立刻跳过安装并回到原系统，不要把“能开机”当作成功。重新检查关机状态、接口、根目录、分区、卷标和版本匹配关系；一次只改一个条件。
在线更新工作流
下载前
- 确认目标分支和订单名称；
- 查看总大小、分包数量和发布时间；
- 记录当前磁盘空间；
- 下载账号缓存和上传缓存索引；
- 关闭不需要的直播、自动刷新和测试功能；
- 确认现场有足够维护时间。
下载中
记录开始时间、当前安装项、总进度、下载速度、失败重试和磁盘剩余空间。大型内容可能拆分为多个安装项：单项完成、进度接近 100% 或公告显示已下发，都不能证明整个订单已经应用。
等待发布时间
下载完成后订单可能等待发布时间。这不是自动失败：
- 不要重复创建同名订单；
- 核对机台时区和页面时区；
- 到时间后刷新一次；
- 仍未开始时记录订单名、时间和状态。
应用与重启
应用阶段可能包括解压、镜像处理、路径映射、启动配置和清理旧内容。不要在此阶段断电、拔盘或同时修改配方。
页面提示热重载时，先确认机台空闲；页面提示冷重启时，不要为了绕过提示连续切换开关。启动配置、挂载、运行库和大型资源可能必须冷重启。
网络维护工作流
没有地址
如果 DHCP 没有给机台分配地址：
- 检查指定 LAN 口和网线；
- 查看路由器端口灯和电源；
- 确认 DHCP 服务开启且地址池没有耗尽；
- 只重启网络设备或机台中的一项；
- 获取地址后再验证健康、网页和登录。
不要先改 Hosts 文本或配方来掩盖地址分配问题。
短暂掉线
历史经验中出现过维护窗口内短暂掉线。先记录最后上报时间，等待窗口结束后刷新一次；超过窗口仍未恢复，再检查物理链路、地址、健康检查和登录结果。
更换网络设备
更换前下载缓存、记录端口和原配置。更换后先只验证网络，不要同时更新版本；网络稳定后再读取配方和订单，最后做普通用户登录、记录和相片验收。
数据保护工作流
上传失败
机台可能已经生成本地游玩数据，但远端保存失败。处理顺序：
- 记录游玩时间、内容和错误消息；
- 不要清理机台缓存；
- 从上传缓存页面下载快照；
- 验证 Token 和访问码；
- 上传一次并等待结果；
- 回到记录/成绩页面重新读取。
如果响应丢失，先刷新列表和只读数据，不要连续上传。
恢复数据
恢复前先下载当前状态，确认备份来自同一账号，解析 JSON 后再提交。恢复完成后检查记录、成绩、相片和配方读取，不要只看恢复条数。
测试数据范围
如果页面或机台提示数据只保存到专用数据区，不要把它当作已经写入全部服务。按管理员给出的保存策略处理，必要时使用上传缓存，等待内容同步后再确认记录。
回滚判断
出现以下情况之一时，暂停继续更新并考虑回滚：
- 无法进入待机且新更新明显相关；
- 所有安装项完成后仍缺少关键内容；
- 订单映射造成路径或显示异常；
- 数据上传出现无法解释的失败；
- 网络、磁盘或启动状态持续恶化。
回滚前保存新版本的错误画面、订单和日志摘要，不要直接删除新版本目录。恢复后先验证网络和账号，再恢复缓存和内容。
最终验收顺序
维护结束后按下面顺序验收：
- 机台进入稳定待机；
- 健康页最后上报时间更新；
- 网络地址、网关和检查结果正常；
- 当前分支和订单符合目标；
- 磁盘空间足够；
- 普通用户登录和退出；
- 完成一次最小内容读取；
- 生成一条最小游玩记录并退出；
- 检查记录/成绩；
- 检查相片列表和缓存；
- 下载一份最新备份；
- 切回管理员页面确认无新错误。
维护结束记录
维护目标：
实际开始/结束：
变更的网络项：
变更的版本/订单：
下载完成时间：
应用/重启时间：
健康上报是否更新：
普通用户登录：通过/失败
记录与成绩：通过/失败
相片与缓存：通过/失败
是否回滚：
备份位置：
遗留问题：