AquaZDL / AquaMai 机台侧扩展设置
本页说明安装在授权机台上的 AquaZDL / AquaMai 用户可见配置。它把扩展设置按使用者能感知的结果整理，而不是解释内部补丁、调用链或未公开接口。
扩展设置不是 ZundaLink 网页的订单配置。网页负责账号、机台健康、订单、缓存和公开控制；AquaZDL / AquaMai 负责机台本地的可见体验、输入、画面、硬件兼容和测试开关。两边同时出现相似名称时，以当前页面显示和管理员提供的配置为准。
安装前提和文件边界
扩展只应放在已获授权的机台和当前发布批次中。安装/升级前：
- 备份当前扩展配置和 ZundaLink 网页缓存；
- 记录当前网页版本、侧载分支和健康状态；
- 使用与机台版本匹配的扩展包；
- 保留原配置作为回滚点；
- 在维护窗口内安装并做普通账号验收。
配置文件是用户可编辑的设置文件，但不等于可以把任意内部字段写进去。未知键、来自旧版本的键和路径型值都应先在测试机验证。不要把 Token、访问码、镜像密码或网页授权值写入扩展配置。
配置文件的通用行为
语言
通用设置可能提供“Mod 界面语言”。常见可选值是 en 和 zh；留空时跟随系统语言。语言不仅改变设置界面，也可能改变配置文件重新保存时的说明文字。
切换语言前保存原文件。切换后重新打开配置，确认值没有被错误类型或旧版本迁移覆盖。
版本迁移
扩展会在版本升级时尝试迁移旧配置。迁移可能新增默认项、调整分组或改写字段格式。升级后不要只看文件能否打开，应逐项查看：
- 启动/跳过设置；
- 输入映射；
- 画面和资源路径；
- 网络/硬件兼容项；
- 网页控制相关开关；
- 自定义图片、视频和音频目录。
迁移失败时保留原文件，使用默认配置启动测试，不要手动删除所有未知字段。
启动和流程设置
跳过启动警告和等待
启动阶段可能提供跳过警告画面、减少等待、跳过新活动/信息页面等选项。它们只改变进入流程的速度，不会修复网络、订单或账号问题。
建议：
- 维护排障时先关闭过多跳过项，保留可见错误信息；
- 普通现场使用确认跳过后仍能看到登录和网络提示；
- 更新后第一次启动不要同时打开所有跳过项；
- 发现黑屏或循环重启时恢复原值再排查。
直接进入选曲/单人体验
某些版本可在登录后直接进入选曲，或固定单人流程。它会改变新用户看到的页面顺序，可能让现场人员误以为登录没有完成。
验收至少包括：登录 → 进入目标页面 → 退出 → 再次登录。多人/双人场景需要单独验证，不要把单人流程的结果扩展到拼机。
快速跳过与快速重试
扩展设置可能包含重开按键、重开长按、跳关按键、跳关长按和强制快速重试。它们会改变输入时序和游玩结束流程：
- 先确认按键不会与正常操作冲突；
- 长按时长以页面/配置说明为准；
- 在测试账号上验证，不要直接在玩家使用中修改；
- 如果记录、计数或退出行为异常，先关闭快速流程选项。
网页机台管理页的“快速跳过/重开”与本地按键配置可能同时生效，出现重复触发时一次只关闭一层并复验。
输入和硬件兼容
外部按钮映射
设置可能允许为 1P/2P 的按钮 1–4 选择功能映射，也可能提供“禁用外键输入”。修改前记录原映射：
| 检查 | 目的 |
|---|---|
| 1P/2P 是否启用 | 避免把单人配置误套到双人 |
| 每个按钮当前功能 | 便于回滚和报告 |
| 外部按键是否禁用 | 排查重复输入/误触 |
| 网页或本地测试功能是否占用按键 | 防止控制动作误触 |
输入异常时先恢复默认映射，再分辨是硬件、游戏内容还是扩展设置问题。
摄像头和硬件告警
硬件告警设置可能控制哪些设备故障显示为画面提示，以及不同摄像头用途的识别。它不会替代网页健康检查。摄像头映射和现场拍摄属于敏感能力：
- 不要在没有许可时开启或保存画面；
- 报告时只提供必要的错误区域；
- 不要把设备索引、现场画面和账号信息混在公开反馈中；
- 网页“抓取摄像头”和本地硬件告警是两层功能，分别验收。
灯板/串口设置
部分配置允许调整灯板串口。这个设置依赖设备管理器中的实际端口，写错后可能造成灯光无响应或启动告警。普通使用者不应猜测端口；只有在维护人员提供当前设备映射时才修改，并保留原值。
音频、音量和音频捕获
音量同步
某些扩展可将 1P 耳机音量同步到主音量，或调整多声道缩放。同步设置可能与八声道/多声道设置互相影响，出现音量过小或重复缩放时：
- 记录当前音量和声道设置；
- 一次只关闭一个同步项；
- 用耳机和外放各做一次小音量测试；
- 维护结束恢复约定值。
网页“系统音量”控制和本地音量同步不是同一个入口；网页修改后仍要检查本地同步规则。
音频捕获/推流
本地配置可能有“启用音频捕获”、控制文件、输出名称等可见设置。使用者只需关注：能力是否启用、网页控制是否允许、启动/停止后是否有音频输出。不要在公开文档或反馈里写控制文件实际路径、管道名称或凭据。
启用音频捕获前确认现场同意和存储策略；停止后关闭网页推流、停止预览并清理临时音画文件。
画面和个性化
自定义版本文本
可以把右上角版本文字改为自定义文本。它只改变显示，不改变实际运行版本、订单、分支或内容。反馈时同时记录真实分支/订单，不要只发自定义文字截图。
自定义店铺名、点数文本和 Logo
这些设置改变拍照/界面上的展示文字或图片：
- 店铺名称应使用现场允许公开的名称；
- 点数文本可以为空，但不要把账号或访问码写进去；
- Logo 图片使用已获授权的资源；
- 全屏 Logo 可能遮挡下屏幕其它提示，先在测试机检查；
- 图片路径改变后要检查文件存在、格式和大小。
自定义皮肤、按钮和开场视频
这类设置通常读取本地资源目录。配置前先确认：
- 资源来自当前版本兼容包；
- 图片尺寸/格式符合页面或发布说明；
- 视频文件命名和左右屏规则一致；
- 缺少资源时仍能正常启动；
- 资源不会覆盖订单或恢复目录。
资源加载失败时先关闭个性化功能，恢复默认画面，再判断是资源缺失还是扩展版本问题。
随机 BGM
随机 BGM 设置可能需要在指定本地目录准备音频资源，且部分游玩模式不支持。启用前确认文件来源、命名、音量和双人模式行为；出现音频异常先清空临时资源索引或关闭该功能，不要把音频文件当成订单安装项。
游戏体验和测试设置
音符/判定/节奏显示
扩展可能提供音符大小、判定模式、判定时机显示或不稳定率显示。它们只改变显示/输入反馈，不会修复网络、记录上传或成绩索引。
逐项测试：
- 默认值下完成一次最小游玩；
- 只改一项并记录画面变化；
- 确认记录/成绩是否按管理员策略保存；
- 测试结束恢复默认。
AutoPlay、测试模式和虚拟投币
这些功能会改变游玩或投币条件，只在明确授权的测试机使用。虚拟投币增加的点数可能不会跨重启保存；网页机台控制的投币动作也可能只影响当前运行状态。
使用前记录：当前投币数、账号、测试分支和数据保存策略。使用后关闭测试开关、清理临时状态并确认普通账号流程没有被改变。
邀请/拼机和白名单体验
扩展或网页设置可能改变邀请游玩、双人登录和账号集合的表现。排查受限内容时，先单账号测试，再用完整参与账号集合测试；不要只看第一张卡或只复制能通过的账号。
与网页机台控制的对应关系
| 网页可见控制 | 本地扩展可能影响的层 | 验收方式 |
|---|---|---|
| 特殊运行模式 | 本地流程/入口 | 登录、退出和页面顺序 |
| 快速跳过/重开 | 本地按键/流程 | 一次跳过、一次重开 |
| 主显示器/启动样式 | 本地画面 | 冷启动截图 |
| 音量/音频推流 | 本地音量同步/捕获 | 外放、耳机和推流回读 |
| 截图/摄像头 | 本地显示和硬件告警 | 取得许可后最小画面 |
| AutoPlay/测试模式 | 本地游玩输入 | 测试账号，结束恢复 |
| 订单/侧载 | 本地启动和资源读取 | 订单、挂载、内容最小读取 |
网页保存成功只说明网页控制层接受了动作；本地扩展配置是否加载，还要等页面提示的生效时机并在机台现场验收。
配置修改的安全流程
备份当前配置/缓存
→ 记录网页健康与分支
→ 修改一个配置项
→ 保存并等待结果
→ 重启或重新加载（按页面提示）
→ 做最小用户流程
→ 检查记录/缓存/画面
→ 记录结果并恢复测试项如果配置文件无法解析、启动画面消失或输入完全失效：
- 停止继续编辑；
- 恢复最近一次可读配置；
- 使用网页健康页和现场画面确认设备状态；
- 在授权测试环境复现；
- 反馈时只提交配置项名称、类型、版本和非敏感错误。
不要提交完整配置、完整资源目录、账号缓存或控制文件内容来询问一个字段的含义。
版本可见性和缺项判断
扩展设置可能因为游戏版本、侧载分支、配置迁移或权限而不出现。缺少某个段落时先确认：
- 当前扩展包版本；
- 目标运行分支；
- 配置是否完成迁移；
- 当前语言是否隐藏了不同名称；
- 该功能是否只在测试环境显示。
不要从其它版本的截图复制配置键名。网页机台页看不到某个本地设置时，也不要手动调用未知入口。