Data & analysis

iaiops-water

Try it

Read water treatment PLCs, analyzers, and transmitters via Modbus, OPC-UA, and HART-IP with built-in compliance checks.

What it does

Connects to water and wastewater plants via Modbus-TCP/RTU, OPC-UA, and HART-IP to read dosing skids, analyzers, flow meters, and process transmitters (pH, turbidity, conductivity, level, flow). Includes water-treatment-specific tools for disinfection CT compliance and effluent quality checks, plus cross-protocol diagnostics for downtime root-cause, data quality scoring, and OEE analysis. All tool access is read-only by design.

When to use it

  • Daily water quality巡检 across multiple protocols
  • Diagnosing missing data or failed instruments at pump stations
  • Verifying disinfection CT and effluent compliance against permit limits
  • OEE and downtime analysis using historian data from water plants

The skill document

iaiops-water — 水处理 edition（Modbus + OPC-UA + HART + 脑）

启动：IAIOPS_MCP=water / iaiops-mcp-water（= modbus + opcua + hart + 脑； 等价显式写法 IAIOPS_MCP=modbus,opcua,hart）。HART 需 extra： pip install iaiops[hart]。典型现场：加药撬/分析仪走 Modbus，全厂 SCADA 走 OPC-UA，pH/浊度/电导率/液位/流量变送器走 HART（经网关）。

工具

Modbus-TCP / Modbus-RTU（只读；加药撬、分析仪、流量计、泵站 RTU）

  • modbus_read_holding modbus_read_input modbus_read_coils modbus_read_discrete
  • modbus_detect_byte_order — 字节/字序自动探测（分析仪浮点数常见坑）
  • modbus_list_templates / modbus_apply_template — 厂商寄存器模板 → 命名 tag
  • modbus_health_summary — 寄存器 vs 阈值分类（如 pH 6.5-8.5 带）

OPC-UA（只读；全厂 SCADA / PLC 网关）

  • opcua_server_info / opcua_browse / opcua_read_node / opcua_read_many
  • opcua_subscribe_sample opcua_read_alarms opcua_alarm_events(A&C 带时间戳) opcua_read_history(HDA)
  • opcua_diagnose_connection — 连接失败归因（证书/策略/认证/网络/配置）
  • opcua_discover_tags — 自动发现 + 语义资产建模（构筑物/工艺段/设备）
  • opcua_health_summary — tag vs 阈值分类；opcua_anomaly_scan — 有界统计异常扫描

HART-IP（只读；水质/过程变送器，经网关，端口 5094）

  • hart_device_identity — 通用设备身份（command 0）
  • hart_primary_variable — 主变量 PV（如 pH 值、NTU）
  • hart_dynamic_variables — PV/SV/TV/QV + 回路电流（command 3）
  • hart_burst_sample — 主动采样 burst 变量；hart_burst_listen — 被动监听 burst publish（待核实）

水处理专属（edition 工具;仅随 water edition 加载,不进全局脑）

  • disinfection_ct — SWTR 消毒 CT 合规:CT = 余氯(mg/L)×有效接触时间 T10(min);逐个 接触池算 achieved CT 对比所需 CT(按州 CT 表按温度/pH/消毒剂查得,由调用方传入),给达标比与 worst-first。纯分析,不内嵌 CT 表(传 required_ct);每比值引用输入。
  • water_quality_compliance — 出厂水质合规:逐采样点对浊度/余氯/pH 判限值(默认浊度 ≤1.0 NTU、 余氯 0.2–4.0 mg/L、pH 6.5–8.5;可按许可证覆盖),越界即 breach,worst-first,引用数值。

跨协议脑（永远随 server 暴露）

  • 诊断：diagnose_dataflow downtime_root_cause downtime_root_cause_live downtime_triage learn_cause_weights rca_corpus_from_maintenance historian_health alarm_bad_actors tag_health subscription_health heartbeat_health alarm_flood_analysis alarm_cascade alarm_rationalization_worksheet
  • 数据质量：data_quality_scorecard data_quality_fleet_rollup（水质仪表重点： 电极老化 flatline / staleness / 量程外 —— 坏数据绝不静默插值）
  • 分析：oee_compute downtime_events oee_multidim monitor_changes health_summary (deprecated) anomaly_scan (deprecated)
  • 资产：asset_inventory cross_protocol_asset_model adopt_alias_map diff_alias_map
  • 基线：baseline_learn baseline_check baseline_record_change baseline_status （change-log 基线：拒学薄历史、只报持续越带、每次告警必引基线样本 —— 非黑盒异常检测）
  • 合规/信创：compliance_mapping compliance_frameworks compliance_dengbao_levels compliance_report compliance_evidence_bundle historian_push export_data historian_query historian_coverage stream_publish stream_publish_event rca_narrate fleet_status fleet_incidents pdm_forecast historian_push export_data
  • 程序解读：plc_program_outline plc_program_xref plc_program_section plc_program_visibility（解读导出的 ST/AWL/L5X 程序,只读文件,强制引用行号）
  • 元：protocols_supported

