fix(investigation): allow autonomous model baseline recovery

2026-11-15 12:37:08 +08:00
parent 58a907bfbe
commit 747e9e53e0
22 changed files with 324 additions and 96 deletions
@@ -2,7 +2,7 @@
 name: appointment-follow-up
 description: 核查关联预约工单的审批、提交、现场执行和反馈，分别判断预约履约与原事件闭环。
 metadata:
-  version: "2.0.4"
+  version: "2.0.5"
 ---

 # 预约任务跟进
@@ -13,7 +13,7 @@ metadata:

 读取当前任务、关联工单、已有报告、证据、动作和最新反馈，核对预约时间、地点、负责人、工作内容及回执要求；需要时追溯关联的投诉或爆管。新一轮优先检查新增事实和旧未决项，保留本流程名称和版本。

-围绕原工作目标完成必要核查：
+以下为参考核查路径，围绕原工作目标自主选择方法、调整顺序并补齐可查询或推导的资料。反馈缺项先核对已有来源和证据，不因首次缺数直接停止；新增现场事实仍以实际回执为准：

 1. 将要求与来源工单最新版本逐项对照，区分预约、派发、到场、完成和原事件发生时间，不用创建或更新时间替代现场时间，也不因预约已过推定已经执行或失约。
 2. 核对动作的审批、提交、执行状态和回执。`approved` 只表示允许提交，`submitted` 只表示已接收，`succeeded` 的建单动作只证明工单创建成功；这些状态均不证明采样、通知、抢修、冲洗或复测完成。`unknown` 由 Server 复核原执行请求，不重复下发。
@@ -2,12 +2,12 @@
 name: burst-event-handling
 description: 根据爆管上报工单处理事件，完成资产关联、隔离方案、影响说明、处置建议与反馈复核。
 metadata:
-  version: "1.1.5"
+  version: "1.1.6"
 ---

 # 爆管事件处理

-适用于工单触发的 `workflow=burst_report`。以工单上报的事件位置和资产线索开展处置，依次完成下列步骤；每一步给出实际结果或具体待补项，已有证据可直接复用。SCADA 异常发现使用独立的 scada-anomaly 流程。
+适用于工单触发的 `workflow=burst_report`。目标是核实事件、评估影响并提出处置与复核依据。以下为参考流程，按证据和依赖自主选择、调整或并行步骤，复用已有成果，补查或补算可取得的前置资料。SCADA 异常发现使用独立的 scada-anomaly 流程。

 先按handling_context接续：等待阶段按第7节保存本轮阶段报告；verification_ready复用已有异常分析与资产、隔离证据，仅补反馈和恢复复核，不重跑初次调查步骤。真正新增的独立事实另行核查。

@@ -23,6 +23,8 @@ metadata:

 爆管候选管段用 locate_features 传 event_kind="burst" 定位。在地图展示上报位置和关联资产，标明关联依据及现场确认状态。存在多个合理对象时保留候选及选择理由；关键位置需要人工补充时，先完成独立工作，再用 ask_task_user 提问。

+上报位置与资产不足以区分候选时，可按现有监测和模型证据自主选择 run_burst_location 等补充分析；准备工具要求的输入，保留假设，不因工单来源限制分析方法。
+
 定位到管道后立即保存 interim/concluded 阶段报告，明确“候选管段待现场核验”，调用 propose_task_action 提出 kind=create_work_order、work_order_type=general 的现场核查／抢修草稿，引用定位证据、地点和管段；沿用已有 action_id，不重复建单。人工审核、派发按 Server 权限与版本完成。审批或现场处理等待期间，继续独立的爆管影响模拟和隔离分析，不等模拟完成才发起工单；模拟结果补入同一调查与后续报告，不能把模型计算成功写成已派单。

 ## 3. 爆管后、处置前的影响范围
@@ -31,7 +33,7 @@ metadata:

 工具在筛选展示节点前比较全网节点的起算同刻在线模拟压力，换算米水头，三档互斥：1≤下降<3、3≤下降<5、下降≥5。只用同刻有效值，不以代表节点、邻近时刻或缺失值代替；保留缺测、单位来源、模型时态、比较节点数及覆盖缺口。范围表示爆管后、关阀或抢修前的模型估计，单独于隔离失源范围。

