补充技能说明

.opencode/skills/analytics/simulation-analysis/burst-location/SKILL.md

@@ -20,3 +20,28 @@ version: 3.0.0
 | GET | `/api/v1/burst-location/schemes/{scheme_name}` | 获取爆管定位方案详情 | network (query), scheme_name (path) | - |
 
 - 覆盖方法：`GET, POST`
+
+## 接口说明
+
+| 接口 | 说明 |
+|---|---|
+| `POST /locate/` | 基于压力和流量SCADA数据定位管网中的爆管位置。通过对比爆管时与正常状态下的压力/流量差异，计算最可能的爆管节点。 |
+| `GET /schemes/` | 获取指定管网的所有爆管定位方案列表，可通过 query_date 按日期筛选。 |
+| `GET /schemes/{scheme_name}` | 获取指定名称的爆管定位方案详细配置，包含传感器布置、阈值参数等。 |
+
+## 请求体关键字段（POST /locate/）
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `network` | str | 管网名称（数据库名） |
+| `data_source` | str | 数据来源：`monitoring`（监测）或 `simulation`（模拟），默认monitoring |
+| `pressure_scada_ids` | list/null | 压力SCADA传感器ID列表 |
+| `burst_pressure` | dict/list/null | 爆管时的压力数据 |
+| `normal_pressure` | dict/list/null | 正常时的压力数据 |
+| `burst_leakage` | float | 爆管时的漏水量（必填） |
+| `flow_scada_ids` | list/null | 流量SCADA传感器ID列表 |
+| `burst_flow` / `normal_flow` | dict/list/null | 爆管/正常时的流量数据 |
+| `min_dpressure` | float | 最小压力差（bar），默认2.0 |
+| `basic_pressure` | float | 基准压力（bar），默认10.0 |
+| `scada_burst_start` / `scada_burst_end` | datetime/null | 从SCADA数据库查询的爆管时间范围 |
+| `use_scada_flow` | bool | 是否使用SCADA流量数据，默认false |