@uwa4d/openapi-mcp 0.2.0-beta.9 → 0.2.1-beta.0

package/spec/uwa-openapi.json

@@ -1,7 +1,7 @@
 {
-  "generatedAt": "2026-08-07T02:47:15.805Z",
+  "generatedAt": "2026-09-02T07:12:46.087Z",
   "sourceDoc": "uwa-openapi-20260730.md",
-  "operationCount": 59,
+  "operationCount": 60,
   "operations": [
     {
       "id": "get_gpu_statistic",
@@ -76,7 +76,7 @@
             }
           ],
           "body": [],
-          "docLine": 5628
+          "docLine": 5717
         },
         {
           "title": "获取报告统计数据",
@@ -116,7 +116,7 @@
             }
           ],
           "body": [],
-          "docLine": 8268
+          "docLine": 8405
         }
       ]
     },
@@ -193,7 +193,7 @@
             }
           ],
           "body": [],
-          "docLine": 6453
+          "docLine": 6542
         }
       ]
     },
@@ -269,7 +269,7 @@
             }
           ],
           "body": [],
-          "docLine": 6323
+          "docLine": 6412
         }
       ]
     },
@@ -364,7 +364,7 @@
             }
           ],
           "body": [],
-          "docLine": 5942
+          "docLine": 6031
         }
       ]
     },
@@ -442,7 +442,7 @@
             }
           ],
           "body": [],
-          "docLine": 1563
+          "docLine": 1564
         },
         {
           "title": "获取报告统计数据 1.0",
@@ -483,7 +483,7 @@
             }
           ],
           "body": [],
-          "docLine": 6835
+          "docLine": 6924
         }
       ]
     },
@@ -548,7 +548,7 @@
               "description": "报告 dataKey 数组，支持批量查询多份报告"
             }
           ],
-          "docLine": 1771
+          "docLine": 1772
         }
       ]
     },
@@ -612,7 +612,7 @@
             }
           ],
           "body": [],
-          "docLine": 1246
+          "docLine": 1247
         },
         {
           "title": "获取报告记录信息",
@@ -645,7 +645,7 @@
             }
           ],
           "body": [],
-          "docLine": 6752
+          "docLine": 6841
         }
       ]
     },
@@ -718,7 +718,7 @@
             }
           ],
           "body": [],
-          "docLine": 1384
+          "docLine": 1385
         },
         {
           "title": "获取报告 URL",
@@ -753,7 +753,7 @@
             }
           ],
           "body": [],
-          "docLine": 6704
+          "docLine": 6793
         }
       ]
     },
@@ -835,7 +835,7 @@
             }
           ],
           "body": [],
-          "docLine": 1900
+          "docLine": 1902
         }
       ]
     },
@@ -902,7 +902,7 @@
               "description": "报告 dataKey，单份报告"
             }
           ],
-          "docLine": 2022
+          "docLine": 2024
         }
       ]
     },
@@ -977,7 +977,7 @@
             }
           ],
           "body": [],
-          "docLine": 6946
+          "docLine": 7035
         }
       ]
     },
@@ -1066,7 +1066,7 @@
             }
           ],
           "body": [],
-          "docLine": 1432
+          "docLine": 1433
         }
       ]
     },
@@ -1157,7 +1157,7 @@
             }
           ],
           "body": [],
-          "docLine": 5829
+          "docLine": 5918
         }
       ]
     },
@@ -1232,7 +1232,7 @@
             }
           ],
           "body": [],
-          "docLine": 5745
+          "docLine": 5834
         }
       ]
     },
@@ -1310,7 +1310,7 @@
             }
           ],
           "body": [],
-          "docLine": 5194
+          "docLine": 5283
         }
       ]
     },
@@ -1384,7 +1384,7 @@
             }
           ],
           "body": [],
-          "docLine": 1327
+          "docLine": 1328
         }
       ]
     },
@@ -1462,7 +1462,7 @@
             }
           ],
           "body": [],
-          "docLine": 6231
+          "docLine": 6320
         }
       ]
     },
@@ -1534,7 +1534,7 @@
             }
           ],
           "body": [],
-          "docLine": 6141
+          "docLine": 6230
         }
       ]
     },
@@ -1611,7 +1611,7 @@
             }
           ],
           "body": [],
