普通缓存页面逐项完整参考

本页详细说明账号数据缓存页面的下载、兼容格式、文件选择、预览、恢复、加载/错误状态、数据范围和账号切换边界。上传缓存快照另见上传缓存页面逐项控件参考。

页面组成

页面通常包含：

1. “数据备份”区域；
2. 普通 JSON 下载按钮；
3. 兼容格式下载按钮；
4. “数据恢复”区域；
5. 文件选择按钮；
6. 文件信息/预览区；
7. 恢复按钮；
8. 备份与恢复说明卡。

下载普通缓存

点击“下载数据缓存”后按钮显示“下载中…”，同一页面的其它下载按钮可能一起禁用。成功后浏览器下载 JSON 文件并显示“数据缓存下载成功！”。

建议文件命名：

<account-alias>_<date>_<version>_cache.json

不要把真实 Token、完整账号名或机台私有地址写进公开文件名。下载后检查浏览器下载记录、文件大小和 JSON 可解析性。

下载兼容格式

页面可能提供“下载兼容格式的账号数据”。它适合跨版本迁移，但字段范围可能与普通备份不同。两份文件要分别标注格式，不要覆盖同名文件。

兼容格式下载成功/失败消息与普通下载类似；失败时先保留普通备份，不要因为兼容格式失败就删除当前缓存。

数据范围

备份说明可能列出：

• 游戏分数；
• 游玩记录；
• 成就进度；
• 设置配置；
• 页面当前可导出的其它账号数据。

页面说明是当前版本的导出范围，不保证未来版本字段完全一致。恢复前先确认来源账号和目标账号一致。

选择恢复文件

文件选择控件通常接受 JSON 文件。选择后页面会：

1. 读取本地文件；
2. 尝试解析 JSON；
3. 显示文件已加载/准备恢复；
4. 在解析失败时显示错误并禁用恢复。

选择文件是浏览器本地操作，不应把文件上传到第三方识别站点。完整备份可能包含账号、路径、记录和配置，存放在加密/受保护位置。

恢复前确认

恢复是高风险写入。开始前：

• 确认当前登录账号；
• 确认备份来自同一账号；
• 下载当前状态作为回滚点；
• 检查文件生成时间、版本和大小；
• 关闭其它会修改同一账号的页面；
• 明确恢复是合并还是覆盖，以当前页面说明为准。

不要用不同账号的 JSON 拼接，也不要在文本编辑器中随意修改字段来“修复”导入问题。

预览状态

页面可能显示“备份文件已加载，准备恢复数据”或预览摘要。预览成功只说明浏览器能解析文件，不说明服务端会接受每一条记录。

预览中出现未知字段时不要立即删除；先保留原文件并对照当前版本兼容性说明。

恢复按钮和结果

点击“恢复数据缓存”后按钮显示“恢复中…”，期间不要重新选择文件或连续点击。成功消息可能包含恢复条数，例如“数据缓存恢复成功！共恢复 N 条数据”。

恢复条数是服务端接受/处理的数量，不等于所有页面已经完成索引。恢复完成后按顺序刷新记录、成绩、相片和统计页面。

错误状态

页面表现	含义	安全处理
请先上传备份文件	没有有效文件	重新选择同账号文件
文件格式错误	JSON 解析失败	保留原文件，检查来源/完整性
恢复中	请求仍在处理	等待一次，不重复提交
恢复失败	服务返回业务错误	保存消息和时间，先读取当前状态
网络错误	浏览器未得到可解析响应	不要立刻重复恢复
恢复成功	请求被接受并返回数量	继续做页面回读

响应丢失时不能直接判断恢复失败。先重新打开记录/缓存页面，确认是否已经出现目标数据，再决定是否联系管理员。

账号切换边界

切换账号后，旧账号的文件选择、预览和页面消息不应当被当成新账号数据。推荐：

1. 退出/切换账号；
2. 清空文件选择；
3. 刷新页面；
4. 检查当前账号别名；
5. 再选择备份。

不要在同一弹窗中先预览 A 账号再切换到 B 账号恢复。

与上传缓存的区别

项目	普通缓存	上传缓存
来源	网页账号导出的备份	机台/页面生成的上传快照
主要用途	账号迁移/离线恢复	断网后受控上传
页面动作	下载、选择、预览、恢复	列表、下载、上传、删除
失败重点	文件来源、JSON、账号	快照索引、访问码、重复提交

不要把上传缓存列表为空当成普通备份为空，也不要用普通备份替代现场上传缓存流程。

页面回归清单

• [ ] 普通下载按钮加载状态正确；
• [ ] 兼容格式下载与普通下载分开保存；
• [ ] 文件选择只接受有效 JSON；
• [ ] 解析失败时恢复按钮禁用；
• [ ] 预览不上传到未知第三方；
• [ ] 恢复前显示当前账号和文件信息；
• [ ] 恢复中不会重复提交；
• [ ] 成功后显示处理条数并回读记录/成绩/相片；
• [ ] 切换账号后清理旧文件选择；
• [ ] 分享排障信息时不附完整备份。