TJWaterAgent/.opencode/skills/data/timeseries-access/realtime/SKILL.md

name, description, version

name	description	version
tjwater-action-data-timeseries-access-realtime	data/timeseries-access 下 realtime 操作技能。	3.0.0

realtime Action Skill

简介

负责 data/timeseries-access 场景下 realtime 的具体接口调用。

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

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

接口目录

Method	Path	Summary	Required Params	Optional Params
DELETE	/api/v1/realtime/links	删除实时管道数据	start_time (query), end_time (query)	-
GET	/api/v1/realtime/links	查询实时管道数据	start_time (query), end_time (query)	-
POST	/api/v1/realtime/links/batch	批量插入实时管道数据	data (body)	-
PATCH	/api/v1/realtime/links/{link_id}/field	更新实时管道字段	link_id (path), time (query), field (query), value (query)	-
DELETE	/api/v1/realtime/nodes	删除实时节点数据	start_time (query), end_time (query)	-
GET	/api/v1/realtime/nodes	查询实时节点数据	start_time (query), end_time (query)	-
POST	/api/v1/realtime/nodes/batch	批量插入实时节点数据	data (body)	-
GET	/api/v1/realtime/query/by-id-time	按ID和时间查询实时模拟数据	id (query), type (query), query_time (query)	-
GET	/api/v1/realtime/query/by-time-property	按时间和属性查询实时数据	query_time (query), type (query), property (query)	-
POST	/api/v1/realtime/simulation/store	存储实时模拟结果	node_result_list (body), link_result_list (body), result_start_time (query)	-

• 覆盖方法：DELETE, GET, PATCH, POST

接口说明

接口	说明
POST /realtime/links/batch	批量将管道（link）模拟结果写入实时数据表（TimescaleDB）
GET /realtime/links	查询指定时间范围内的实时管道模拟数据
DELETE /realtime/links	删除指定时间范围内的实时管道数据
PATCH /realtime/links/{link_id}/field	修改某条管道在特定时刻的某个字段值
POST /realtime/nodes/batch	批量将节点模拟结果写入实时数据表
GET /realtime/nodes	查询指定时间范围内的实时节点模拟数据
DELETE /realtime/nodes	删除指定时间范围内的实时节点数据
POST /realtime/simulation/store	一次性存储一次完整模拟运行的节点和管道结果（含起始时间）
GET /realtime/query/by-time-property	按查询时间点和属性名（如 pressure/flow）查询全网实时模拟值
GET /realtime/query/by-id-time	按单个元素ID、类型和时间点查询其实时模拟值