网页可见功能全表
本页把网页中能够通过导航、账号权限或页面状态看到的功能按“入口—可见动作—结果—详细文档”列出。它用于确认是否漏掉某个使用者能看到的区域，不描述隐藏实现、内部请求或未公开入口。
页面可能根据账号、机台、计划、版本和网络状态隐藏卡片。表中的“可能”表示页面条件，不表示可以手工绕过权限。
全部入口
| 入口/页面 | 使用者能看到的主要内容 | 典型写入/读取 | 详细文档 |
|---|---|---|---|
| 账号选择 | 本地账号条目、最近使用、导入/导出、删除和切换 | 本地账号管理、登录 | 账号选择与登录页面 |
| 登录表单 | Token、用户名密码、二维码文本等登录方式 | 创建会话、验证会话 | 账号与 Token |
| 设置密码 | 密码输入、确认、保存和结果 | 绑定/修改密码 | 账号异常与恢复流程 |
| 主页 | 统计卡、地区摘要、导航入口和公告 | 读取统计 | 主页仪表盘逐项说明 |
| 二维码/访问码 | 临时/长期码、图片识别、机台绑定和 NFC | 生成访问码、绑定 | 访问码页面逐项控件参考 |
| 配方 | 账号/机台设置卡片、开关、下拉、文本、数字和图片 | 读取/修改配置 | 配方页面控件与可见字段类型参考 |
| 普通缓存 | 备份下载、格式选择、文件预览和恢复 | 下载/恢复 JSON | 普通缓存页面逐项控件参考 |
| 上传缓存 | 快照列表、下载、上传、删除和访问码输入 | 文件读写、删除快照 | 上传缓存页面逐项控件参考 |
| 相片 | 缩略图、原图预览、下载、删除和分页 | 读取/删除相片 | 相片页面实战流程 |
| 游玩记录 | 记录卡、详情、判定、参与者、分页和时间范围 | 读取记录 | 游玩记录页面字段与分页参考 |
| 乐曲成绩 | 成绩卡、排序、筛选、评论、点赞/点踩和反馈 | 读取/互动/反馈 | 成绩页面控件与数据字段参考 |
| 查卡 | 机台选择、在线玩家、时间段、会话和图表 | 读取统计 | 查卡页面逐项说明 |
| 机台管理 | 健康快照、订单、控制卡片、侧载、维护和结果 | 读取/高风险控制 | 机台管理页面逐项完整参考 |
| 测试内容 | 索引、详情、难度、申请卡和提交说明 | 读取/提交申请 | 测试内容计划页面逐项参考 |
| 网页内 API | 分类、请求字段、响应树、复制和兼容提示 | 读取公开参考 | 网页内 API 参考页面逐项说明 |
页面都会出现的通用控件
导航和账号状态
顶部导航可能包含首页、安装、使用和 API 文档。账号菜单显示当前登录条目；切换账号后，页面数据不应继续被旧账号缓存误认为新账号数据。切换后优先刷新只读页面，再进行上传、删除或写入。
加载、空数据和错误
三种状态必须分别理解：
- 加载中：请求尚未结束；
- 空状态：请求成功但当前范围没有数据；
- 错误状态：请求失败或权限不足。
刷新空页面、切换筛选和重新登录之前，先记录当前页面和账号。空列表不等于数据已删除，404 也不一定等于入口不存在。
表单输入
页面可能使用文本框、数字框、开关、滑块、下拉、日期/时间输入、文件选择和 JSON 文本区。输入显示出来不代表格式已经被接受：
- 数字框可能把空值显示为 0；
- 开关可能是“启用某能力”或“禁用某能力”，要看两侧文字；
- 文件选择成功不等于文件内容可解析；
- JSON 文本区可能在语法错误时禁用保存；
- 下拉未列出的值不要手动猜；
- 取消通常只丢弃当前草稿，不会撤回已经送达的操作。
账号和登录功能的完整链路
本地账号条目
本地条目可能包括显示名、类型、最近使用、导入/导出和删除。它们描述浏览器本地状态，不等于服务端账号已删除。导入后要逐个验证身份、Token 状态和数据归属，再调整排序。
Token/二维码/密码
页面可能允许多种登录方式，但它们最终都要以页面的验证结果为准。二维码、Token、密码和访问码不应出现在公共截图、聊天或仓库。登录成功后至少读取一份账号数据，确认没有切错账号。
账号恢复
恢复过程应先保留本地缓存和服务端可下载备份，再区分：凭据无效、二维码过期、账号未授权、网络失败、服务端会话失效。不要用重复生成二维码掩盖状态异常。
数据页面的完整链路
产生、上传、索引和显示
游玩记录、成绩、相片和缓存可能经历不同时间：机台产生、浏览器上传、服务端接受、索引建立和页面读取。看到游玩结束不等于页面已经有成绩；看到上传成功也不等于所有列表已更新。
只读页面的最小验收
切换账号后先读取：主页/统计 → 记录 → 成绩 → 相片 → 缓存。每一步记录账号别名、时间范围和空/非空状态，防止把旧页面缓存当作新账号数据。
删除页面的最小验收
删除相片、上传缓存或本地账号条目前先下载/导出必要资料，确认对象名称和当前账号，再执行二次确认。删除成功后回读列表；回读失败时不要重复删除。
机台管理页面的入口层级
机台管理页可以再拆成六层：
- 顶部操作进度和重要提示；
- 健康快照；
- 网络/显示/画面控制；
- 订单、侧载和限速；
- 授权测试功能；
- 维护动作和结果记录。
越靠后越可能中断现场或改变数据。详细字段与弹窗见机台管理页面逐项完整参考，VHDX 订单见VHDX 订单场景化操作手册。
测试内容页面的可见链路
测试内容页面可能包含索引、详情、难度、资源、申请卡、公告、发布进度、提交建议和压缩包提交。申请通过、内容发布、机台可见是三个阶段；页面隐藏或空列表也可能是权限/计划状态。
提交包前清理凭据、二维码、缓存、路径和个人信息，在授权环境验证启动、读取、退出和共存。发布后按目标分支、订单、分包、时间和权限逐项验收。
网页内 API 参考页面
公开参考页可能按会话、访问码、配方、相片、缓存、记录、成绩、统计和文件分类。使用者能看到请求字段、响应示例、复制按钮、状态说明和兼容提示。
开发者文档只应使用页面公开的字段和行为；不要从错误消息、网页源码或未知配置推测未公开接口。分页、二进制文件、错误处理、日志脱敏和数据最小化见 API 章节。
可见功能的回归矩阵
| 回归层 | 要打开的页面 | 不产生写入的检查 | 写入/高风险检查 |
|---|---|---|---|
| 登录 | 账号选择、主页 | 当前账号、退出后状态 | 登录/切换/密码绑定 |
| 访问码 | 二维码页 | 生成页、识别页、取消 | 绑定机台、生成长期码 |
| 配方 | 配方页 | 类型、当前值、图片预览 | 单项修改、回读 |
| 缓存 | 普通/上传缓存 | 列表、预览、下载 | 恢复、上传、删除 |
| 数据 | 记录、成绩、相片 | 分页、详情、空状态 | 互动、反馈、删除 |
| 机台 | 健康、控制、订单 | 刷新、展开、取消弹窗 | 限速、订单、挂载、重启 |
| 内容 | 测试内容/计划 | 索引、详情、公告 | 申请、提交、发布验收 |
| API | API 参考 | 分类、字段、响应 | 仅在授权测试账号验证公开工作流 |
发现新控件时的补文档规则
当页面出现新按钮、弹窗或字段：
- 先记录页面显示名称和出现条件；
- 记录输入类型、默认值、范围、取消行为和保存行为；
- 记录成功、失败、超时、空状态和刷新后的表现；
- 对删除、上传、重启、网络、订单和凭据增加停手条件；
- 在覆盖矩阵中加入入口；
- 在 FAQ 和聊天经验索引中加入对应现象；
- 用 Computer Use 打开页面验证可见文本和浏览器日志。
如果一个功能只能通过隐藏地址、内部命令或未公开字段触发，不把它写成普通用户教程；只记录使用者能够在公开页面看到和调用的部分。