核心用法
iaiops-renewables 是 IAIOPS 工业智能运维平台的可再生能源专用版本，专为光伏电站（PV）与风电场（Wind Farm）场景设计。启动方式：IAIOPS_MCP=renewables 或 iaiops-mcp-renewables，等效于同时加载 Modbus、OPC-UA、Sparkplug 三大协议栈及跨协议智能分析引擎。
核心功能模块
1. 多协议数据采集（只读）
- Modbus-TCP/RTU：接入华为 SUN2000、Growatt 等逆变器，组串汇流箱，风机控制器及智能电表，支持字节序自动探测与厂商模板快速配置
- OPC-UA：对接全站 SCADA 系统、PLC 网关，支持实时数据（DA）、历史数据（HDA）、报警与条件（A&C）订阅
- MQTT-Sparkplug B：接入电站 IoT 网关遥测数据，支持 UNS（统一命名空间）架构下的主题审计与模式漂移检测
2. 光伏专属分析
pv_performance：组串/逆变器欠发检测算法，基于性能比（Performance Ratio）计算，自动识别积灰、遮挡、熔丝熔断、组件失效等故障，输出 worst-first 排序清单
3. 跨协议智能大脑
- 预测性维护（PdM）：逆变器温升趋势、风机轴承/齿轮箱寿命预测
- OEE 计算与停机根因分析（RCA）
- 数据质量评分、基线学习、资产库存跨协议建模
- 合规支持：等保分级映射、信创证据包导出
典型工作流
1. Doctor-first 诊断：先执行连接诊断，确认协议链路健康
2. 欠发排查：应用逆变器模板 → 读取组串功率与辐照数据 → pv_performance 检测欠发 → 结合 pdm_forecast 监控设备劣化趋势
3. 停机告警处理：downtime_triage 快速定位根因，风机关键部件用 PdM 提前预警
显著优点
1. 多协议原生融合：Modbus（现场层）+ OPC-UA（控制层）+ Sparkplug（云端/IoT层）统一接入，打破光伏风电场常见的数据孤岛问题，无需额外中间件。
2. 领域语义深度优化：内置 irradiance、wind_speed、rotor_speed、pitch、yaw、state_of_charge 等可再生能源专属语义，opcua_discover_tags 自动归类，降低点表配置门槛。
3. 算法即服务：pv_performance 将传统需要 Excel 或 SCADA 二次开发的组串诊断算法封装为原子能力，直接输出 actionable insights。
4. 预测性维护闭环：从数据采集、特征提取、趋势预测到剩余寿命计算一站式完成，支持风机轴承、齿轮箱、逆变器关键部件的早期劣化发现。
5. 只读安全设计：全工具表面只读，控制指令（逆变器限功率、风机偏航）不经过本通道下发，满足电力生产安全分区要求。
潜在缺点与局限性
1. 协议版本覆盖有限：OPC-UA 仅支持 1.0x 版本的 DA/HA/AC 子集，未明确提及 OPC-UA PubSub；Modbus-RTU 物理 RS-485 环境标注「待核实」，生产环境需额外验证。
2. 厂商模板待核实：huawei_sun2000_inverter、growatt_inverter、generic_wind_turbine 等模板均标记为 待核实，实际寄存器地址、缩放因子可能需要现场调试校准。
3. 控制功能缺失：明确只读设计意味着功率调节、设备启停、参数整定等控制功能需通过其他系统（如电站AGC/AVC或独立控制通道）实现，本技能仅作为监测与分析层。
4. 依赖专业网络知识：现场部署涉及 Modbus TCP/502、OPC-UA opc.tcp、MQTT 1883/8883 端口规划，以及 UNS 架构设计，需要工业网络与电力自动化背景。
5. 设计文档未公开：「内部 HLD §8，设计文档不随本仓发布」，架构细节、安全模型、性能基线缺乏外部审计依据。
适合的目标群体
- 光伏电站运维工程师：日常组串故障排查、性能比分析、积灰遮挡识别
- 风电场技术主管：风机关键部件预测性维护、停机根因分析、OEE 报表
- 新能源 EPC/系统集成商：电站 SCADA 方案设计、多协议数据融合项目
- 工业数据分析师：新能源资产数据质量评估、跨协议资产建模、合规证据整理
- 信创/等保合规人员：新能源场站网络安全等级保护映射、审计证据包生成
使用风险
1. 依赖项版本锁定风险：pymodbus>=3.5,<4、asyncua>=1.0,<2、paho-mqtt>=2.0,<3 等严格版本约束可能与用户现有 Python 环境冲突，建议在隔离容器中使用。
2. 现场网络稳定性：Modbus-TCP over 电站局域网、OPC-UA 跨安全区通信、MQTT-Sparkplug 经防火墙/NAT 传输，任一链路抖动可能导致 pv_performance 输入数据缺失，产生误判。
3. 模板配置错误风险：厂商模板未经完全验证，寄存器地址偏移、数据类型（U16/I32/Float）错误会导致功率、辐照值读取异常，进而影响欠发检测准确性。
4. 只读假设被突破：虽然声明只读，但 mqtt_publish、sparkplug_node_list 等工具存在写入接口，若配置错误可能误操作现场设备，需严格权限管控。
5. 算法解释性局限：pv_performance 基于「额定×辐照/1000」或全场中位数估算期望功率，极端天气、组件衰减模型不一致时可能产生假阳性/假阴性，需结合现场经验人工复核。