配方与机台设置

网页中的“配方”是面向使用者的设置入口。它把复杂的机台与账号选项整理成开关和值，用户无需了解服务内部实现即可完成常用配置。

账号类型差异

用户账号

常见项目包括：

• 是否使用 ZundaLink 数据路径；
• 登录状态和数据版本；
• 用户名、头像、地区等展示信息；
• 伙伴、对手和内容展示；
• 断网恢复或备用数据相关开关。

机台账号

常见项目包括：

• 机台连接和备用网络选择；
• 代理优先级和连接策略；
• 用户白名单、黑名单和内容屏蔽；
• 相机、头像、用户名和访问码功能；
• 机台默认版本、内容和上传策略。

修改一个项目

1. 登录正确的账号。
2. 打开“配方”页面并点击重新加载。
3. 找到需要修改的项目，先记录原来的开关和值。
4. 修改开关或值，点击保存。
5. 等待成功提示，再让机台重新登录或重启相关页面。

一次只改一个项目

多个项目同时修改会让排障变得困难。每次只改一个项目，确认效果后再进行下一项。

值的写法

• 单个 ID 通常直接填写数字；
• 多个值通常按页面提示使用英文逗号分隔；
• 图片类项目使用页面的上传按钮，不要手动粘贴超长编码；
• JSON 项目必须是有效 JSON，括号、引号和逗号都要完整；
• 不确定的字段保持默认值，不要从其他机台复制。

机台管理员的建议

• 修改前下载缓存并截图保存原配置；
• 只把管理员账号交给可信人员；
• 白名单和黑名单不要同时随意调整；
• 更新内容、网络策略和用户展示设置分开变更；
• 配置完成后用普通用户账号做一次最小化验收。

API 使用提示

配方 API 返回的项目名和值以当前账号可见范围为准。开发者应展示服务返回的项目，不要在程序中硬编码未公开项目，也不要把机台凭据写入前端代码。详见配方 API。

网页中可见的配置类别

网页根据账号类型显示不同配置。下面的名称是用户视角的功能分类，不要求用户记忆服务内部键名。

账号连接与数据路径

用于决定账号数据是否经过 ZundaLink、是否暂存、何时上传以及是否避免把特殊版本数据写回主数据源。

常见使用方式：

1. 新账号首次使用时保持默认值；
2. 需要缓存或离线恢复时，先开启数据缓存相关选项；
3. 需要恢复到主数据源时，先下载缓存并确认上传目标；
4. 不要同时打开多个互相冲突的数据路径选项。

登录与恢复

登录状态相关设置可能包括强制登录状态、继承最近登录时间、自动修复票据和版本兼容。它们会影响机台登录是否继续、数据是否被暂存和客户端看到的版本。

• 只在管理员确认的场景下启用；
• 出现反复登录、登录后立即退出或灰色网络状态时，先恢复默认值；
• 不要为了绕过错误随意修改多个版本字段。

版本字段

页面可能显示数据版本、ROM 版本、上传数据版本和上传 ROM 版本。它们不是任意文本标签，而是服务用于判断客户端兼容性的值。

建议：

• 只填写管理员给出的版本格式；
• 下拉数据和上传数据要成对检查；
• 修改后先使用测试账号验证读取、保存和退出；
• 版本异常时保留原值，不要用当前日期或自定义文字代替。

用户展示

用户账号可能看到用户名、头像、伙伴和对手设置：

• 用户名应使用普通、合法、可识别的文字；
• 头像通过上传按钮选择图片，网页会缩放并转换为适合显示的格式；
• 对手/伙伴等多值字段按照页面提示使用英文逗号分隔；
• 不要上传包含二维码、联系方式或他人肖像的图片。

地区选择

地区字段使用下拉菜单选择，不要手动输入未列出的地区。它用于数据展示和上传时的地区标记，不能改变机台物理位置或网络出口。

内容显示与测试开关

测试账号可能看到空数据、修改列表、空物品、空地图、空伙伴、空登录奖励等测试选项。这些选项用于复现问题：

1. 只在测试账号启用；
2. 每次只启用一个；
3. 记录启用前后的现象；
4. 测试结束立即关闭；
5. 不要把测试结果当作正式数据备份。

内容解锁和自制内容显示

某些账号可能看到内容解锁、热门内容或自制内容锁定选项。它们会改变选曲列表和可见内容，可能影响记录一致性。正式使用前先阅读管理员公告，并确认所有参与玩家都了解变化。

机台账号配置类别

连接目标

机台账号可能看到连接主服务、连接标题/登录服务、网络路径和代理相关设置。对于这些设置：

• 修改前先记录当前值；
• “立即生效”和“重启生效”要区别处理；
• 连接路径异常时先恢复已验证值；
• 不要把加密字段、服务地址或代理凭据复制给普通用户。

代理优先级

网页提供的优先级下拉项使用三位数字表示三类代理的顺序。数字含义由页面文字说明决定；例如 123 表示第一类优先，其次第二类，最后第三类。

修改原则：

• 默认值适合大多数机台；
• 只有在特定代理路径故障时才调整；
• 调整后观察延迟、健康检查和资源下载；
• 不要在同一时间启用多个未知代理。

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

列表字段通常使用英文逗号分隔多个 ID：

12345,67890

黑名单优先级高于白名单。出现“某账号看不到内容”时，按以下顺序排查：

1. 账号是否在白名单；
2. 账号是否同时在黑名单；
3. 机台是否启用了内容屏蔽；
4. 拼机时另一侧账号是否影响最终结果；
5. 是否需要重新登录或刷新缓存。

机台展示行为

机台账号可能看到用户名、头像、相机、访问码和内容解锁等行为开关。它们只控制机台是否提供相应体验，不会自动替用户获得账号权限。

自定义 JSON 项目

机台设置中可能出现“自定义主服务配置”和“自定义机台标识配置”两个 JSON 编辑器。本文不公开其中的加密字段或地址字段；使用者只应：

• 从管理员处获取完整、已验证的 JSON；
• 保持 JSON 的键名、大小写和类型；
• 修改前下载原配置；
• 保存后等待成功并重启验证；
• 不要把完整 JSON 贴到公开聊天。

如果网页提示 JSON 格式错误，优先使用页面提供的结构重新填写，而不是从任意网络文章复制。

图片上传规则

头像等图片项目会在浏览器中预处理：

• 只接受图片文件；
• 页面会缩放到适合显示的方形尺寸；
• 保存的是处理后的结果；
• 浏览器不会替你判断图片是否合规。

上传完成后重新加载页面，确认缩略图和机台展示都正常。