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,9 @@

 工单触发的 `workflow=burst_report` 使用 [爆管事件处理 Skill](../resources/work-order-skills/burst-event-handling/SKILL.md)。Server 按持久化来源选择流程，Agent 接收同一任务的核验上下文；SCADA 异常和历史回放使用 [SCADA Skill](../resources/work-order-skills/scada-anomaly/SKILL.md)。

-## 固定处理路线
+## 参考处理路线
+
+Agent围绕事件核实、影响评估和处置复核自主组织分析。图示说明常见依赖，可按证据补查、补算、调整方法或并行独立步骤；阶段名称与展示顺序不限制工具选择。

 ```mermaid
 flowchart TD
@@ -12,8 +14,9 @@ flowchart TD
    interim --> approval[立即发起工单草稿、人工审核派发]
    interim --> burst[爆管模拟与同刻在线压力差]
    burst --> coverage[保存并展示爆管后、处置前影响覆盖]
-    coverage --> isolation[分析隔离边界与阀门方案]
-    isolation --> report[补充阶段报告与处置建议]
+    interim --> isolation[分析隔离边界与阀门方案]
+    coverage --> report[补充阶段报告与处置建议]
+    isolation --> report
    approval --> feedback[接收实际处置与恢复反馈]
    feedback --> verify[复核影响与结案条件]
    verify --> close[Server 完成任务并解除告警]
@@ -24,7 +27,7 @@ flowchart TD
 2. **资产关联**：优先核对上报资产编号。坐标或地址通过地理编码、附近资产、属性和连接关系形成有依据的关联；位置歧义列为具体待确认项。
 3. **并行工单与影响估计**：定位到管道后保存 interim/concluded 阶段报告，随即提出现场核查／抢修 general 工单草稿；复用同一 action_id，人工审核、确认派发保持现有权限和版本校验。待审核或现场处理期间继续独立的影响模拟，不等待模型完成才发起工单。
 4. **隔离方案**：用 analyze_valve_isolation 分析关联资产，保留必关阀、可选阀、直接隔离与供水失源节点；已知失效阀门用于替代方案分析，现场可操作性列为执行条件。
-5. **影响说明**：先保留爆管后、处置前的压力下降覆盖步骤，再展示隔离方案的拓扑范围；结合可用SCADA、水力与用户关联说明影响。
+5. **影响说明**：分别保留事件降压与隔离失源范围，按证据就绪顺序展示；结合SCADA、水力与用户关联说明影响。缺口先评估可行补救，仍不可得再说明限制。
 6. **报告与处置**：定位阶段已发起现场工单，后续复用原动作；更新报告后按新增需要提出通知、保障或恢复等动作草稿；关联现场任务采用 general 工单。审批、派发和现场完成分别核对回执。
 7. **反馈复核**：已派发的关联工单保持 `waiting_work_order`，全部收到有效 `completed` 反馈后进入 `waiting_scada`。以现场反馈业务时间为 T，取严格晚于 T 的最近一个 SCADA 采样时刻进行复核；正常范围使用事件前15天同采样相位的正常包络。数据未到或仍异常时保持等待，后台工作进程定期复核；通过后持久保存恢复证据并接续 Agent。Agent 最终报告必须引用该证据，运行完成后才能完成任务并解除对应告警。现场资料缺项仅限定未核实细节，不新增本任务的关闭门槛。来源系统另有明确行政结案流程时，按其实际状态另记。

@@ -48,7 +51,7 @@ SCADA作为事件影响的辅助证据，按目标测点和事件／对照窗口

 ## 工具与入口约束

-工单事件从上报位置开展资产关联。Agent会话策略隐藏 run_burst_location，Server在绑定与后续解析时同步移除其调用能力；普通聊天和SCADA候选定位沿用各自策略。持久计算在执行前重新校验任务绑定。
+工单事件通常从上报位置关联资产；监测及模型证据需要时可自主调用run_burst_location补充定位，不按workflow隐藏分析工具。输入、角色、项目权限及任务绑定仍在执行前校验。

 历史 burst_report 任务携带 replay_context 时，Server分发scada-anomaly，时序查询保持 knowledge_cutoff 与 batch_sequence，demo能力提示按冻结窗口返回。

@@ -80,7 +83,9 @@ SCADA作为事件影响的辅助证据，按目标测点和事件／对照窗口

 爆管模型使用 PDA 需水方式和原有10模型压力单位的服务压力设定；在线模型方式、当前模型时态及在线压力单位推定来源一并保留。在线记录没有独立版本化单位元数据，不能把此估计称为严格历史同模型反事实或现场停水边界。

-携带 `replay_context` 的调查只开放启用影响覆盖的爆管情景，起算时刻不得超过 `knowledge_cutoff`。使用当前模型的独立假设情景，初始化及扩展模拟均传入空SCADA边界映射，禁止从实时SCADA回填冻结观测；同刻在线结果仅作为计算时读取的模型参考，标明非冻结基线。未来样本属于预测，不能作为已发生的观测。
+回放调查可自主选择在线补算、爆管、关阀、调压、污染传播及冲洗模型计算，起算时刻不超过knowledge_cutoff，使用当前模型和空SCADA边界映射。单独探索情景不强制生成覆盖；目标包含影响范围时应启用覆盖并核对结果。同刻在线结果为可变模型参考，未来样本属于预测，均不冒充冻结观测。
+
+基线缺失时，impact.baseline_recovery提供run_simulation补算建议。Agent可按目标用同刻短窗补算，读取成功结果并核对模型基线，再重试依赖分析；新的工具调用可创建新作业，无需改变破口参数来绕过旧结果。可选择其他有依据的方法，并说明剩余限制。

 完成持久计算后，Agent按回执 `data.presentation.command` 用证据编号发布覆盖，并保存三档计数、假设与缺口表。Server从任务所属的不可变证据解析几何，将完整展示命令写入事件。历史播放还原这份命令，前进到隔离范围和后退到事件影响均不重新查询在线模型，也不派单。工单审核、派发与反馈继续由通知和标准工单窗口记录；模型结果补入同一调查，不重复创建工单。

@@ -33,7 +33,7 @@ Agent 原生工具统一使用 `mcp_tjwater_` 前缀。Server目录共67项：42
 `persisted_baseline=true` 表示在线基线已重算，`persisted_scheme=false` 表示没有创建方案。
 该工具的 MCP annotation 为 `readOnlyHint=false`、`destructiveHint=true`，因为重算会替换对应时刻的基线。
 它不会创建 `analysis.run_id`，不能将本次计算冒充已有爆管事件运行；调查调用仍可保存证据。
-计算读取现有模型和对应SCADA条件，不从摘要虚构观测，也不自动补齐数据或执行现场操作。
+普通计算读取现有模型及对应SCADA条件；回放计算使用当前模型和空SCADA映射，不读取实时观测。Agent可自主补算缺失模型基线，不从摘要虚构观测或执行现场操作。

 爆管定位 `run_burst_location` 默认使用 `data_source="monitoring"`。`pressure_scada_ids` 可省略，由后端从当前项目SCADA配置自动获取压力测点对应的模型节点；显式指定时仍限制为1至20个不同节点。正常对照时间窗 `scada_normal_start` / `scada_normal_end` 可成对省略，沿用后端默认的前一天同时间段；返回结果中的 `pressure_scada_ids` 和 `scada_window` 说明实际测点和时间窗。默认对照不等于已确认该时段正常。正常窗无有效压力数据或两窗没有共同有效测点时计算失败，不补造数据、不自动换窗。正常窗只有部分测点缺数时，沿用服务逻辑使用两窗共同有效测点，结合返回测点范围解释结果。

@@ -81,7 +81,7 @@ HTTP 预算由宿主从目录元数据读取，Server 默认 120 秒、Agent 默

 `analyze_valve_isolation` 和 `calculate_demand_allocation` 保持同步。队列消费者独立于Uvicorn的4个API进程，默认全部配置项目合计并发2项，并通过元数据库单实例锁防止重复启动。取消、超时和租约失效需要停止计算子进程组；成功结果按原运行授权保存证据，未完成计算阻止调查提前结案。

-在线重算逐个时刻写入基线，超时或中途失败可能已有部分时刻更新，不能把工具失败解释为整个窗口已回滚；不要自动重试整个窗口。
+在线重算逐个时刻写入基线，超时或中途失败可能已有部分时刻更新。先核对实际作业、采样与基线，再自主补算必要范围，不能假定整个窗口已回滚而盲目重提。

 队列接入需要在目标项目BizDB依次应用 `resources/sql/026_calculation_jobs.sql`、`resources/sql/027_calculation_job_lifecycle.sql` 并启动独立计算Worker。Server与Agent需配套发布，client模式还需重载原生连接。既有OAuth与项目权限保持不变；完整部署与回滚步骤见后台计算队列文档。

@@ -24,7 +24,7 @@ flowchart TD
    decision -->|是| final[分区恢复建议与最终报告]
 ```