Workflows

  1. Doctor-first：protocols_supported → iaiops doctor → HART 先 hart_device_identity，OPC-UA 先 opcua_diagnose_connection。
  2. Read-first：水质巡检 = modbus_apply_template/hart_primary_variable 读 pH/浊度/电导率 → opcua_health_summary 对阈值 → 异常用 opcua_anomaly_scan； 泵站"没数据"用 diagnose_dataflow，停机用 downtime_root_cause_live。
  3. MOC 写：本 edition 工具表面全只读（加药量/泵启停不经本工具下发）。 若现场确需写，须切到含写工具的 profile 并走统一 MOC：risk=HIGH + 默认 dry_run=True + 改前值 undo + iaiops approve 具名审批双确认。 未经授权绝不写生产控制系统。

支持版本矩阵（内部 HLD §8，设计文档不随本仓发布；待核实 不得当既成事实）

协议库(pin)规范/版本覆盖传输自测
Modbus-TCPpymodbus>=3.5,<4App 1.1b3；FC 1/2/3/4/5/6/15/16分析仪/加药撬/任意 TCP 从站TCP/502✅
Modbus-RTUpymodbus>=3.5,<4 + pyserial>=3.5Modbus serial (RTU)串口从站（泵站 RTU/表计）RS-485/serial✅ socat PTY verified 2026-07-02；物理 RS-485 待核实
OPC-UAasyncua>=2.0,<3OPC UA 1.0x（DA+HA+AC 子集）任意合规 Server / SCADAopc.tcp✅ mock+HDA
HART-IPhart-protocol>=2023.6,<2025（extra）HART-IP（经网关）水质/过程变送器UDP/TCP 5094⚠️ codec CI 自测；真机网关 待核实

Questions people ask

What protocols does this skill support?
Modbus-TCP, Modbus-RTU, OPC-UA, and HART-IP. All access is read-only. HART requires installing the extra hart dependency separately.
Can this skill write to PLCs or change pump/dosing setpoints?
No. This edition exposes only read tools. Write access requires a separate profile with explicit risk controls (dry-run default, dual approval required for production).
Does it replace the operator for dosing decisions?
No. The CT and water quality tools perform calculations and flag breaches against permit limits. The operator reviews the output and makes control decisions.

Related skills

k8s-aiops

Operate Kubernetes clusters with 55 audited tools — list resources, diagnose pod health, scale workloads, and manage rollouts safely.

by zw0081 installs1 stars

Cognitive Science Landscape

Diagnose which mental domain is holding you back before choosing a cognitive intervention.

by deciqai1 installs3 stars

Tunnel Vision & Slack

Escape the scarcity trap — diagnose bandwidth consumption and design protected slack to restore strategic capacity.

by deciqai1 installs2 stars

BATNA & ZOPA

Structured framework to analyze your alternatives and acceptable deal range before you commit

by deciqai1 installs3 stars

Gravity Field Empowerment

Measure whether a transformation changed your growth engine or just added a one-time bump.

by deciqai1 installs2 stars

Join meeting

Join video meetings as a voice bot, visual avatar, or avatar with live screen sharing.

by johnpatternai22 installs8 stars

More from zw008

Browse all skills

vmware-aiops

Operate VMware VMs, deployments, clusters, guest tasks, and alarms with plan and rollback support.

by zw00878 installs1 stars

vmware-monitor

Inspect VMware health, inventory, alarms, events, and performance without changing infrastructure.

by zw00876 installs

vmware-aria

Query Aria Operations metrics, alerts, capacity forecasts, anomalies, and reports from CLI or MCP.

by zw00853 installs

vmware-avi

Manage AVI services and pools, and diagnose AKO ingress, sync, certificates, analytics, and health.

by zw00851 installs

vmware-vks

Manage Supervisor Namespaces and TKC cluster lifecycles in vSphere Kubernetes Service.

by zw00851 installs

vmware-nsx

Manage NSX segments, gateways, routing, IP pools, health checks, and connectivity diagnostics.

by zw00850 installs