-读取计算结果后按 data.presentation.command 的 evidence_id 用 publish_task_presentation 发布“爆管后、处置前的预计影响范围”，并发布三档节点计数、比较时刻和假设表；无地图几何时说明原因。证据、地图及表格进入正式任务事件，历史播放还原已保存结果，不重新查询在线基线。本步 narration.stage 用 event_impact。三级结果 unavailable 时单列原因和待补项；先保留此步骤，再展示隔离方案，不得用关阀覆盖替代。
+读取结果后按 data.presentation.command 发布预计降压范围和分档计数、比较时刻及假设，narration.stage 用 event_impact。基线缺失时可自主用 run_simulation 补算同刻数据；等待成功并读取结果后重试依赖计算，不靠扩大破口面积修复基线缺失。其他失败按原因选择补查、修正参数或替代方法，补救后仍不可用才列具体限制。事件降压与关阀范围分别保存，展示按结果就绪顺序发布；历史播放复用保存证据。

 ## 4. 隔离方案

@@ -2,14 +2,14 @@
 name: burst-report
 description: 爆管业务流程的历史入口索引，运行时按事件来源选择独立 Skill。
 metadata:
-  version: "2.0.11"
+  version: "2.0.12"
 ---

 # 爆管业务流程入口

 Server 根据绑定任务的 workflow 和 replay_context 分发当前流程：

- 工单触发的 burst_report：使用 burst-event-handling，依次完成接收核对、地点与资产关联、隔离方案、影响说明、处置建议和反馈复核。
+- 工单触发的 burst_report：使用 burst-event-handling，围绕事件核实、资产关联、影响评估、处置建议和反馈复核自主组织分析。
 - SCADA 异常及带 replay_context 的历史回放任务：使用 scada-anomaly，完成冻结数据核验、诊断、候选定位与隔离影响分析。

 通过 get_task_context 的 section="skill" 读取实际流程，保留返回的 name、version、content_sha256。工具范围由绑定任务的服务端策略及 Agent 会话策略共同确定。
@@ -2,12 +2,12 @@
 name: scada-anomaly
 description: 从 SCADA 指标异常开展数据核验、爆管诊断、候选定位与影响分析。
 metadata:
-  version: "1.0.20"
+  version: "1.0.21"
 ---

 # SCADA 数据异常调查

-读取任务与 replay_context，核对设备、单位、异常时刻、knowledge_cutoff 和 batch_sequence。使用本轮已提交的 SCADA 观测开展调查，同一持续事件沿用已有调查。证据来源字段用于记录数据取得方式，不构成停止分析的条件。
+目标是核验异常、判断原因和影响并形成处置依据。下文为参考流程，可按证据和依赖自主调整方法与顺序，补查、补算前置资料。核对任务、设备、单位、异常时刻、knowledge_cutoff及batch_sequence，使用本轮已提交观测，同一持续事件沿用原调查。证据来源字段用于记录数据取得方式，不构成停止分析的条件。

 先按handling_context接续：待审批/工单/监测且无独立工作时，保存本轮interim/concluded及action_id后退出，不轮询。verification_ready复用原异常证据，只补恢复复核；初次分析按下文。

@@ -31,9 +31,9 @@ metadata:

 取得候选即展示管道，发 interim/concluded 报告及现场工单草稿；复用action_id，待审批继续模拟。

-run_burst_simulation设include_impact_coverage=true，用定位管道、异常时刻及有依据的破口面积cm²。全网同刻在线压力差按米水头分档1≤下降<3、3≤下降<5、下降≥5。按data.presentation发布地图及计数，narration.stage=event_impact；不可用时单列原因，禁用关阀范围替代。回放仅用当前模型、禁实时SCADA；在线参考非冻结观测，历史展示复用保存证据。
+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。候选与拓扑建议标注为待现场核验方案。爆管候选用locate_features传event_kind=burst。报告前核对定位结果，失败列明错误与缺口。
+按需用analyze_valve_isolation分析隔离边界，保留必关阀、可选阀、affected_nodes、supply_affected_nodes及计数；generate_node_coverage展示关阀覆盖，stage=isolation_plan；analyze_valve_closure可补水力影响。候选与建议待现场核验，展示按就绪顺序。候选用locate_features传event_kind=burst。

 ## 对比展示与影响

@@ -43,22 +43,22 @@ run_burst_simulation设include_impact_coverage=true，用定位管道、异常

 定位输入具备后继续定位。压力、流量按设备另发七天同期复合图，不占用或替代全量当前总览。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，保留单位、方向与缺测。区分各阶段测点数，不相加不同影响集合。现场事项按回执列待办。现场工单与设备操作遵守服务端动作权限，恢复复核通过后闭环。
