用途：在 ESP-IDF 上设计并排查 ESP32 低功耗睡眠策略，包括 light-sleep 与 deep-sleep 选型、深睡唤醒源配置、跨睡眠状态保存，以及睡眠电流的实测验收。
主要能力：给出双模式定义（light-sleep 为时钟门控、状态保持、无线断电；deep-sleep 为 CPU、大部分 RAM 与数字外设断电，仅 RTC 控制器、ULP、RTC FAST/SLOW 内存供电）；列举六类深睡唤醒源：RTC Timer（µs 精度）、Touch、EXT0（单 RTC GPIO）、EXT1（多 RTC GPIO，S2/S3/C6/H2 额外支持 ANY_LOW）、ULP 协处理器、deepsleep GPIO wake，可组合使用；说明 ULP 形态随芯片不同（ESP32 为 ULP-FSM，S2/S3 为 RISC-V ULP 或 FSM，C6/P4 为 LP 核）；提供 RTC 内存保留与 NVS 快照的取舍判据。
使用方式：先运行 idf.py --version 与 grep 检查 sdkconfig 中的睡眠/电源管理配置及 CONFIG_IDF_TARGET，确认芯片型号后再判断可用唤醒源；用 esp_sleep 启用 API 族声明唤醒源（如 esp_sleep_enable_timer_wakeup()、esp_sleep_enable_ext0_wakeup()、esp_sleep_enable_ext1_wakeup()），具体签名以官方 API 文档为准；唤醒后查询复位/唤醒原因并写入启动日志。
适用场景：电池设备月级续航的周期上报、按键或外部事件唤醒、ULP 采样、睡眠电流与续航测算。
限制：不承诺任何具体电流数值，深睡电流属未核验信息，只认板级实测；GPIO 唤醒仅限 RTC GPIO 集合，引脚事实不确定即停；light-sleep 无线断电，不能表述为“低功耗且不断网”；无真机时结论标 Pending HIL；不做 FreeRTOS 任务层功耗设计、芯片选型与工程骨架。