当前项目范围
新版生成器只面向 MQTT 主线
当前线上说明仅对应 u724-next。旧的 u724.pages.dev 已冻结，不再作为新项目说明入口，也不再承接后续配置变更。
2. 现场准备
开始生成前，先把客户和设备两边的必需信息收齐。
设备与网络
准备 Air724UG 设备、可用 SIM 卡、USB 数据线，以及能访问 MQTT 后台的电脑环境。SIM 卡至少要保证短信功能正常。
后台参数
至少需要 MQTT Host、Port、Username、Password。若现场固定设备标识，也一并准备设备 ID 和本机号码。
交付形式
现场主要使用 config.bin。如需脚本自举，也可导出 universal_bootstrap.lua，但不再下发旧式 config.lua 兼容内容。
3. 生成配置
主界面只保留核心字段，先填这些，再决定是否进入二级编辑。
- 打开 配置生成器首页。
- 填写客户 / 备注，方便后续区分项目或设备批次。
- 填写
config.bin 密钥。默认是jocry，若设备端已改密钥，网页必须保持一致。 - 填写 MQTT Host、Port、Username、Password。
- 如果现场需要固定
dev_id，填写“固定设备 ID”；否则可留空，由设备运行时自行识别。 - 点击“刷新预览”确认摘要和 JSON 是否正确，再导出
config.bin、JSON或universal_bootstrap.lua。
设备实际读取的文件名仍然必须是 config.bin。不要在导出后改成客户名或日期名。
4. 二级编辑说明
次级参数不再散铺在首页，而是收口为四个确认式编辑块。
设备标识与安全
用于填写 MQTT Client ID、设备密钥种子。适合做统一固件批量交付或固定密钥派生。
连接细节
用于调整 KeepAlive、接收等待、上报批量，以及是否在日志中隐藏服务端地址。
维护与语音
用于控制后台短信、OTA 配置更新、语音上传、定时重启、SIM 自检等运维参数。
短信、通话与硬件
用于设置来电动作、短信 TTS、短信白名单、音量、RNDIS、状态灯和 SIM PIN。
- 点击每个区域的“编辑并确认”进入二级编辑。
- 在弹层中完成修改后，点“确认写入”才会更新主摘要。
- 点“取消”、点遮罩或按
Esc会回退本次二级编辑，不会把半成品写回主配置。 - 如果现场需求简单，完全可以只填主界面核心字段，不进入二级面板。
5. 导入旧文件
当前页面支持导入 config.bin 和导出的 JSON，不再支持旧式 config.lua。
- 点击首页“导入 config.bin / JSON”。
- 选择之前导出的
config.bin或air724ug-config.json。 - 如果导入的是
config.bin，先确认页面里的config.bin 密钥与原文件一致。 - 导入成功后，主页摘要和预览会自动刷新，再按当前项目要求重新导出即可。
当前项目已经取消旧版 Lua 明文兼容路径。不要再拿旧 config.lua、旧通知字段或旧 Cloudflare 项目说明来混用。
6. 下发到设备
把生成文件放到设备当前脚本体系能读取的位置即可。
- 确认设备已经烧录当前主线脚本，保留完整
script/目录结构。 - 将导出的
config.bin复制到设备 U 盘根目录，对应路径通常是/usbmsc0/config.bin。 - 如果使用自举模式，则把
universal_bootstrap.lua按当前现场流程写入对应脚本目录，不再和旧兼容开关混用。 - 断开设备或重启模块，等待设备重新读取配置并上线到 MQTT 后台。
7. 验收检查
配置下发后，先按这几项做一次闭环检查。
8. 常见问题
现在最常见的问题，先按当前新版方向排查。
为什么说明页里不再写通知渠道配置？
因为通知渠道已经转到服务端后台处理，设备端和生成器只负责 MQTT 与设备本身配置，不再承载第三方通知密钥。
为什么不能再导入 config.lua？
当前项目明确取消旧 Lua 明文兼容，避免编码、字段漂移和现场误操作。导入只认新版 config.bin 或生成器导出的 JSON。
生成器改版后，现场人员要从哪里开始？
先看主界面的核心配置，只有现场确实需要更细参数时，再进入“二级编辑”弹层。摘要区会帮忙快速复核当前配置。
旧的 u724 页面还能继续当新项目入口吗？
不能。旧的 u724.pages.dev 已冻结，当前新项目入口和说明只认 u724-next。