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

name, description, version

name	description	version
tjwater-action-analytics-simulation-analysis-leakage	analytics/simulation-analysis 下 leakage 操作技能。	3.0.0

leakage Action Skill

简介

负责 analytics/simulation-analysis 场景下 leakage 的具体接口调用。

子模块索引 (渐进式引导)

• 当前为叶子节点，直接使用下方接口目录。

接口目录

Method	Path	Summary	Required Params	Optional Params
POST	/api/v1/leakage/identify/	执行漏损识别	data (body)	-
GET	/api/v1/leakage/schemes/	查询漏损识别方案列表	network (query)	query_date (query)
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为全部