65 lines
9.2 KiB
Markdown
65 lines
9.2 KiB
Markdown
---
|
||
name: scada-anomaly
|
||
description: 从 SCADA 指标异常开展数据核验、爆管诊断、候选定位与影响分析。
|
||
metadata:
|
||
version: "1.0.21"
|
||
---
|
||
|
||
# SCADA 数据异常调查
|
||
|
||
目标是核验异常、判断原因和影响并形成处置依据。下文为参考流程，可按证据和依赖自主调整方法与顺序，补查、补算前置资料。核对任务、设备、单位、异常时刻、knowledge_cutoff及batch_sequence，使用本轮已提交观测，同一持续事件沿用原调查。证据来源字段用于记录数据取得方式，不构成停止分析的条件。
|
||
|
||
先按handling_context接续：待审批/工单/监测且无独立工作时，保存本轮interim/concluded及action_id后退出，不轮询。verification_ready复用原异常证据，只补恢复复核；初次分析按下文。
|
||
|
||
阅读时间按 Asia/Shanghai 换算，已有 +08:00 不重复换算，跨日更新日期。正文、标题、进展、表格和图表只写当地日期、时刻与单位，省略时区名称、偏移及原始时间戳；横轴用“时间”。查询、冻结边界和 sample_times 保留明确偏移。
|
||
|
||
## 数据核验与诊断
|
||
|
||
任一已配置压力、流量或压力模型信号异常即调查。先核验数据质量与测点，再判别原因；组合指标有缺口时继续核查单项异常。水质侦测使用独立 water_pollution / water-pollution-event 流程，与 water_quality_complaint 投诉分开，不计入爆管支持分。
|
||
|
||
通过 query_scada_readings 省略device_ids读取冻结异常窗内全部SCADA设备的完整属性和授权观测，覆盖压力、流量、水质等全部类型；正常对照也采用全量读取。Server自动读完所有设备页和观测页，完整返回devices、readings、coverage，结果仍受8MiB整份上限约束，超限明确报错后按时间分段，不能丢弃设备。query_complete表示查询已读完，缺测与无有效值另行判断。查询结束时间止于knowledge_cutoff，数据批次止于batch_sequence；冻结范围外设备单列，不回退实时数据。按需核查开始前15天基线，复用已有完整监测回执。结合monitored_value、cleaned_value和质量标记判断变化，可靠采集的低压与水质变化保留为业务异常。
|
||
|
||
全量devices含完整目录，readings含观测，coverage含各设备读数数量、缺测及冻结范围外清单。不得由代表测点推断全网。单查list_scada_devices默认每页100，读至page.has_more=false，属性缩略不代表完整信息。全量后可按device_ids局部复核并持续翻页，不能替代全量输入。final引用本轮knowledge_cutoff及batch_sequence的全量证据；Server拒绝局部或旧批次证据。
|
||
|
||
核对模型得分、压力变化与出厂边界流量的联合证据；权重、门槛、阈值、测点与基线留在依据。得分越低越异常，相似度非发生概率。区分边界与其他管流测点，规则零命中不代表无流量变化；其他异常按证据选择原因。
|
||
|
||
## 候选定位与隔离
|
||
|
||
综合分达到嫌疑门槛，或压力与模型证据支持高嫌疑时，继续候选定位。流量变化和现场确认作为证据维度，定位输入按当前工具要求准备。
|
||
|
||
检查摘要或 skill 响应顶层的 location_capability。available=true 时，用 run_burst_location 提交提示的异常窗、已核验的冻结正常对照窗及实际压力节点，burst_leakage 可省略。读取返回的候选管段与相似度，优先按 similarity_percent 展示百分比；只有 similarity 时，按0–1小数换算。取得候选后继续地图展示、隔离边界、节点覆盖与影响分析，完成报告后再收尾。其他定位路径使用有依据的漏量估计或明确情景假设。缺少定位输入时记录待补项，继续独立的资产、空间与拓扑核查。
|
||
|
||
取得候选即展示管道，发 interim/concluded 报告及现场工单草稿；复用action_id，待审批继续模拟。
|
||
|
||
run_burst_simulation设include_impact_coverage=true，用候选管道、异常时刻及有依据的破口面积cm²，按米水头分档1≤下降<3、3≤下降<5、下降≥5。基线缺失可自主用run_simulation补算同刻数据，读取成功结果后重试。其他缺口先按原因补查、补算或修正参数，仍不可用才记录限制。按data.presentation发布地图及计数，stage=event_impact；禁用关阀范围替代。回放模型计算不读实时SCADA，非冻结观测；历史展示复用保存证据。
|
||
|
||
按需用analyze_valve_isolation分析隔离边界，保留必关阀、可选阀、affected_nodes、supply_affected_nodes及计数；generate_node_coverage展示关阀覆盖，stage=isolation_plan；analyze_valve_closure可补水力影响。候选与建议待现场核验，展示按就绪顺序。候选用locate_features传event_kind=burst。
|
||
|
||
## 对比展示与影响
|
||
|
||
监测图必填chart.scada：role=current/comparison、metric=pressure/flow、unit、window_start/window_end（三小时）；series绑定device_id、day_offset=0..7。evidence_refs包含所有采样来源。报告scada_device_ids声明表格目标。Server在final及成功结束校验本轮总览和同期覆盖，SCADA_PRESENTATION_INCOMPLETE须补图；仅作参考不豁免。缺测须完整查询证明，保留null和设备图；scada.gaps由Server生成。恢复复核沿用恢复门禁。
|
||
|
||
先查询并发布以本轮knowledge_cutoff或异常时刻t为终点的[t-3小时,t]当前总览，覆盖地图定位、等级标记和表格列出的全部SCADA目标，含正常与异常测点。压力、流量按指标及单位分图，每设备一条序列，name带device_id；每图最多8组，超限按设备分图并用不同稳定chart_id。保留三小时内真实采样网格；截止非整刻不平移采样。超过100槽按连续时间分图，各用稳定chart_id，scada窗口仍填完整三小时；Server合并采样槽覆盖。低频无计划采样槽时，完整查询当天及历史窗口，以截止时刻单个null保留入口。缺测保留设备；“数据”视图沿用全部序列，报告附设备、单位、窗口、有效点数与缺测表。
|
||
|
||
定位输入具备后继续定位。压力、流量按设备另发七天同期复合图，不占用或替代全量当前总览。chart_type=time_comparison：x_data是UTC+8的HH:mm或HH:mm:ss共享槽，不拼接历史日期；当前[t-3小时,t]用series.type=line，前7天每天t-30分钟、t-15分钟、t用scatter。15分钟数据13槽，历史七组仅末3槽有值。每组sample_times与data等长，保留真实带时区日期；有效值与对应槽的本地时刻一致，缺测值和时间均null。当前曲线共用窗口，历史每组取此前某天对应窗口，跨午夜顺序排列；普通图用line/bar，坐标轴标单位。七天按t的本地日期回退，不含当天。按实际周期保留缺口，按需翻页并报告参考点数；基线未冻结、读取失败或缺测时说明并保留当前趋势，不退化为前一天或相邻两点。
|
||
|
||
影响说明比较异常前、异常期间及已有恢复观测，列压力、流量或水质变化、持续时间、测点与资产。同对象、单位、时段及条件计算变化量，区分观测、模型和拓扑结果；停水及漏量保留依据，缺恢复、用户或现场资料时明确限制。
|
||
|
||
## 范围与报告
|
||
|
||
观测保持本轮冻结窗口，后续观测由相应轮次处理。资产、空间与拓扑用当前模型；水力计算标明模型来源，定位保留权限、设备及冻结观测校验。
|
||
|
||
报告先写判断与依据，摘要建议150字、最多300字；多测点数值入Table，保留单位、方向和缺测，不相加不同影响集合。现场事项按回执列待办。现场工单与设备操作遵守服务端动作权限，恢复复核通过后闭环。
|
||
|
||
现场工单用propose_task_action（kind=create_work_order、work_order_type=general），注明对象、条件、回执及回放来源；有权限者确认派发，通知保留，报告完成不等于现场完成；回放禁设备命令。
|
||
|
||
## 完工后的恢复复核
|
||
|
||
工单completed后，以handling_context.returned_at为实际完工时间；Server取严格晚于该时刻的最近一帧及事件前15天同相位对照，保存恢复证据。回放同样适用，不推进回放或修改原冻结边界。
|
||
|
||
waiting_work_order等待完工；waiting_scada按last_check说明尚无后续采样、数据缺项或仍异常，等待监测复核。verification_ready时用get_task_evidence读取verification_evidence_id完整快照；工单completed且恢复证据status=passed时，发布final/concluded恢复闭环报告，同时引用原异常全量证据与当前恢复证据。Server完成运行后关闭任务并解除关联告警，phase=completed表示已闭环。阀位、漏点照片、现场复测数值等未提供时仅记为资料缺项，不新增现场核验、人工确认或更多采样的闭环条件。
|
||
|
||
恢复报告列反馈、完工与采样时间、全部复核测点及基线，说明单帧与模型边界，日常监测列建议。更新已解除的等待标记，保留路线与失败记录。
|
||
|
||
恢复观测由Server独立保存，原冻结上限不阻断此证据的使用；query_scada_readings仍遵守冻结窗口。完工时间修订后使用新证据编号，旧证据仅作历史。确有独立工作时再提议新动作。
|