ota-deployment-guardian

OTA 部署守护

当设备通过远程方式更新，且失去更新途径代价高昂时，使用此技能。

资源

• references/ota-safe-sketch.md - 草图端 OTA 合约及防护措施的最低要求
• references/discovery-and-network-ports.md - IDE、mDNS、IP 可达性及网络端口消失问题的排查
• references/recovery-and-rollback.md - 发布安全、回滚及最后手段恢复计划
• references/native-espidf-rollback.md - 原生应用分区、启动验收、停止输出确认，以及兼容回滚的 NVS／校准数据模式
• ../../docs/board-support/uno-r4-family.md - Uno R4 Minima 和 Uno R4 WiFi 板卡系列注意事项

使用时机

在请求涉及以下内容时使用此技能：

• 为 ESP32、Nano ESP32 或 Uno R4 WiFi 进行 OTA 上传
• 网络端口短暂出现后消失
• IDE 可以 ping 通设备，但无法上传
• 确保远程气象站或已部署的开发板仍可更新
• 避免 OTA 部署后设备因自身问题而无法使用

除非用户明确是在为之后的 OTA 部署做准备，否则不要将此技能用于普通的台架 USB 上传。

工作流

1. 确认板卡系列：
   • 原生 ESP-IDF -> 打开 references/native-espidf-rollback.md；构建准备仍由 embedded-build-workflow 负责，而非 Arduino 草图说明。
   • ESP32 或 Nano ESP32 -> 打开 references/ota-safe-sketch.md
   • Uno R4 WiFi -> 还要打开 ../../docs/board-support/uno-r4-family.md
2. 区分发现问题与草图问题：
   • ping 正常，但网络端口消失 -> 打开 references/discovery-and-network-ports.md
   • OTA 成功过一次，但新草图运行后端口消失 -> 确认新草图仍实现了 ota-safe-sketch.md 中的 OTA 路径
3. 在建议发布前，查看 references/recovery-and-rollback.md，了解恢复途径、回滚策略，以及必须继续通过 USB 提供的功能。
4. 如果 OTA 之前正常，之后变得不可靠，则将核心版本变更视为一个可能的影响因素。

安全与维护边界

有关机密信息、签名映像、依赖版本、分阶段发布、回滚、漏洞响应和退役，请使用路由器的联网设备安全参考。本技能中针对板卡的 OTA 流程并不能证明设备启用了安全启动、经过身份验证的更新或可恢复的现场部署；请针对确切目标核实这些控制措施。

核心规则

• 除非新草图保留了 OTA 路径，否则绝不要假设 OTA 在新草图运行后仍可用。
• 区分可达性和 OTA 发现能力。ping 成功并不能证明 IDE 能发现设备或进行上传。
• 对于出问题代价高昂的远程设备，至少保留一种恢复途径。
• 对 Uno R4 WiFi，明确说明板卡系列的注意事项。它的 WiFi 部分与普通 ESP32 板卡的运行模式不同。

验证

• 确认草图启动后仍能连接到预期网络，并提供 OTA 路径。
• 确认故障仅影响发现、仅影响上传，还是导致设备完全不可达。
• 对于远程部署，在建议更新之前，确认回滚计划或现场恢复计划。
• 如果近期更改过板卡或核心版本，在断定问题出在用户代码之前，记录确切版本。

集成

• 用户需要命令行上传或检查端口时，与 arduino-cli-skill 配合使用。
• OTA 路径只在脱离 USB 或现场供电条件下失效时，与 field-power-and-connectivity-triager 配合使用。
• OTA 草图本身无法构建时，与 error-message-explainer 配合使用。

共享输出约定

请遵循共享 Arduino 技能约定：说明假设、所需工具和版本、实施步骤、各验证阶段的测试／证据、已知限制，以及恢复／安全注意事项。