网页完整使用流程

本页把第一次打开网页、登录、切换账号、使用主要页面和退出的完整过程串起来。它补充各个功能页的字段说明，适合现场人员照着执行，也适合第三方客户端把网页行为转换成自己的界面。

先判断当前状态

打开网页后先看顶部账号区域：

看到的状态	含义	下一步
未登录	浏览器没有可用会话	打开账号选择页并登录
显示用户账号	已取得用户权限	可以使用个人数据、缓存和成绩页面
显示机台账号	已取得机台权限	可以看到机台健康、控制和订单页面
一直转圈	正在验证本地保存的会话	等待一次验证结束，再决定是否重新登录
红色失败提示	会话失效或服务请求失败	记录提示文字和时间，重新验证一次

页面是否显示某个菜单由账号类型和授权决定。看不到“机台管理”“测试内容”或审核入口时，先按权限判断，不要把隐藏菜单当成加载故障。

第一次登录

使用二维码或访问码

1. 点击顶部的“未登录”或账号选择页中的“添加账号”。
2. 选择二维码/访问码输入方式。
3. 粘贴文本，或上传一张完整、清晰的二维码图片。
4. 如果页面要求自定义服务地址而你没有管理员提供的地址，保持为空。
5. 点击登录，等待按钮从“登录中”恢复。
6. 成功后确认账号名称、账号类型和可见菜单。

二维码图片只在识别期间需要。登录完成后应删除下载目录、截图和聊天软件中的临时副本。

使用用户名和密码

1. 在登录弹窗切换到用户名/密码方式。
2. 输入账号名称和密码；密码不要复制到备注、地址栏或普通聊天。
3. 完成人机验证（如果出现）。
4. 提交后等待成功提示。

如果首次只有二维码登录，登录成功后可以在账号菜单中设置用户名和密码。设置完成后要退出并重新登录一次，确认凭据确实可用。

添加多个账号

账号选择页允许保存多个本地账号条目。每个条目都要明确标注使用场景，例如“家用”“测试机台”或“备用”，避免在高风险页面操作错目标。

• 选择条目时页面会验证 Token；
• 验证失败的条目不要连续重试，先检查网络和时间；
• 重命名只改变浏览器里的显示名称，不会改变服务端账号；
• 删除条目只清理浏览器本地保存，不等于注销服务端账号；
• 导入/导出只用于受信设备之间迁移，导出文件应按敏感凭据处理；
• 排序只改变本地列表顺序。

登录后的安全检查

第一次进入主页后，建议马上完成以下检查：

1. 打开账号菜单，确认账号名称和类型。
2. 打开 Token 页面或重新加载页面，确认会话仍然有效。
3. 打开数据缓存，下载一份当前账号备份。
4. 如果是机台账号，打开健康页面，记录在线状态、版本、网络和磁盘空间。
5. 如果要在公共电脑使用，退出账号并删除本地账号条目。

不要把 Token 当作普通登录密码；它能代表当前会话，应避免进入浏览器同步、截图、命令历史和第三方日志。

主页和主题

主页的统计卡片可能需要等待服务聚合数据。卡片为空时先确认页面加载成功，再区分“没有数据”和“读取失败”。地区图或统计图的时间点可能与其它页面不同，不要用它们做精确结算。

右上角太阳/月亮按钮切换浅色和深色主题。主题设置属于当前浏览器环境，不会写入机台配置。移动端通过汉堡菜单访问相同功能；打开菜单后点击页面外区域可以关闭。

推荐的日常顺序

普通用户

1. 登录并确认账号名称。
2. 需要登录设备时，使用二维码页生成一次性访问码。
3. 日常查看成绩、记录和相片。
4. 网络不稳定时先下载缓存，再处理上传缓存。
5. 重要操作完成后重新打开列表确认结果。
6. 离开公共设备前退出并清理本地账号条目。

机台管理员

1. 先看健康数据和最近上报时间。
2. 再看订单、下载和磁盘状态。
3. 只在机台空闲时修改配方或执行控制操作。
4. 保存配置前下载缓存并记录当前状态。
5. 一次只执行一个高风险操作，等待结果后再刷新。
6. 用普通用户完成登录、最小游玩、记录和相片验收。

读懂网页反馈

反馈	正确处理
加载中/处理中	不重复点击，等待当前动作结束
成功	记录返回文字，刷新相关列表确认持久化
失败	保留原数据，记录提示和时间，先排查网络/权限
暂无数据	检查账号、时间范围和是否完成首次同步
Token 失效	停止后台刷新，重新登录后再继续
权限不足	使用普通入口或联系管理员，不寻找隐藏入口
操作超时	区分网页等待超时与机台动作是否已送达，不能盲目重试

切换账号与退出

点击当前账号名称后选择“切换用户”。网页会结束当前页面会话并回到账号选择页；切换前最好停止正在进行的下载、上传、删除或恢复。

退出不等于删除服务端数据。若设备由多人共用，退出后再进入账号选择页删除本地条目，并清理浏览器下载、剪贴板和二维码图片。

移动端注意事项

• 二维码识别时保持屏幕亮度足够，避免自动旋转；
• 大表格和 JSON 文本区域可以横向滚动，不要为了适应屏幕手动删字段；
• 文件上传前确认浏览器授予了文件访问权限；
• 滑块、弹窗和确认按钮可能需要滚动到可见区域；
• 网络切换后先刷新页面状态，不要立刻重复提交写入操作。

一次完整验收

完成安装或大版本更新后，用下面的最小闭环验收：

1. 网页打开成功；
2. 账号登录成功；
3. Token 验证成功；
4. 一个只读页面能返回数据；
5. 一次二维码/访问码流程能完成；
6. 缓存能够下载；
7. 记录或成绩页面能够读取；
8. 相片列表能够打开（没有相片时显示空状态）；
9. 机台账号能看到健康状态并确认时间更新；
10. 普通用户能完成登录和退出；
11. 退出并重新进入后，之前的备份仍可找到。

出现失败时只记录失败步骤，不要同时修改网络、订单、配方和账号。