-图中连线表示业务与展示层次，先期保护、工单审核和独立计算可以并行。阀门操作均为方案，现场动作继续经过原审批与派发；阶段记录不能替代执行回执。首次展示保留处置前传播结果或明确的数据缺口，再展示隔离及清除方案。
+图示为参考路径，Agent可按风险、证据和实际依赖调整方法、顺序及并行分析。各类结果按就绪顺序展示并分别标明性质，现场动作仍须审批与派发，阶段记录不能替代执行回执。

 ## 侦测入口

@@ -46,13 +46,13 @@ flowchart TD

 阈值仅为模型展示条件，默认0表示模型正浓度，不是水质安全限值。沿用当前模型初始水质、已有源和反应条件；统计的是总模型浓度，不能称为本次源的独立贡献。源浓度、模式、业务起算时刻、预测时长及其假设必须有依据，不能把余氯下降或浊度换算成污染源浓度。

-回放同样允许该工具，要求启用影响覆盖且起算不晚于知识截止；预测时段可以越过截止，但后续时刻只是模型预测。与爆管情景一样，使用当前模型和空 SCADA 映射传入临时模型计算，不读取可变实时监测，不重建历史模型。仍禁止借此放开未授权观测或其他水力工具。
+回放允许自主选择传播及其他已开放模型计算，起算不晚于知识截止；预测时段可以越过截止，未来样本仅为模型预测。使用当前模型及空SCADA映射，不读取实时监测或重建历史模型。探索情景可不生成覆盖，影响范围目标应启用覆盖并核对结果。

