@uwa4d/openapi-mcp 0.2.1-beta.0 → 0.2.1-beta.1

package/dist/version-guide.js

@@ -156,22 +156,25 @@ export const VERSION_GUIDE = {
         '【选用规则——务必先看】',
         '- **仅 Unity Overview**。查 SDK 打点的自定义代码段（custom_id_map），不是门户「自定义函数组」。',
         '- 未打点或无 custom_id_map 时 data=[]，不要说报告没有函数。',
-        '- 返回 methodId / methodName / totalTimeTotal / totalTimeMean；子线程才有 threadId。',
-        '- 逐帧曲线：把 methodId 当作 stackMethodId 传给 gotonline_overview_method_curve_presign。',
+        '- **threadId 决定后续怎么查（必须遵守）**：',
+        '  · **没有 threadId = 主线程**（不是缺字段）。可调函数曲线 gotonline_overview_method_curve_presign（methodId→stackMethodId，Unity 不传 threadName）；堆栈/结点曲线不传 threadId。',
+        '  · **有 threadId = 子线程。子线程没有函数**，禁止调 method_curve / method_curve_presign。只能查结点曲线 gotonline_overview_stack_sample_frame_presign，并把该 threadId 原样传入。',
         '- 不要和 gotonline_overview_method_group_statistic / method_idmap_statistic 混用。',
     ].join('\n'),
     gotonline_overview_method_curve: [
         '【选用规则——务必先看】',
         '- v1.0.1 直出曲线 JSON（按 stackMethodName 或 stackMethodId）。',
         '- **MCP 与 Open API 推荐改用 gotonline_overview_method_curve_presign（v1.0.2）**：OSS 预签名，id 或 name 至少其一。',
-        '- stackMethodId 来自 gotonline_overview_method_idmap_statistic、自定义函数组统计，或自定义代码段统计（methodId）。',
+        '- stackMethodId 来自 gotonline_overview_method_idmap_statistic、自定义函数组统计，或**主线程**自定义代码段（customidmap 条目无 threadId 时的 methodId）。',
+        '- 自定义代码段若带了 threadId（子线程）：没有函数曲线，改用 gotonline_overview_stack_sample_frame_presign。',
     ].join('\n'),
     gotonline_overview_method_curve_presign: [
         '【选用规则——务必先看】',
         '- v1.0.2 OSS 预签名下载函数逐帧曲线 JSON（Unity · UE）。',
         '- stackMethodId 与 stackMethodName **至少传一个**（同时传时优先 id）；UE 另需 threadName，Unity 不传。',
         '- 不要用 v1.0.1 gotonline_overview_method_curve 除非必须服务端直出。',
-        '- id 优先从 gotonline_overview_method_idmap_statistic 获取；自定义代码段用 gotonline_overview_method_customidmap_statistic 的 methodId。',
+        '- id 优先从 gotonline_overview_method_idmap_statistic 获取。',
+        '- 自定义代码段：仅当 customidmap 条目**没有** threadId（主线程）时把 methodId 当 stackMethodId；**有 threadId 的子线程没有函数**，改用 gotonline_overview_stack_sample_frame_presign。',
     ].join('\n'),
     gotonline_overview_indicator_dashboard_keys: [
         '【选用规则——务必先看】',
@@ -225,6 +228,7 @@ export const VERSION_GUIDE = {
         '【选用规则——务必先看】',
         '- 堆栈树某个结点的逐帧曲线；结点 id 来自树文件。',
         '- Unity 子线程须传 threadId + sampleId；不传 threadId 为主线程（可不传 sampleId 取全帧聚合）。',
+        '- 自定义代码段若带了 threadId：子线程**没有函数曲线**，用本工具看结点逐帧，threadId 用 customidmap 返回值。',
         STACK_ANALYSIS_GUIDE,
     ].join('\n'),
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uwa4d/openapi-mcp",
-  "version": "0.2.1-beta.0",
+  "version": "0.2.1-beta.1",
   "description": "UWA 开放平台 MCP Server，将 UWA Open API 暴露为 MCP 工具供 AI 助手调用",
   "type": "module",
   "bin": {

package/spec/uwa-openapi.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-09-02T07:12:46.087Z",
+  "generatedAt": "2026-09-02T08:04:33.507Z",
   "sourceDoc": "uwa-openapi-20260730.md",
   "operationCount": 60,
   "operations": [
@@ -76,7 +76,7 @@
             }
           ],
           "body": [],
-          "docLine": 5717
+          "docLine": 5719
         },
         {
           "title": "获取报告统计数据",
@@ -116,7 +116,7 @@
             }
           ],
           "body": [],
-          "docLine": 8405
+          "docLine": 8407
         }
       ]
     },
@@ -193,7 +193,7 @@
             }
           ],
           "body": [],
-          "docLine": 6542
+          "docLine": 6544
         }
       ]
     },
@@ -269,7 +269,7 @@
             }
           ],
           "body": [],