-          "docLine": 6051
+          "docLine": 6140
         }
       ]
     },
@@ -1717,7 +1717,7 @@
             }
           ],
           "body": [],
-          "docLine": 4305
+          "docLine": 4394
         }
       ]
     },
@@ -1809,7 +1809,7 @@
             }
           ],
           "body": [],
-          "docLine": 4066
+          "docLine": 4155
         }
       ]
     },
@@ -1916,7 +1916,7 @@
             }
           ],
           "body": [],
-          "docLine": 4209
+          "docLine": 4298
         }
       ]
     },
@@ -2006,7 +2006,7 @@
             }
           ],
           "body": [],
-          "docLine": 2158
+          "docLine": 2160
         }
       ]
     },
@@ -2109,7 +2109,7 @@
             }
           ],
           "body": [],
-          "docLine": 3470
+          "docLine": 3559
         },
         {
           "title": "自定义变量曲线数据",
@@ -2164,7 +2164,7 @@
             }
           ],
           "body": [],
-          "docLine": 7466
+          "docLine": 7557
         }
       ]
     },
@@ -2244,7 +2244,7 @@
             }
           ],
           "body": [],
-          "docLine": 3287
+          "docLine": 3376
         },
         {
           "title": "自定义变量 idmap",
@@ -2284,7 +2284,7 @@
             }
           ],
           "body": [],
-          "docLine": 7287
+          "docLine": 7378
         }
       ]
     },
@@ -2420,7 +2420,7 @@
               "description": "子属性 ID，Vector 类型变量必传，其他类型忽略"
             }
           ],
-          "docLine": 3363
+          "docLine": 3452
         },
         {
           "title": "自定义变量统计数据",
@@ -2478,7 +2478,7 @@
               "description": "子属性 ID，Vector 类型必传，来自 idmap 的 dimensionList[].id"
             }
           ],
-          "docLine": 7361
+          "docLine": 7452
         }
       ]
     },
@@ -2555,7 +2555,7 @@
             }
           ],
           "body": [],
-          "docLine": 3637
+          "docLine": 3726
         }
       ]
     },
@@ -2629,7 +2629,7 @@
             }
           ],
           "body": [],
-          "docLine": 3698
+          "docLine": 3787
         }
       ]
     },
@@ -2705,7 +2705,7 @@
             }
           ],
           "body": [],
-          "docLine": 7556
+          "docLine": 7647
         }
       ]
     },
@@ -2801,7 +2801,7 @@
             }
           ],
           "body": [],
-          "docLine": 2501
+          "docLine": 2503
         }
       ]
     },
@@ -2847,7 +2847,7 @@
           "returnRules": [],
           "query": [],
           "body": [],
-          "docLine": 2270
+          "docLine": 2272
         }
       ]
     },
@@ -2939,7 +2939,7 @@
             }
           ],
           "body": [],
-          "docLine": 2317
+          "docLine": 2319
         }
       ]
     },
@@ -3018,7 +3018,7 @@
             }
           ],
           "body": [],
-          "docLine": 2831
+          "docLine": 2833
         },
         {
           "title": "线程 idmap",
@@ -3059,7 +3059,7 @@
             }
           ],
           "body": [],
-          "docLine": 7165
+          "docLine": 7256
         }
       ]
     },
@@ -3138,7 +3138,7 @@
             }
           ],
           "body": [],
-          "docLine": 5101
+          "docLine": 5190
         },
         {
           "title": "运行日志",
@@ -3177,7 +3177,7 @@
             }
           ],
           "body": [],
-          "docLine": 7883
+          "docLine": 8020
         }
       ]
     },
@@ -3266,7 +3266,7 @@
             }
           ],
           "body": [],
-          "docLine": 3756
+          "docLine": 3845
         }
       ]
     },
@@ -3341,7 +3341,7 @@
             }
           ],
           "body": [],
-          "docLine": 3580
+          "docLine": 3669
         }
       ]
     },
@@ -3448,7 +3448,7 @@
             }
           ],
           "body": [],
-          "docLine": 3198
+          "docLine": 3287
         }
       ]
     },
@@ -3457,7 +3457,7 @@
       "name": "函数曲线预签名",
       "method": "GET",
       "path": "/openapi/v1/data/gotonline/overview/method/curve/presign",
