@uwa4d/openapi-mcp 0.2.0-beta.13 → 0.2.0-beta.15

package/dist/composite/mcp-version.js

@@ -5,14 +5,16 @@ const release = describeReleaseChannel(PACKAGE_VERSION);
 const STABLE_DESCRIPTION = [
     '查询当前 UWA OpenAPI MCP 正式版版本，并与 npm 最新稳定版对比（仅正式版↔正式版，不与内部测试版交叉）。',
     '适用：Unity / UE｜复合工具｜无需 dataKey',
-    '若 updateAvailable=true，请用 userNotice 主动转告客户重启 MCP 升级。',
-    '用户问「MCP 什么版本」「有没有新版本」时优先调用本工具，不要臆测版本号。',
+    '触发：本对话第一次使用任意 UWA MCP 工具前应先调一次；用户问版本/升级时也可调。同一对话勿重复。',
+    '若 updateAvailable=true / suggestTellUser=true，请用 userNotice 主动转告客户重启 MCP 升级；已是最新勿打扰。',
+    '不要臆测版本号。',
 ].join('\n');
 const INTERNAL_DESCRIPTION = [
     '查询当前 UWA OpenAPI MCP 内部测试版版本，并与 npm @beta 最新测试版对比（仅测试↔测试，不与正式版交叉）。',
     '适用：Unity / UE｜复合工具｜无需 dataKey｜仅 UWA 内部 sandbox 联调',
-    '若 updateAvailable=true，请用 userNotice 主动转告测试人员重启 MCP 升级。',
-    '用户问「MCP 什么版本」「有没有新版本」时优先调用本工具，不要臆测版本号。',
+    '触发：本对话第一次使用任意 UWA MCP 工具前应先调一次；用户问版本/升级时也可调。同一对话勿重复。',
+    '若 updateAvailable=true / suggestTellUser=true，请用 userNotice 主动转告测试人员重启 MCP 升级；已是最新勿打扰。',
+    '不要臆测版本号。',
 ].join('\n');
 export const mcpVersionTool = {
     id: 'uwa_mcp_version',

package/dist/server-instructions.js

@@ -12,7 +12,7 @@ export const SERVER_INSTRUCTIONS = [
     '5. 非法面板名要纠正（fps_mean→fps_avg；android_pss_max→android_memory_pss@max）；数值带单位。PSS 优先读 pss_peak_kb/mb/frame。',
     '6. 接口失败时说明原因：运行日志 80108 — Unity 无 LG file_meta 表示未解析、无可用日志；UE 无 meta 只能说「暂不支持获取当前报告的运行日志」（方案切换过），勿断定报告本身无日志。其它失败勿把瞬时错误说成「一定没有数据」。',
     '7. 接口限流 31004（API_RATE_LIMIT）：UWA 服务端保护，预期行为，不是 Bug。稍等重试或减少并行/批量（如 top_resources 缩小 assetTypes）。若返回含 _partialErrors 且 _rateLimitHint，部分类型限流时已有 Top 仍可用，需说明可能不完整，勿当成报告无资源。',
-    '8. MCP 版本：用户问版本或升级时调用 uwa_mcp_version（正式版只对比正式版最新稳定版，内部测试版只对比测试版，互不交叉）。若 instructions 含「MCP 正式版/内部测试版有新版本」，必须用 userNotice 主动转告并说明重启 MCP 升级。',
+    '8. MCP 版本（每对话最多一次）：本对话第一次使用任意 UWA MCP 工具前，先调用一次 uwa_mcp_version 核对 npm（正式版只对比正式版，内部测试版只对比测试版，互不交叉）。若 updateAvailable=true / suggestTellUser=true，必须用 userNotice 主动转告并说明重启 MCP 升级；已是最新则不要打扰用户。同一对话内勿重复调用。用户显式问版本时也可再调。',
     '',
     '体检优先调用 report_diagnosis；细节再按 _apisUsed 深挖。对比多份报告时说明场景/时长/目标帧是否可比（见 comparability_note）。',
 ].join('\n');

package/dist/version-guide.js

@@ -208,6 +208,7 @@ export const VERSION_GUIDE = {
     gotonline_overview_stack_tree_frame_presign: [
         '【选用规则——务必先看】',
         '- **单帧**完整堆栈树（frameId 必填）。用于已知尖峰帧深挖，不是卡顿分析的第一步。',
+        '- Unity：不传 threadId=主线程；传子线程 id/名=该子线程指定帧树（thread idmap）。UE：threadId 必传（含 GameThread）。',
         '- 卡顿共性根因请先用 stutter_full_tree / stutter_scene_tree（已是多帧合并结果）。',
         '- ❌ 不要对 frametime valueGt 筛出的每个慢帧循环调用本工具来「聚类」。',
         STACK_ANALYSIS_GUIDE,
@@ -215,6 +216,7 @@ export const VERSION_GUIDE = {
     gotonline_overview_stack_sample_frame_presign: [
         '【选用规则——务必先看】',
         '- 堆栈树某个结点的逐帧曲线；结点 id 来自树文件。',
+        '- Unity 子线程须传 threadId + sampleId；不传 threadId 为主线程（可不传 sampleId 取全帧聚合）。',
         STACK_ANALYSIS_GUIDE,
     ].join('\n'),
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uwa4d/openapi-mcp",
-  "version": "0.2.0-beta.13",
+  "version": "0.2.0-beta.15",
   "description": "UWA 开放平台 MCP Server，将 UWA Open API 暴露为 MCP 工具供 AI 助手调用",
   "type": "module",
   "bin": {
@@ -27,6 +27,7 @@
     "prepublishOnly": "npm run build && node scripts/check-publish-tag.mjs",
     "release": "node scripts/release.mjs",
     "release:dry": "node scripts/release.mjs --dry-run",
+    "release:stable-patch": "node scripts/release-stable-patch.mjs",
     "version:beta": "node scripts/bump.mjs beta",
     "version:release": "node scripts/bump.mjs release"
   },

package/spec/uwa-openapi.json

@@ -4904,7 +4904,7 @@
           "type": "string",
           "required": true,
           "example": "GameThread",
-          "description": "UE 必传。Unity 忽略"
+          "description": "UE 必传。Unity：不传=主线程；传子线程 id/名=该子线程结点曲线（须同时传 sampleId）"
         }
       ],
       "body": [],
@@ -4954,7 +4954,7 @@
               "type": "string",
               "required": true,
               "example": "GameThread",
-              "description": "UE 必传。Unity 忽略"
+              "description": "UE 必传。Unity：不传=主线程；传子线程 id/名=该子线程结点曲线（须同时传 sampleId）"
             }
           ],
           "body": [],
@@ -5403,7 +5403,7 @@
           "type": "string",
           "required": true,
           "example": "GameThread",
-          "description": "UE 必传（线程 id 或线程名）。Unity 主线程可不传"
+          "description": "UE 必传（线程 id 或线程名）。Unity：不传=主线程；传子线程 id/名=该子线程指定帧树"
         }
       ],
       "body": [],
@@ -5419,7 +5419,7 @@
             "unreal"
           ],
           "module": "overview",
-          "description": "获取指定帧的函数调用堆栈树。返回 OSS 预签名地址，下载后为 gzip 压缩的树结构文件（与面板 stack/tree/frame 同源）。",
+          "description": "获取指定帧的函数调用堆栈树。返回 OSS 预签名地址，下载后为 gzip 压缩的树结构文件（与面板 stack/tree/frame 同源）。Unity 可传 threadId 取子线程。",
           "apiVersions": [
             "v1.0.1"
           ],
@@ -5453,7 +5453,7 @@
               "type": "string",
               "required": true,
               "example": "GameThread",
-              "description": "UE 必传（线程 id 或线程名）。Unity 主线程可不传"
+              "description": "UE 必传。Unity：不传=主线程；传子线程 id/名=该子线程指定帧树"
             }
           ],
           "body": [],