核心用法
iaiops-water 是面向水处理行业的工业智能运维技能，通过统一的 MCP 接口整合三大工业通信协议：
协议接入层：
- Modbus-TCP/RTU：连接加药撬、分析仪、流量计、泵站RTU等设备，支持字节序自动探测和厂商寄存器模板应用
- OPC-UA：对接全厂SCADA/PLC系统，提供节点浏览、订阅采样、历史数据读取(HDA)、报警事件采集(A&C)及连接诊断
- HART-IP：经网关读取水质/过程变送器（pH、浊度、电导率、液位、流量），支持设备身份识别和动态变量采集
水处理专属功能：
disinfection_ct：按SWTR标准计算消毒CT值，对比温度/pH条件下的所需CT，输出达标比与worst-first排序water_quality_compliance：逐点判读浊度/余氯/pH合规性，默认限值可覆盖，越界即标记breach
跨协议智能层：
- 诊断：数据流诊断、停机根因分析(实时/历史)、报警泛滥分析、级联分析
- 数据质量：电极老化flatline检测、staleness监控、量程外标记，拒绝静默插值
- OEE计算、基线学习/检查、资产建模、PLC程序解读（ST/AWL/L5X只读）
典型工作流遵循"Doctor-first→Read-first"原则：先执行协议诊断，再读取数据，异常时启动根因分析。
显著优点
1. 协议覆盖完整：水行业三大主流协议(Modbus/OPC-UA/HART)一站式集成，无需多工具切换
2. 行业深度定制：内置SWTR消毒CT计算、出厂水质合规检查，符合EPA及国内水司规范
3. 数据质量透明：明确标记坏数据(flatline/staleness/out-of-range)，拒绝黑盒插值，保障分析可靠性
4. 只读安全设计：本edition全工具表面只读，消除误操作风险；写操作需切换profile并走MOC审批
5. 根因分析能力：跨协议数据关联，支持停机根因实时推断和报警理性化分析
6. 信创合规支持：内置等保分级映射、合规证据包导出，满足国内关键基础设施要求
潜在缺点与局限性
1. HART-IP真机待验证：codec已通过CI测试，但真实网关环境标注"待核实"
2. Modbus-RTU物理层局限：RS-485物理串口验证待完成，目前仅socat PTY验证
3. CT表外置依赖：消毒CT计算不内嵌州CT表，需调用方传入required_ct，增加集成复杂度
4. 写操作受限：生产控制写操作(加药量调整、泵启停)不在本edition，需切换profile
5. PLC程序解读范围：仅支持导出文件的离线解读，不支持在线PLC程序直接读取
6. 语言混合：界面输出中英文混合，国际化体验待完善
适合的目标群体
- 自来水厂/污水厂：工艺工程师、自动化工程师、水质化验员
- 环保运维公司：负责多水厂托管运营的技术团队
- 系统集成商：水行业SCADA/MES集成项目的实施团队
- 设备厂商：加药设备、分析仪、泵站RTU的远程运维服务团队
- 监管机构/水司：需要合规证据包和水质数据审计的技术管理方
使用风险
| 风险类别 | 具体描述 | 缓解措施 |
|---------|---------|---------|
| **网络连接风险** | OPC-UA证书/策略配置错误导致连接失败 | 使用`opcua_diagnose_connection`前置诊断 |
| **数据质量风险** | 电极老化导致flatline，若未检测则误判水质正常 | 启用`data_quality_scorecard`监控 |
| **协议版本风险** | HART-IP网关版本差异导致采集异常 | 优先`hart_device_identity`确认设备身份 |
| **基线学习风险** | 历史数据不足时基线学习失效 | 系统自动拒绝薄历史学习，需人工确认 |
| **合规引用风险** | CT计算依赖外部传入的required_ct | 需确保CT表来源权威（州/国标） |
| **性能风险** | 大规模tag订阅可能影响SCADA性能 | 使用`opcua_subscribe_sample`控制采样频率 |
| **误操作风险** | 误以为本工具支持写操作 | 明确区分read-only edition与write-capable profile |