核心用法
iaiops-water 是面向水处理场景的工业智能运维（IAIOps）专用版本，支持三种主流工业协议的只读数据采集：
1. Modbus 协议族（TCP/RTU）
- 适用于加药撬、水质分析仪、流量计、泵站RTU等设备
- 提供寄存器读写、字节序自动探测、厂商模板套用等功能
- 内置健康摘要，自动对比pH 6.5-8.5等水质阈值
2. OPC-UA
- 对接全厂SCADA/PLC系统，支持DA（数据访问）、HA（历史访问）、AC（报警与条件）子集
- 提供节点浏览、批量读取、历史数据查询、报警事件订阅
- 自动语义建模，支持构筑物-工艺段-设备层级资产发现
3. HART-IP
- 经网关连接pH、浊度、电导率、液位、流量等过程变送器
- 读取主变量PV、动态变量、设备身份信息
- 支持主动采样与被动监听burst模式
核心工作流：先执行协议诊断 → 按模板读取水质参数 → 阈值合规判定 → 异常扫描与根因分析。所有工具表面强制只读，写入操作需切换profile并走MOC审批流程。
显著优点
多协议融合能力：单一技能覆盖水处理现场90%以上的数据采集场景，无需为不同设备类型切换工具。
水质专业深度：内置SWTR消毒CT合规计算、出厂水质合规判定（浊度≤1.0 NTU、余氯0.2-4.0 mg/L、pH 6.5-8.5），直接输出达标比与worst-first排序。
数据质量保障：针对水质仪表常见问题（电极老化flatline、数据 staleness、量程外值）提供显式检测，拒绝静默插值，确保坏数据可追溯。
故障诊断体系：跨协议的downtime root-cause分析、数据流诊断、报警泛滥分析，支持从仪表到PLC到SCADA的全链路问题定位。
信创合规支持：内置等保分级映射、合规证据包导出，满足国内水务行业监管要求。
潜在缺点与局限性
硬件依赖：HART-IP需额外安装pip install iaiops[hart]，且必须经过HART网关转换，无法直连变送器；物理RS-485现场验证状态为"待核实"。
只读约束：本edition明确禁止写操作，泵启停、加药量调节等控制指令无法通过本工具下发，需切换profile并走审批流程，紧急工况下响应延迟。
CT表缺失：消毒CT合规计算不内嵌各州CT查表数据，需调用方自行传入required_ct，增加集成复杂度。
学习门槛：需同时理解Modbus寄存器寻址、OPC-UA信息模型、HART命令集三类工业协议知识，对非自动化背景用户友好度一般。
实时性限制：burst监听功能状态为"待核实"，历史数据查询依赖OPC-UA HDA，部分老旧SCADA可能不支持。
适合的目标群体
- 水厂/污水厂自动化工程师：日常巡检、故障排查、阈值监控
- 水务集团数字化运维团队：多厂站资产统一管理、数据质量治理
- 环保合规专员：出水水质合规报告、消毒CT计算、等保审计证据收集
- 工业物联网集成商：快速接入水处理项目，避免重复开发协议栈
- 科研院校水处理实验室：过程数据采集、实验数据完整性保障
使用风险
性能风险：批量读取大量OPC-UA节点或高频HART burst监听可能占用显著网络带宽，建议在非生产高峰期执行全厂资产扫描。
依赖项风险：asyncua>=1.0,<2、pymodbus>=3.5,<4、hart-protocol>=2023.6,<2025等版本锁定较严格，与其他工业协议库共存时可能出现依赖冲突。
数据解释风险：Modbus字节序探测为启发式算法，分析仪浮点数解析仍存在误码可能；所有水质判定结果需人工复核后方可用于监管上报。
合规边界：本工具仅提供计算辅助，不替代人工化验与官方认证流程；等保相关功能需配合现场安全测评，不可直接作为过级依据。
运维连续性："待核实"功能（物理RS-485、真机HART网关burst）在关键场景中应准备备用采集方案。