配方页面控件与可见字段类型参考

本页按前端配方页面实际控件说明读取、筛选、开关、值输入、头像上传和单项保存行为。它只使用访问者能看到的通用字段类别，不列出隐藏规则名或内部实现名称。

页面头部

配方页根据账号类型显示不同标题和提示：

• 用户账号：个人数据、登录、展示和测试相关配置；
• 机台账号：连接、代理、内容、行为和机台列表相关配置。

页面加载中会显示加载状态；没有配方时显示空状态；读取失败时保留错误消息和重新加载按钮。普通账号看不到机台字段是权限设计，不是页面损坏。

配方卡片结构

每张卡片可能包含：

1. 配方显示名称；
2. 描述；
3. 开关；
4. 值输入；
5. 单项保存按钮；
6. 保存中状态；
7. 成功/失败消息。

开关和值分开保存。打开开关不保证值正确，修改值也不一定自动打开开关。

值编辑器类型

普通文本

用于名称、版本、地址提示和状态类值。按页面提示输入，不要添加注释、引号或换行。

数字文本

页面可能把数字以文本框显示。输入前确认单位、范围和空值语义。保存后回读，不能只依赖浏览器输入框的显示。

省份/地区下拉

下拉框通常包含占位项和有效选项。选择不存在的值不会改变真实网络出口，也不能用来修改地理位置。

代理顺序下拉

可能显示六种三位顺序：

顺序	先后
123	主代理 → 机台代理 → 自定义代理
132	主代理 → 自定义代理 → 机台代理
213	机台代理 → 主代理 → 自定义代理
231	机台代理 → 自定义代理 → 主代理
312	自定义代理 → 主代理 → 机台代理
321	自定义代理 → 机台代理 → 主代理

顺序只是尝试优先级，不是网络可用保证。修改后观察延迟、登录和下载。

图片上传

头像类卡片可能显示当前图片、占位图和“点击上传头像”。选择文件后浏览器会处理图片并自动提交：

• 只选择图片；
• 推荐正方形；
• 不上传二维码、Token、密码或他人肖像；
• 处理/上传中不要重复选择；
• 成功后用普通账号验收。

JSON 编辑器

自定义服务、机台标识或其它结构化值可能显示多个输入框和 JSON 文本区。页面允许的字段才可填写。双引号、数字类型和未知字段保留是基本要求。

列表文本

对手、伙伴、允许名单、排除名单和内容过滤可能使用英文逗号。列表用途不同，不能复制到另一个卡片；保存前保留原文。

单项保存时序

1. 点击页面刷新/读取；
2. 找到目标卡片；
3. 复制原开关和值；
4. 只修改一个卡片；
5. 点击该卡片保存；
6. 等待当前按钮结束；
7. 看到成功消息；
8. 重新读取；
9. 按描述决定是否重启。

一个卡片保存失败，不应自动重试所有卡片。超时先回读目标卡片。

用户字段类别

可能看到：

• 缓存/上传路径；
• 登录状态；
• 最近登录时间；
• 数据/客户端版本；
• 地区；
• 对手/伙伴；
• 用户名和头像；
• 内容测试开关；
• 公开展示开关。

测试字段不是普通用户功能。测试结束后关闭、重新读取并清理测试缓存。

机台字段类别

可能看到：

• 机台名称列表；
• 连接目标；
• 直连/代理；
• 服务 JSON；
• 代理优先级；
• 允许/排除用户列表；
• 内容过滤；
• 版本兼容覆盖；
• 用户名/头像/相机/访问码展示开关；
• 离线/备用模式。

这些字段可能分别是立即生效、重新读取生效或重启生效。页面描述优先于经验推断。

JSON 类型和保存风险

页面显示 JSON 有效不等于内容适合机台。保存前检查：

• 顶层结构；
• 必填键；
• 数字是否误加引号；
• 地址是否来自管理员；
• 未知字段是否保留；
• 是否包含凭据；
• 是否需要重启。

保存完整对象前先下载原值。不要从截图或群聊复制一整份服务 JSON。

常见页面状态

现象	含义	建议
卡片为空	尚未读取/账号无数据	刷新并确认账号
保存按钮处理中	当前写入未结束	不重复点击
JSON 报错	文本不可解析	恢复最后有效值
成功但无效果	可能需回读/重启	刷新并按提示执行
头像占位	图片未读/开关关闭	重新读取并验收
内容不可见	过滤/权限/缓存	按范围逐项检查

配方问题反馈

账号类型：用户 / 机台
账号别名：<脱敏>
卡片类别：<通用类别>
原值摘要：<脱敏>
目标值摘要：<脱敏>
是否成功保存：
是否重新读取：
是否重启：
页面/机台结果：

不要附完整配方、Token、地址、密码、私钥、原始 Hosts 或完整机台编号。