-      "summary": "获取指定函数逐帧曲线（预签名 JSON，v1.0.2，仅 stackMethodId）",
+      "summary": "Unity 指定函数逐帧曲线（预签名，v1.0.2）",
       "engines": [
         "unity",
         "unreal"
@@ -3487,40 +3487,47 @@
         {
           "name": "stackMethodId",
           "type": "string",
-          "required": true,
+          "required": false,
           "example": "4096133288",
-          "description": "[Unity] 函数 ID（必填） [UE] 函数 ID（Open API 必填）"
+          "description": "函数 ID；与 stackMethodName 至少传一个，同时传时优先 id"
+        },
+        {
+          "name": "stackMethodName",
+          "type": "string",
+          "required": false,
+          "example": "Animators.WriteJob",
+          "description": "函数名称；与 stackMethodId 至少传一个"
         },
         {
           "name": "threadName",
           "type": "string",
-          "required": true,
+          "required": false,
           "example": "GameThread",
-          "description": "[Unity] UE 必传 [UE] UE 必传。Unity 无需此参数"
+          "description": "UE 必传。Unity 无需此参数"
         }
       ],
       "body": [],
       "returnsPresignUrl": true,
       "variants": [
         {
-          "title": "函数曲线预签名",
+          "title": "函数曲线预签名（Unity）",
           "docEngines": [
             "unity"
           ],
           "supportedEngines": [
-            "unity",
-            "unreal"
+            "unity"
           ],
           "module": "overview",
-          "description": "获取指定函数的逐帧曲线（self_times / total_times / call_counts）。返回 OSS 预签名 JSON。Open API 仅支持 stackMethodId 入参（不支持函数名）。",
+          "description": "获取指定函数的逐帧曲线（self_times / total_times / call_counts）。返回 OSS 预签名 JSON。完整说明见 函数曲线预签名（Unity）；UE 见 自定义函数组曲线数据。",
           "apiVersions": [
             "v1.0.2"
           ],
           "sdkRequirement": ">= 2.5.1",
-          "prerequisite": "stackMethodId 需从函数 idmap 统计或自定义函数组统计获取。",
+          "prerequisite": "使用 stackMethodId 时：可从函数 idmap 统计（Unity）或自定义函数组统计获取 使用 stackMethodName 时：同名函数会按 totalTimeMean 取较大者；需精确定位请传 id",
           "notes": [
-            "Header 须 v1.0.2；逐帧直出请用 v1.0.1 method/curve（按名称，不推荐 Open API 使用）",
-            "Unity 无需 threadName；UE 必须传 threadName"
+            "Header 须 v1.0.2",
+            "同名函数建议传 stackMethodId 以避免歧义",
+            "尖峰帧下钻见 指定帧堆栈树（Unity）"
           ],
           "returnRules": [],
           "query": [
@@ -3541,20 +3548,20 @@
             {
               "name": "stackMethodId",
               "type": "string",
-              "required": true,
+              "required": false,
               "example": "4096133288",
-              "description": "函数 ID（必填）"
+              "description": "函数 ID；与 name 至少传一个，同时传时优先"
             },
             {
-              "name": "threadName",
+              "name": "stackMethodName",
               "type": "string",
-              "required": true,
-              "example": "GameThread",
-              "description": "UE 必传"
+              "required": false,
+              "example": "Animators.WriteJob",
+              "description": "函数名称；与 id 至少传一个"
             }
           ],
           "body": [],
-          "docLine": 3153
+          "docLine": 3237
         },
         {
           "title": "自定义函数组曲线数据",
@@ -3562,19 +3569,18 @@
             "unreal"
           ],
           "supportedEngines": [
-            "unity",
             "unreal"
           ],
           "module": "overview",
-          "description": "获取 Overview 报告中指定函数的逐帧曲线数据。Open API 请使用本接口（v1.0.2 预签名，仅 stackMethodId）；v1.0.1 直出见 Unity 章节 method/curve。",
+          "description": "获取 UE Overview 报告中指定函数的逐帧曲线数据，包含每帧自身耗时、总耗时、调用次数。返回预签名下载地址，下载后为 JSON 格式。仅适用于 2026-03-25 之后提交的报告，UE 引擎必须指定线程名称。",
           "apiVersions": [
             "v1.0.2"
           ],
-          "prerequisite": "stackMethodId 需从函数 idmap 统计或自定义函数组统计数据 2.0获取。",
+          "prerequisite": "使用 stackMethodId：可从函数 idmap 统计（UE）或自定义函数组统计数据 2.0获取 使用 stackMethodName：按名称解析；同名时建议传 id 精确定位",
           "notes": [
             "接口版本需传 v1.0.2（Header x-uwa-api-minor-version）",
-            "Open API 仅支持 stackMethodId，不支持 stackMethodName",
-            "UE 下 threadName 必传；Unity 无需 threadName",
+            "stackMethodId / stackMethodName 至少传一个；同时传时优先 id",
+            "threadName 必传（含 GameThread）",
             "URL 有效期 600 秒，过期后需重新调用本接口获取新地址",
             "本接口仅支持 2026-03-25 之后提交的报告"
           ],
@@ -3597,20 +3603,107 @@
             {
               "name": "threadName",
               "type": "string",
-              "required": true,
+              "required": false,
               "example": "GameThread",
-              "description": "UE 必传。Unity 无需此参数"
+              "description": "必传。GameThread、RHIThread、RenderThread、FAsyncLoadingThread 等"
             },
             {
               "name": "stackMethodId",
               "type": "string",
-              "required": true,
+              "required": false,
               "example": "329",
-              "description": "函数 ID（Open API 必填）"
+              "description": "函数 ID；与 name 至少传一个，同时传时优先"
+            },
+            {
+              "name": "stackMethodName",
+              "type": "string",
+              "required": false,
+              "example": "Tick_SlateInput",
+              "description": "函数名称；与 id 至少传一个"
+            }
+          ],
+          "body": [],
+          "docLine": 7916
+        }
+      ]
+    },
+    {
+      "id": "gotonline_overview_method_customidmap_statistic",
+      "name": "自定义代码段统计",
+      "method": "GET",
+      "path": "/openapi/v1/data/gotonline/overview/method/customidmap/statistic",
+      "summary": "Unity SDK 打点代码段耗时统计",
+      "engines": [
+        "unity"
+      ],
+      "modules": [
+        "overview"
+      ],
+      "apiVersions": [
+        "v1.0.1"
+      ],
+      "defaultApiVersion": "v1.0.1",
+      "query": [
+        {
+          "name": "recordId",
+          "type": "string",
+          "required": false,
+          "example": "1002",
+          "description": "报告 recordId。与 dataKey 二选一"
+        },
+        {
+          "name": "dataKey",
+          "type": "string",
+          "required": false,
+          "example": "testDataKey1",
+          "description": "报告 dataKey。与 recordId 二选一"
+        }
+      ],
+      "body": [],
+      "returnsPresignUrl": false,
+      "variants": [
+        {
+          "title": "自定义代码段统计",
+          "docEngines": [
+            "unity"
+          ],
+          "supportedEngines": [
+            "unity"
+          ],
+          "module": "overview",
+          "description": "查询 GOT Online Overview 报告中 SDK 打点的自定义代码段（custom_id_map）统计，返回各代码段的累计总耗时与平均总耗时。与自定义函数组统计不同：本接口读取 SDK 埋点代码段，不是门户里配置的函数组。仅 Unity Overview。SDK 版本需 >= 2.5.1。",
+          "apiVersions": [
+            "v1.0.1"
+          ],
+          "sdkRequirement": ">= 2.5.1",
+          "notes": [
+            "仅支持 Unity Overview；UE 报告调用会返回参数错误",
+            "报告未做 SDK 自定义代码段打点、或 custom_id_map 不存在时，data 返回空数组 []",
+            "返回按 totalTimeTotal 降序排列",
+            "与自定义函数组统计不是同一份数据：函数组是门户配置，本接口是 SDK 打点代码段",
+            "逐帧曲线请用 method/curve/presign v1.0.2，传本接口返回的 methodId 作为 stackMethodId"
+          ],
+          "returnRules": [
+            "threadId：非主线程代码段才返回；主线程条目无此字段"
+          ],
+          "query": [
+            {
+              "name": "recordId",
+              "type": "string",
+              "required": false,
+              "example": "1002",
+              "description": "报告 recordId。与 dataKey 二选一"
+            },
+            {
+              "name": "dataKey",
+              "type": "string",
+              "required": false,
+              "example": "testDataKey1",
+              "description": "报告 dataKey。与 recordId 二选一"
             }
           ],
           "body": [],
-          "docLine": 7783
+          "docLine": 3090
         }
       ]
     },
