docs: 更新 API 文档并补充技能级局部更新说明

新增技能级 PATCH 接口说明,明确 PUT 浅合并规则与 PATCH 局部更新的适用场景
调整智能体操作流程,补充顶层字段与技能级的不同修改方式指引
This commit is contained in:
panFD
2026-10-06 00:11:05 +08:00
parent 04cea0fbb2
commit 4be5252cc4
5 changed files with 1556 additions and 307 deletions

View File

@@ -7,6 +7,52 @@
".json"
],
"subMetas": {
"57674": {
"importer": "sprite-frame",
"uuid": "81af97ed-7940-45e6-91a1-21bd0df1a343@57674",
"displayName": "",
"id": "57674",
"name": "Icon_Battle",
"userData": {
"trimThreshold": 1,
"rotated": false,
"offsetX": 0,
"offsetY": 0,
"trimX": 1349,
"trimY": 1894,
"width": 64,
"height": 57,
"rawWidth": 64,
"rawHeight": 57,
"borderTop": 0,
"borderBottom": 0,
"borderLeft": 0,
"borderRight": 0,
"packable": true,
"pixelsToUnit": 100,
"pivotX": 0.5,
"pivotY": 0.5,
"meshType": 0,
"vertices": {
"rawPosition": [],
"indexes": [],
"uv": [],
"nuv": [],
"minPos": [],
"maxPos": []
},
"isUuid": true,
"imageUuidOrDatabaseUri": "ca2b26a5-8d54-49ec-bdaf-e9f777afc9cb@6c48a",
"atlasUuid": "81af97ed-7940-45e6-91a1-21bd0df1a343",
"trimType": "auto"
},
"ver": "1.0.12",
"imported": true,
"files": [
".json"
],
"subMetas": {}
},
"58094": {
"importer": "sprite-frame",
"uuid": "81af97ed-7940-45e6-91a1-21bd0df1a343@58094",
@@ -53,6 +99,98 @@
],
"subMetas": {}
},
"63222": {
"importer": "sprite-frame",
"uuid": "81af97ed-7940-45e6-91a1-21bd0df1a343@63222",
"displayName": "",
"id": "63222",
"name": "Title_01_NoDeco_Tangerine",
"userData": {
"trimThreshold": 1,
"rotated": false,
"offsetX": 0,
"offsetY": 0,
"trimX": 1624,
"trimY": 1777,
"width": 273,
"height": 115,
"rawWidth": 273,
"rawHeight": 115,
"borderTop": 0,
"borderBottom": 0,
"borderLeft": 0,
"borderRight": 0,
"packable": true,
"pixelsToUnit": 100,
"pivotX": 0.5,
"pivotY": 0.5,
"meshType": 0,
"vertices": {
"rawPosition": [],
"indexes": [],
"uv": [],
"nuv": [],
"minPos": [],
"maxPos": []
},
"isUuid": true,
"imageUuidOrDatabaseUri": "ca2b26a5-8d54-49ec-bdaf-e9f777afc9cb@6c48a",
"atlasUuid": "81af97ed-7940-45e6-91a1-21bd0df1a343",
"trimType": "auto"
},
"ver": "1.0.12",
"imported": true,
"files": [
".json"
],
"subMetas": {}
},
"86850": {
"importer": "sprite-frame",
"uuid": "81af97ed-7940-45e6-91a1-21bd0df1a343@86850",
"displayName": "",
"id": "86850",
"name": "Title_01_NoDeco_Orange",
"userData": {
"trimThreshold": 1,
"rotated": false,
"offsetX": 0,
"offsetY": 0,
"trimX": 1349,
"trimY": 1777,
"width": 273,
"height": 115,
"rawWidth": 273,
"rawHeight": 115,
"borderTop": 0,
"borderBottom": 0,
"borderLeft": 135,
"borderRight": 138,
"packable": true,
"pixelsToUnit": 100,
"pivotX": 0.5,
"pivotY": 0.5,
"meshType": 0,
"vertices": {
"rawPosition": [],
"indexes": [],
"uv": [],
"nuv": [],
"minPos": [],
"maxPos": []
},
"isUuid": true,
"imageUuidOrDatabaseUri": "ca2b26a5-8d54-49ec-bdaf-e9f777afc9cb@6c48a",
"atlasUuid": "81af97ed-7940-45e6-91a1-21bd0df1a343",
"trimType": "auto"
},
"ver": "1.0.12",
"imported": true,
"files": [
".json"
],
"subMetas": {}
},
"4f746": {
"importer": "sprite-frame",
"uuid": "81af97ed-7940-45e6-91a1-21bd0df1a343@4f746",
@@ -110,8 +248,8 @@
"rotated": false,
"offsetX": -4,
"offsetY": 82,
"trimX": 1349,
"trimY": 1095,
"trimX": 675,
"trimY": 1669,
"width": 616,
"height": 182,
"rawWidth": 672,
@@ -157,7 +295,7 @@
"offsetX": 0,
"offsetY": -3,
"trimX": 675,
"trimY": 1775,
"trimY": 1853,
"width": 672,
"height": 92,
"rawWidth": 672,
@@ -199,11 +337,11 @@
"name": "0l4_clouds02",
"userData": {
"trimThreshold": 1,
"rotated": false,
"rotated": true,
"offsetX": 0,
"offsetY": 122,
"trimX": 675,
"trimY": 1869,
"trimX": 1931,
"trimY": 675,
"width": 672,
"height": 76,
"rawWidth": 672,
@@ -294,8 +432,8 @@
"rotated": false,
"offsetX": 0,
"offsetY": -108,
"trimX": 1,
"trimY": 1589,
"trimX": 675,
"trimY": 1193,
"width": 672,
"height": 162,
"rawWidth": 672,
@@ -337,11 +475,11 @@
"name": "0l7_ground02",
"userData": {
"trimThreshold": 1,
"rotated": false,
"rotated": true,
"offsetX": 0,
"offsetY": -120,
"trimX": 675,
"trimY": 1507,
"trimX": 1663,
"trimY": 675,
"width": 672,
"height": 138,
"rawWidth": 672,
@@ -383,11 +521,11 @@
"name": "0l8_ground",
"userData": {
"trimThreshold": 1,
"rotated": false,
"rotated": true,
"offsetX": 0,
"offsetY": -81,
"trimX": 1349,
"trimY": 381,
"trimX": 1729,
"trimY": 1,
"width": 672,
"height": 216,
"rawWidth": 672,
@@ -613,11 +751,11 @@
"name": "1l5_crystals",
"userData": {
"trimThreshold": 1,
"rotated": true,
"rotated": false,
"offsetX": -2,
"offsetY": -85,
"trimX": 1349,
"trimY": 1279,
"trimY": 1349,
"width": 662,
"height": 90,
"rawWidth": 672,
@@ -659,11 +797,11 @@
"name": "1l6_ground",
"userData": {
"trimThreshold": 1,
"rotated": true,
"rotated": false,
"offsetX": 0,
"offsetY": -151,
"trimX": 1441,
"trimY": 1279,
"trimX": 1293,
"trimY": 1699,
"width": 672,
"height": 76,
"rawWidth": 672,
@@ -705,11 +843,11 @@
"name": "3l2_clouds",
"userData": {
"trimThreshold": 1,
"rotated": false,
"rotated": true,
"offsetX": 0,
"offsetY": -48,
"trimX": 675,
"trimY": 1353,
"trimX": 1509,
"trimY": 675,
"width": 672,
"height": 152,
"rawWidth": 672,
@@ -751,11 +889,11 @@
"name": "3l3_pyramid",
"userData": {
"trimThreshold": 1,
"rotated": true,
"rotated": false,
"offsetX": 2,
"offsetY": -7,
"trimX": 1621,
"trimY": 1279,
"trimX": 1349,
"trimY": 1543,
"width": 528,
"height": 154,
"rawWidth": 672,
@@ -800,8 +938,8 @@
"rotated": false,
"offsetX": 0,
"offsetY": -111,
"trimX": 1,
"trimY": 1753,
"trimX": 675,
"trimY": 1357,
"width": 672,
"height": 156,
"rawWidth": 672,
@@ -846,8 +984,8 @@
"rotated": false,
"offsetX": 0,
"offsetY": -99,
"trimX": 1349,
"trimY": 599,
"trimX": 1,
"trimY": 1589,
"width": 672,
"height": 180,
"rawWidth": 672,
@@ -889,11 +1027,11 @@
"name": "3l6_bg-ground03",
"userData": {
"trimThreshold": 1,
"rotated": false,
"rotated": true,
"offsetX": 0,
"offsetY": -126,
"trimX": 675,
"trimY": 1647,
"trimX": 1803,
"trimY": 675,
"width": 672,
"height": 126,
"rawWidth": 672,
@@ -938,8 +1076,8 @@
"rotated": false,
"offsetX": 0,
"offsetY": -113,
"trimX": 1349,
"trimY": 941,
"trimX": 675,
"trimY": 1515,
"width": 672,
"height": 152,
"rawWidth": 672,
@@ -981,11 +1119,11 @@
"name": "Stone_A_01",
"userData": {
"trimThreshold": 1,
"rotated": false,
"rotated": true,
"offsetX": 0,
"offsetY": 0,
"trimX": 1777,
"trimY": 1626,
"trimX": 1879,
"trimY": 1629,
"width": 68,
"height": 51,
"rawWidth": 68,
@@ -1027,11 +1165,11 @@
"name": "Stone_A_04",
"userData": {
"trimThreshold": 1,
"rotated": false,
"rotated": true,
"offsetX": 0,
"offsetY": 0,
"trimX": 1850,
"trimY": 1562,
"trimX": 1293,
"trimY": 1777,
"width": 60,
"height": 51,
"rawWidth": 60,
@@ -1073,11 +1211,11 @@
"name": "Stone_A_07",
"userData": {
"trimThreshold": 1,
"rotated": false,
"rotated": true,
"offsetX": 0,
"offsetY": 0,
"trimX": 1621,
"trimY": 1809,
"trimX": 1947,
"trimY": 1,
"width": 107,
"height": 51,
"rawWidth": 107,
@@ -1122,8 +1260,8 @@
"rotated": false,
"offsetX": 0,
"offsetY": 0,
"trimX": 1519,
"trimY": 1865,
"trimX": 1935,
"trimY": 1441,
"width": 68,
"height": 70,
"rawWidth": 68,
@@ -1168,8 +1306,8 @@
"rotated": false,
"offsetX": 0,
"offsetY": 0,
"trimX": 1777,
"trimY": 1679,
"trimX": 1415,
"trimY": 1894,
"width": 66,
"height": 45,
"rawWidth": 66,
@@ -1214,8 +1352,8 @@
"rotated": false,
"offsetX": 0,
"offsetY": 0,
"trimX": 1730,
"trimY": 1809,
"trimX": 1293,
"trimY": 1669,
"width": 35,
"height": 22,
"rawWidth": 35,
@@ -1257,11 +1395,11 @@
"name": "Stone_B_04",
"userData": {
"trimThreshold": 1,
"rotated": false,
"rotated": true,
"offsetX": 0,
"offsetY": 0,
"trimX": 1777,
"trimY": 1562,
"trimX": 1899,
"trimY": 1777,
"width": 71,
"height": 62,
"rawWidth": 71,
@@ -1306,8 +1444,8 @@
"rotated": true,
"offsetX": 0,
"offsetY": 0,
"trimX": 1967,
"trimY": 1095,
"trimX": 1879,
"trimY": 1543,
"width": 84,
"height": 43,
"rawWidth": 84,
@@ -1352,8 +1490,8 @@
"rotated": false,
"offsetX": 0,
"offsetY": 0,
"trimX": 1519,
"trimY": 1937,
"trimX": 1947,
"trimY": 110,
"width": 31,
"height": 15,
"rawWidth": 31,
@@ -1399,7 +1537,7 @@
"offsetX": 0,
"offsetY": 0,
"trimX": 1,
"trimY": 1911,
"trimY": 1931,
"width": 44,
"height": 16,
"rawWidth": 44,
@@ -1441,7 +1579,7 @@
"name": "l1_sky",
"userData": {
"trimThreshold": 1,
"rotated": false,
"rotated": true,
"offsetX": 0,
"offsetY": 0,
"trimX": 1349,
@@ -1533,11 +1671,11 @@
"name": "l3_clouds",
"userData": {
"trimThreshold": 1,
"rotated": true,
"rotated": false,
"offsetX": -6,
"offsetY": 89,
"trimX": 1519,
"trimY": 1279,
"trimX": 1349,
"trimY": 1441,
"width": 584,
"height": 100,
"rawWidth": 672,
@@ -1579,11 +1717,11 @@
"name": "l4_bg-ground01",
"userData": {
"trimThreshold": 1,
"rotated": false,
"rotated": true,
"offsetX": 0,
"offsetY": -110,
"trimX": 675,
"trimY": 1193,
"trimX": 1349,
"trimY": 675,
"width": 672,
"height": 158,
"rawWidth": 672,
@@ -1628,8 +1766,8 @@
"rotated": false,
"offsetX": 0,
"offsetY": -110,
"trimX": 1349,
"trimY": 781,
"trimX": 1,
"trimY": 1771,
"width": 672,
"height": 158,
"rawWidth": 672,
@@ -1708,52 +1846,6 @@
".json"
],
"subMetas": {}
},
"14c74": {
"importer": "sprite-frame",
"uuid": "81af97ed-7940-45e6-91a1-21bd0df1a343@14c74",
"displayName": "",
"id": "14c74",
"name": "logo2",
"userData": {
"trimThreshold": 1,
"rotated": true,
"offsetX": 1,
"offsetY": 2,
"trimX": 1777,
"trimY": 1279,
"width": 281,
"height": 231,
"rawWidth": 307,
"rawHeight": 307,
"borderTop": 0,
"borderBottom": 0,
"borderLeft": 0,
"borderRight": 0,
"packable": true,
"pixelsToUnit": 100,
"pivotX": 0.5,
"pivotY": 0.5,
"meshType": 0,
"vertices": {
"rawPosition": [],
"indexes": [],
"uv": [],
"nuv": [],
"minPos": [],
"maxPos": []
},
"isUuid": true,
"imageUuidOrDatabaseUri": "ca2b26a5-8d54-49ec-bdaf-e9f777afc9cb@6c48a",
"atlasUuid": "81af97ed-7940-45e6-91a1-21bd0df1a343",
"trimType": "auto"
},
"ver": "1.0.12",
"imported": true,
"files": [
".json"
],
"subMetas": {}
}
},
"userData": {