测试内容页面逐项完整参考
本页专门解释测试内容页面中使用者能看到的索引卡、搜索框、曲目卡、难度信息、详情读取、封面预览、下载确认、申请区、公告区和免责声明。它补充测试内容与谱面浏览、测试内容计划页面逐项参考和测试内容发布与机台可见性。
页面内容会按账号、计划状态、发布批次和机台分支变化。普通账号看不到授权卡片时，不要猜测入口或手工拼接下载地址。
页面加载顺序
进入页面后，页面通常分成四个异步阶段：
- 页面骨架、标题和权限提示出现；
- 内容索引加载，曲目文本和统计卡出现；
- 封面进入可视范围后懒加载；
- 点击曲目或难度后，按需读取详情。
因此可能出现“文字已经出现但封面仍是占位图”“列表有曲目但难度按钮暂时不能点”“详情打开比列表慢”等正常过渡。首次加载期间不要反复刷新或连续点击同一难度。
页面顶部和计划状态
页面可能显示：
- 测试内容标题；
- 内容总数、作者数量、物量等统计；
- 申请加入计划卡；
- 联系渠道卡；
- 当前发布进度；
- 展示选项说明；
- 免责声明和使用协议。
统计是当前索引快照，不代表目标机台已经下载，也不代表所有内容对当前账号可见。计划卡隐藏、申请按钮不可用、列表为空和网络加载失败需要分别判断。
内容索引卡
卡片可见字段
单个内容卡可能显示：
| 字段 | 用途 |
|---|---|
| 封面缩略图 | 快速识别内容，按需加载 |
| 曲目编号 | 与详情、文件名和反馈对应 |
| 曲名 | 搜索和确认弹窗显示 |
| 作者/曲师 | 识别来源 |
| BPM | 搜索和内容参考 |
| 分类/Genre | 过滤和描述 |
| 谱面作者 | 难度详情中的作者信息 |
| 难度列表 | 进入详情或下载确认 |
| 更新时间 | 判断索引批次 |
封面显示失败不等于谱面文件缺失；详情显示失败也不等于整条索引不存在。反馈时分别记录封面、详情、难度和下载哪一层失败。
统计卡
统计卡可能显示内容总数、作者数量、物量或其它索引聚合。索引正在追加加载时统计可能暂时偏小；等列表完成或刷新后再记录最终数值。
搜索、追加加载和空状态
搜索框
搜索框可能提示“搜索曲名、ID、配方作者、BPM…”。搜索词可能同时匹配标题、编号、作者、谱面作者和 BPM。使用时：
- 输入一个清晰关键词；
- 等待当前列表更新；
- 清空输入恢复已加载列表；
- 如果为空，检查编号、标点、前导零和索引是否仍在加载。
搜索通常只过滤当前已加载的索引，不会因为输入关键词自动下载所有详情。
追加加载
列表接近底部时可能自动追加一批内容。追加期间不要重复拖动到底部或连续刷新；观察列表数量是否增加。分页/追加失败时记录最后一个可见内容和时间。
空状态
| 页面表现 | 可能原因 | 首步 |
|---|---|---|
| 正在加载音乐数据 | 索引请求未完成 | 等待一次 |
| 暂无匹配内容 | 搜索条件过窄或索引未完成 | 清空搜索并等待 |
| 无测试内容卡片 | 未登录、未授权或计划关闭 | 检查账号/公告 |
| 有列表但无详情 | 详情文件未发布或读取失败 | 点开一项并记录错误 |
| 有详情但无可用难度 | 难度文件缺失或未开放 | 记录编号和难度 |
曲目详情和难度区域
点击卡片或难度按钮后，页面可能读取详细 XML/详情对象。详情区域可能包括：
- 标题、作者和分类；
- BPM；
- 各难度名称；
- 各难度物量；
- 谱面作者；
- 版本和描述；
- 谱面文件路径的脱敏显示；
- 下载/查看按钮。
详情可能有短期缓存。同一曲目第二次打开更快，不代表管理员不会更新详情；发布批次变化后重新加载页面再确认。
难度按钮与颜色
页面使用颜色区分难度，常见映射为 BASIC、ADVANCED、EXPERT、MASTER、Re:MASTER。颜色是视觉辅助，实际难度名称和数字以详情文字为准。
当某个按钮灰掉或不可点击时，优先判断：
- 详情是否已经加载；
- 该难度文件是否存在；
- 内容是否对当前账号开放；
- 该难度是否仍在审核/发布流程；
- 浏览器是否还在加载上一项。
不要通过复制另一个难度的文件名来替代缺失难度。
下载确认弹窗
点击可用难度后可能出现下载确认弹窗，弹窗应显示：
- 曲名；
- 目标难度；
- 文件名或内容标识；
- 取消按钮；
- 确认下载按钮。
下载前逐项核对曲名和难度。取消只关闭弹窗，不创建下载。确认后浏览器接收文件，页面的成功提示只说明下载动作已发起，不代表内容已经安装到机台。
下载失败时记录编号、难度、文件名、页面提示和时间；不要连续点击，也不要把下载到的测试包发到公开群组。
封面预览
点击封面可能打开大图预览。大图预览属于浏览器本地显示，不等于原始资源公开。保存或分享前检查画面是否包含账号、未公开内容、个人信息或机台标识。
懒加载失败时可以重新进入可视区域或刷新当前页面；不要因封面失败直接删除索引或提交重复内容。
自制内容申请区
申请卡可能显示：
- 申请条件；
- 申请命令/说明；
- 联系邮箱或群组/Bot；
- 当前计划状态；
- 免责声明和使用协议。
联系方式会变化，使用者应以当前页面当时显示的渠道为准。旧截图中的联系方式、旧群组和旧命令不应复制到新申请中。
申请准备清单
- 账号别名和使用场景；
- 目标机台/设备授权说明；
- 内容类型和复现步骤；
- 已知依赖、版本和资源清单；
- 恢复介质、缓存备份和回滚方案；
- 可以接受计划范围、审核和发布时间变化。
申请成功不等于测试内容已经发布，也不等于普通账号已经可见。
联系渠道和隐私
页面可能同时显示频道、群组、Bot、邮箱和申请入口。点击外部链接前确认页面当前来源和目标账号，不要向不明 Bot 发送 Token、密码、二维码、完整缓存或整盘备份。
故障反馈使用最小信息：内容编号、难度、时间、页面状态、非敏感错误和已经尝试的步骤。原始截图和包文件只放在受保护渠道。
发布进度卡
进度卡可能把内容流程拆成：
- 索引准备；
- 详情文件准备；
- 资源准备；
- 授权测试；
- 更新批次；
- 目标分支可见。
进度卡是发布公告，不是机台安装状态。目标机台还需要订单下载、Hash/大小校验、发布时间、应用、挂载/重启和最小内容验收。
自定义内容提交字段
提交建议或包时，页面/管理员可能要求：
| 字段 | 写什么 |
|---|---|
| 内容标题/编号 | 可公开识别的名称 |
| 作者 | 内容作者或团队名称 |
| 难度 | 每个已启用难度 |
| 资源依赖 | 音频、封面、预览和附加资源 |
| 测试环境 | 授权机台和版本范围 |
| 复现步骤 | 从进入内容到问题出现的步骤 |
| 已知限制 | 缺资源、兼容性和未完成部分 |
不要把账号备份、访问码、Token、私钥、Hosts 文本、完整日志和无关个人资料混入提交包。
发布后的三段式验收
提交已收到
证据是页面/管理员确认收到清单、依赖和测试结果。此时内容还可能没有构建，也不能要求所有机台立即可见。
内容已发布
证据是进入某个审核通过的批次或分支。仍需等待机台下载和应用。
目标机台可见
证据必须包含：目标分支、订单/安装项完成、发布时间满足、挂载/重启完成、索引详情可读和最小内容打开成功。
把三段状态分开写入维护记录，避免“已提交”被误解为“已安装”。
双人/多人账号和内容可见性
测试内容可能按一次会话中的全部账号判断。一个账号不在允许范围、被排除或状态未同步时，另一个单独可用的账号在拼机时也可能看不到内容。
排查顺序：单账号 → 每个参与账号 → 完整账号集合 → 目标机台分支/订单。不要公开发送账号编号、名单截图或完整配置。
页面错误与安全停手
遇到以下情况先停止写入：
- 页面显示内容与当前公告明显不一致；
- 下载确认中的曲名/难度与目标不一致；
- 详情和文件名来自不同批次；
- 目标机台分支未知或最后上报过旧；
- 测试包包含凭据、二维码或个人资料；
- 下载成功但内容启动/退出异常；
- 申请渠道要求提供完整备份或私密值。
报告中记录页面名称、内容编号、难度、时间、错误文字和脱敏环境；不要为了“验证一次”反复下载、游玩或提交。
现场经验：内容可见但音频/视频或结算异常
聊天记录中出现过内容卡片可以打开，但音频/视频缺失、设置不生效、游玩中途卡住或结算无法完成。内容列表可见只证明索引层返回了项目，不证明所有运行资源、详情和目标分支都已应用。
排查时只选一个内容和一个难度，记录异常发生在加载、游玩、结算还是成绩读取阶段；再对照订单安装项、当前分支、磁盘和挂载状态。用已验证内容做一次最小对照，若只有一项异常就暂停测试并反馈该项，若多个项目同时异常才扩大到机台健康和网络排查。
反馈中把封面、详情、音频、视频、谱面和结算分别标为“可用/缺失/未测试”，不要用复制其它机台目录、删除整批缓存或反复结算来验证。上传缓存和页面截图先留档，公开反馈只提供脱敏名称、时间、分支和非敏感错误。
页面回归清单
只读
- [ ] 页面标题和计划状态可读；
- [ ] 索引统计在加载完成后稳定；
- [ ] 搜索、清空和追加加载正常；
- [ ] 封面懒加载和预览正常；
- [ ] 详情字段和难度数量可读；
- [ ] 申请/协议/联系方式卡片符合当前权限；
- [ ] 空状态和错误状态能区分。
下载/提交
- [ ] 确认弹窗显示正确内容和难度；
- [ ] 取消不会下载；
- [ ] 下载文件进入受保护的测试目录；
- [ ] 内容在授权环境启动、读取、退出；
- [ ] 提交包已清理敏感材料；
- [ ] 发布后做单机台最小验收，再扩大范围。