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

name, description, version

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

burst-location Action Skill

简介

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

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

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

接口目录

Method	Path	Summary	Required Params	Optional Params
POST	/api/v1/burst-location/locate/	执行爆管定位	data (body)	-
GET	/api/v1/burst-location/schemes/	查询爆管定位方案列表	network (query)	query_date (query)
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