SuperAPI AI 工具集

ota-deployment-guardian

部署与运维

查看项目

更新于 10-16 01:09

技能介绍

用途:当设备需要远程更新,且丢失更新通道代价较高时使用。适用 ESP32、Nano ESP32、Uno R4 WiFi 的 OTA 上传场景,包括网络端口短暂出现或消失、IDE 能 ping 到设备却无法上传、远程气象站或已部署板卡需保持可更新、避免 OTA 后自锁等情况。普通 USB 台面烧录不适用,除非用户明确在为后续 OTA 部署做准备。

主要能力:提供最低限度的 sketch 端 OTA 约定与护栏;区分发现失败与 sketch 失败;给出 IDE、mDNS、IP 可达性与网络端口消失的排查思路;覆盖推送安全、回滚与最后手段恢复规划;针对原生 ESP-IDF 说明 app 槽位、启动确认、停止输出确认及可兼容回滚的 NVS/校准模式;并包含 Uno R4 系列板卡注意事项。

使用方式:先确认板卡家族——原生 ESP-IDF 查看 references/native-espidf-rollback.md,构建接入归 embedded-build-workflow,而非 Arduino sketch 指令;ESP32 或 Nano ESP32 查看 references/ota-safe-sketch.md;Uno R4 WiFi 还需查看 ../../docs/board-support/uno-r4-family.md。若 ping 通但网络端口消失,查看 references/discovery-and-network-ports.md;若 OTA 成功一次后新 sketch 运行时消失,确认新 sketch 是否仍保留 OTA 通道。建议推送前先查看 references/recovery-and-rollback.md 确认恢复路径、回滚策略以及 USB 上必须保留的能力。此前 OTA 可用后变得不可靠时,将核心版本变化视为可能的变量。

限制与边界:机密、签名镜像、依赖版本、分阶段推送、回滚、漏洞响应与退役应参考路由器连接设备安全资料;本技能不证明设备具备安全启动、认证更新或可恢复的现场部署,需在确切目标上验证。核心规则:不得假定新 sketch 后 OTA 仍可用,除非 sketch 保持 OTA 通道;区分可达性与 OTA 发现,ping 成功不代表能发现或上传;高成本远程设备至少保留一条恢复路径;Uno R4 WiFi 的 WiFi 侧操作模型不同于普通 ESP32。验证时需确认 sketch 启动后仍连接目标网络并服务 OTA 通道,判断失败属于仅发现、仅上传还是完全不可达,远程部署须先确认回滚或物理恢复方案,板卡或核心版本近期变更时记录确切版本。可与 arduino-cli-skill、field-power-and-connectivity-triager、error-message-explainer 配合。收费、价格、安装命令等资料暂未提供。