配方编辑器逐步使用

本页说明网页“烘焙配方”页面的实际编辑行为。它补充配方与机台设置和配方字段详解，重点解释页面卡片、账号过滤、值编辑器、图片上传和单项保存。

页面加载

打开页面后，网页会根据当前 Token 和账号类型读取可见配置，并把每一项显示成卡片。

加载状态可能包括：

• 加载中：显示加载提示，不能编辑；
• 成功：显示配置卡片；
• 空数据：提示账号尚未注册或尚未完成首次连接；
• 失败：显示服务消息和重新加载按钮；
• 网络错误：保留页面结构，等待用户重试。

空数据不等于账号数据丢失。先让目标账号完成一次正常连接，再重新加载。

账号类型过滤

用户账号

用户账号主要看到个人数据路径、登录状态、版本、地区、姓名、头像、伙伴、对手、缓存、测试和内容展示相关项目。

机台账号

机台账号可能看到机台连接目标、代理顺序、用户白名单/黑名单、内容屏蔽、版本覆盖、访问码、相机、用户展示和离线行为相关项目。

只显示当前范围

页面会根据账号类型和权限过滤列表。普通用户看不到机台项是预期行为，不要尝试在浏览器控制台手动加入名称。

配置卡片结构

每张卡片通常包含：

1. 配置名称；
2. 描述文字；
3. “开关”控件；
4. “值”编辑器；
5. 保存按钮；
6. 更新中状态；
7. 成功 Toast 或错误提示。

开关和数值是两个独立字段。打开开关不会自动修正值，保存值也不一定自动打开开关。

单项保存流程

1. 先点击重新加载；
2. 记录目标卡片的原始开关和值；
3. 只修改一个卡片；
4. 修改开关或值；
5. 点击该卡片的保存按钮；
6. 等待“修改成功”提示；
7. 重新加载页面验证持久化；
8. 根据描述判断是否需要重新登录或重启。

保存期间当前卡片按钮禁用，其它卡片不应被同时提交。失败时页面保留原值和错误消息，不要重复发送未知状态的请求。

值编辑器类型

普通文本

用于版本、名称、状态或地址提示。不要添加页面未要求的注释、引号或换行。

数字文本

先确认单位和允许范围。数字输入框通常在浏览器侧把空值处理为 0，但 0 是否有特殊含义要看页面说明。

地区下拉

页面提供地区选项时使用下拉选择，不要手动输入不存在的地区。地区标记不改变物理位置或网络出口。

代理优先级下拉

机台账号可能看到六种三位顺序选项，用来排列三类可见代理：

• 主代理 → 机台代理 → 自定义代理；
• 主代理 → 自定义代理 → 机台代理；
• 机台代理 → 主代理 → 自定义代理；
• 机台代理 → 自定义代理 → 主代理；
• 自定义代理 → 主代理 → 机台代理；
• 自定义代理 → 机台代理 → 主代理。

修改后观察延迟、健康检查、登录和下载。不要同时开启多个未知代理来“提高成功率”。

逗号分隔列表

白名单、黑名单、内容屏蔽、伙伴或对手列表可能使用英文逗号：

<ID_A>,<ID_B>,<ID_C>

不要使用中文逗号、方括号或昵称，除非页面说明明确要求。保存后重新登录或刷新内容缓存。

JSON 编辑器

页面可能出现自定义服务或机台标识 JSON：

• 顶层结构必须符合页面示例；
• 使用双引号；
• 数字保持数字类型；
• 不要删掉未编辑字段；
• 保存原始 JSON 后再修改；
• 语法错误时不要提交；
• 不要把完整 JSON 贴到公开聊天。

自定义 JSON 可能包含敏感地址或加密字段。本文只说明编辑行为，不公开具体值。

图片上传

头像等图片卡片通常提供图片选择按钮：

1. 选择图片文件；
2. 页面在浏览器中预览并处理；
3. 图片通常被缩放到 256×256 的方形 JPEG；
4. 页面自动提交处理后的值；
5. 等待成功提示并重新读取卡片。

只接受图片文件。图片加载、画布处理或上传失败时，页面显示错误并清空本次文件选择。不要上传二维码、密码、个人联系方式或他人肖像。

用户配置类别

数据路径与缓存

用于决定账号数据是否使用缓存、何时上传和怎样处理网络波动。修改前先下载缓存；遇到上传失败时先用上传缓存，不要同时切换多个路径开关。

登录状态与时间

可能包含最近登录时间、登录状态继承和票据修复等项目。它们会影响登录持续性和页面看到的时间。出现反复登录或登录后立即退出时，先恢复原值并重新验证。

版本字段

可能包含数据版本、客户端版本、上传数据版本和上传版本等字段。它们用于兼容判断，不是任意显示文本。只填写管理员提供的格式，并成对验证读取与上传。

用户展示

用户名、头像、伙伴和对手字段会影响机台上看到的内容。保存后使用普通用户账号验收，确认没有把管理员账号或私密信息显示给现场用户。

测试项目

测试账号可能看到空数据、内容列表、物品、地图、伙伴或登录奖励等测试开关。测试结束后关闭并清理测试缓存；不要在公共账号上启用未知测试项。

内容可见性

内容解锁、自制内容显示或锁定项目会改变选曲列表。修改前记录原值，并确认所有参与游玩者知道内容范围发生变化。

机台配置类别

机台连接

连接目标、直连/代理模式、登录路径和数据路径可能分别有“立即生效”和“重启生效”区别。保存后先重新读取，再按页面提示执行重启。

代理与自定义列表

代理优先级只改变尝试顺序，不保证网络一定可用。代理 URL 可能含凭据，不要写入截图、日志或共享配置。

用户列表与内容屏蔽

白名单允许指定用户，黑名单排除指定用户，内容屏蔽列表排除指定内容。黑名单与白名单冲突时通常按更严格的限制处理；排障时先保存原列表，再逐项验证。

行为开关

相机、头像、用户名、访问码、内容解锁和离线行为等开关只控制机台是否提供对应体验，不会自动给普通用户授予权限。

错误与恢复

现象	第一动作	第二动作
配方列表为空	确认账号和首次连接	重新加载
保存按钮处理中	等待当前请求	不重复点击
保存失败	保留原值和消息	检查机台在线状态
成功但无效果	重新读取	按提示重启
JSON 格式错误	撤销最后改动	从有效备份恢复
图片处理失败	重新选择普通图片	检查格式和尺寸
内容不可见	查黑名单/白名单	查内容屏蔽和缓存
代理延迟升高	恢复原顺序	单独测试一类代理

开发者展示建议

第三方客户端应使用服务返回的可见配置名，不要硬编码隐藏列表。每个卡片独立显示：加载中、保存中、成功、失败和权限不足状态；未知字段应保留，未知编辑器类型应只读展示。

写入失败或响应超时时，先重新读取当前配置；如果已经成功，避免重复提交。日志中不要保存 Token、密码、访问码、机台标识和完整 JSON。