@@ -3631,7 +3724,7 @@
         "v1.0.1",
         "v1.0.2"
       ],
-      "defaultApiVersion": "v1.0.2",
+      "defaultApiVersion": "v1.0.1",
       "query": [
         {
           "name": "recordId",
@@ -3697,7 +3790,7 @@
             }
           ],
           "body": [],
-          "docLine": 2901
+          "docLine": 2903
         },
         {
           "title": "自定义函数组统计数据 2.0",
@@ -3738,13 +3831,13 @@
             {
               "name": "threadName",
               "type": "string",
-              "required": true,
+              "required": false,
               "example": "GameThread",
               "description": "线程名称。UE 必传，可选值：GameThread、RHIThread、RenderThread、FAsyncLoadingThread；Unity 不传时默认主线程"
             }
           ],
           "body": [],
-          "docLine": 7651
+          "docLine": 7742
         }
       ]
     },
@@ -3753,7 +3846,7 @@
       "name": "函数 idmap 统计",
       "method": "GET",
       "path": "/openapi/v1/data/gotonline/overview/method/idmap/statistic",
-      "summary": "获取全部函数的自身/总耗时/调用次数统计（v1.0.2，不去重）",
+      "summary": "Unity 全部函数统计（v1.0.2，不去重）",
       "engines": [
         "unity",
         "unreal"
@@ -3783,25 +3876,24 @@
         {
           "name": "threadName",
           "type": "string",
-          "required": true,
+          "required": false,
           "example": "GameThread",
-          "description": "UE 必传。线程名：GameThread、RHIThread、RenderThread、FAsyncLoadingThread"
+          "description": "UE 必传（GameThread / RHIThread / RenderThread / FAsyncLoadingThread 等）。Unity 无需此参数（不传=主线程）"
         }
       ],
       "body": [],
       "returnsPresignUrl": false,
       "variants": [
         {
-          "title": "函数 idmap 统计",
+          "title": "函数 idmap 统计（Unity）",
           "docEngines": [
             "unity"
           ],
           "supportedEngines": [
-            "unity",
-            "unreal"
+            "unity"
           ],
           "module": "overview",
-          "description": "返回 id_map / stats_id_map 中全部函数的统计值（selfTimeMean、totalTimeMean、callCountTotal），不去重、不过滤无统计项。适用于需要完整函数列表或按 stackMethodId 拉曲线的场景。SDK 版本需 >= 2.5.1。",
+          "description": "返回 Unity Overview 报告 id_map 中全部函数的统计值（selfTimeMean、totalTimeMean、callCountTotal 等），不去重、不过滤无统计项。适用于需要完整函数列表或按 stackMethodId 拉曲线的场景。SDK 版本需 >= 2.5.1。",
           "apiVersions": [
             "v1.0.2"
           ],
@@ -3812,6 +3904,44 @@
             "逐帧曲线请用 method/curve/presign v1.0.2，传本接口返回的 stackMethodId"
           ],
           "returnRules": [],
+          "query": [
+            {
+              "name": "recordId",
+              "type": "string",
+              "required": false,
+              "example": "1002",
+              "description": "报告 recordId。与 dataKey 二选一"
+            },
+            {
+              "name": "dataKey",
+              "type": "string",
+              "required": false,
+              "example": "testDataKey1",
+              "description": "报告 dataKey。与 recordId 二选一"
+            }
+          ],
+          "body": [],
+          "docLine": 3017
+        },
+        {
+          "title": "函数 idmap 统计（UE）",
+          "docEngines": [
+            "unreal"
+          ],
+          "supportedEngines": [
+            "unreal"
+          ],
+          "module": "overview",
+          "description": "获取 UE Overview 报告中指定线程下全部函数的统计值（自身耗时、总耗时、调用次数等），不去重、不过滤无统计项。仅适用于 2026-03-25 之后提交的报告，UE 引擎必须指定线程名称。",
+          "apiVersions": [
+            "v1.0.2"
+          ],
+          "notes": [
+            "仅适用于 2026-03-25 之后提交的报告",
+            "接口版本须传 v1.0.2；threadName 必传（含 GameThread）",
+            "不同线程需分别调用；后续曲线接口请传相同 threadName"
+          ],
+          "returnRules": [],
           "query": [
             {
               "name": "recordId",
@@ -3830,13 +3960,13 @@
             {
               "name": "threadName",
               "type": "string",
-              "required": true,
+              "required": false,
               "example": "GameThread",
-              "description": "UE 必传。线程名：GameThread、RHIThread、RenderThread、FAsyncLoadingThread"
+              "description": "必传。GameThread、RHIThread、RenderThread、FAsyncLoadingThread 等"
             }
           ],
           "body": [],
-          "docLine": 3015
+          "docLine": 7874
         }
       ]
     },
