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

name, description, version

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

simulation Action Skill

简介

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

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

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

接口目录

Method	Path	Summary	Required Params	Optional Params
GET	/api/v1/runproject/	运行项目模拟	network (query)	-
GET	/api/v1/runprojectreturndict/	运行项目模拟（返回字典）	network (query)	-
GET	/api/v1/runinp/	运行INP文件	network (query)	-
GET	/api/v1/dumpoutput/	导出模拟输出	output (query)	-
GET	/api/v1/burstanalysis/	爆管分析（基础）	network (query), pipe_id (query), start_time (query), end_time (query), burst_flow (query)	-
GET	/api/v1/burst_analysis/	爆管分析（高级）	network (query), modify_pattern_start_time (query), burst_ID (query), burst_size (query), modify_total_duration (query), scheme_name (query)	-
GET	/api/v1/valvecloseanalysis/	阀门关闭分析（基础）	network (query), valve_id (query), start_time (query), end_time (query)	-
GET	/api/v1/valve_close_analysis/	阀门关闭分析（高级）	network (query), start_time (query), valves (query)	duration (query)
GET	/api/v1/valve_isolation_analysis/	阀门隔离分析	network (query), accident_element (query)	disabled_valves (query)
GET	/api/v1/flushinganalysis/	冲洗分析（基础）	network (query), pipe_id (query), start_time (query), duration (query), flow (query)	-
GET	/api/v1/flushing_analysis/	冲洗分析（高级）	network (query), start_time (query), valves (query), valves_k (query), drainage_node_ID (query)	flush_flow (query), duration (query), scheme_name (query)
GET	/api/v1/contaminant_simulation/	污染物模拟	network (query), start_time (query), source (query), concentration (query), duration (query)	scheme_name (query), pattern (query)
GET	/api/v1/ageanalysis/	水龄分析（基础）	network (query)	-
GET	/api/v1/age_analysis/	水龄分析（高级）	network (query), start_time (query), end_time (query), duration (query)	-
GET	/api/v1/pressureregulation/	压力调节（基础）	network (query), target_node (query), target_pressure (query)	-
POST	/api/v1/pressure_regulation/	压力调节（高级）	data (body)	-
GET	/api/v1/projectmanagement/	项目管理（基础）	network (query)	-
POST	/api/v1/project_management/	项目管理（高级）	data (body)	-
POST	/api/v1/scheduling_analysis/	排程分析	data (body)	-
POST	/api/v1/daily_scheduling_analysis/	日排程分析	data (body)	-
POST	/api/v1/network_project/	导入网络项目	file (file)	-
GET	/api/v1/networkupdate/	管网更新（基础）	network (query)	-
POST	/api/v1/network_update/	管网更新（高级）	file (file)	-
POST	/api/v1/pump_failure/	泵故障管理	data (body)	-
GET	/api/v1/pressuresensorplacementsensitivity/	压力传感器放置-灵敏度分析（基础）	name (query), scheme_name (query), sensor_number (query), min_diameter (query), username (query)	-
POST	/api/v1/pressure_sensor_placement_sensitivity/	压力传感器放置-灵敏度分析（高级）	data (body)	-
GET	/api/v1/pressuresensorplacementkmeans/	压力传感器放置-KMeans聚类分析（基础）	name (query), scheme_name (query), sensor_number (query), min_diameter (query), username (query)	-
POST	/api/v1/pressure_sensor_placement_kmeans/	压力传感器放置-KMeans聚类分析（高级）	data (body)	-
POST	/api/v1/sensorplacementscheme/create	传感器放置方案创建	network (query), scheme_name (query), sensor_type (query), method (query), sensor_count (query), user_name (query)	min_diameter (query)
POST	/api/v1/runsimulationmanuallybydate/	手动运行日期指定模拟	data (body)	-

• 覆盖方法：GET, POST

接口说明

接口	说明
GET /runproject/	运行标准水力模拟，返回纯文本格式的模拟报告
GET /runprojectreturndict/	运行标准水力模拟，返回JSON字典（含节点/管段结果数据），适合程序处理；结果可达30MB+
GET /runinp/	运行指定INP文件（文件放在inp文件夹中，参数为不含扩展名的文件名）进行水力模拟
GET /dumpoutput/	导出指定绝对路径的模拟输出文件内容
GET /burstanalysis/	基础爆管分析：对指定管道指定时间范围内的爆管事件进行分析，评估对压力/流量的影响
GET /burst_analysis/	高级爆管分析：支持在指定时间点修改泵控制模式和阀门开度，分析干预措施对爆管影响的作用；支持固定泵和变速泵独立控制
GET /valve_close_analysis/	高级阀门关闭分析：支持同时关闭多个阀门，指定持续时间，返回纯文本格式结果
GET /valve_isolation_analysis/	阀门隔离分析：分析突发事件时通过关闭指定阀门进行隔离，确定必须关闭阀门、可选关闭阀门及隔离可行性
GET /flushing_analysis/	高级冲洗分析：支持同时开启多个阀门冲洗，指定排污节点，设置固定冲洗流量，返回纯文本结果
GET /contaminant_simulation/	污染物模拟：评估污染源对管网的影响范围和浓度分布，支持指定污染位置、浓度和扩散模式
GET /age_analysis/	高级水龄分析：在指定时间点分析水体停留时间，支持自定义模拟持续时间，返回纯文本结果
POST /pressure_regulation/	高级压力调节：通过JSON体提供详细控制参数（固定泵/变速泵独立控制、水箱初始水位等）进行压力优化
POST /project_management/	高级项目管理：通过JSON体提供详细参数（泵控制策略、水箱水位、区域需水量控制）进行管网管理
POST /scheduling_analysis/	排程分析：优化泵运行时间和出水流量，平衡水厂出水、水箱进出水，满足用户需求
POST /daily_scheduling_analysis/	日排程分析：优化水库、水厂、水箱和用户需求协调，制定合理的每日排程方案
POST /pump_failure/	泵故障管理：记录故障发生时间和受影响的泵列表，更新泵状态日志
POST /pressure_sensor_placement_sensitivity/	高级传感器放置（灵敏度法）：通过JSON体提供详细参数，基于灵敏度矩阵确定最优放置位置
POST /pressure_sensor_placement_kmeans/	高级传感器放置（KMeans法）：通过JSON体提供详细参数，基于聚类算法确定最优放置位置
POST /sensorplacementscheme/create	创建传感器放置方案：支持 sensitivity 和 kmeans 两种算法，自动计算最优传感器位置并存储方案
POST /runsimulationmanuallybydate/	按日期手动运行模拟：根据指定日期、开始时间和持续时间查询管网参数并执行水力模拟