账号异常与恢复流程
本页处理登录失败、账号名称变化、Token 失效、本地账号条目异常和恢复后数据不一致。它的核心原则是先确认账号归属,再处理凭据,最后恢复数据;不要因为一个页面为空就立即覆盖缓存。
先区分三种账号身份
浏览器本地条目
账号选择器中的名称、颜色、排序和最近使用时间只属于当前浏览器。重命名只改变本地显示,删除只移除本地入口。
服务端账号
服务端账号由登录凭据和 Token 关联。服务端名称、账号类型和可见数据决定页面权限。
机台显示名称
机台上显示的昵称、伙伴、头像或本地标识可能由配方和内容状态决定。它与网页本地名称不一定相同。
名称变化不能单独证明账号丢失。先使用只读页面验证记录、成绩和相片归属。
登录失败分流
没有反应或按钮一直处理中
- 等待当前请求结束;
- 检查网络和浏览器控制台是否有错误;
- 刷新账号选择器;
- 不要连续点击登录;
- 仍卡住时关闭当前页面后重新打开。
二维码识别失败
检查图片完整、清晰、包含四个定位点,并避免压缩或反光。识别失败时使用页面提供的文本输入,复制原文本,不要手动添加空格、换行或引号。
Token 无效或过期
停止后台刷新和写入,重新验证当前账号。保留本地显示条目,重新登录成功后再打开数据页面。不要把旧 Token 发送给管理员“确认格式”。
用户名密码失败
先确认账号名称、大小写和密码来源。密码修改成功后必须退出并重新登录;不要在登录错误截图中显示密码或自动填充内容。
账号选择器恢复
保留原条目
在删除或导入前先导出当前账号列表,保存到受保护位置。若一个条目验证失败,不要先删除所有条目;单独记录失败原因和最近使用时间。
重新命名
使用脱敏、可区分的本地名称,例如“个人测试”“一号机台”。不要把密码、Token、访问码、完整机台编号放入名称。
重新排序
排序只影响本地列表。导入后顺序变化不代表账号变化;逐条验证账号类型,再按使用习惯拖拽排序。
导入失败
确认文件来自受信设备、格式完整且浏览器允许读取文件。导入前保留当前列表,导入后验证每个条目;不要在公共设备上长期保存导出文件。
恢复前的只读确认
登录恢复前按顺序打开:
- 主页:确认账号名称和类型;
- 配方:读取当前可见配置;
- 记录:确认是否属于目标账号;
- 成绩:确认曲目和时间范围;
- 相片:确认文件列表;
- 缓存:下载当前状态。
如果只有一个页面空,先检查筛选和索引;如果多个页面同时空,再检查账号、Token、同步队列和服务状态。
账号数据恢复
恢复前必须满足:
- 备份来源属于同一账号;
- 当前状态已经下载;
- 文件能解析且大小合理;
- 用户知道恢复可能覆盖的范围;
- 恢复后有时间做完整验收。
恢复步骤见公开缓存备份格式与迁移和缓存与离线恢复。恢复成功后重新登录、刷新页面并记录返回条数;不要把 count 当成页面完全恢复的证明。
访问码异常
临时码和长期码需要分开判断。临时码过期时重新生成;长期码疑似泄露时先停止使用并通知管理员。网页二维码成功生成但机台拒绝时,分别检查:二维码完整性、机台网络、访问码功能保存状态、目标账号和是否需要重启。
账号“被锁定”或持续拒绝
不要用不同账号、随机密码或旧二维码连续试探。保存错误消息和时间,下载可见缓存,联系管理员确认账号状态。尝试绕过锁定可能延长恢复时间,也会让现场日志更难分析。
恢复完成标准
- [ ] 账号名称、类型和目标一致;
- [ ] Token 验证通过;
- [ ] 可以退出并重新登录;
- [ ] 配方读取正常;
- [ ] 记录/成绩归属正确;
- [ ] 相片列表正确;
- [ ] 缓存备份可下载;
- [ ] 上传缓存状态已确认;
- [ ] 临时二维码和错误截图已清理;
- [ ] 账号导出文件已受保护。
如果只恢复了登录但没有验证数据,结论写“登录恢复,数据待验收”。
