核心用法
iaiops-renewables 是面向可再生能源行业的专业运维技能，专为光伏电站（光伏逆变器、组串汇流箱）和风电场（风机控制器）场景打造。启动时通过环境变量 IAIOPS_MCP=renewables 激活，自动加载 Modbus-TCP/RTU、OPC-UA、MQTT-Sparkplug B 三大工业协议栈及跨协议分析引擎。
典型工作流程：
1. 协议诊断先行：调用 protocols_supported 确认能力 → 执行 iaiops doctor 系统自检 → OPC-UA 场景优先 opcua_diagnose_connection 验证连通性
2. 组串性能排查：通过 modbus_apply_template 加载华为 SUN2000 或 Growatt 逆变器模板 → 读取各组串功率及辐照数据 → pv_performance 自动计算性能比，识别欠发组串（积灰/遮挡/熔丝断/组件失效）
3. 预测性维护：pdm_forecast 追踪逆变器温升趋势、风机轴承/齿轮箱劣化，输出到限时间预警
4. 停机根因分析：downtime_triage 快速分类停机事件，downtime_root_cause 深度挖掘根因
数据接入方式：
- Modbus：逆变器、汇流箱、风机控制器、智能表计（TCP/502 或 RTU/RS-485）
- OPC-UA：全站 SCADA 系统、PLC 网关（支持 DA+HA+AC，含历史数据读取）
- MQTT-Sparkplug B：电站遥测数据、IoT 网关、UNS（统一命名空间）架构
显著优点
1. 多协议深度融合
打破传统单协议工具孤岛，Modbus/OPC-UA/Sparkplug 三栈并行，自动识别 irradiance、wind_speed、rotor_speed、pitch、yaw、state_of_charge 等可再生能源专属语义，实现跨协议资产建模与统一分析。
2. 光伏专属智能诊断pv_performance 是核心差异化能力：自动计算组串性能比（支持预期功率输入或额定×辐照/1000 估算），以全场中位数为基准，worst-first 排序输出欠发组串，精准定位积灰、遮挡、熔丝熔断、组件失效等问题，无需人工逐串比对。
3. 工业级可靠性设计
- 字节序自动探测（
modbus_detect_byte_order）解决_endianness_ 兼容性痛点 - 厂商模板机制（华为 SUN2000、Growatt、通用风机）降低现场配置复杂度
- 只读设计原则，杜绝误操作导致的发电损失或设备损伤
4. 预测性维护闭环pdm_forecast 基于趋势外推，对逆变器温升、风机轴承/齿轮箱状态给出到限时间，变被动抢修为主动预防，延长资产寿命。
5. 企业级治理能力
内置数据质量评分（data_quality_scorecard）、OEE 多维分析（oee_multidim）、合规映射（compliance_mapping 含等保级别）、告警泛滥分析（alarm_flood_analysis）等模块，满足大型电站集团化运维需求。
潜在缺点与局限性
1. 模板依赖与验证状态
华为 SUN2000、Growatt 等厂商模板标记为「待核实」，实际部署需现场验证寄存器映射准确性，存在模板与固件版本不匹配风险。
2. 物理层接入限制
- Modbus-RTU 物理 RS-485 标注「待核实」，目前仅验证 socat PTY 模拟环境
- 缺乏对 IEC 61850（电力系统主流标准）、DNP3 等协议的支持
- 无 4G/5G 无线专网接入能力说明
3. 控制功能缺失
明确只读设计，逆变器限功率调节、风机偏航控制等需通过独立系统下发，本技能仅作监测分析，无法形成控制闭环。
4. 边缘计算部署未明确
未说明是否支持边缘网关本地部署（如 ARM 架构工业网关），大型电站海量测点场景可能存在云端传输带宽与实时性瓶颈。
5. 历史数据深度受限historian_query 等能力存在，但未披露与主流工业时序数据库（PI、eDNA、InfluxDB 工业版）的原生集成深度。
适合的目标群体
- 光伏电站运维团队：集中式地面电站、分布式工商业/户用光伏的远程运维人员
- 风电场资产管理方：陆上/海上风电场的 SCADA 工程师、可靠性工程师
- 新能源 EPC 与 OEM：逆变器、风机制造商的售后技术支持与远程诊断团队
- 电力集团新能源子公司：需要多电站集群管理、OEE 对标、合规报告生成的中后台人员
- 预测性维护服务商：为新能源资产提供第三方运维托管的 MSP（Managed Service Provider）
不适合纯消费级用户或无工业现场网络接入条件的场景。
使用风险
性能风险：多协议并发订阅高频率遥测点（如 1Hz 风机振动数据）时，需评估 asyncua 异步栈与 pymodbus 同步栈的协程调度效率，大规模部署建议前置协议网关做聚合。
依赖项风险：pymodbus>=3.5,<4、asyncua>=1.0,<2、paho-mqtt>=2.0,<3 版本锁严格，与现有 Python 环境可能存在依赖冲突；pyserial 串口驱动在跨平台（Windows/Linux/嵌入式）稳定性需实测验证。
数据质量风险：辐照传感器故障或校准漂移将直接导致 pv_performance 误判，建议配套 data_quality_scorecard 交叉验证传感器健康度。
网络安全风险：工业协议（Modbus-TCP/502、OPC-UA opc.tcp、MQTT/1883）默认无加密，生产环境必须配置 TLS/SSL（OPC-UA）、VPN 或专用 APN，严禁公网裸跑。
合规风险：等保 2.0/3.0 映射工具（compliance_dengbao_levels）为辅助参考，最终测评报告需以具备资质的第三方机构出具为准。