ota-deployment-guardian

OTA 部署守护

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

资源

• references/ota-safe-sketch.md - 草图端 OTA 合约及防护措施的最低要求
• references/discovery-and-network-ports.md - IDE、mDNS、IP 可达性及网络端口消失问题的排查
• references/recovery-and-rollback.md - 发布安全、回滚及最后手段的恢复规划
• ../../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. 确认板卡系列：
   • 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 途径消失 -> 确认新草图仍在 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 技能约定： 说明假设、所需工具及版本、实施步骤、各证明阶段的测试／证据、已知限制，以及 恢复／安全注意事项。