普通缓存页面逐项控件参考
本页专门解释普通缓存页面的备份、兼容格式、文件选择、预览、恢复和回显。它与上传缓存页面分开，不能互相替代。
页面分区
普通缓存页面通常有三部分：
- 页面标题和账号提示；
- 数据备份按钮；
- 数据恢复文件选择和结果区；
- 备份内容说明和数据类别卡片。
数据备份按钮
页面可能提供普通 JSON 备份和兼容格式备份两个按钮。按钮点击后：
- 浏览器生成下载任务；
- 文件名包含时间或账号提示；
- 失败时页面显示错误消息；
- 不会自动恢复或上传。
普通备份优先用于完整留档，兼容格式适用于页面明确支持的迁移。两种格式不要互相覆盖，保留原始文件。
下载前后
下载前确认当前账号；下载后：
- 检查文件确实落盘；
- 检查大小不是 0；
- 计算哈希或记录文件大小；
- 放到受保护目录；
- 文件名使用脱敏别名、时间和版本。
不要把备份 JSON 直接粘贴到公开聊天或普通错误日志。
文件选择器
恢复区的文件选择器接受 JSON 文件。选择文件后页面可能立即解析并显示预览：
- 未选择文件：恢复按钮禁用；
- 解析中：显示处理中；
- JSON 无效：显示错误，不能恢复；
- JSON 有效：显示摘要和恢复按钮；
- 重新选择：清除上一份文件状态。
选择另一个账号的文件时，客户端不一定能在本地识别，应由用户核对来源、账号别名和导出时间。
预览区
预览只显示摘要，不应泄露完整 Token、密码、地址或服务 JSON。可能显示：
- 顶层对象是否有效；
- 识别到的数据类别；
- 数量摘要；
- 导出时间/版本（如果存在）；
- 当前账号提示；
- 文件错误。
预览通过不等于服务端一定接受，仍要在恢复后回读页面。
恢复按钮
点击恢复前应执行：
- 下载当前状态；
- 确认目标账号；
- 确认文件来源；
- 明确恢复可能覆盖的范围；
- 点击一次恢复；
- 等待回显。
恢复中按钮显示处理中并禁用。成功后可能显示处理条数和消息；失败时保留当前服务端数据，不要自动用另一份文件覆盖。
数据回显
回显可能按类别显示：
- 游戏分数；
- 游玩记录；
- 成就进度；
- 设置配置；
- 其它服务返回的数据类别。
回显数量不一定等于记录页面立即可见的数量。恢复后重新登录或刷新各页面，等待索引更新。
兼容格式
如果页面提供兼容格式备份：
- 它可能只覆盖部分数据；
- 不能替代普通完整备份；
- 恢复前确认目标版本；
- 跨版本时保留原始格式；
- 失败后不要删除原文件。
错误矩阵
| 现象 | 处理 |
|---|---|
| 下载按钮无反应 | 检查 Token、浏览器下载权限 |
| 文件选择后无预览 | 检查扩展名、编码和文件大小 |
| JSON 格式错误 | 从原始备份重新复制 |
| 恢复按钮禁用 | 文件未通过本地解析 |
| 恢复成功但页面为空 | 账号、索引和同步队列 |
| 回显条数异常 | 来源、范围和文件是否截断 |
| 恢复后数据混合 | 立即停止，下载当前状态并联系管理员 |
页面切换和账号边界
切换账号或离开页面时清理文件预览和当前文件状态。新账号不能复用旧账号的预览摘要。浏览器返回/刷新不会自动撤销已经发送的恢复。
验收清单
- [ ] 两种下载格式说明清楚；
- [ ] 下载前后账号可确认；
- [ ] 无效 JSON 不可恢复；
- [ ] 预览不泄露敏感字段；
- [ ] 恢复有当前状态备份；
- [ ] 恢复中按钮锁定；
- [ ] 成功后显示回显并要求回读；
- [ ] 账号切换清理旧文件；
- [ ] 超时不自动重复恢复。