常见问题 FAQ
安装与恢复
U 盘需要多大？
建议使用 64 GB 或更大的 U 盘或移动硬盘。制作过程会格式化设备，容量不是唯一条件，速度和可靠性同样重要。
可以把多个版本放在同一只 U 盘吗？
不建议。恢复介质和安装介质应分开保存，每只盘只放管理员确认的一个版本，避免启动程序误选文件。
U 盘应该插在哪里？
使用管理员指定的 USB 接口。不同机台的启动识别顺序可能不同，不要根据普通电脑经验随意选择接口。
更新卡住了怎么办？
先观察下载进度和磁盘活动，不要立即拔盘或断电。大型更新可能拆成多个包，也可能已经下载完成但在等待发布时间。记录屏幕和时间，等待管理员判断。
什么时候使用恢复介质？
启动循环、更新损坏、无法进入待机或管理员明确要求回滚时使用。先停止重复尝试，阅读恢复与回滚。
网络与登录
页面显示离线，但机台似乎还能工作？
网页状态和机台本地显示可能有采样延迟。先刷新健康数据，再做一次最小化登录测试；不要只根据颜色图标判断。
临时访问码无法登录
临时访问码可能已经过期、被使用过或图片识别时发生字符错误。重新生成并直接复制文本，避免从模糊截图手动抄写。
没有缓存的账号可以直接登录吗？
取决于账号和机台当前状态。首次使用前应先通过网页生成或恢复必要数据，不要用没有验证过的公共账号进行正式游玩。
浏览器每次都要求重新登录
检查是否清理了站点数据、使用了隐私模式或禁用了本地存储。公共设备建议每次都重新登录；个人设备可以在可信范围内保留账号条目。
数据与缓存
备份文件应该保存多久？
至少保留最近一次正常使用前、每次大版本更新前和每次恢复后的备份。文件名写上账号别名、日期、版本和来源。
恢复后记录数量少了
先确认恢复文件是否来自同一账号，再查看服务返回的恢复条数。不要在没有保存当前状态的情况下反复恢复不同文件。
上传缓存和普通备份有什么区别？
普通备份适合完整留档和恢复；上传缓存适合网络波动时暂存快照。两者都不应被当作永久、无限容量的历史库。
删除相片或缓存能恢复吗？
网页删除操作通常不可逆。删除前先下载文件或导出列表；不要把浏览器本地缩略图当作服务端备份。
机台管理
为什么看不到机台管理菜单？
当前账号可能不是机台账号、尚未绑定目标机台，或没有管理权限。切换正确账号后仍没有入口，请联系管理员。
订单下载完成后没有立即应用
检查订单和安装项的发布时间。下载完成与允许应用是两个阶段；还要确认订单没有被黑名单、删除列表或可选列表排除。
自定义订单保存失败
检查顶层是否为 JSON 数组、反斜杠是否转义、逗号和引号是否完整。VHDX 配置还要检查镜像文件名、校验值、大小、密码和启动路径。
切换侧载版本后没有变化
确认自定义订单名称已经出现在侧载弹窗，点击“使用”后等待成功，再按页面提示重启。不要只在浏览器中修改排序就认为机台已经切换。
机台截图包含敏感信息怎么办？
保存前遮挡账号、二维码、地址、密钥和现场人员。截图只用于授权排障，不要上传到公开群组。
成绩与测试内容
乐曲成绩列表为空
先清空搜索条件，等待数据加载；再检查当前账号是否有可查询缓存。成绩页不是公共曲目目录，账号没有记录时可能为空。
下载测试谱面失败
记录曲目编号、难度和时间，确认浏览器允许下载，再联系管理员。不要修改文件名或重新打包后传播。
评论提交失败
检查 Token 是否仍有效、内容是否为空、是否重复快速提交。失败时不要连续点击，刷新互动数据后再试。
如何提交有效反馈
反馈中包含：
- 页面或机台名称；
- 发生时间和时区；
- 当前版本；
- 复现步骤；
- 错误消息和已尝试的处理；
- 已遮挡敏感信息的截图。
不要发送完整 Token、密码、私钥、二维码、原始 Hosts 文本或未公开的订单密码。
现场反馈高频问题
路由器能否临时换到另一台机台？
只有在管理员确认授权和版本兼容后才可以。换机前先关机、记录原机台配置，并确认新机台不会读取旧机台的缓存或订单。
可以安装后移除预配置网络设备吗？
有些安装方式允许机台之后直连，有些不允许。必须以管理员对当前版本的说明为准；不要以一次成功启动推断永久可以移除。
网络恢复后需要一直重启吗？
通常先刷新健康数据并完成一次登录测试。如果订单或缓存仍在处理，再按页面提示执行一次重启；连续重启不会加快网络恢复。
页面上的绿网/灰网和实际结果不一致怎么办？
把图标当作展示状态，另外检查最后上报时间、HTTP/TCP 检查和普通账号登录。记录三者结果再反馈。
大型更新一天没完成正常吗？
大型内容可能拆成多个文件，速度还会受到磁盘、网络和限速设置影响。先检查进度是否变化、剩余空间是否足够，以及是否已经进入等待发布时间阶段。
更新包下载完成但曲目或图片缺失怎么办？
确认所有分包都完成，尤其是图片、视频和音频资源。若只有部分资源完成，先等待下一阶段，不要立即删除订单；全部完成后再重启验收。
更新后显示的版本号没有变化怎么办？
显示文本、数据版本和内容订单可能分别更新。先检查订单状态和实际内容，再联系管理员确认是否只是显示文本没有变化。
更新分支切换后看不到新内容怎么办？
确认当前机台真正使用了新分支，订单已下载并且机台连接的是 ZundaLink 路径。切换浏览器里的排序不会自动切换机台版本。
可以直接把自制包发给所有人吗？
不可以。自制包要在授权环境验证、按管理员指定方式提交并通过审核。包中不要包含账号、密钥或未授权数据。
自制内容提交时要写什么？
至少写曲名、作者、编号、难度、依赖资源、已知问题、测试环境和复现步骤。一个压缩包只放一个清晰的发布单元，避免管理员无法判断文件归属。
访问码截图能放在聊天收藏里吗？
不建议。长期访问码和账号 Token 都应离线或加密保存；临时码用完删除。聊天记录可能被同步到多个设备。
手机无法识别二维码怎么办？
把图片裁剪为只包含二维码但保留四个定位点，提高亮度并避免反光；仍失败时复制文本。不要手动修改识别出的字符。
NFC 读取需要什么？
需要支持 NFC 的设备、浏览器和系统权限。NFC 不支持时改用二维码，不要反复请求不存在的权限。
Web 能否安装到手机桌面？
支持 PWA 的浏览器可以使用“添加到主屏幕”。安装只是网页快捷方式，不会改变账号权限，也不会替代机台安装。
为什么上传缓存列表为空？
上传缓存和普通备份是两套列表。先刷新列表，确认当前账号、访问码和网络；普通备份存在不代表上传缓存一定存在。
上传缓存显示成功但数据没有变化怎么办？
等待服务处理，再刷新记录和成绩。不要连续上传同一快照；如果仍无变化，记录快照名称、时间和返回消息。
恢复缓存后成绩重复怎么办？
停止继续恢复，保留当前和恢复前的备份。重复恢复不同来源的文件可能使问题更复杂，应由管理员确认合并范围。
相片页面的“清除缓存”会删除相片吗？
不会。它只清理当前浏览器的本地图片缓存；服务端删除要通过单张删除或删除全部相片。
为什么相片缩略图加载很慢？
页面先读取列表，再按需加载图片；大量相片、网络速度和本地缓存都会影响速度。可以先查看单张重要相片并下载。
查卡自动刷新会不会影响机台？
它只是网页读取聚合数据，不会改变机台配置。但多个浏览器同时自动刷新会增加请求量，管理员应避免无意义的长时间轮询。
多机台查卡为什么没有会话摘要？
多机台的会话窗口和延迟不同，页面可能隐藏无法安全合并的摘要。切回单机台即可查看更完整的会话统计。
主页统计和查卡数字不一致正常吗？
两者统计窗口、缓存时间和聚合范围可能不同。记录刷新时间，分别刷新两个页面，不要把数字简单相加。
为什么看不到测试内容申请卡片？
申请卡片可能只对特定账号、计划阶段或已登录状态显示。不要通过直接猜 URL 访问隐藏页面，联系管理员确认资格。
测试内容详情加载失败怎么办？
列表索引和详情文件是分开加载的。先刷新页面，确认单曲编号，再记录失败的曲目和时间；不要把其它曲目的文件改名替代。
下载按钮为什么没有反应？
无效路径、详情尚未加载或浏览器阻止下载都可能导致按钮不可用。先点击曲目详情，确认弹窗显示正确文件名，再检查浏览器下载权限。
机台管理页面为什么有些卡片被禁用？
操作冲突、机台离线、已有操作正在轮询或账号权限不足都会禁用按钮。等待当前操作结束并刷新状态，不要用脚本绕过禁用。
取消操作后还能继续点击其它按钮吗？
先确认操作状态已经从轮询区域消失，再刷新配置。取消通常停止网页等待，不保证机台已经撤销原动作。
订单黑名单和可选列表冲突怎么办？
先保存两份原始列表，确认目标订单名称是否同时存在。黑名单通常优先，修复后重新打开弹窗确认实际保存值。
删除列表和黑名单有什么区别？
黑名单是阻止订单项参与；删除列表会触发数据清理，风险更高。不要把一个列表的内容直接复制到另一个列表。
更新限速填 0 是什么含义？
页面通常把 0 视为该阶段不增加额外限制，但实际效果以当前版本为准。过低的限速会让订单长时间等待，过高可能影响场所网络。
订单路径能随便写吗？
不能。路径必须存在或允许创建，并且使用目标机台能访问的盘符和目录。JSON 中反斜杠要正确转义。
VHDX 密码能写在公开文档吗？
不能。密码只能由管理员通过受信渠道提供；文档、截图、仓库、日志和工单都应使用占位符。
为什么 VHDX 订单下载完仍不显示？
检查 is_vhdx、安装项文件名、Hash、大小、发布时间、侧载开关和自定义订单列表。不要直接修改镜像文件名来“修复”。
目录映射方向写反会怎样？
可能造成内容找不到、空目录或覆盖错误目录。先使用已验证的键/值样例，测试机验证后再用于生产机台。
如何判断一次维护是否完成？
至少通过：健康状态刷新、普通账号登录、记录读取、相片读取、缓存下载、订单状态和现场显示七项检查，并保存时间记录。