axiom-energy-ref

用途：面向 iOS 开发者的能耗优化 API 参考，提供 Power Profiler 工作流与各类节能 API 的代码示例，来源为 WWDC 会话与 Apple 文档。相关技能：axiom-energy（决策树与模式）、axiom-energy-diag（故障排查）。

主要能力：

1. Power Profiler 工作流：有线（Xcode 连接设备、Product→Profile、添加 Power Profiler）与设备端录制（开发者模式、Performance Trace、控制中心快捷方式，最长 10 小时）。指标含 System/CPU/GPU/Display/Network Power Impact，为可比较的分数而非绝对值，需同设备前后对比。注意充电时系统功耗显示为 0，建议无线调试。
2. 定时器：Timer 设置 tolerance（建议至少 10%）、Combine Timer.publish、DispatchSourceTimer 的 leeway，以及用 dispatch source 事件驱动替代轮询。
3. 网络：URLSessionConfiguration 的 waitsForConnectivity、allowsExpensiveNetworkAccess、allowsConstrainedNetworkAccess；后台会话 isDiscretionary、earliestBeginDate、字节数预估与 delegate 处理。
4. 定位：CLLocationManager 的 desiredAccuracy、distanceFilter、pausesLocationUpdatesAutomatically；iOS 26+ CLLocationUpdate.liveUpdates 异步 API；CLMonitor 区域监控；各精度常量与耗电对照。
5. 后台执行：beginBackgroundTask、BGAppRefreshTask、BGProcessingTask（requiresNetworkConnectivity、requiresExternalPower）、iOS 26+ BGContinuedProcessingTask（进度上报、提交策略 .fail 或排队），并列出 EMRCA 原则（高效、最小、弹性、礼貌、自适应）。
6. 显示与 GPU：深色模式动态颜色（OLED 纯黑省电）、CADisplayLink 的 preferredFrameRateRange 控制帧率、不可见时停止动画。

使用方式：按需查阅对应 API 段落，复制示例代码到项目并按注释调整参数；后台任务需在 Info.plist 注册标识符。

限制：资料为 API 参考与示例，未提供完整项目集成步骤、版本兼容细节或效果保证；部分内容（如 MetricKit）在资料中仅提及名称，具体用法暂未提供。