上传缓存页面
“上传配方缓存”页面用于管理已经生成的缓存快照。它和“数据缓存”页面不同：数据缓存偏向完整账号备份，上传缓存偏向等待发送、可下载留档和可再次提交的快照。
使用前提
- 已登录正确的用户账号；
- 当前 Token 仍然有效；
- 已准备页面要求的访问码文本；
- 知道当前快照属于哪个账号和哪个机台；
- 删除前已经把需要留存的快照下载到安全位置。
不要在公共电脑上保存访问码、Token 或上传缓存文件。
页面布局
页面顶部依次出现：
- 页面标题“上传配方缓存”；
- “刷新列表”按钮；
SGWCMAID输入框；- “自定义 Aime 服务器地址”输入框；
- 错误/成功提示区；
- 当前账号的快照列表；
- 上传缓存说明。
刷新列表
打开页面时会自动读取列表，也可以点击“刷新列表”重新读取。读取过程中按钮显示“加载中…”，不要连续点击。
出现“请先登录账号”时先回到账号选择页；出现“网络错误”时保留原列表，不要把空列表当成服务端已经删除。
SGWCMAID 输入框
这是页面要求的访问码/二维码文本输入框。上传动作没有填写有效文本时，页面会在提交前提示“请输入 SGWCMAID”。
- 直接粘贴页面生成的完整文本；
- 不要手动插入空格、换行或引号；
- 不要在日志、截图或聊天中公开完整值；
- 更换账号或目标机台后重新确认它属于当前操作。
自定义服务器地址
“自定义 Aime 服务器地址”可留空，留空时使用页面默认地址。只有管理员明确提供地址时才填写；不确定时不要复制群聊中的旧地址。
保存该输入不会单独发起请求，只有点击某条快照的“上传”时才会随请求使用。输入地址时不要带多余空格，也不要把带凭据的地址写入公共配置。
快照卡片
每条快照卡片显示：
- 快照名称；
- “上传配方缓存”说明；
- 下载按钮；
- 上传按钮；
- 删除按钮。
同一条快照的上传或下载进行时，对应按钮会显示“上传中…”或“下载中…”，避免重复提交。其它快照仍可能显示，但操作前必须确认没有选错名称。
下载
点击“下载”后，页面读取该快照对象并在浏览器中生成 JSON 文件。文件名通常由快照名称和当前日期组成。
下载完成后检查：
- 浏览器下载确实完成；
- 文件可以解析为 JSON；
- 文件名、账号和日期符合预期；
- 文件放入加密磁盘或离线备份；
- 不要把完整文件上传到公开网盘。
下载失败时保留快照列表，不要因为一次超时就删除快照。
上传
上传是高风险写入动作，推荐顺序：
- 先点击下载留档；
- 填写当前有效访问码；
- 确认自定义地址为空或确实由管理员提供；
- 点击目标快照的“上传”；
- 等待成功/失败消息；
- 回到记录、成绩或机台页面重新读取。
成功消息说明服务接受了上传请求，不等于每个页面已经立即建立索引。响应丢失时先刷新列表或重新读取只读页面，不要立刻重复上传。
删除
点击“删除”会弹出二次确认，确认文字包含快照名称。删除成功后该名称从当前列表中移除。
删除不可逆，且不会替代数据备份。删除前至少确认：
- 快照已经下载；
- 不再需要从它恢复或上传；
- 当前账号没有选错；
- 没有其它管理员正在使用该快照。
空状态与错误状态
| 页面显示 | 含义 | 处理 |
|---|---|---|
| 加载中 | 正在读取列表 | 等待，不重复刷新 |
| 暂无上传缓存 | 当前列表为空或尚未生成快照 | 先确认普通备份和账号状态 |
| 请先登录账号 | 没有可用 Token | 重新登录/验证 |
| 获取上传缓存失败 | 服务返回业务失败 | 保留消息，稍后重试一次 |
| 网络错误 | 浏览器未收到可解析响应 | 检查网络，不立即重复写入 |
| 上传成功 | 请求被接受 | 重新读取记录/成绩 |
| 删除成功 | 快照已从列表移除 | 检查本地留档 |
聊天经验对应处理
历史群聊中出现过“机台已经游玩但页面没有成绩”“上传按钮报错”“响应看似失败但实际上已经接受”的情况。安全做法是先下载缓存，再用当前页面提示的访问码上传一次；如果请求结果不明确，先刷新列表和只读数据，不要清空机台缓存，也不要通过再次游玩来测试。
当机台提示本次数据只保存到专用数据区时，上传缓存可以作为受控转移手段，但实际保存范围由当前管理员策略决定。不要手工改 JSON 来强行改变目标范围。
与 API 的关系
对应公开接口见上传缓存 API。开发者实现时应：
- 先调用列表接口取得
indexName，不要让用户任意拼接名称； - 把访问码视为敏感输入；
- 删除前显示明确的快照名称并二次确认；
- 二进制/JSON 响应按
Content-Type处理； - 写入请求超时后先重新读取状态，再决定是否重试。