账号与 Token

ZundaLink Web 会在浏览器本地保存已经添加的账号，以便下次快速切换。Token 等同于登录凭据，请按密码级别保护。

用户账号与机台账号

类型	适合用途	常见可见功能
用户账号	查看个人数据、记录、相片和成绩	用户配方、缓存、成绩互动
机台账号	管理机台、查看在线活动和机台配置	机台配方、查卡、机台管理、审核功能

网页会依据 Token 返回的账号类型显示菜单。看不到某个页面通常表示当前账号没有对应权限，不要通过猜测接口或复制他人 Token 绕过限制。

添加账号

1. 点击右上角账号名称，选择“切换用户”。
2. 点击“添加新账号”。
3. 选择二维码、账号密码或管理员提供的凭据登录。
4. 登录成功后可以给账号改一个容易识别的本地名称。

账号选择页会显示账号类型、最近使用时间和本地名称。可以拖拽或长按账号调整显示顺序；排序只影响当前浏览器，不会修改服务端账号。

导入和导出

机台账号可在账号选择页使用导出/导入功能：

1. 导出会生成一个 JSON 文件，里面包含本地账号信息和 Token。
2. 将文件保存到加密磁盘或离线介质，不要上传到群组、网盘公开链接或工单附件。
3. 在另一台可信设备中选择导入，网页会跳过重复账号并验证可用性。
4. 迁移完成后，删除旧设备中的导出文件。

导入时网页会校验文件结构：缺少 Token 或名称的条目会计入失败，已经存在的相同 Token 会跳过，合法的新条目才会加入列表。导入完成后应逐个验证账号，而不是假设文件中的所有账号仍然有效。

不要把导出文件当普通配置分享

任何拿到导出文件的人都可能以你的身份调用公开 API。怀疑泄露时，请立即退出相关 Token，并联系管理员处理。

绑定用户名和密码

二维码登录成功后，可以在账号菜单中选择“设置用户名密码”：

• 首次设置时旧密码可以留空；
• 修改已有密码时应填写旧密码；
• 新密码至少 6 位，并在确认框中再次输入；
• 绑定成功后，二维码仍可以继续作为备用登录方式。

Token 失效

出现“Token 无效”“需要重新登录”时：

1. 回到账号选择页重新验证该账号。
2. 如果仍失败，重新获取二维码或使用用户名密码登录。
3. 不要重复提交已经过期的临时访问码。

如果账号验证失败，网页可能从“最近使用”状态中移除当前账号，也可能保留条目等待用户手动删除。手动删除账号只清理浏览器本地保存，不等于注销服务端账号。

公共设备使用建议

• 不要勾选浏览器的密码保存。
• 使用完毕后退出并删除账号条目。
• 不要在截图、控制台日志或 URL 中记录 Token。

多账号切换验收

切换账号后应检查三件事：

1. 顶部名称已经变化；
2. 页面菜单与账号类型匹配；
3. 缓存、相片、记录和配方没有继续显示上一个账号的数据。

若浏览器回退后页面仍显示旧数据，先退出再重新选择账号，并清理当前页面的临时状态。