用途
该技能适用于「台面能跑、实地掉链子」的供电类故障：项目通过 USB 供电时工作正常，改用实际部署时的供电路径（电池、VIN、3V3 等）后出现复位、掉电或传感器不稳定。它定位于任何电压/电流路径不确定的板卡或负载；文档中以 ESP32 为例，但明确说明这只是常见案例，不代表所有板卡都具有相同限制。
触发场景
当请求中出现以下情形时使用：
- 「USB 上能用，换我的电源就不行」
- WiFi 在台面能连上，部署后连不上
- 只在现场出现的复位、掉电复位（brownout）或传感器不稳定
- 怀疑稳压器或接线路径能力不足
- 涉及电池、VIN 或 3V3 供电路径的问题
主要能力与参考资料
技能附带以下资源：
references/power-path-triage.md：USB、VIN、3V3 供电路径诊断流程references/wifi-and-peak-current.md：WiFi 启动、掉电复位与电流峰值行为references/measurement-checklist.md：在归咎于代码之前应测量的内容../../docs/board-support/uno-r4-family.md：Uno R4 系列板卡的相关注意事项
使用方式（工作流）
- 复现问题分界：USB 可用，目标供电路径失败。
- 打开
references/power-path-triage.md对供电路径进行分类。 - 若涉及 WiFi 或射频启动，打开
references/wifi-and-peak-current.md。 - 按
references/measurement-checklist.md采集实际测量数据，不要先假设问题出在用户代码。 - 若目标板为 Uno R4 WiFi，打开
../../docs/board-support/uno-r4-family.md，并明确区分连接侧硬件因素。
核心规则
- 「USB 上能用」是关于供电路径的证据，不能证明代码本身正确。
- 在 ESP32 类板卡上，WiFi 启动电流峰值是首要嫌疑对象。
- 先诊断供电路径，再盲目调整网络代码。
- 实地供电下出现的传感器不稳定，在测量结果排除之前应视为可能的电源完整性问题。
- 不得用标称电压或空载电流读数作为峰值电流安全的依据；应把实测负载路径与板卡及元件限值进行比较。
验证要点
- 确认故障仅在目标供电路径上复现。
- 确认故障阶段（而非仅空载时）的电压与电流条件。
- 确认故障发生在启动、WiFi 关联过程中，还是之后带负载运行时。
- 确认供电路径修正后，同一程序表现是否一致。
与其他技能的配合
- 可能为电源容量偏小时，配合
power-budget-calculator。 - OTA 仅在实地供电下失败时，配合
ota-deployment-guardian。 - 怀疑板卡接线本身有问题时，配合
circuit-debugger。
输出约定
遵循共享的 Arduino 技能契约（../../docs/arduino-skill-contract.md）：说明假设、所需工具与版本、实施步骤、按证明阶段划分的测试/证据、已知限制，以及恢复与安全注意事项。
限制
文档未提供具体电压、电流阈值、元件型号或适用板卡的完整清单；实际限值需依据测量清单自行采集并与板卡、元件规格比对。ESP32 仅为示例，不代表其他板卡适用相同限值。