核心用法
iaiops-renewables 是专为可再生能源电站设计的工业物联网运维技能，支持光伏（PV）和风电两大场景。核心工作流遵循"诊断优先"原则：首先通过 protocols_supported 确认协议能力，再执行连接诊断。对于光伏电站，典型流程为应用厂商模板（如华为SUN2000、Growatt逆变器）读取组串功率与辐照数据，经 pv_performance 算法识别欠发组串（积灰、遮挡、熔丝熔断等故障）；对于风电场景，则通过 Modbus 读取风机控制器数据，结合 pdm_forecast 预测轴承/齿轮箱劣化趋势。全站 SCADA 数据通过 OPC-UA 接入，MQTT-Sparkplug 处理电站遥测，三者通过跨协议脑实现统一资产建模与告警关联分析。
显著优点
1. 多协议深度融合：同时支持 Modbus-TCP/RTU、OPC-UA、MQTT-Sparkplug B 三种工业标准协议，覆盖从设备级（逆变器、风机控制器）到站级（SCADA）再到云级（UNS架构）的全链路数据。
2. 光伏专属智能诊断：pv_performance 工具独创组串性能比算法，可基于额定功率、实测辐照或全场中位数自动计算预期发电量，精准定位 underperforming 组串，解决光伏电站运维中难以发现的组串级故障痛点。
3. 预测性维护能力：内置 pdm_forecast 支持逆变器温升趋势、风机轴承/齿轮箱状态预测，将运维模式从被动抢修转向主动预防。
4. 只读安全设计：本版本工具表面全为只读操作，避免误操作导致逆变器限功率或风机偏航等控制指令下发，降低现场安全风险。
5. 国产化信创合规：内置 compliance_dengbao_levels 等工具，支持等保框架映射与合规证据包生成。
潜在缺点与局限性
1. 模板状态待核实：华为 SUN2000、Growatt 等厂商模板标注为「待核实」，实际部署中可能需要字段校验或定制调整。
2. 物理串口待验证：Modbus-RTU 的物理 RS-485 连接仅通过 socat PTY 自测，真实工业环境下的串口稳定性未完全验证。
3. 控制功能缺失：纯只读设计虽保障安全，但无法实现远程参数整定、功率调节等控制闭环，完整 O&M 需配合其他系统。
4. 依赖工业网络可达性：需现场具备 TCP/502、opc.tcp、MQTT 等端口网络可达性，老旧电站改造存在网络基础设施门槛。
5. 设计文档未随仓发布：支持版本矩阵引用的内部 HLD §8 文档不公开，高级排障时可能缺乏底层设计参考。
适合的目标群体
- 光伏电站运维工程师：需快速排查组串欠发、积灰、遮挡等性能损失；
- 风电场技术主管：关注风机传动系统预测性维护与停机根因分析；
- 工业物联网集成商：为新能源客户构建 Modbus/OPC-UA/MQTT 多协议融合的数据中台；
- 能源资产管理方：需跨电站 fleet 级性能对标与数据质量评估；
- 信创合规专员：需满足电力行业等保要求的清洁能源项目。
使用风险
- 网络延迟风险：OPC-UA HDA 历史数据读取与 MQTT 遥测流在高延迟网络下可能出现采样中断或告警 flood；
- 协议版本兼容：OPC-UA 仅支持 1.0x 子集（DA+HA+AC），与部分新版 PLC 的 1.04 安全扩展可能存在互操作限制；
- 数据质量依赖：
pv_performance算法依赖辐照传感器精度，传感器漂移将导致误判； - 模板维护成本：逆变器固件升级可能导致寄存器映射变化，需持续维护
modbus_list_templates； - Python 依赖版本锁定：
pymodbus>=3.5,<4、asyncua>=1.0,<2等严格版本 pin 可能与其他 ML/数据分析库产生依赖冲突。