+报告先写判断与依据，摘要建议150字、最多300字；多测点数值入Table，保留单位、方向和缺测，不相加不同影响集合。现场事项按回执列待办。现场工单与设备操作遵守服务端动作权限，恢复复核通过后闭环。

 现场工单用propose_task_action（kind=create_work_order、work_order_type=general），注明对象、条件、回执及回放来源；有权限者确认派发，通知保留，报告完成不等于现场完成；回放禁设备命令。

 ## 完工后的恢复复核

-关联工单completed后，以handling_context.returned_at为实际完工业务时间，不用创建、预约或电脑当前时间代替。Server读取严格晚于该时刻的最近一帧及事件前15天同相位对照，独立保存恢复证据。回放来源工单同样适用，不推进回放，原knowledge_cutoff与batch_sequence不变。
+工单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仍遵守冻结窗口。完工时间修订后使用新证据编号，旧证据仅作历史。确有独立工作时再提议新动作。
@@ -2,13 +2,15 @@
 name: water-pollution-event
 description: 水污染侦测后的观测核验、候选溯源、源头控制、用户隔离、清除冲洗与水质复测。
 metadata:
-  version: "1.2.0"
+  version: "1.2.1"
 ---

 # 水污染侦测事件调查

 适用于 workflow=water_pollution，与 water_quality_complaint 投诉分开，不依赖爆管评分、漏量或压力流量异常。侦测信号、候选污染源、污染确诊和恢复供水分别说明。

+目标是核验风险、来源、影响及处置恢复依据。以下为参考流程，可自主调整方法、顺序，补查参数并比较明确假设；缺口先补救，保护措施及时提出。
+
 读取任务、信号、时间、handling_context 和已有成果。回放遵守 knowledge_cutoff、batch_sequence；阅读时间 Asia/Shanghai，查询与 sample_times 带时区。后续轮次复用成果，优先新增事实。

 ## 1. 核验观测与先期保护
@@ -25,15 +27,15 @@ query_scada_readings 省略 device_ids，读取异常前三小时全量 SCADA，

 ## 3. 处置前污染影响

-run_contaminant_simulation 设 source=located_node、include_impact_coverage=true，采用事件起算时刻、明确预测时长和需画曲线的 output_node_ids。concentration 为 mg/L，须有来源或说明情景假设，不能把浊度、余氯下降或感官描述直接换算成污染源浓度。缺依据时列具体参数缺口，继续工单和独立分析。
+run_contaminant_simulation 设 source=located_node、include_impact_coverage=true，采用事件起算时刻、明确预测时长和需画曲线的 output_node_ids。concentration 为 mg/L，须有来源或说明情景假设，不能把浊度、余氯下降或感官描述直接换算成污染源浓度。可自主补查来源、比较明确假设的浓度或时长；不可推断的现场事实才列具体缺口，继续工单和独立分析。

 impact_threshold_mg_l 默认0、严格大于，仅供展示，非饮用水安全限值。全网整个时段汇总累计节点、首个超阈值采样时刻、峰值与覆盖；沿用初始水质和反应条件，非源独立贡献，范围外不等于安全。

 queued/running 时继续独立工作，get_calculation_job 跟踪、get_calculation_result 读终态。未完计算不能 final，由宿主等待接续；待审批不阻止分析，模拟失败不撤回工单。

-按 presentation_preview.evidence_id 发布“水污染传播预计影响范围（处置前情景）”、参数与计数表及浓度曲线；模型曲线不填观测专用 chart.scada。保存正式事件供历史复用；空范围、缺测、单位及几何限制单列。先保留污染传播步骤，再展示隔离范围，不以隔离覆盖替代传播范围。
+按返回的data.presentation.command发布“水污染传播预计影响范围（处置前情景）”、参数与计数表及浓度曲线；模型曲线不填观测专用chart.scada。空范围、缺测、单位及几何问题先核对可行补救，再列剩余限制；传播与隔离分别保存，不以隔离覆盖替代传播范围。

-回放允许传播及冲洗情景，起算不晚于知识截止，使用当前模型且不读取实时 SCADA；未来样本仅预测，非历史重建。
+回放允许在线基线补算及传播、关阀、调压、冲洗情景，起算不晚于知识截止，使用当前模型且不读取实时SCADA；未来样本仅预测，非历史重建。

 ## 4. 源头控制与用户隔离

@@ -47,7 +49,7 @@ analyze_valve_isolation 设 accident_element=[located_node]、accident_element_t

 先说明污染物性质、处理依据和未知项，再提出排空、冲洗、消毒或其他适用处理；不得默认任何污染都能冲洗清除。排放去向及污染水收集处理须有依据，不默认排入雨水、河道或普通排水口。