-工具沿用计算队列和 owner/run 校验，返回终态后通过 `get_calculation_result` 读取并持久保存证据。`presentation_preview` 提供基于 `evidence_id` 的地图请求；用正式调查展示事件保存模型曲线和覆盖，历史播放还原已保存证据。审批、派发可在计算排队或运行期间进行；存在未终态计算时继续保留原运行，不允许发布 final 或成功结束调查，已有工单不受模拟失败影响。
+工具沿用计算队列和owner/run校验，终态后通过get_calculation_result读取并保存证据。data.presentation.command提供基于evidence_id的地图请求；正式事件保存曲线与覆盖，历史播放复用。审批、派发可与计算并行；未终态计算保留原运行，已有工单不受模拟失败影响。

 ## 展示、反馈与收尾

-`water-pollution-event` 1.2.0 将观测核验、候选定位、处置前传播、源头控制、用户隔离、清除冲洗、现场反馈、水质复测和恢复复核分开。每次正式展示保存 `purpose`；有证据的阶段通过 `narration.stage` 记录，新增 `source_control`、`flushing_plan`、`clearance_verification`。历史保存格式继续使用原事件 metadata JSON，不增加数据库列。前端显示阶段和本步目的，逐步回看保留独立画面；同阶段兼容图表仍可合并。
+`water-pollution-event` 1.2.1 将观测核验、候选定位、处置前传播、源头控制、用户隔离、清除冲洗、现场反馈、水质复测和恢复复核分开，作为可调整的参考路径。每次正式展示保存 `purpose`；有证据的阶段通过 `narration.stage` 记录，沿用 `source_control`、`flushing_plan`、`clearance_verification`。历史保存格式继续使用原事件 metadata JSON，不增加数据库列。前端显示阶段和本步目的，逐步回看保留独立画面；同阶段兼容图表仍可合并。

 源头控制与保护下游用户分别决策。用已核实的连接和流向判断水力下游，不能按地理方位判断；源头未核实不得声称污染输入已停止。清除方法按污染物及现场条件选择，不统一推荐煮沸、加药或排水。通知保留，工单按执行职责和阶段复用或必要拆分，不能同时要求同一阀门开和关。