现场维护记录簿

维护记录不是形式文档，而是用来回答“改了什么、什么时候改的、是否生效、如何回退”。每台机台、每个维护窗口单独记录，不能用一句“已更新”代替详细状态。

记录原则

• 一次变更对应一条记录；
• 时间统一写时区；
• 原值和目标值分开写；
• 记录页面结果和机台结果；
• 失败时保留现场，不用第二次操作覆盖；
• 敏感值只写“已提供/已轮换/已遮挡”；
• 关闭任务前做回读和最小验收。

维护窗口表头

维护窗口编号：
机台别名：
现场地点别名：
负责人：
开始时间/时区：
结束时间/时区：
维护目的：
当前版本/分支：
当前订单摘要：
恢复介质别名：

不要写完整 IP、账号密码、Token、访问码、私钥或原始网络文本。

变更单

变更编号：
操作页面：
操作名称：
目标字段/订单：
原值摘要：
目标值摘要：
操作者：
发送时间：
页面结果：
重新读取结果：
机台健康结果：
是否重启/热重载：
重启完成时间：
最小验收结果：
回滚值/回滚点：
结论：通过 / 部分通过 / 回滚 / 待处理

维护前记录

维护开始前至少保存：

• 当前健康页截图（已遮挡）；
• 当前配方原值；
• 当前订单和安装项；
• 普通缓存备份；
• 上传缓存索引；
• 重要相片；
• 当前侧载选择和排序；
• 恢复 U 盘可识别结果。

若无法取得其中一项，记录原因并让管理员决定是否继续，不要默默跳过。

维护中记录

按时间顺序记下：

1. 读取原值；
2. 点击的页面控件；
3. 页面显示的处理中/成功/失败；
4. 健康和订单刷新；
5. 重启/热重载开始与结束；
6. 现场发现的资源和显示问题。

写“修改了网络”不够，应说明修改的是哪一类可见字段和是否恢复。

维护后验收

网页层

• Token 验证；
• 主页加载；
• 配方读取；
• 缓存下载；
• 记录/成绩读取；
• 相片列表读取；
• 上传缓存列表读取。

机台层

• 新的健康上报；
• 本地待机/登录入口；
• 目标分支和订单状态；
• 内容索引、详情和资源；
• 最小登录/退出；
• 记录或缓存提示；
• 现场声音、显示和直播状态。

只通过网页层时，结论写“网页恢复”；只通过机台启动时，写“启动恢复，数据待验收”。

失败记录

失败记录要包含“最后一个成功动作”。例如：

最后成功：订单列表可见，安装项 A 已完成
首次失败：切换侧载后重启，内容索引缺少详情
已尝试：刷新健康一次，未修改订单
下一步：保留缓存，等待管理员核对发布包

不要只写“还是不行”，也不要把失败后的连续试错省略。

敏感信息记录

内容	记录方式
Token/密码	不记录原文，只写已验证/已轮换
二维码/访问码	不截原图，只写生命周期和时间
IP/网关	只写检查是否成功
订单 URL/密码	写脱敏名称和校验结果
机台编号	使用现场别名
相片/摄像头	只保留必要裁剪图

关闭记录

维护窗口结束时确认：

• [ ] 所有临时开关已恢复；
• [ ] 直播、摄像头、测试模式已关闭；
• [ ] 侧载选择已记录；
• [ ] 订单不再处于未知写入状态；
• [ ] 缓存和回滚点已保存；
• [ ] 账号可以最小登录和退出；
• [ ] 现场使用者知道当前限制；
• [ ] 临时敏感文件已清理；
• [ ] 记录中没有凭据原文。

交接摘要

交给下一位维护人员的摘要只写：当前版本/分支、已完成操作、待处理订单、已知问题、回滚点、下次动作和联系渠道。原始备份和敏感日志放在受保护位置，不要贴入摘要。