-          "docLine": 6412
+          "docLine": 6414
         }
       ]
     },
@@ -364,7 +364,7 @@
             }
           ],
           "body": [],
-          "docLine": 6031
+          "docLine": 6033
         }
       ]
     },
@@ -483,7 +483,7 @@
             }
           ],
           "body": [],
-          "docLine": 6924
+          "docLine": 6926
         }
       ]
     },
@@ -645,7 +645,7 @@
             }
           ],
           "body": [],
-          "docLine": 6841
+          "docLine": 6843
         }
       ]
     },
@@ -753,7 +753,7 @@
             }
           ],
           "body": [],
-          "docLine": 6793
+          "docLine": 6795
         }
       ]
     },
@@ -977,7 +977,7 @@
             }
           ],
           "body": [],
-          "docLine": 7035
+          "docLine": 7037
         }
       ]
     },
@@ -1157,7 +1157,7 @@
             }
           ],
           "body": [],
-          "docLine": 5918
+          "docLine": 5920
         }
       ]
     },
@@ -1232,7 +1232,7 @@
             }
           ],
           "body": [],
-          "docLine": 5834
+          "docLine": 5836
         }
       ]
     },
@@ -1310,7 +1310,7 @@
             }
           ],
           "body": [],
-          "docLine": 5283
+          "docLine": 5285
         }
       ]
     },
@@ -1462,7 +1462,7 @@
             }
           ],
           "body": [],
-          "docLine": 6320
+          "docLine": 6322
         }
       ]
     },
@@ -1534,7 +1534,7 @@
             }
           ],
           "body": [],
-          "docLine": 6230
+          "docLine": 6232
         }
       ]
     },
@@ -1611,7 +1611,7 @@
             }
           ],
           "body": [],
-          "docLine": 6140
+          "docLine": 6142
         }
       ]
     },
@@ -1717,7 +1717,7 @@
             }
           ],
           "body": [],
-          "docLine": 4394
+          "docLine": 4396
         }
       ]
     },
@@ -1809,7 +1809,7 @@
             }
           ],
           "body": [],
-          "docLine": 4155
+          "docLine": 4157
         }
       ]
     },
@@ -1916,7 +1916,7 @@
             }
           ],
           "body": [],
-          "docLine": 4298
+          "docLine": 4300
         }
       ]
     },
@@ -2109,7 +2109,7 @@
             }
           ],
           "body": [],
-          "docLine": 3559
+          "docLine": 3561
         },
         {
           "title": "自定义变量曲线数据",
@@ -2164,7 +2164,7 @@
             }
           ],
           "body": [],
-          "docLine": 7557
+          "docLine": 7559
         }
       ]
     },
@@ -2244,7 +2244,7 @@
             }
           ],
           "body": [],
-          "docLine": 3376
+          "docLine": 3378
         },
         {
           "title": "自定义变量 idmap",
@@ -2284,7 +2284,7 @@
             }
           ],
           "body": [],
-          "docLine": 7378
+          "docLine": 7380
         }
       ]
     },
@@ -2420,7 +2420,7 @@
               "description": "子属性 ID，Vector 类型变量必传，其他类型忽略"
             }
           ],
-          "docLine": 3452
+          "docLine": 3454
         },
         {
           "title": "自定义变量统计数据",
@@ -2478,7 +2478,7 @@
               "description": "子属性 ID，Vector 类型必传，来自 idmap 的 dimensionList[].id"
             }
           ],
-          "docLine": 7452
+          "docLine": 7454
         }
       ]
     },
@@ -2555,7 +2555,7 @@
             }
           ],
           "body": [],
-          "docLine": 3726
+          "docLine": 3728
         }
       ]
     },
@@ -2629,7 +2629,7 @@
             }
           ],
           "body": [],
-          "docLine": 3787
+          "docLine": 3789
         }
       ]
     },
@@ -2705,7 +2705,7 @@
             }
           ],
           "body": [],
-          "docLine": 7647
+          "docLine": 7649
         }
       ]
     },
@@ -3059,7 +3059,7 @@
             }
           ],
           "body": [],
-          "docLine": 7256
+          "docLine": 7258
         }
       ]
     },
@@ -3138,7 +3138,7 @@
             }
           ],
           "body": [],
-          "docLine": 5190
+          "docLine": 5192
         },
         {
           "title": "运行日志",
@@ -3177,7 +3177,7 @@
             }
           ],
           "body": [],
-          "docLine": 8020
+          "docLine": 8022
         }
       ]
     },
@@ -3266,7 +3266,7 @@
             }
           ],
           "body": [],
-          "docLine": 3845
+          "docLine": 3847
         }
       ]
     },
@@ -3341,7 +3341,7 @@
             }
           ],
           "body": [],
-          "docLine": 3669
+          "docLine": 3671
         }
       ]
     },
@@ -3448,7 +3448,7 @@
             }
           ],
           "body": [],
-          "docLine": 3287
+          "docLine": 3289
         }
       ]
     },
