TJWaterAgent/.opencode/skills/business/project-workspace/snapshots/SKILL.md

name, description, version

name	description	version
tjwater-action-business-project-workspace-snapshots	business/project-workspace 下 snapshots 操作技能。	3.0.0

snapshots Action Skill

简介

负责 business/project-workspace 场景下 snapshots 的具体接口调用。

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

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

接口目录

Method	Path	Summary	Required Params	Optional Params
POST	/api/v1/batch/	执行批量命令	network (query)	-
POST	/api/v1/compressedbatch/	执行压缩批量命令	network (query)	-
GET	/api/v1/getcurrentoperationid/	获取当前操作ID	network (query)	-
GET	/api/v1/getrestoreoperation/	获取恢复操作ID	network (query)	-
GET	/api/v1/getsnapshots/	获取快照列表	network (query)	-
GET	/api/v1/havesnapshot/	检查快照是否存在	network (query), tag (query)	-
GET	/api/v1/havesnapshotforcurrentoperation/	检查当前操作快照是否存在	network (query)	-
GET	/api/v1/havesnapshotforoperation/	检查操作快照是否存在	network (query), operation (query)	-
POST	/api/v1/pickoperation/	选择操作	network (query), operation (query)	discard (query)
POST	/api/v1/picksnapshot/	选择快照	network (query), tag (query)	discard (query)
POST	/api/v1/redo/	重做操作	network (query)	-
POST	/api/v1/setrestoreoperation/	设置恢复操作ID	network (query), operation (query)	-
GET	/api/v1/syncwithserver/	与服务器同步	network (query), operation (query)	-
POST	/api/v1/takenapshotforcurrentoperation	为当前操作创建快照（兼容模式）	network (query), tag (query)	-
POST	/api/v1/takesnapshot/	创建快照	network (query), tag (query)	-
POST	/api/v1/takesnapshotforcurrentoperation	为当前操作创建快照	network (query), tag (query)	-
POST	/api/v1/takesnapshotforoperation/	为操作创建快照	network (query), operation (query), tag (query)	-
POST	/api/v1/undo/	撤销操作	network (query)	-

• 覆盖方法：GET, POST

接口说明

接口	说明
GET /getsnapshots/	列出当前管网所有已保存的快照标签（tag）列表
GET /havesnapshot/	检查指定 tag 的快照是否存在
POST /takesnapshot/	保存当前管网状态为一个快照，tag 为快照名称
POST /picksnapshot/	将管网状态回滚到指定快照，discard=true 时丢弃当前未保存修改
GET /getcurrentoperationid/	获取当前管网的操作ID（用于追踪操作历史）
POST /undo/	撤销对管网的最近一次操作
POST /redo/	重做上一次被撤销的操作
POST /batch/	批量执行多个管网操作命令（原子事务）
POST /compressedbatch/	执行压缩格式的批量命令（减少网络传输量）
GET /syncwithserver/	将客户端的操作与服务端管网状态同步
POST /pickoperation/	切换到指定 operation ID 的历史操作状态
POST /takesnapshotforcurrentoperation	为当前 operation 创建快照（保存当前操作节点状态）