Atoms项目一键部署生产环境指南

AtomS3R回声板需编译、烧录、配网、调试四步闭环，非云服务，生产环境指固件稳定、Wi-Fi自连、语音唤醒可靠、OLED可视、外设可接入；核心三步不可省：set-target esp32s3、选对分区表、首次扫码配网。

AtomS3R回声板不是靠“一键部署”跑起来的，它本质是嵌入式开发板，需要编译、烧录、配网、调试四步闭环。所谓“一键”，其实是把重复操作脚本化，降低入门门槛，但不能跳过硬件交互和环境适配环节。

它既不是云服务，也不是容器应用，不存在Kubernetes、Docker或CI/CD流水线这些概念。那么，它的“生产环境”究竟指什么呢？具体来说，就是固件要能稳定运行，Wi-Fi要能自动重连，语音唤醒响应要可靠，OLED状态要可视，并且外设（比如传感器）可以按需接入。其目标是让设备在无人值守的情况下长期保持在线，而不是追求秒级的弹性扩缩容。

• 编译前必须执行 idf.py set-target esp32s3，否则默认按 ESP32 编译，会导致音频驱动异常或麦克风静音
• menuconfig 中必须选对分区表 partitions/v2/8m.csv，否则 OTA 升级失败或日志写满 Flash
• 烧录后首次启动会进入配网模式，OLED 显示二维码，需用手机微信扫码填入 Wi-Fi 账号密码——这步无法跳过，也没有“免配网”后门

• 把 Wi-Fi SSID 和密码硬编码进 main/app_main.c 的 wifi_config_t 结构体里，可跳过扫码（适合批量部署）
• 在 sdkconfig.defaults 文件中预置 CONFIG_ESP_WIFI_SSID="your_ssid" 和 CONFIG_ESP_WIFI_PASSWORD="your_pass"，再执行 idf.py menuconfig 时这些值会自动加载
• 使用 idf.py flash --no-monitor 避免串口监控干扰自动流程，适合集成进 shell 脚本批量烧录

• 检查 OLED 是否显示 IP 地址和信号强度，无显示说明 Wi-Fi 连接失败或屏幕初始化异常
• 用手机录音 App 录下唤醒词（如“小智”），回放确认麦克风采样无削波、底噪低于 -50dBFS
• 通过串口监视器观察 I (xxx) AUDIO: VAD triggered 日志，确认语音活动检测（VAD）模块已激活，不是全程静音监听

不需要复杂运维平台，也不依赖外部集群。把它当成一台带语音能力的嵌入式终端来对待，稳住底层驱动和网络连接，就是最实在的“生产就绪”。