-核对清洁水源、排放点、流量及许可条件后用 analyze_flushing。每阶段保存目的、前置条件、清洁进水依据、排放去向、完整开关阀清单、顺序、流量、时长、预计水量、监测和待办。隔离和冲洗不能共用固定关阀清单，进水阀打开不等于用户复供；缺参数仅停依赖分支。
+核对清洁水源、排放点、流量及许可条件后用analyze_flushing。阶段记录目的、条件、进排水依据、完整阀态、顺序、流量、时长、水量、监测及待办。隔离和冲洗按各自目标选阀，进水阀打开不等于复供；缺参数先补查。

 opened_valves 明确开阀、closed_valves 指定关闭阀门，两者互斥。每次是独立当前模型情景，未列阀门沿用模型状态，不继承上次模拟；重列本阶段必要阀态，不能称为连续污染清除。flushing_plan 保存方案及估计排放量，仅证明水力结果，不验证清洁进水、排放合规或现场执行。尚未耦合停止输入后的水质衰减，压力、流量或模型零浓度不能替代复测。

@@ -57,9 +59,9 @@ opened_valves 明确开阀、closed_valves 指定关闭阀门，两者互斥。

 水质 chart.scada 填 metric=quality、unit、role、完整三小时 window_start/window_end，总览覆盖全部目标。逐设备 time_comparison 用当前 line、七天每天末三真实槽 scatter；series 带 device_id、day_offset、等长 sample_times，缺测 null。不同指标或单位分图，超限分段，不标成流量。

-展示依次为观测、候选、传播、源头控制、隔离、冲洗、反馈、复测、恢复；计算可并行，首次隔离展示须在传播结果或缺口说明之后，通知和工单不等待展示。发布填写具体 purpose；有证据时带 narration（stage、summary、evidence_refs）。沿用原阶段，源头控制用 source_control、冲洗用 flushing_plan、水质复测用 clearance_verification。阶段不等于批准或已执行，不为凑阶段造证据或空操作。
+展示随证据就绪发布，按观测、候选、传播、源头控制、隔离、冲洗、反馈、复测和恢复标明性质与依赖，无需等待其他独立分析或固定播放顺序。通知和工单不等待展示。发布填写purpose及有依据的narration（stage、summary、evidence_refs）；源头控制用source_control、冲洗用flushing_plan、水质复测用clearance_verification。阶段不等于批准或已执行，不为凑阶段造证据或空操作。

-报告依次写事件概况、观测、候选与传播、源头控制、用户隔离、清除冲洗、反馈复测及恢复条件；各项列结论、对象、预计或实际、证据和待办。操作表保留阶段、阀态、进排水、条件、反馈及复测依据。引用本轮全量 SCADA 和已取得的分析证据；权限拒绝不写成无数据。各阶段独立保存，回放不合并吞步骤，不派单或操作设备。
+报告按风险与结论组织，覆盖观测、候选、传播、源头控制、隔离、清除及复测恢复，区分预计与实际。操作表保留阀态、进排水、条件和反馈依据。引用本轮全量SCADA与分析证据；权限拒绝不写成无数据。阶段独立保存，历史播放不派单或操作设备。

 ## 7. 工单反馈与复测恢复

@@ -2,7 +2,7 @@
 name: water-quality-complaint
 description: 调查供水水质投诉，核查投诉与监测覆盖，评估候选原因、影响和采样处置建议。
 metadata:
-  version: "2.0.4"
+  version: "2.0.5"
 ---

 # 水质投诉处置
@@ -15,7 +15,7 @@ metadata:

 ## 风险与工程分析

-根据当前证据选择必要步骤：
+以下为参考核查路径，根据当前证据选择必要步骤，自主调整顺序、查询范围、工具组合及模型情景。可通过补查、推导或有说明的假设解决的缺口先处理，确需现场事实或人工决策时再提问：

 1. 核实投诉位置及相近时段的同类投诉，用 `query_peripheral_data` 按实际时间、位置和来源标识核对外围工单或观察。目录首屏不能证明没有其他投诉；未知点位先查目录，不猜编号或把演示点当真实资产。
 2. 解析未知地址，查询附近资产、属性和连接，区分上游、管网、末梢、二次供水和用户端的实际覆盖。地点明确后展示投诉位置，取得关联资产后展示正在核查的管段或节点。拓扑连接不等于实际流向，方向判断需要同窗模型或监测依据。