配方字段详解

本页把“配方”页面中常见的用户级、机台级和行为级设置按用途展开说明。页面只显示当前账号允许修改的字段；如果没有看到某个字段，请以当前页面为准，不要手动伪造字段名。

字段的共同结构

每个可见项目都包含：

• 名称：页面显示的配置名称；
• 描述：该配置的用途和风险；
• 开关：是否启用；
• 值：文本、数字、列表、JSON 或图片；
• 保存反馈：成功或失败消息。

开关和数值是两个独立概念：打开一个项目并不等于值已经正确，修改值也不一定自动打开项目。保存后应重新加载确认。

用户账号字段

数据路径

这组设置决定用户数据是否进入 ZundaLink 的缓存路径、是否上传到主数据源以及是否同步到其他数据服务。

适合的操作顺序：

1. 先下载当前缓存；
2. 修改一个数据路径开关；
3. 让账号完成一次登录/退出；
4. 检查记录、缓存和上传结果；
5. 再决定是否保留设置。

不要在同一时间同时切换多个数据路径项目，否则无法判断是哪一项造成数据差异。

网络上传策略

部分设置用于控制是否把特定版本或特殊内容上传到主数据源。它们通常在机台账号和用户账号上显示不同的范围。

• 需要测试数据时，优先使用缓存；
• 不确定上传目标时保持默认；
• 出现数据分流时先下载两边的可用缓存；
• 不要把“关闭上传”理解为“本地数据永远不会丢失”。

外部成绩同步

如果页面显示成绩同步项目，值通常是一个好友码或服务侧标识：

• 只填写管理员或服务页面提供的值；
• 不要把 Token 当成好友码；
• 同步失败时检查账号权限和服务端是否可达；
• 同步是附加操作，不应阻塞主数据保存。

登录状态和缓存登录

登录状态类字段可能让账号先使用缓存，再在网络恢复后重新上传。它们适合网络波动排障，不适合长期隐藏数据问题。

启用后建议观察：

• 机台是否仍能进入选曲/主页面；
• 退出时是否有上传提示；
• 上传缓存列表是否新增项目；
• 恢复网络后是否能够重新同步。

地区

地区使用下拉列表选择。它只影响账号提交数据时携带的地区信息，不改变账号真实所在地、机台 IP 或网络出口。

登录时间和版本字段

页面可能提供继承最近登录时间、最后数据版本、最后 ROM 版本、上传数据版本和上传 ROM 版本等字段。这些设置用于兼容不同版本的客户端。

规则：

• 读取和上传字段要按管理员的版本表配套填写；
• 值通常是数字/版本文本，不要加入说明文字；
• 改完先测试读取，再测试保存；
• 看到版本不匹配错误时恢复原值。

对手、伙伴和用户展示

用户账号可能可以设置：

• 对手列表：多个编号用英文逗号分隔；
• 强制伙伴：填写页面或管理员提供的伙伴编号；
• 用户名：只使用合法、适合公开显示的文字；
• 用户头像：使用图片上传按钮；
• 空对手数据处理方式。

图片上传后会在浏览器侧缩放为适合显示的方形图片。不要上传包含二维码、密码或他人隐私的图片。

测试字段

拥有测试权限的账号可能看到用于复现问题的空数据或修改数据项目：

• 空乐曲数据；
• 修改乐曲列表；
• 空物品；
• 空地图；
• 空伙伴；
• 空登录奖励；
• 空充值记录；
• 强制出现特定提示；
• 跨版本读取但不上传某些数据。

这些字段不是普通用户功能。启用后可能让页面、机台或成绩看起来异常；测试完成必须关闭，并清除测试产生的缓存。

机台账号字段

机台名称列表

机台账号可能绑定多个机台。页面可以用 JSON 或逗号分隔的旧格式显示机台标识，并允许为机台设置本地名称。

推荐 JSON 形状：

[
  { "name": "一号机", "cid": "<MACHINE_ID_1>" },
  { "name": "二号机", "cid": "<MACHINE_ID_2>" }
]

不要在名称中加入密码或地址；删除绑定前确认它不是当前正在使用的目标。

连接目标和直连模式

机台字段可能包含连接主服务、登录服务、标题服务和直连模式等开关。它们会决定机台使用哪条公开网络路径。

• “立即生效”字段保存后可能马上改变连接；
• “重启生效”字段需要空闲时重启；
• 直连/代理切换时应先记录原值；
• 网络异常时优先恢复管理员已验证的配置。