@@ -3561,7 +3561,7 @@
             }
           ],
           "body": [],
-          "docLine": 3237
+          "docLine": 3239
         },
         {
           "title": "自定义函数组曲线数据",
@@ -3623,7 +3623,7 @@
             }
           ],
           "body": [],
-          "docLine": 7916
+          "docLine": 7918
         }
       ]
     },
@@ -3681,7 +3681,9 @@
             "报告未做 SDK 自定义代码段打点、或 custom_id_map 不存在时，data 返回空数组 []",
             "返回按 totalTimeTotal 降序排列",
             "与自定义函数组统计不是同一份数据：函数组是门户配置，本接口是 SDK 打点代码段",
-            "逐帧曲线请用 method/curve/presign v1.0.2，传本接口返回的 methodId 作为 stackMethodId"
+            "threadId 决定后续怎么查：没有该字段 = 主线程（不是缺失）；有 = 子线程",
+            "主线程（无 threadId）：可用函数曲线预签名，methodId 作为 stackMethodId",
+            "子线程（有 threadId）：没有函数曲线，不要调 method/curve；只能查结点曲线，并把该 threadId 传入"
           ],
           "returnRules": [
             "threadId：非主线程代码段才返回；主线程条目无此字段"
@@ -3837,7 +3839,7 @@
             }
           ],
           "body": [],
-          "docLine": 7742
+          "docLine": 7744
         }
       ]
     },
@@ -3966,7 +3968,7 @@
             }
           ],
           "body": [],
-          "docLine": 7874
+          "docLine": 7876
         }
       ]
     },
@@ -4040,7 +4042,7 @@
             }
           ],
           "body": [],
-          "docLine": 4504
+          "docLine": 4506
         }
       ]
     },
@@ -4134,7 +4136,7 @@
             }
           ],
           "body": [],
-          "docLine": 4947
+          "docLine": 4949
         }
       ]
     },
@@ -4227,7 +4229,7 @@
             }
           ],
           "body": [],
-          "docLine": 4786
+          "docLine": 4788
         }
       ]
     },
@@ -4306,7 +4308,7 @@
             }
           ],
           "body": [],
-          "docLine": 4687
+          "docLine": 4689
         }
       ]
     },
@@ -4412,7 +4414,7 @@
             }
           ],
           "body": [],
-          "docLine": 4595
+          "docLine": 4597
         }
       ]
     },
@@ -4517,7 +4519,7 @@
             }
           ],
           "body": [],
-          "docLine": 4068
+          "docLine": 4070
         }
       ]
     },
@@ -4624,7 +4626,7 @@
             }
           ],
           "body": [],
-          "docLine": 4866
+          "docLine": 4868
         }
       ]
     },
@@ -4729,7 +4731,7 @@
             }
           ],
           "body": [],
-          "docLine": 3962
+          "docLine": 3964
         }
       ]
     },
@@ -4849,7 +4851,7 @@
             }
           ],
           "body": [],
-          "docLine": 7318
+          "docLine": 7320
         }
       ]
     },
@@ -4986,7 +4988,7 @@
             }
           ],
           "body": [],
-          "docLine": 7175
+          "docLine": 7177
         }
       ]
     },
@@ -5088,7 +5090,7 @@
             }
           ],
           "body": [],
-          "docLine": 3201
+          "docLine": 3203
         }
       ]
     },
@@ -5171,7 +5173,7 @@
             }
           ],
           "body": [],
-          "docLine": 5412
+          "docLine": 5414
         },
         {
           "title": "获取卡顿帧列表",
@@ -5216,7 +5218,7 @@
             }
           ],
           "body": [],
-          "docLine": 8111
+          "docLine": 8113
         }
       ]
     },
@@ -5297,7 +5299,7 @@
             }
           ],
           "body": [],
-          "docLine": 5524
+          "docLine": 5526
         },
         {
           "title": "获取卡顿帧汇总堆栈树",
@@ -5340,7 +5342,7 @@
             }
           ],
           "body": [],
-          "docLine": 8219
+          "docLine": 8221
         }
       ]
     },
@@ -5435,7 +5437,7 @@
             }
           ],
           "body": [],
-          "docLine": 5619
+          "docLine": 5621
         },
         {
           "title": "获取指定场景卡顿帧汇总堆栈树",
@@ -5485,7 +5487,7 @@
             }
           ],
           "body": [],
-          "docLine": 8310
+          "docLine": 8312
         }
       ]
     },
@@ -5586,7 +5588,7 @@
             }
           ],
           "body": [],
-          "docLine": 3165
+          "docLine": 3167
         }
       ]
     },
@@ -5661,7 +5663,7 @@
             }
           ],
           "body": [],
-          "docLine": 5068
+          "docLine": 5070
         }
       ]
     },
@@ -5845,7 +5847,7 @@
             }
           ],
           "body": [],
-          "docLine": 6643
+          "docLine": 6645
         }
       ]
     },