@@ -3910,7 +4040,7 @@
             }
           ],
           "body": [],
-          "docLine": 4415
+          "docLine": 4504
         }
       ]
     },
@@ -4004,7 +4134,7 @@
             }
           ],
           "body": [],
-          "docLine": 4858
+          "docLine": 4947
         }
       ]
     },
@@ -4097,7 +4227,7 @@
             }
           ],
           "body": [],
-          "docLine": 4697
+          "docLine": 4786
         }
       ]
     },
@@ -4176,7 +4306,7 @@
             }
           ],
           "body": [],
-          "docLine": 4598
+          "docLine": 4687
         }
       ]
     },
@@ -4282,7 +4412,7 @@
             }
           ],
           "body": [],
-          "docLine": 4506
+          "docLine": 4595
         }
       ]
     },
@@ -4387,7 +4517,7 @@
             }
           ],
           "body": [],
-          "docLine": 3979
+          "docLine": 4068
         }
       ]
     },
@@ -4494,7 +4624,7 @@
             }
           ],
           "body": [],
-          "docLine": 4777
+          "docLine": 4866
         }
       ]
     },
@@ -4599,7 +4729,7 @@
             }
           ],
           "body": [],
-          "docLine": 3873
+          "docLine": 3962
         }
       ]
     },
