@uwa4d/openapi-mcp 0.2.0-beta.0 → 0.2.0-beta.10

package/dist/composite/overview-view.js

@@ -0,0 +1,373 @@
+import { isObj } from './helpers.js';
+function firstVal(v) {
+    return Array.isArray(v) ? v[0] : v;
+}
+function numOf(v) {
+    const x = firstVal(v);
+    if (typeof x === 'number' && Number.isFinite(x))
+        return x;
+    if (typeof x === 'string' && x.trim() && !Number.isNaN(Number(x)))
+        return Number(x);
+    return null;
+}
+function toBytes(value, unit) {
+    const u = (unit ?? '').toLowerCase();
+    if (u === 'b' || u === 'byte' || u === 'bytes')
+        return Math.round(value);
+    if (u === 'kb')
+        return Math.round(value * 1024);
+    if (u === 'mb')
+        return Math.round(value * 1024 * 1024);
+    if (u === 'gb')
+        return Math.round(value * 1024 * 1024 * 1024);
+    // 无单位时：很大的数当字节，否则当 MB（兼容 v1 brief 的 _mem_max_mb）
+    return value > 10_000 ? Math.round(value) : Math.round(value * 1024 * 1024);
+}
+function unitFromLabel(label) {
+    const m = /[（(]\s*(MB|KB|GB|B|字节)\s*[）)]/i.exec(label);
+    return m?.[1]?.toLowerCase() === '字节' ? 'b' : m?.[1]?.toLowerCase();
+}
+/** 排除「数量峰值」这类非内存指标。 */
+function looksLikeMemoryMetric(label, key, unit) {
+    if (/数量|count|cnt/i.test(label) || /count|cnt/i.test(key))
+        return false;
+    if (/^(b|byte|bytes|kb|mb|gb)$/i.test(unit))
+        return true;
+    return /内存|memory|mem|reserved|used|heap|gfx|mono|lua/i.test(label + key);
+}
+function guessAssetType(label, fallback) {
+    const rules = [
+        [/RenderTexture/i, 'RenderTexture'],
+        [/纹理|Texture/i, 'Texture'],
+        [/网格|Mesh/i, 'Mesh'],
+        [/Shader/i, 'Shader'],
+        [/材质|Material/i, 'Material'],
+        [/动画|Animation/i, 'AnimationClip'],
+        [/音频|Audio/i, 'AudioClip'],
+        [/字体|Font/i, 'Font'],
+        [/AssetBundle/i, 'AssetBundle'],
+        [/TextAsset|文本资源/i, 'TextAsset'],
+        [/粒子|Particle/i, 'ParticleSystem'],
+        [/Lua/i, 'Lua'],
+        [/Mono/i, 'Mono'],
+        [/Gfx/i, 'Gfx'],
+    ];
+    for (const [re, t] of rules)
+        if (re.test(label))
+            return t;
+    return fallback;
+}
+/** 把 summary / UE brief 一类 [{label,value}] 展开成 map。 */
+function expandLabelValueRows(rows) {
+    const out = {};
+    for (const row of rows) {
+        if (!isObj(row))
+            continue;
+        const label = String(row['label'] ?? row['key'] ?? '');
+        if (!label)
+            continue;
+        out[label] = firstVal(row['value'] ?? row['data']);
+        const key = row['key'];
+        if (typeof key === 'string' && key && !(key in out))
+            out[key] = out[label];
+    }
+    return out;
+}
+function basicInfoMap(basicInfo) {
+    const out = {};
+    if (!basicInfo)
+        return out;
+    const rows = Array.isArray(basicInfo)
+        ? basicInfo
+        : isObj(basicInfo)
+            ? Object.values(basicInfo)
+            : [];
+    for (const row of rows) {
+        if (!isObj(row))
+            continue;
+        const key = String(row['key'] ?? row['label'] ?? '');
+        if (!key)
+            continue;
+        out[key] = firstVal(row['data'] ?? row['value']);
+        const label = row['label'];
+        if (typeof label === 'string' && label && !(label in out))
+            out[label] = out[key];
+    }
+    return out;
+}
+function parseHasResource(summary, brief) {
+    for (const src of [brief, summary]) {
+        for (const [k, v] of Object.entries(src)) {
+            const keyHit = /^(OverviewHasResource|Resource|resourceMemory|resourceManagement|资源内存|资源管理|资源采集)$/i.test(k);
+            if (!keyHit)
+                continue;
+            const n = numOf(v);
+            if (n != null)
+                return n !== 0;
+            const s = String(firstVal(v) ?? '');
+            if (s === '1' || s === '2' || /详细|开启|千帧|60|模式/.test(s))
+                return true;
+            if (s === '0' || /关闭|无|关/.test(s))
+                return false;
+        }
+    }
+    return null;
+}
+/**
+ * UE 2.0：从 Resource / resource 段判定资源采集。
+ * 「资源内存占用峰值」> 0 → true；段存在但无法确认时返回 null（不误报关闭）。
+ */
+function parseHasResourceFromResourceSection(report) {
+    const section = report['Resource'] ?? report['resource'];
+    if (!Array.isArray(section) || section.length === 0)
+        return null;
+    let peak = null;
+    let anyMemPositive = false;
+    for (const item of section) {
+        if (!isObj(item))
+            continue;
+        const label = String(item['label'] ?? item['key'] ?? '');
+        const n = numOf(item['value'] ?? item['data']);
+        if (n == null)
+            continue;
+        if (/^资源内存占用峰值/.test(label) || /资源内存占用峰值（MB）/.test(label))
+            peak = n;
+        const unit = unitFromLabel(label) ?? '';
+        if (looksLikeMemoryMetric(label, '', unit) && n > 0)
+            anyMemPositive = true;
+    }
+    if (peak != null && peak > 0)
+        return true;
+    if (anyMemPositive)
+        return true;
+    return null;
+}
+/** 解析 Resource / resource 数组 → memory[]（排除数量峰值）。 */
+function memoryFromResourceSection(report) {
+    const section = report['Resource'] ?? report['resource'];
+    if (!Array.isArray(section))
+        return [];
+    const memory = [];
+    for (const item of section) {
+        if (!isObj(item))
+            continue;
+        const label = String(item['label'] ?? item['key'] ?? '');
+        const num = numOf(item['value'] ?? item['data']);
+        if (!label || num == null)
+            continue;
+        const unit = unitFromLabel(label) ?? 'mb';
+        if (!looksLikeMemoryMetric(label, '', unit))
+            continue;
+        // 总「资源内存占用峰值」不绑具体类型，仍保留便于看总量
+        memory.push({
+            name: label,
+            assetType: guessAssetType(label, 'Resource'),
+            memoryBytes: toBytes(num, unit),
+            _source: 'overview.Resource',
+        });
+    }
+    return memory;
+}
+function extractV2(data) {
+    const summary = basicInfoMap(data['basicInfo']);
+    const brief = {};
+    const functions = [];
+    const memory = [];
+    const categories = Array.isArray(data['categories']) ? data['categories'] : [];
+    for (const cat of categories) {
+        if (!isObj(cat))
+            continue;
+        const catName = String(cat['category'] ?? '');
+        const indicators = Array.isArray(cat['indicators']) ? cat['indicators'] : [];
+        for (const ind of indicators) {
+            if (!isObj(ind))
+                continue;
+            const label = String(ind['label'] ?? ind['key'] ?? '');
+            const key = String(ind['key'] ?? ind['indicatorKey'] ?? label);
+            const value = numOf(ind['data'] ?? ind['value']);
+            const unitObj = ind['unit'];
+            const unit = isObj(unitObj) ? String(unitObj['value'] ?? unitObj['description'] ?? '') : String(unitObj ?? '');
+            if (value != null && key)
+                brief[key] = value;
+            if (value != null && label && !(label in brief))
+                brief[label] = value;
+            const isFuncCat = /卡顿|重点函数|函数/.test(catName);
+            const isMemCat = /内存|资源|LLM/i.test(catName);
+            if (isFuncCat && value != null && label) {
+                functions.push({
+                    name: label,
+                    value,
+                    unit: unit || undefined,
+                    source: `overview.v2.${catName}`,
+                    label: catName,
+                });
+            }
+            if (isMemCat && value != null && label && looksLikeMemoryMetric(label, key, unit)) {
+                memory.push({
+                    name: label,
+                    assetType: guessAssetType(label, catName),
+                    memoryBytes: toBytes(value, unit),
+                    _source: `overview.v2.${catName}`,
+                });
+            }
+        }
+    }
+    functions.sort((a, b) => b.value - a.value);
+    memory.sort((a, b) => b.memoryBytes - a.memoryBytes);
+    return {
+        brief,
+        summary,
+        functions,
+        memory,
+        hasResource: parseHasResource(summary, brief),
+        shape: 'v2',
+    };
+}
+function extractV1OrUe(report) {
+    const brief = {};
+    const summary = {};
+    const functions = [];
+    const memory = [];
+    const briefIsArray = Array.isArray(report['brief']);
+    if (briefIsArray) {
+        Object.assign(brief, expandLabelValueRows(report['brief']));
+    }
+    else if (isObj(report['brief'])) {
+        for (const [k, v] of Object.entries(report['brief']))
+            brief[k] = firstVal(v);
+    }
+    if (Array.isArray(report['summary'])) {
+        Object.assign(summary, expandLabelValueRows(report['summary']));
+    }
+    else if (isObj(report['reportInfo'])) {
+        Object.assign(summary, report['reportInfo']);
+    }
+    if (Array.isArray(report['func'])) {
+        for (const item of report['func']) {
+            if (!isObj(item))
+                continue;
+            const name = String(item['label'] ?? item['key'] ?? item['name'] ?? '');
+            const value = numOf(item['value'] ?? item['data']);
+            if (!name || value == null)
+                continue;
+            functions.push({ name, value, source: 'overview.func', label: name });
+        }
+    }
+    if (isObj(report['brief'])) {
+        for (const [k, v] of Object.entries(report['brief'])) {
+            if (!/_mem_max_mb$/i.test(k) && !/Memory.*max/i.test(k))
+                continue;
+            const num = numOf(v);
+            if (num == null)
+                continue;
+            memory.push({
+                name: k,
+                assetType: k.replace(/_mem_max_mb$/i, ''),
+                memoryBytes: toBytes(num, 'mb'),
+                _source: 'overview.brief',
+            });
+        }
+    }
+    // UE 数组 brief 里也可能夹带内存类指标（类型级）
+    if (briefIsArray) {
+        for (const [label, v] of Object.entries(brief)) {
+            if (!looksLikeMemoryMetric(label, '', unitFromLabel(label) ?? ''))
+                continue;
+            const num = numOf(v);
+            if (num == null)
+                continue;
+            if (memory.some((m) => m.name === label))
+                continue;
+            memory.push({
+                name: label,
+                assetType: guessAssetType(label, 'brief'),
+                memoryBytes: toBytes(num, unitFromLabel(label) ?? 'mb'),
+                _source: 'overview.brief',
+            });
+        }
+    }
+    for (const row of memoryFromResourceSection(report)) {
+        if (memory.some((m) => m.name === row.name))
+            continue;
+        memory.push(row);
+    }
+    if (Array.isArray(report['asset_stats'])) {
+        for (const item of report['asset_stats']) {
+            if (!isObj(item))
+                continue;
+            const label = String(item['label'] ?? item['key'] ?? '');
+            const num = numOf(item['value'] ?? item['data']);
+            if (!label || num == null)
+                continue;
+            if (memory.some((m) => m.name === label))
+                continue;
+            const looksMb = /mb|内存/i.test(label);
+            memory.push({
+                name: label,
+                assetType: guessAssetType(label, label),
+                memoryBytes: looksMb ? toBytes(num, 'mb') : toBytes(num, 'b'),
+                _source: 'overview.asset_stats',
+            });
+        }
+    }
+    if (Array.isArray(report['LLM'])) {
+        for (const item of report['LLM']) {
+            if (!isObj(item))
+                continue;
+            const label = String(item['label'] ?? item['key'] ?? '');
+            const num = numOf(item['value'] ?? item['data']);
+            if (!label || num == null)
+                continue;
+            memory.push({ name: label, assetType: 'LLM', memoryBytes: toBytes(num, 'b'), _source: 'overview.LLM' });
+        }
+    }
+    functions.sort((a, b) => b.value - a.value);
+    memory.sort((a, b) => b.memoryBytes - a.memoryBytes);
+    const fromSection = parseHasResourceFromResourceSection(report);
+    const fromFields = parseHasResource(summary, brief);
+    return {
+        brief,
+        summary,
+        functions,
+        memory,
+        hasResource: fromSection ?? fromFields,
+        shape: briefIsArray ? 'ue-v2' : 'v1',
+    };
+}
+/** 把 unwrap 后的报告或原始 data 统一成 OverviewView。 */
+export function viewOverview(data) {
+    if (!data) {
+        return { brief: {}, summary: {}, functions: [], memory: [], hasResource: null, shape: 'unknown' };
+    }
+    // 数组取第一份
+    let root = data;
+    if (Array.isArray(data) && data.length)
+        root = data[0];
+    if (!isObj(root)) {
+        return { brief: {}, summary: {}, functions: [], memory: [], hasResource: null, shape: 'unknown' };
+    }
+    if (Array.isArray(root['categories']) || root['basicInfo'] != null)
+        return extractV2(root);
+    // batch map: { [dataKey]: { categories... } }
+    const values = Object.values(root);
+    if (values.length === 1 && isObj(values[0]) && (Array.isArray(values[0]['categories']) || values[0]['basicInfo'])) {
+        return extractV2(values[0]);
+    }
+    for (const k of ['reports', 'list', 'content', 'data', 'records']) {
+        const v = root[k];
+        if (Array.isArray(v) && v.length && isObj(v[0]))
+            return viewOverview(v[0]);
+    }
+    if ('brief' in root ||
+        'func' in root ||
+        'summary' in root ||
+        'asset_stats' in root ||
+        'Resource' in root ||
+        'resource' in root) {
+        return extractV1OrUe(root);
+    }
+    // 可能整包就是 v2 包在更深一层
+    if (values.length && isObj(values[0]) && Array.isArray(values[0]['categories']))
+        return extractV2(values[0]);
+    return extractV1OrUe(root);
+}

package/dist/composite/report-diagnosis.d.ts

@@ -0,0 +1,2 @@
+import type { CompositeTool } from './types.js';
+export declare const reportDiagnosisTool: CompositeTool;