核心用法
iaiops-renewables 是面向光伏电站与风电场的工业智能运维专业版技能，通过多协议数据接入实现资产监控与性能诊断。启动时需设置 IAIOPS_MCP=renewables，典型部署场景包括：逆变器/组串汇流箱通过Modbus-TCP/RTU采集，全站SCADA经OPC-UA接入，遥测数据通过MQTT-Sparkplug B传输。
核心工作流遵循"Doctor-first"原则：先执行协议探测与连接诊断，再开展业务分析。对于光伏场景，推荐使用 modbus_apply_template 加载华为SUN2000或Growatt厂商模板，读取组串功率与辐照数据后，调用 pv_performance 执行欠发组串检测——该工具基于性能比算法（实际功率/预期功率），自动识别积灰、遮挡、熔丝熔断或组件失效等异常，按worst-first排序输出。风电场景则侧重 pdm_forecast 预测性维护，对风机轴承、齿轮箱温升趋势及剩余寿命进行建模预警。
跨协议脑层提供统一的资产管理与诊断能力：cross_protocol_asset_model 建立Modbus/OPC-UA/MQTT多源资产映射，downtime_root_cause 与 alarm_cascade 实现停机根因分析与告警风暴抑制，oee_compute 计算设备综合效率。数据质量方面，data_quality_scorecard 与 historian_health 保障时序数据完整性。
显著优点
协议覆盖全面：同时支持Modbus-TCP/RTU、OPC-UA（DA/HA/AC）、MQTT-Sparkplug B三大工业协议，适配光伏逆变器、风电控制器、智能电表及SCADA系统的异构接入需求。
领域语义深度内置：opcua_discover_tags 自动识别 irradiance、wind_speed、rotor_speed、pitch、yaw、state_of_charge 等可再生能源专属语义，降低标签映射配置成本。
算法即开即用：pv_performance 内置组串性能比计算与欠发检测算法，无需用户自行开发；pdm_forecast 融合趋势外推与到限时间预测，直接输出可执行的维护建议。
只读安全设计：全工具表面仅暴露读操作，逆变器功率调节、风机偏航控制等写操作被物理隔离，避免误操作导致生产事故。
合规与信创就绪：内置 compliance_mapping 支持等保级别映射与证据包生成，满足电力行业网络安全合规审计要求。
潜在缺点与局限性
厂商模板待核实：Huawei SUN2000、Growatt、Generic Wind Turbine 等模板标记为"待核实"状态，实际部署时可能需要根据固件版本调整寄存器地址映射。
物理串口未充分验证：Modbus-RTU经socat PTY自测通过，但物理RS-485总线的信号完整性、终端电阻匹配等工程问题仍需现场验证。
预测模型依赖数据质量：pdm_forecast 的轴承/齿轮箱寿命预测需历史振动或温度趋势数据支撑，新建电站冷启动阶段模型置信度较低。
Sparkplug B为可选依赖：MQTT相关功能需额外安装 paho-mqtt，未纳入核心依赖，可能因环境配置遗漏导致功能不可用。
无实时控制闭环：设计定位为监测诊断层，不支持AGC/AVC指令下发、有功功率调节等实时控制场景。
适合的目标群体
- 新能源电站运维工程师：日常巡检、组串故障排查、清洗策略优化
- 资产性能分析师：PR（性能比）计算、发电量损失归因、OEE多维分析
- 预测性维护工程师：风机传动系统状态监测、逆变器热管理趋势跟踪
- 系统集成商/SCADA开发商：多协议数据汇聚、统一命名空间（UNS）构建
- 电力行业合规审计人员：等保测评证据采集、网络安全合规报告生成
使用风险
网络隔离风险：Modbus-TCP/502、OPC-UA/opc.tcp、MQTT/1883 等端口需穿透生产网防火墙，存在网络安全暴露面，建议部署于DMZ或采用VPN/专线。
协议版本兼容性：OPC-UA实现基于 asyncua>=2.0,<3，部分老旧SCADA的UA协议可能存在子集兼容性问题；Sparkplug B 3.0与2.x版本存在Payload编码差异。
时序数据存储压力：historian_query 与 opcua_read_history 可能拉回大量高频采样数据，需评估边缘节点存储与内存峰值。
厂商模板漂移风险：逆变器固件升级可能导致寄存器表变更，模板化读取可能出现数据错位，建议关键点位启用 tag_health 进行合理性校验。
依赖项版本锁定：pymodbus>=3.5,<4、asyncua>=2.0,<3 等严格版本约束可能与其他Python依赖产生冲突，建议使用隔离虚拟环境部署。