核心用法
iaiops-water 是专为水处理场景设计的工业AI运维技能，采用纯只读架构保障生产安全。启动时通过 IAIOPS_MCP=water 激活，支持三种工业协议栈：Modbus-TCP/RTU 用于加药撬、分析仪、流量计及泵站RTU；OPC-UA 对接全厂SCADA/PLC系统；HART-IP 经网关读取pH、浊度、电导率、液位等过程变送器数据。
标准工作流程遵循"Doctor-first"原则：先执行协议探测与诊断，确认连接健康后再进行数据读取。水质巡检场景下，通过模板化寄存器映射读取仪表数据，结合阈值分类与统计异常扫描实现智能监控；泵站"无数据"或停机场景则调用数据流诊断与实时根因分析工具。
水处理专属工具包括消毒CT合规计算（SWTR标准）与出厂水质合规判定，支持浊度、余氯、pH等关键指标越界检测。跨协议脑层提供设备故障根因分析（RCA）、数据质量评分、OEE多维计算、报警泛滥分析等高级功能，并支持PLC程序解读与信创合规映射。
显著优点
工业级协议覆盖：完整支持水处理现场最常见的三大协议族，Modbus侧提供字节序自动探测与厂商模板库，解决分析仪浮点数解析难题；OPC-UA侧实现DA/HA/AC子集，支持历史数据访问与报警事件订阅；HART-IP侧覆盖主流水质变送器协议。
安全优先设计：工具表面全只读，彻底杜绝误操作风险；若现场确需写操作，强制切换profile并走统一变更管理（MOC）流程，包含高风险标记、dry_run默认值、改前值undo及双确认审批机制。
水质专业深度：内置SWTR消毒CT计算、多指标水质合规判定，电极老化检测（flatline/staleness/量程外）等水处理专属能力，非黑盒的基线学习机制确保每次告警可追溯。
智能诊断能力：跨协议数据流诊断可定位"有连接无数据"类隐形故障；实时根因分析支持停机现场快速定责；报警泛滥与级联分析帮助优化HMI设计。
潜在缺点与局限性
物理层验证待完善：HART-IP真机网关测试标记为"待核实"，RS-485物理串口验证未完全覆盖，现场部署前需额外兼容性确认。
写操作需外部切换：本edition完全只读，任何控制类操作（加药量调整、泵启停）必须切换至含写工具的profile，可能增加运维流程复杂度。
CT表依赖外部输入：消毒CT合规计算不内嵌各州/地区CT查表数据，required_ct需由调用方传入，对使用者的行业知识有一定要求。
信创合规工具体系较新：compliance_dengbao_levels等信创相关工具处于早期阶段，实际等保测评场景下的证据链完整性需项目验证。
适合的目标群体
- 水务集团/自来水公司：水厂工艺工程师、自动化班组、水质化验室，用于日常巡检、合规报告、异常溯源
- 环保运营企业：污水处理厂运维团队，关注曝气池、加药系统、泵站群的状态监控与能效分析
- 工业自动化集成商：水处理项目的SCADA集成、数采网关部署、 historians 对接实施人员
- 设备厂商售后服务：pH/浊度/电导率分析仪、电磁流量计、加药撬设备的远程诊断支持团队
使用风险
性能风险：OPC-UA历史数据批量查询、跨协议资产模型构建可能产生高内存占用，大规模标签（>10万点）场景建议分片采样验证。
依赖项风险：HART-IP功能需额外安装 pip install iaiops[hart]，且依赖 hart-protocol 库的稳定性，该库版本约束为2023.6-2025区间，需关注上游更新。
数据质量风险：水质仪表电极老化导致的flatline或staleness若未配置合理阈值，可能被误判为正常稳定运行；建议结合 data_quality_scorecard 定期巡检仪表健康度。
网络隔离风险：Modbus-TCP/502、OPC-UA/opc.tcp、HART-IP/5094均为明文协议，生产网与办公网打通场景需严格遵循等保2.0/3.0的网络安全架构设计，避免直接暴露工控协议端口。