@@ -4680,7 +4810,7 @@
             }
           ],
           "body": [],
-          "docLine": 2756
+          "docLine": 2758
         },
         {
           "title": "函数 idmap",
@@ -4719,7 +4849,7 @@
             }
           ],
           "body": [],
-          "docLine": 7227
+          "docLine": 7318
         }
       ]
     },
@@ -4808,7 +4938,7 @@
             }
           ],
           "body": [],
-          "docLine": 2606
+          "docLine": 2608
         },
         {
           "title": "线程堆栈树",
@@ -4856,7 +4986,7 @@
             }
           ],
           "body": [],
-          "docLine": 7084
+          "docLine": 7175
         }
       ]
     },
@@ -4895,16 +5025,16 @@
         {
           "name": "sampleId",
           "type": "integer",
-          "required": true,
+          "required": false,
           "example": "42",
-          "description": "结点 id。UE 必传。Unity 不传则返回全帧聚合曲线"
+          "description": "结点 id。UE 必传。Unity 不传则返回全帧聚合曲线（仅主线程）"
         },
         {
           "name": "threadId",
           "type": "string",
-          "required": true,
+          "required": false,
           "example": "GameThread",
-          "description": "UE 必传。Unity 忽略"
+          "description": "UE 必传。Unity：不传 = 主线程；传子线程 id/名 = 该子线程结点曲线（须同时传 sampleId）"
         }
       ],
       "body": [],
@@ -4945,20 +5075,20 @@
             {
               "name": "sampleId",
               "type": "integer",
-              "required": true,
+              "required": false,
               "example": "42",
-              "description": "结点 id。UE 必传。Unity 不传则返回全帧聚合曲线"
+              "description": "结点 id。UE 必传。Unity 不传则返回全帧聚合曲线（仅主线程）"
             },
             {
               "name": "threadId",
               "type": "string",
-              "required": true,
+              "required": false,
               "example": "GameThread",
-              "description": "UE 必传。Unity 忽略"
+              "description": "UE 必传。Unity：不传 = 主线程；传子线程 id/名 = 该子线程结点曲线（须同时传 sampleId）"
             }
           ],
           "body": [],
