上传缓存页面逐项控件参考
本页逐项说明上传缓存页面的刷新、访问码、自定义地址、快照卡片、下载/上传/删除按钮及其状态。
页面加载
页面首先读取当前账号的上传缓存索引。状态可能是：
- 加载中；
- 空列表；
- 列表成功；
- 读取失败；
- Token 失效。
空列表不是普通缓存为空，也不是上传失败。先确认当前账号和刷新时间。
刷新列表
点击刷新后按钮进入加载状态。刷新只更新索引，不会自动上传或下载快照。刷新期间不要点击多个操作。
刷新后页面应显示：
- 快照数量；
- 每条快照名称；
- 对应下载/上传/删除按钮；
- 操作中的状态。
访问码输入
上传区可能要求输入访问码/二维码文本。输入原值，不添加空格、换行或引号。访问码不是 Token，不能互换。
访问码为空时：
- 上传按钮可能在点击时提示缺少输入；
- 下载和删除通常不需要该输入；
- 不要用普通账号密码填入。
自定义地址
留空通常表示使用默认地址。只有页面和管理员明确要求时填写。上传前确认地址与快照/账号范围一致；失败后先恢复留空再排查。
快照卡片
每条卡片通常显示名称和三个动作：
下载
下载当前快照文件到本地，适合留档/查看。下载中按钮禁用，完成后检查文件大小和保存位置。
上传
将指定快照发送到当前目标。上传中按钮显示“上传中…”并禁用。成功后应刷新列表和记录；响应超时先回读，不要再次上传。
删除
删除会从上传缓存列表移除对象，可能不可逆。删除前下载留档并确认名称。删除中按钮禁用；成功后列表更新。
快照索引边界
名称必须来自当前列表。列表刷新后旧卡片可能已过期，操作前重新确认名称。不要自己拼接索引，不要把另一个账号的名称复制过来。
三类状态区别
| 状态 | 页面处理 |
|---|---|
| 下载中 | 只锁定当前下载按钮 |
| 上传中 | 只锁定当前上传相关操作，等待回读 |
| 删除中 | 显示明确删除状态，不再重复点击 |
| 列表刷新 | 暂时锁定刷新按钮，保留旧卡片 |
| 失败 | 保留索引和错误，允许用户决定下一步 |
上传后的回读
成功消息之后按顺序：
- 刷新上传缓存列表；
- 查看目标快照是否变化/移除；
- 查看游玩记录/成绩；
- 必要时重新登录；
- 记录上传时间和页面结果。
上传成功不代表所有页面立即建立索引。不要用重复游玩来验证。
删除后的回读
删除请求超时：
- 刷新列表；
- 目标不存在时按已删除处理；
- 目标仍存在时保留未确认状态；
- 只有用户再次明确确认后才可重试。
账号切换
切换账号后清空：
- 上传缓存索引；
- 快照卡片操作状态；
- 访问码输入；
- 自定义地址输入；
- 未完成下载/上传 UI。
重新读取新账号列表，不能把旧账号快照显示给新账号。
反馈模板
text
账号别名：<脱敏>
快照名称：<脱敏>
动作：下载 / 上传 / 删除
发生时间：<含时区>
页面状态：
Token 验证：
列表回读：
记录/成绩回读：
错误消息：不附完整快照、访问码、Token、密码或原始日志。