补充技能说明

.opencode/skills/analytics/simulation-analysis/leakage/SKILL.md

@@ -20,3 +20,27 @@ version: 3.0.0
 | GET | `/api/v1/leakage/schemes/{scheme_name}` | 获取漏损识别方案详情 | network (query), scheme_name (path) | - |
 
 - 覆盖方法：`GET, POST`
+
+## 接口说明
+
+| 接口 | 说明 |
+|---|---|
+| `POST /identify/` | 基于压力观测数据和遗传算法识别管网中的漏损位置和大小。通过对比模型计算与实测压力数据，迭代优化找到最匹配的漏损节点和漏水量。 |
+| `GET /schemes/` | 获取指定管网的所有漏损识别方案列表，可通过 query_date 按日期筛选。 |
+| `GET /schemes/{scheme_name}` | 获取指定名称的漏损识别方案详细配置，包含传感器节点、算法参数等。 |
+
+## 请求体关键字段（POST /identify/）
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `network` | str | 管网名称（数据库名） |
+| `observed_pressure_data` | str/dict/list/null | 观测压力数据 |
+| `start_time` | float | 起始时间（小时），默认0 |
+| `duration` | float | 持续时间（小时），默认24 |
+| `timestep` | float | 时间步长（分钟），默认5 |
+| `q_sum` | float | 总流量（m³/s），默认0.2 |
+| `pop_size` | int | 遗传算法种群大小，默认50 |
+| `max_gen` | int | 遗传算法最大代数，默认100 |
+| `n_workers` | int | 并行工作线程数，默认CPU数-1（最大4） |
+| `scada_start` / `scada_end` | datetime/null | 从SCADA数据库查询的时间范围 |
+| `sensor_nodes` | list/null | 传感器节点列表，null为全部 |