-          "docLine": 3117
+          "docLine": 3201
         }
       ]
     },
@@ -5041,7 +5171,7 @@
             }
           ],
           "body": [],
-          "docLine": 5323
+          "docLine": 5412
         },
         {
           "title": "获取卡顿帧列表",
@@ -5086,7 +5216,7 @@
             }
           ],
           "body": [],
-          "docLine": 7974
+          "docLine": 8111
         }
       ]
     },
@@ -5167,7 +5297,7 @@
             }
           ],
           "body": [],
-          "docLine": 5435
+          "docLine": 5524
         },
         {
           "title": "获取卡顿帧汇总堆栈树",
@@ -5210,7 +5340,7 @@
             }
           ],
           "body": [],
-          "docLine": 8082
+          "docLine": 8219
         }
       ]
     },
@@ -5305,7 +5435,7 @@
             }
           ],
           "body": [],
-          "docLine": 5530
+          "docLine": 5619
         },
         {
           "title": "获取指定场景卡顿帧汇总堆栈树",
@@ -5355,7 +5485,7 @@
             }
           ],
           "body": [],
-          "docLine": 8173
+          "docLine": 8310
         }
       ]
     },
@@ -5364,7 +5494,7 @@
       "name": "指定帧堆栈树",
       "method": "GET",
       "path": "/openapi/v1/data/gotonline/overview/stack/tree/frame/presign",
-      "summary": "获取指定帧的调用堆栈树（预签名）",
+      "summary": "Unity 指定帧调用堆栈树（预签名）",
       "engines": [
         "unity",
         "unreal"
@@ -5401,25 +5531,24 @@
         {
           "name": "threadId",
           "type": "string",
-          "required": true,
-          "example": "GameThread",
-          "description": "UE 必传（线程 id 或线程名）。Unity 主线程可不传"
+          "required": false,
+          "example": "4261395632",
+          "description": "UE 必传（线程 id 或线程名，含 GameThread）。Unity：不传=主线程；传子线程 id/名=该子线程指定帧树"
         }
       ],
       "body": [],
       "returnsPresignUrl": true,
       "variants": [
         {
-          "title": "指定帧堆栈树",
+          "title": "指定帧堆栈树（Unity）",
           "docEngines": [
             "unity"
           ],
           "supportedEngines": [
-            "unity",
-            "unreal"
+            "unity"
           ],
           "module": "overview",
-          "description": "获取指定帧的函数调用堆栈树。返回 OSS 预签名地址，下载后为 gzip 压缩的树结构文件（与面板 stack/tree/frame 同源）。",
+          "description": "获取指定帧的函数调用堆栈树。返回 OSS 预签名地址，下载后为 gzip 压缩的树结构文件。完整说明见 指定帧堆栈树（Unity）；UE 见 指定帧堆栈树（UE）。",
           "apiVersions": [
             "v1.0.1"
           ],
@@ -5451,13 +5580,13 @@
             {
               "name": "threadId",
               "type": "string",
-              "required": true,
-              "example": "GameThread",
-              "description": "UE 必传（线程 id 或线程名）。Unity 主线程可不传"
+              "required": false,
+              "example": "4261395632",
+              "description": "不传 = 主线程；传子线程 id/名 = 该子线程指定帧树（见线程 idmap）"
             }
           ],
           "body": [],
-          "docLine": 3081
+          "docLine": 3165
         }
       ]
     },
@@ -5532,7 +5661,7 @@
             }
           ],
           "body": [],
-          "docLine": 4979
+          "docLine": 5068
         }
       ]
     },
@@ -5654,7 +5783,7 @@
             }
           ],
           "body": [],
-          "docLine": 1096
+          "docLine": 1097
         },
         {
           "title": "获取测试记录列表",
@@ -5716,7 +5845,7 @@
             }
           ],
           "body": [],
-          "docLine": 6554
+          "docLine": 6643
         }
       ]
     },
@@ -5790,7 +5919,7 @@
             }
           ],
           "body": [],
-          "docLine": 1499
+          "docLine": 1500
         }
       ]
     }