@uwa4d/openapi-mcp 0.2.0-beta.3 → 0.2.0-beta.5

package/dist/tools.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { UwaApiError } from './client.js';
-import { versionGuideFor } from './version-guide.js';
+import { INDICATOR_DASHBOARD_PANEL_GUIDE, versionGuideFor } from './version-guide.js';
 const ENGINE_LABEL = { unity: 'Unity', unreal: 'UE' };
 /**
  * 预签名数据默认完整返回，不按条数截断——实测各接口解压后在 10 KB ~ 500 KB 之间，
@@ -41,6 +41,10 @@ function describe(op) {
     const guide = versionGuideFor(op.id);
     if (guide)
         lines.push(guide);
+    else if (op.query.some((p) => p.name === 'indicatorDashboards')) {
+        // 带 indicatorDashboards 但未单独写 VERSION_GUIDE 的原子工具（兜底）
+        lines.push(INDICATOR_DASHBOARD_PANEL_GUIDE);
+    }
     const engines = op.engines.map((e) => ENGINE_LABEL[e]).join(' / ');
     lines.push(`适用引擎：${engines}｜模块：${op.modules.join(',')}｜${op.method} ${op.path}`);
     const sdk = op.variants.find((v) => v.sdkRequirement)?.sdkRequirement;
@@ -84,7 +88,15 @@ function describe(op) {
 export function buildInputSchema(op) {
     const shape = {};
     for (const p of [...op.query, ...op.body]) {
-        const base = zodFor(p).describe(p.example ? `${p.description}（示例：${p.example}）` : p.description);
+        let desc = p.description;
+        if (p.name === 'indicatorDashboards') {
+            desc = [
+                desc,
+                '传参名为面板标识符：后缀 _max/_avg 等为历史命名，不表示只能取峰值或均值。',
+                '例：temperature_max 可拿到整机/CPU/GPU/电池温度的曲线及 mean/max/min 统计（见映射表子指标 key）。',
+            ].join(' ');
+        }
+        const base = zodFor(p).describe(p.example ? `${desc}（示例：${p.example}）` : desc);
         shape[p.name] = p.required ? base : base.optional();
     }
     if (op.apiVersions.length > 1) {

package/dist/version-guide.d.ts

@@ -4,6 +4,11 @@
  * 集中手写、挂到 describe() 首段，避免散落在 notes 里被模型漏读。
  * 不塞进 docs/ 生成链路——刷新官方文档镜像不会冲掉这里。
  */
+/**
+ * indicatorDashboards 传参名称说明（面板标识符，非统计维度后缀）。
+ * 挂到所有带 indicatorDashboards 的工具 description，避免模型见 _max 只读峰值。
+ */
+export declare const INDICATOR_DASHBOARD_PANEL_GUIDE: string;
 /** 写入工具 description 的「选用规则」块，key 为 operation id。 */
 export declare const VERSION_GUIDE: Record<string, string>;
 export declare function versionGuideFor(opId: string): string | undefined;

package/dist/version-guide.js

@@ -4,6 +4,19 @@
  * 集中手写、挂到 describe() 首段，避免散落在 notes 里被模型漏读。
  * 不塞进 docs/ 生成链路——刷新官方文档镜像不会冲掉这里。
  */
+/**
+ * indicatorDashboards 传参名称说明（面板标识符，非统计维度后缀）。
+ * 挂到所有带 indicatorDashboards 的工具 description，避免模型见 _max 只读峰值。
+ */
+export const INDICATOR_DASHBOARD_PANEL_GUIDE = [
+    '【indicatorDashboards 传参名称——勿按后缀猜统计维度】',
+    '- 传参名（如 temperature_max、fps_avg、drawcall_cnt_max）是**面板标识符**，_max / _avg / @max 等为历史命名，**不限制**返回 mean / maximum / min 等统计类型。',
+    '- 例：temperature_max 面板含子指标 temperature、android_temper_cpu、android_temper_gpu、android_temper_battery；',
+    '  · 曲线接口（indicator_curve / custom_dashboard）→ 各子指标逐帧曲线；',
+    '  · 统计 2.0（indicator_statistic_dashboard）→ statistic 下 *_mean / *_maximum / *_min 及 scene_* 等全量统计。',
+    '- 查温度曲线/均值/峰值：Unity Overview 且 SDK ≥ 2.5.1 时传 indicatorDashboards=temperature_max，再读 y_axis 或 statistic；勿仅看 get_overview_statistic 的汇总段。',
+    '- UE Overview 当前 Open API 未开放 custom/indicator dashboard 路径（会 24052），UE 温度汇总见 get_ue_overview_statistic_v2 的 temperature 段。',
+].join('\n');
 /** 写入工具 description 的「选用规则」块，key 为 operation id。 */
 export const VERSION_GUIDE = {
     get_overview_statistic_v1: [
@@ -39,12 +52,14 @@ export const VERSION_GUIDE = {
         '- 自定义面板统计 1.0（抽帧曲线）。不支持 GPU 类面板。',
         '- 需要 GPU 指标或更多统计值类型时，改用 gotonline_overview_indicator_statistic_dashboard（2.0，需 SDK ≥ 2.5.1）。',
         '- 逐帧曲线用 gotonline_overview_indicator_curve_dashboard（2.0，最多 3 个面板）。',
+        INDICATOR_DASHBOARD_PANEL_GUIDE,
     ].join('\n'),
     gotonline_overview_indicator_statistic_dashboard: [
         '【选用规则——务必先看】',
         '- 自定义面板统计 2.0。需 SDK ≥ 2.5.1，支持 GPU 指标，最多 15 个面板。',
         '- 旧接口（抽帧、无 GPU）见 gotonline_overview_custom_dashboard。',
         '- 只要逐帧曲线不要统计值时用 gotonline_overview_indicator_curve_dashboard。',
+        INDICATOR_DASHBOARD_PANEL_GUIDE,
     ].join('\n'),
     gotonline_overview_indicator_curve_dashboard: [
         '【选用规则——务必先看】',
@@ -53,6 +68,12 @@ export const VERSION_GUIDE = {
         '- 【横轴——勿混用】外层 x_axis 为逐帧共享横轴（1、2、3…）；y_axis.{指标名}.x_axis 为该曲线专属横轴（常见步长 30：0、30、60…）。',
         '- 读取某条曲线时：若存在专属 x_axis 必须用专属，否则才用外层共享 x_axis。把共享横轴套到 FPS 等专属曲线会错位。',
         '- 响应另含 _axisBinding / _axisHint，按其中 xAxisSource 取值即可。',
+        INDICATOR_DASHBOARD_PANEL_GUIDE,
+    ].join('\n'),
+    gotonline_gpu_curve: [
+        '【选用规则——务必先看】',
+        '- GPU 模式指标面板逐帧曲线，indicatorDashboards 为 GPU 面板映射表中的传参名称。',
+        INDICATOR_DASHBOARD_PANEL_GUIDE,
     ].join('\n'),
     gotonline_overview_memory_usage_snapshot: [
         '【选用规则——务必先看】',

package/package.json

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