页面中的自定义服务 JSON 可能包含加密材料和多个服务地址。本文只解释其用途，不公开字段内容和示例值；不要从浏览器、日志或截图中复制这些值。

代理选项

机台账号可能看到三类代理：主代理、机台代理、用户自定义代理。代理优先级下拉框使用三位数字表示先后顺序：

• 第一位为最先尝试的代理；
• 第二位为第一项不可用时的候选；
• 第三位为最后候选；
• 同时启用多个代理可能增加延迟。

自定义代理列表如页面允许多个值，按页面说明使用分隔符；不要把带密码的代理链接写入公开配置。

白名单、黑名单与内容屏蔽

白名单是允许使用特定内容的用户编号列表。输入多个值时使用英文逗号，不要添加括号、昵称或中文逗号，除非页面明确要求带昵称格式。

黑名单优先级高于白名单。用户同时存在于两者时，通常按黑名单处理。排查内容不可见时先查黑名单，再查白名单和内容列表。

机台可以指定不允许出现的内容编号。修改前保存原列表；移除一个编号后要重新登录或刷新内容缓存验证。

版本覆盖

机台版本字段用于让下载和上传使用管理员指定的兼容版本。它通常不改变屏幕上看到的版本号，而是改变数据请求时的版本标识。不要把它当成升级按钮。

聊天经验：切换连接目标后要重新验收

现场曾出现“规则已经打开但旧账号仍不能登录”“切换后要不要重启”和“侧载与常规分支行为不同”等问题。连接目标、代理优先级和版本覆盖可能需要重新启动才对机台生效；修改后按以下顺序验收：

1. 保存原始值；
2. 只修改一个连接相关字段；
3. 重新读取配方确认保存成功；
4. 按页面提示完成热重载或冷重启；
5. 用测试账号完成登录、退出和最小数据读取；
6. 最后再验证记录/上传。

不要在侧载运行时随意切换到常规连接目标，也不要在不知道规则含义时复制群聊中的字段名。

聊天经验：多人登录时按整次会话核对名单

受限内容可能按本次会话中的全部账号判断。两张卡或多人登录时，只要其中一个账号不在当前允许范围、仍在排除范围，或机台尚未读取最新名单，所有参与者都可能看不到内容。

现场核对应先单账号验证，再逐个加入其它账号；每次变更后重新读取配方，按页面提示热重载或冷重启，并用同一组账号做验收。不要只检查管理员账号，也不要把网页保存成功当作机台已经应用。

聊天经验：共享验证值和管理员凭据必须分开

页面可能要求一个由管理员提供的验证值，但它不一定拥有管理员配方的写入权限。没有明确用途的字符串不要填入 Token、密码或配方值；公用验证值、账号密码和管理员私密凭据分别保存、分别轮换。

若值被发到错误的群组，按凭据泄露处理：停止使用、通知所有者、按要求失效/轮换，并只提交脱敏的泄露时间和范围。

工坊行为字段

机台账号可能看到以下行为开关：

类别	可见效果
应用配方	允许或禁止应用网页配置
用户名	是否显示用户名称
用户头像	是否显示用户头像
相机	是否使用相机功能
访问码	是否允许二维码/访问码流程
内容解锁	是否允许特定内容解锁
离线/备用模式	是否允许管理员开启备用数据流程

行为开关只控制机台功能是否可用，不会自动授予用户访问权限。修改后要用一个普通用户账号做验收。

JSON 编辑器的通用检查

当页面出现 JSON 编辑器时：

1. 先复制原始内容；
2. 使用双引号，不要使用智能引号；
3. 数字不要加引号，除非页面示例明确要求文本；
4. 不要删除页面没有展示的字段；
5. 保存后等待成功消息；
6. 刷新页面确认值仍然存在。

配方排障矩阵

现象	第一检查项	第二检查项
读取为空	账号是否在目标机台完成一次连接	当前账号类型和权限
保存失败	值格式和 JSON 语法	机台是否在线
保存成功但无效果	是否需要重启	是否被另一个开关覆盖
内容不可见	黑名单/白名单	内容屏蔽列表
数据上传异常	上传版本字段	缓存和网络状态
头像不显示	图片格式和尺寸	行为开关是否开启
代理延迟变高	优先级顺序	是否同时启用了多类代理