批量授权 · 操作员指南
写给使用 tyutool 进行批量烧录授权的操作员，"照着做"的顺序，无需技术背景。
固件开发者请看开发者指南。
工作流顺序：① 开工前清单 → ② 配置 → ③ 接线与启动 → ④ 核对结果 · 出错速查 · 安全铁律。
这个工具做什么
多台设备插多串口，点"全部开始"，同时烧录+授权，授权码从 Excel 自动读取。
批量页面——完成横幅 / 仪表盘（烧录累计·授权累计·本次批次）/ 配置面板 / 工具栏（自动分配·串口过滤·全部读取·全部开始）/ 端口列表。
开工前清单
| 准备项 | 怎么算就绪 |
|---|---|
| 桌面版 tyutool | 已安装并能启动 |
| 授权码 Excel | 至少有 UUID + AuthKey 两列；从 tuyaopen.ai/zh/pricing 购买 |
| 设备 + 串口线 | 已接线，设备能进下载模式 |
| 串口驱动 | CH340/CP2102/FT232 已装 |
| 固件文件 | 本次批次用的 .bin |
安装包（版本号仅作参考，始终以 GitHub Releases 为准）：
| 平台 | 文件 |
|---|---|
| Windows | ..._windows_x86_64_nsis_x.x.x.exe |
| macOS（Universal） | ..._macos_universal_dmg_x.x.x.dmg |
| Linux | ..._linux_x86_64_appimage_x.x.x.AppImage（先 chmod +x） |
这些设备有两个串口——务必接烧录/授权口，不要接日志口。
妥善保管 Excel。
配置交接单
| 配置项 | 开发者填 | 操作员核对 |
|---|---|---|
| 芯片型号 | 如 esp32 / t5ai | 与设备一致 |
| 操作模式 | 只授权 vs 先烧再授（路径 A/B） | "烧录固件"开关一致 |
| 固件文件与版本 | 文件名 + 版本 | batch-summary.json 记 SHA256 |
| 烧录波特率 | 如 921600 | 设置正确 |
| 授权波特率 | 如 115200 | 设置正确 |
| 存储模式 | KV / OTP | OTP → 先单台验证 |
| 冲突策略 | 跳过 / 覆盖 | OTP 只能跳过 |
| 授权表 | 剩余 ≥ 本批新设备数 | 恢复/重试已登记设备不占新码 |
| 接线 | 说明 | 确认 RTS 接到复位脚 |
| MAC 唯一性 | 每台 MAC 全球唯一 | tyutool 不校验 MAC 冲突，重复 MAC 让设备共用授权码 |
| 单台试通 | 已通过 | 上量前已做 |
| 特殊事项 | — | 阅读 |
对不上先停下来找开发者确认，不要自行改配置。
操作流程
工具箱 → 批量烧录授权。
第一次进入会弹免责声明对话框（不可逆操作），可勾"不再提示"；重显见设置。
阶段一 · 配置
- 选芯片（ESP32 / T5AI；只授权选
other）。 - 烧录波特率。
- 授权波特率。
- 是否烧录固件（先烧再授）。
- 固件文件（本地 / 默认授权固件）。
- 选固件位置或选版本。
配置区——共享配置面板。
- 选授权表（
.xlsx）。 - 查看统计：总计 / 已用 / 占用中 / 剩余（给新设备分码需剩余 > 0；仅恢复/重试已登记设备剩余 0 也可启动，按 MAC 找回原码）。
- 已带授权设备：跳过（推荐）/ 覆盖。
批量授权配置——授权表统计。
（仅 T5AI）选存储模式：KV 可重写；OTP 写一次不可逆（见安全）。
阶段二 · 接线与启动
先 1 台完整跑通 → 2～4 台小批量试跑 → 再上整批。
接好后两步：
- 点自动分配（扫描加插槽，每口一行"空闲"）。
- 点全部开始（空闲端口 > 8 时先弹确认）。
逐行对照交接单核对配置；OTP 是否已单台验证？
工具栏与端口列表——每口一个插槽。
② 串口过滤 · ③ 全部读取（只读不写）· ④ 取消 · ⑤ 重试失败 · ⑦ 单口读取。
阶段三 · 等待与核对
- 看仪表盘等完成（完成横幅：全部成功 / 全失败 / 部分成功 / 全跳过）。
- 逐行核对（失败看重试）。
- 整单跑完点"归档"（中间轮次不用归档）。
仪表盘与完成横幅（右侧归档按钮）。
看懂结果
| 状态 | 意思 | 做什么 |
|---|---|---|
done | 完成，好品 | — |
failed | 失败 | 重试 |
skipped | 已有授权按策略跳过 | — |
no_code | 新设备但剩余 = 0 | 补表重跑 |
| 其他 | 处理中 | 等 |
归档
一次"全部开始" = 一轮；一份授权表 = 一单（往往多轮）。归档以单为单位。
一键归档：选目录，建带时间戳文件夹 batch-archive_20260717-143205_esp32/，含：授权表副本 / 固件(含 SHA256) / logs.zip / batch-summary.json / batch-slots.csv。summary 的 lastRun 和 csv 只是最后一轮快照。
档案内容：
| 文件 | 是什么 |
|---|---|
| 授权表 Excel 副本 | 所用的表 |
| 固件文件 | 烧录的 .bin |
| logs.zip | 压缩日志 |
| batch-summary.json | 运行汇总 |
| batch-slots.csv | 最后一轮的按槽快照 |
| 完成横幅截图 | 可选记录 |
档案含 UUID + AuthKey，防泄露；排查只给日志和错误信息，授权表不外发。
出错速查
| 现象 | 处理 |
|---|---|
| 应用打不开 / 白屏 | 见 FAQ · Linux 白屏 |
| 端口没出现 | 换线换口、装驱动、关其他程序，见 FAQ · 端口 |
| 全部失败 | 单台试通、降到 115200、查供电 |
| Excel"文件被占用" | 关掉 Excel/WPS 重选 |
| Excel 表无效 | 查 UUID + AuthKey 两列及长度 |
| 需详细日志 | 按保存现场保存，见 FAQ · 日志 |
先保存现场
趁现场点"归档"全存下；再手工补三样：界面截图（遮 AuthKey，UUID 可留）/ 问题设备实物（贴标签单独放）/ 一句话现象描述。
别拖也别泄露：当天归档；外发只给日志和错误信息。
安全铁律
这是唯一会触发不可逆硬件操作的功能。
OTP（仅 T5AI）把授权烧进芯片后永远无法撤销。配错毁整批——务必先用一台完整跑通验证再批量。
选 OTP 时界面提示写入后不可撤销。
这类设备授权可能已写、状态不确定，既不能当好品也不能直接重跑，必须单独核实。