EchoEar 烧录助手 — Windows 图形界面

启动
双击 EchoEarFlasher.exe。engine 和 firmware-build 文件夹必须与程序放在一起。
这台电脑已具备所需 Python 环境，无需打开终端。
适用设备：原 COM6 的 EchoEar ESP32-S3，16MB Flash，MAC B4:3A:45:16:34:A8。

恢复迁移后连接失败的设备
1. 打开“线上设备管理”，用运维账号登录。
2. 创建设备，型号 ECHOEAR-S3，下载 KP01-…-burn-in-v1.json。
3. 在助手里选择该 JSON，确认串口 COM6 和硬件 MAC。
4. 模式保持“重新初始化（保留固件）”。
5. 点击检查/预览，核对出厂编号、平台地址、写入区域。
6. 确认将清除旧 Wi-Fi 和语音配置，点击开始烧录并在确认窗口核对目标。
7. 等待检查设备 → 完整16MB备份 → 写入 → 校验完成。
8. 成功后手动复位或断电重启，再到家庭端/小程序重新蓝牙配网与绑定老人。

预览只处理电脑上的文件，不打开设备串口。只有点击开始烧录并确认才会写设备。
烧录过程中不要拔线或关闭程序；界面显示实际阶段，不显示虚构的进度百分比。
失败时查看提示，备份保留；重新检查并预览后再重试。

完整固件模式
需要重新刷整机固件时，选择完整固件模式。它会写配套Bootloader、分区表、
应用、OTA启动信息、语音模型和屏幕资源，同时清理旧运行状态，之后必须重新配网。
本包包含项目现有1.7.0-controls.28构建：离线文件校验通过，尚未完成实机验收。
本次云端清库后的身份恢复推荐保留现有固件，无需升级到.28。
完整模式必须使用一整套构建目录，不能随意选择单个应用.bin作为整机镜像。

初始化信息
设备编号、型号、平台地址和设备密钥来自后台JSON，无需手填密钥。
家庭Wi-Fi、账号归属和老人通过家庭端/小程序配置；不要写入火山主账号AK/SK。
本次云端已经清空记录，因此可按新设备重新建立身份。对于仍在使用的其他设备，
本地清配置不会替代云端解绑，需先处理归属。

文件与依赖
生成的工厂身份、完整Flash备份含设备秘密，保存在界面指定的本地私有目录。
程序不会把密钥显示在界面日志，不会自动上传备份，不会执行整片擦除。
本版本使用电脑上已安装的Python运行烧录引擎，不是自带Python的独立运行包。
默认查找：%USERPROFILE%\.espressif\python_env\idf5.5_py3.12_env\Scripts\python.exe。
若换电脑，可在高级设置选择Python 3.10+解释器；该解释器需有
esptool 4.x/5.x、esp-idf-nvs-partition-gen、pyserial。
本机已验证依赖版本：esptool 4.12.0、esp-idf-nvs-partition-gen 0.1.9、pyserial 3.5。

备份目录及初始化材料请妥善保存，勿提交Git或公开分享。
程序和模拟测试通过不等于真机烧录验收；本次交付没有替用户执行烧录。