前端 UI 逐项索引
本页按网页可见区域建立索引，适合在不知道某个按钮属于哪个页面时查找。页面会根据账号、设备和服务状态隐藏部分项目；“看不到”本身也是权限和状态的一部分。
全局导航
顶部区域
- ZundaLink 文档/网页标题；
- 当前账号名称和账号类型；
- 浅色/深色主题切换；
- 移动端汉堡菜单；
- 搜索入口或页面内搜索框。
账号下拉菜单
- 切换用户：返回账号选择页；
- 设置用户名密码：仅在用户账号可用时显示；
- 删除账号：只清理浏览器本地保存；
- 重命名：只修改本地显示名称；
- 导入/导出：迁移本地账号条目。
账号选择页
账号选择页包含空状态、已保存账号列表、添加账号、拖拽排序、导入、导出和删除操作。
账号条目状态
- 用户账号/机台账号标签；
- 最近使用时间；
- Token 验证中的加载状态；
- 验证失败消息；
- 编辑本地名称按钮；
- 删除确认按钮。
登录弹窗
登录弹窗可能包含二维码图片上传、二维码文本、用户名、密码、自定义服务地址、人机验证和提交按钮。提交期间按钮会变为“登录中”，不要重复点击。
主页
主页包含欢迎区、常用入口、服务级统计、数据拉取统计、地区分布、免责声明、功能说明和安全提醒。详情见主页统计。
获取访问码
页面可能包含：
- 一次性/长期标签页；
- 生成按钮；
- 二维码图像；
- 访问码文本；
- Web 绑定入口；
- 图片识别输入；
- NFC 状态；
- 自定义服务地址；
- 机台标识选择；
- 人机验证。
详情见二维码与访问码。
配方页面
配方页的每一行通常包含配置名称、描述、开关、值编辑器和保存反馈。值编辑器可能是：
- 普通文本框；
- 省份下拉框；
- 代理优先级下拉框；
- JSON 多字段编辑器；
- 头像上传器；
- 逗号分隔列表文本框。
页面会按用户/机台账号过滤配置。详情见配方与机台设置。
数据类页面
数据缓存
按钮：下载普通备份、下载兼容格式、选择 JSON 文件、恢复缓存、重新选择文件。详情见缓存与离线恢复。
上传缓存
控件：刷新列表、访问码输入、自定义地址输入、每条缓存的下载/上传/删除。详情见公开 API 与缓存指南。
相片
控件：刷新相片、清除本地图片缓存、删除全部、单张查看、单张删除、原图下载、关闭预览。
游玩记录
控件：刷新、上一页、下一页、页码、跳转页码、加载中和空状态。
乐曲成绩
控件：搜索、清除搜索、排序、单曲展开、点赞/点踩、发表评论、回复、删除评论、内容反馈和有权限时的审核按钮。
查卡页面
控件：机台选择、多选、刷新、自动刷新开关、在线状态卡、时间段标签、时长分析、会话趋势、用户频率、最近记录和回访统计。详情见查卡与会话统计。
机台管理页面
页面包含健康检查、刷新数据、刷新配置、控制卡、操作进度、截图预览、摄像头预览、订单列表、侧载选择和高级弹窗。详情见：
测试内容页面
控件：内容索引、搜索曲名/编号/作者/BPM、滚动加载、封面放大、难度按钮、详情加载、下载确认、申请入口和更新说明。详情见测试内容与谱面浏览。
统一状态
页面普遍使用以下状态：
- 加载中：按钮禁用，避免重复请求；
- 空状态：没有数据，不一定是失败；
- 错误：红色消息，保留原数据；
- 成功：绿色消息，刷新相关列表；
- 二次确认：删除、覆盖、替换配置前出现；
- 轮询：页面等待机台或服务返回结果。
移动端差异
- 桌面端侧栏常驻，移动端通过汉堡菜单打开；
- 大表格可能横向滚动；
- 弹窗使用全屏或接近全屏布局；
- 触摸长按可能进入排序模式；
- 截图、二维码和滑块操作要确保浏览器没有被系统手势打断。