flutter-devtools-mcp 0.3.1

package/dist/services/rebuild-tracker-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuild-tracker-service.d.ts","sourceRoot":"","sources":["../../src/services/rebuild-tracker-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAGL,KAAK,QAAQ,EACd,MAAM,oBAAoB,CAAC;AAE5B,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACtC,MAAM,EAAE,OAAO,GACd,IAAI,CA6DN;AAwBD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,SAAS,CAAK;IAEtB,OAAO,CAAC,eAAe,CAyBrB;gBAEU,MAAM,EAAE,sBAAsB;IAI1C,IAAI,UAAU,IAAI,OAAO,CAExB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BtB,IAAI,CAAC,IAAI,SAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAqD9C,cAAc,IAAI,MAAM;CAIzB"}

package/dist/services/rebuild-tracker-service.js

@@ -0,0 +1,196 @@
+import { normalizeSourceFile, severityFromRebuildCount, } from "./session-types.js";
+/**
+ * Flutter.RebuiltWidgets / widgetLocationIdMap 的 locations 格式（DevTools 同款）：
+ * {
+ *   "file:///.../lib/main.dart": {
+ *     "ids": [1, 2],
+ *     "lines": [23, 32],
+ *     "columns": [10, 12],
+ *     "names": ["HomePage", "OrderCard"]
+ *   }
+ * }
+ *
+ * 旧版 newLocations：{ "file": [id, line, column, ...] }
+ * 兼容扁平：{ "24": { file, line, column, name } }
+ */
+export function mergeLocationMap(target, source) {
+    if (!source || typeof source !== "object")
+        return;
+    for (const [key, value] of Object.entries(source)) {
+        if (value == null)
+            continue;
+        // 扁平：id -> { file, line, ... }
+        if (typeof value === "object" &&
+            !Array.isArray(value) &&
+            ("file" in value ||
+                "scriptUri" in value ||
+                "name" in value ||
+                "className" in value) &&
+            !("ids" in value)) {
+            const loc = normalizeWidgetLocation(value);
+            if (loc)
+                target[String(key)] = loc;
+            continue;
+        }
+        // 新版：file -> { ids, lines, columns, names }
+        if (typeof value === "object" &&
+            !Array.isArray(value) &&
+            "ids" in value) {
+            const entry = value;
+            const ids = entry.ids ?? [];
+            const lines = entry.lines ?? [];
+            const columns = entry.columns ?? [];
+            const names = entry.names ?? [];
+            for (let i = 0; i < ids.length; i++) {
+                const id = ids[i];
+                if (id == null)
+                    continue;
+                target[String(id)] = {
+                    file: key,
+                    line: Number(lines[i] ?? 0),
+                    column: Number(columns[i] ?? 0),
+                    name: String(names[i] ?? "Unknown"),
+                };
+            }
+            continue;
+        }
+        // 旧版 newLocations：file -> [id, line, column, id, line, column, ...]
+        if (Array.isArray(value)) {
+            for (let i = 0; i + 2 < value.length; i += 3) {
+                const id = value[i];
+                if (id == null)
+                    continue;
+                target[String(id)] = {
+                    file: key,
+                    line: Number(value[i + 1] ?? 0),
+                    column: Number(value[i + 2] ?? 0),
+                    name: "Unknown",
+                };
+            }
+        }
+    }
+}
+function normalizeWidgetLocation(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const loc = raw;
+    const file = loc.file ??
+        loc.scriptUri ??
+        loc.path ??
+        "";
+    const name = loc.name ??
+        loc.className ??
+        loc.kind ??
+        "Unknown";
+    if (!file && name === "Unknown")
+        return null;
+    return {
+        file,
+        line: Number(loc.line ?? loc.lineNumber ?? 0),
+        column: Number(loc.column ?? loc.columnNumber ?? 0),
+        name,
+    };
+}
+export class RebuildTrackerService {
+    client;
+    tracking = false;
+    rebuildCounts = new Map();
+    locationMap = {};
+    startTime = 0;
+    rebuildListener = (event) => {
+        const e = event;
+        if (e?.extensionKind !== "Flutter.RebuiltWidgets")
+            return;
+        const data = e.extensionData;
+        if (data?.locations)
+            mergeLocationMap(this.locationMap, data.locations);
+        if (data?.newLocations)
+            mergeLocationMap(this.locationMap, data.newLocations);
+        if (!data?.events?.length)
+            return;
+        for (let i = 0; i < data.events.length; i += 2) {
+            const locationId = data.events[i];
+            const count = data.events[i + 1];
+            this.rebuildCounts.set(locationId, (this.rebuildCounts.get(locationId) ?? 0) + count);
+        }
+    };
+    constructor(client) {
+        this.client = client;
+    }
+    get isTracking() {
+        return this.tracking;
+    }
+    async start() {
+        if (this.tracking)
+            throw new Error("Rebuild tracking already active");
+        this.rebuildCounts = new Map();
+        this.locationMap = {};
+        try {
+            await this.client.getWidgetTree();
+            await new Promise((r) => setTimeout(r, 500));
+        }
+        catch {
+            // inspector warmup optional
+        }
+        try {
+            mergeLocationMap(this.locationMap, await this.client.getWidgetLocationMap());
+        }
+        catch {
+            // optional
+        }
+        this.client.on("stream:Extension", this.rebuildListener);
+        await this.client.startTrackingRebuilds();
+        this.tracking = true;
+        this.startTime = Date.now();
+    }
+    async stop(topN = 15) {
+        if (!this.tracking)
+            throw new Error("Rebuild tracking not active");
+        try {
+            mergeLocationMap(this.locationMap, await this.client.getWidgetLocationMap());
+        }
+        catch {
+            // best effort before stop
+        }
+        await this.client.stopTrackingRebuilds();
+        this.client.off("stream:Extension", this.rebuildListener);
+        this.tracking = false;
+        try {
+            mergeLocationMap(this.locationMap, await this.client.getWidgetLocationMap());
+        }
+        catch {
+            // best effort
+        }
+        const entries = [];
+        for (const [locationId, count] of this.rebuildCounts) {
+            const loc = this.locationMap[String(locationId)];
+            if (loc) {
+                const file = normalizeSourceFile(loc.file);
+                entries.push({
+                    widget: loc.name,
+                    file,
+                    line: loc.line,
+                    count,
+                    severity: severityFromRebuildCount(count),
+                });
+            }
+            else {
+                entries.push({
+                    widget: `Unknown(${locationId})`,
+                    file: "unknown",
+                    line: 0,
+                    count,
+                    severity: severityFromRebuildCount(count),
+                });
+            }
+        }
+        entries.sort((a, b) => b.count - a.count);
+        return entries.slice(0, topN);
+    }
+    getDurationSec() {
+        if (!this.startTime)
+            return 0;
+        return (Date.now() - this.startTime) / 1000;
+    }
+}
+//# sourceMappingURL=rebuild-tracker-service.js.map

package/dist/services/rebuild-tracker-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuild-tracker-service.js","sourceRoot":"","sources":["../../src/services/rebuild-tracker-service.ts"],"names":[],"mappings":"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"}

package/dist/services/session-types.d.ts

@@ -0,0 +1,240 @@
+export type Severity = "low" | "medium" | "high" | "critical";
+/** 掉帧判定固定按 60FPS：单帧 > 16.67ms 计为 jank（不跟设备刷新率） */
+export declare const JANK_TARGET_FPS = 60;
+export declare const JANK_FRAME_BUDGET_MS: number;
+/** 耗时函数（业务 lib/ Top）Self 超过该值判为异常 */
+export declare const HOT_FUNCTION_ABNORMAL_MS = 20;
+export interface PerformanceSessionResult {
+    scenario: string;
+    /** 兼容旧字段：等同 wallClockSec（从启动到报告完成的总墙钟时间） */
+    durationSec: number;
+    /** 实际录制窗口（warmup + durationSec 参数） */
+    recordingWindowSec?: number;
+    /** 总墙钟时间（含收尾分析） */
+    wallClockSec?: number;
+    progressLog?: string[];
+    profileModeHint: string;
+    frames: {
+        total: number;
+        jankCount: number;
+        jankPct: number;
+        avgMs: number;
+        p99Ms: number;
+        buildMaxMs: number;
+        layoutMaxMs: number;
+        paintMaxMs: number;
+    };
+    topFunctions: Array<{
+        name: string;
+        file: string;
+        selfMs: number;
+        pct: number;
+        severity: Severity;
+    }>;
+    projectTopFunctions: Array<{
+        name: string;
+        file: string;
+        selfMs: number;
+        pct: number;
+        severity: Severity;
+    }>;
+    /** VM / 引擎内部 CPU 热点（可读化，非业务 lib/） */
+    vmTopFunctions?: Array<{
+        name: string;
+        rawName: string;
+        file: string;
+        selfMs: number;
+        pct: number;
+        severity: Severity;
+    }>;
+    topRebuilds: Array<{
+        widget: string;
+        file: string;
+        line: number;
+        count: number;
+        severity: Severity;
+        /** 业务侧定位（上级 Widget / 页面） */
+        bizWidget?: string;
+        bizFile?: string;
+        bizLine?: number;
+        bizSource?: "direct" | "runtime" | "static" | "inferred";
+        /** 代码库内参考引用，非当前屏定位 */
+        staticRefNote?: string;
+    }>;
+    memory: {
+        /** false 表示未调用 getAllocationProfile（默认关闭以缩短收尾） */
+        collected?: boolean;
+        heapMb: number;
+        utilizationPct: number;
+        topClasses: Array<{
+            name: string;
+            instances: number;
+            bytesMb: number;
+        }>;
+        suspicious: string[];
+    };
+    network: {
+        total: number;
+        errors: number;
+        slow: Array<{
+            method: string;
+            url: string;
+            ms: number;
+            status?: number;
+        }>;
+        /** 请求频率 req/s */
+        qps?: number;
+        avgMs?: number;
+        /** 响应体 >= Dio 默认 50KB 阈值 */
+        largeJsonResponseCount?: number;
+        topPaths?: Array<{
+            path: string;
+            method?: string;
+            count: number;
+            avgMs?: number;
+            totalBytes?: number;
+        }>;
+        /** JSON/Transform 解析耗时 Top（非 HTTP 总耗时） */
+        topParsePaths?: Array<{
+            path: string;
+            method?: string;
+            count: number;
+            avgParseMs: number;
+            totalParseMs: number;
+            avgPostResponseMs?: number;
+            totalBytes?: number;
+            source: "measured" | "estimate" | "mixed";
+        }>;
+    };
+    /** Dio FusedTransformer 后台 JSON 解析与 HTTP 统计关联 */
+    dioJsonDecode?: {
+        detected: true;
+        source: string;
+        isolateThresholdKb: number;
+        workerCount: number;
+        totalWorkerCpuMs: number;
+        networkTotal: number;
+        networkQps: number;
+        largeJsonResponseCount: number;
+        topPaths: Array<{
+            path: string;
+            count: number;
+            avgMs?: number;
+            totalBytes?: number;
+        }>;
+        suggestions: string[];
+    };
+    /** GC 停顿（Timeline GC 流） */
+    gc?: {
+        count: number;
+        totalPauseMs: number;
+        maxPauseMs: number;
+        avgPauseMs: number;
+        longPauseCount: number;
+        /** 最长停顿 Top5 */
+        topPauses?: Array<{
+            name: string;
+            ms: number;
+        }>;
+    };
+    /** 滚动/交互分段 FPS（2s 窗口） */
+    scrollFps?: {
+        segmentSec: number;
+        overallFps: number;
+        worstSegments: Array<{
+            startSec: number;
+            endSec: number;
+            frames: number;
+            fps: number;
+            jankCount: number;
+            jankPct: number;
+            avgMs: number;
+            maxMs: number;
+        }>;
+    };
+    /** 图片解码粗统计 */
+    imageDecode?: {
+        count: number;
+        totalMs: number;
+        maxMs: number;
+        slow: Array<{
+            name: string;
+            ms: number;
+            url?: string;
+            width?: number;
+            height?: number;
+            bytes?: number;
+        }>;
+        /** 有解码信号但无有效时长 */
+        untimedSignals?: number;
+    };
+    /** 各 isolate CPU 采样对比 */
+    isolateCpu?: Array<{
+        isolateId: string;
+        name: string;
+        isMain: boolean;
+        sampleCount: number;
+        topSelfMs: number;
+        topName: string;
+    }>;
+    /** 超阈值：大图片 / 大接口 + 解析或解码耗时 */
+    thresholdAlerts?: {
+        config: {
+            largeImageBytes: number;
+            slowImageDecodeMs: number;
+            largeApiBytes: number;
+            slowApiParseMs: number;
+        };
+        summary: {
+            largeImageHits: number;
+            slowDecodeHits: number;
+            largeApiHits: number;
+            slowParseHits: number;
+        };
+        largeImages: Array<{
+            url: string;
+            path: string;
+            bytes?: number;
+            width?: number;
+            height?: number;
+            decodeMs?: number;
+            httpMs?: number;
+            triggers: string[];
+            source: "timeline" | "http" | "both";
+        }>;
+        largeApis: Array<{
+            method?: string;
+            path: string;
+            count: number;
+            bytes?: number;
+            avgBytes?: number;
+            avgParseMs: number;
+            totalParseMs: number;
+            triggers: string[];
+            parseSource?: "measured" | "estimate" | "mixed";
+        }>;
+    };
+    filesToInspect: string[];
+    hintsForAnalysis: string[];
+    aiNextStep: string;
+    cpuProfileSource?: "vm-samples" | "timeline-dart" | "timeline-hotspot" | "none";
+    aiAnalysis?: string;
+}
+export declare const PERFORMANCE_SESSIONS_DIR = "performance-sessions";
+export declare function resolveSessionOutputDir(options: {
+    outputDir?: string;
+    projectRoot?: string;
+}): string;
+export declare function severityFromRebuildCount(count: number): Severity;
+export declare function severityFromPct(pct: number): Severity;
+export declare function normalizeSourceFile(file: string): string;
+export declare function isFrameworkOrSdkFile(file: string): boolean;
+export declare function isProjectSourceFile(file: string): boolean;
+/**
+ * 是否为业务 App 的 lib/ 源码。
+ * @param packageName 可选：pubspec name，用于识别 package:<name>/...
+ */
+export declare function isAppLibFile(file: string, packageName?: string): boolean;
+/** 从 pubspec.yaml 文本解析 name */
+export declare function parsePubspecPackageName(pubspecText: string): string | undefined;
+//# sourceMappingURL=session-types.d.ts.map

package/dist/services/session-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-types.d.ts","sourceRoot":"","sources":["../../src/services/session-types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE9D,kDAAkD;AAClD,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,oBAAoB,QAAyB,CAAC;AAE3D,qCAAqC;AACrC,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,YAAY,EAAE,KAAK,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,QAAQ,CAAC;KACpB,CAAC,CAAC;IACH,mBAAmB,EAAE,KAAK,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,QAAQ,CAAC;KACpB,CAAC,CAAC;IACH,qCAAqC;IACrC,cAAc,CAAC,EAAE,KAAK,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,QAAQ,CAAC;KACpB,CAAC,CAAC;IACH,WAAW,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,QAAQ,CAAC;QACnB,4BAA4B;QAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;QACzD,sBAAsB;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,MAAM,EAAE;QACN,kDAAkD;QAClD,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACxE,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC1E,iBAAiB;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,4BAA4B;QAC5B,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,EAAE,KAAK,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;QACH,0CAA0C;QAC1C,aAAa,CAAC,EAAE,KAAK,CAAC;YACpB,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,UAAU,EAAE,MAAM,CAAC;YACnB,YAAY,EAAE,MAAM,CAAC;YACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;SAC3C,CAAC,CAAC;KACJ,CAAC;IACF,iDAAiD;IACjD,aAAa,CAAC,EAAE;QACd,QAAQ,EAAE,IAAI,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,kBAAkB,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,QAAQ,EAAE,KAAK,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;QACH,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,2BAA2B;IAC3B,EAAE,CAAC,EAAE;QACH,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB;QAChB,SAAS,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACjD,CAAC;IACF,yBAAyB;IACzB,SAAS,CAAC,EAAE;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,KAAK,CAAC;YACnB,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,CAAC;YACf,GAAG,EAAE,MAAM,CAAC;YACZ,SAAS,EAAE,MAAM,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;SACf,CAAC,CAAC;KACJ,CAAC;IACF,cAAc;IACd,WAAW,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,KAAK,CAAC;YACV,IAAI,EAAE,MAAM,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;YACX,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,CAAC,CAAC;QACH,kBAAkB;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,yBAAyB;IACzB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,8BAA8B;IAC9B,eAAe,CAAC,EAAE;QAChB,MAAM,EAAE;YACN,eAAe,EAAE,MAAM,CAAC;YACxB,iBAAiB,EAAE,MAAM,CAAC;YAC1B,aAAa,EAAE,MAAM,CAAC;YACtB,cAAc,EAAE,MAAM,CAAC;SACxB,CAAC;QACF,OAAO,EAAE;YACP,cAAc,EAAE,MAAM,CAAC;YACvB,cAAc,EAAE,MAAM,CAAC;YACvB,YAAY,EAAE,MAAM,CAAC;YACrB,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC;QACF,WAAW,EAAE,KAAK,CAAC;YACjB,GAAG,EAAE,MAAM,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnB,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;SACtC,CAAC,CAAC;QACH,SAAS,EAAE,KAAK,CAAC;YACf,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,UAAU,EAAE,MAAM,CAAC;YACnB,YAAY,EAAE,MAAM,CAAC;YACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnB,WAAW,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;SACjD,CAAC,CAAC;KACJ,CAAC;IACF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,YAAY,GAAG,eAAe,GAAG,kBAAkB,GAAG,MAAM,CAAC;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAE/D,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAMT;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAKhE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAKrD;AAmBD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2ExD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAqC1D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUzD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAUxE;AAED,+BAA+B;AAC/B,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG/E"}

package/dist/services/session-types.js

@@ -0,0 +1,180 @@
+import { join } from "path";
+/** 掉帧判定固定按 60FPS：单帧 > 16.67ms 计为 jank（不跟设备刷新率） */
+export const JANK_TARGET_FPS = 60;
+export const JANK_FRAME_BUDGET_MS = 1000 / JANK_TARGET_FPS; // ≈ 16.666…ms
+/** 耗时函数（业务 lib/ Top）Self 超过该值判为异常 */
+export const HOT_FUNCTION_ABNORMAL_MS = 20;
+export const PERFORMANCE_SESSIONS_DIR = "performance-sessions";
+export function resolveSessionOutputDir(options) {
+    if (options.outputDir)
+        return options.outputDir;
+    if (options.projectRoot) {
+        return join(options.projectRoot, PERFORMANCE_SESSIONS_DIR);
+    }
+    return PERFORMANCE_SESSIONS_DIR;
+}
+export function severityFromRebuildCount(count) {
+    if (count > 100)
+        return "critical";
+    if (count > 30)
+        return "high";
+    if (count > 10)
+        return "medium";
+    return "low";
+}
+export function severityFromPct(pct) {
+    if (pct > 20)
+        return "critical";
+    if (pct > 10)
+        return "high";
+    if (pct > 5)
+        return "medium";
+    return "low";
+}
+/** Flutter / Dart SDK 与常见包，不算业务 App 源码 */
+const NON_APP_PACKAGE_PREFIXES = [
+    "package:flutter/",
+    "package:flutter_test/",
+    "package:flutter_localizations/",
+    "package:flutter_web_plugins/",
+    "package:sky_engine/",
+    "package:collection/",
+    "package:characters/",
+    "package:vector_math/",
+    "package:meta/",
+    "package:async/",
+    "package:path/",
+    "package:stack_trace/",
+    "dart:",
+];
+export function normalizeSourceFile(file) {
+    const raw = file.trim();
+    if (!raw)
+        return raw;
+    // 已是 lib/... 相对路径
+    if (raw.startsWith("lib/") || raw.startsWith("LIB/")) {
+        return raw.replace(/^LIB\//, "lib/");
+    }
+    // package:app_name/path/under/lib.dart → lib/path/under/lib.dart
+    const pkgMatch = raw.match(/^package:([^/]+)\/(.+)$/);
+    if (pkgMatch) {
+        const pkg = pkgMatch[1].toLowerCase();
+        const pathInPkg = pkgMatch[2];
+        // 仅精确匹配 SDK 包名，不要用 flutter_ 前缀误伤 flutter_simple 等业务包
+        if (pkg === "flutter" ||
+            pkg === "flutter_test" ||
+            pkg === "flutter_localizations" ||
+            pkg === "flutter_web_plugins" ||
+            pkg === "sky_engine") {
+            return `package:${pkgMatch[1]}/${pathInPkg}`;
+        }
+        if (pathInPkg.startsWith("lib/"))
+            return pathInPkg;
+        return `lib/${pathInPkg}`;
+    }
+    const cleaned = raw.replace(/^file:\/\//, "");
+    const lower = cleaned.toLowerCase();
+    // 排除 Flutter SDK 的 lib/，避免变成 lib/src/widgets/... 误判业务代码
+    if (lower.includes("/packages/flutter/lib/") ||
+        lower.includes("/bin/cache/pkg/sky_engine/") ||
+        lower.includes("/sky_engine/")) {
+        const libIdx = cleaned.indexOf("/lib/");
+        if (libIdx >= 0) {
+            const afterLib = cleaned.slice(libIdx + "/lib/".length);
+            if (lower.includes("/sky_engine/")) {
+                return `package:sky_engine/${afterLib}`;
+            }
+            return `package:flutter/${afterLib}`;
+        }
+        return cleaned;
+    }
+    // Dart SDK / dart:ui：不要收成业务 lib/
+    if (lower.includes("/dart-sdk/") ||
+        lower.includes("/org-dartlang-sdk/") ||
+        lower.includes("/lib/_internal/") ||
+        lower.includes("/lib/developer/") ||
+        lower.includes("/lib/async/") ||
+        lower.includes("/lib/core/") ||
+        lower.includes("/lib/io/") ||
+        lower.includes("/lib/isolate/") ||
+        lower.includes("/lib/ui/") ||
+        /\/flutter\/bin\/cache\/artifacts\/engine\//.test(lower)) {
+        const libIdx = cleaned.indexOf("/lib/");
+        if (libIdx >= 0) {
+            const after = cleaned.slice(libIdx + "/lib/".length);
+            if (after.startsWith("ui/") || after === "ui.dart") {
+                return `dart:ui/${after.replace(/^ui\//, "")}`;
+            }
+            return `dart:${after}`;
+        }
+        return cleaned;
+    }
+    const libIdx = cleaned.indexOf("/lib/");
+    if (libIdx >= 0)
+        return cleaned.slice(libIdx + 1);
+    return cleaned.split("/").pop() ?? cleaned;
+}
+export function isFrameworkOrSdkFile(file) {
+    const f = file.toLowerCase().replace(/^file:\/\//, "");
+    if (NON_APP_PACKAGE_PREFIXES.some((p) => f.startsWith(p)))
+        return true;
+    if (f.includes("/packages/flutter/") || f.includes("/sky_engine/"))
+        return true;
+    // 精确匹配 SDK package，避免 package:flutter_simple 被误判
+    if (f.startsWith("package:flutter/") ||
+        f.startsWith("package:flutter_test/") ||
+        f.startsWith("package:flutter_localizations/") ||
+        f.startsWith("package:flutter_web_plugins/") ||
+        f.startsWith("package:sky_engine/")) {
+        return true;
+    }
+    // 历史误归一：Flutter SDK 被收成 lib/src/widgets|rendering|scheduler/...
+    if (/^lib\/src\/(widgets|rendering|scheduler|painting|gestures|services|foundation|material|cupertino|animation)\//.test(f)) {
+        return true;
+    }
+    // Dart SDK / dart:ui / dart:_http / dart:internal 误归一
+    if (/^lib\/(developer|async|collection|convert|core|io|isolate|math|typed_data|_internal|ui|_http|internal)\//.test(f) ||
+        f.includes("lib/_internal/") ||
+        f.includes("lib/_http/") ||
+        f.includes("lib/internal/") ||
+        f.startsWith("dart:")) {
+        return true;
+    }
+    return false;
+}
+export function isProjectSourceFile(file) {
+    const f = file.toLowerCase().replace(/^file:\/\//, "");
+    if (!f || isFrameworkOrSdkFile(f))
+        return false;
+    if (f.startsWith("lib/"))
+        return true;
+    if (f.startsWith("package:") && f.endsWith(".dart"))
+        return true;
+    return (f.endsWith(".dart") &&
+        !f.startsWith("dart:") &&
+        !f.includes("package:flutter"));
+}
+/**
+ * 是否为业务 App 的 lib/ 源码。
+ * @param packageName 可选：pubspec name，用于识别 package:<name>/...
+ */
+export function isAppLibFile(file, packageName) {
+    const f = file.toLowerCase().replace(/^file:\/\//, "");
+    if (!f || isFrameworkOrSdkFile(f))
+        return false;
+    if (f.startsWith("lib/"))
+        return true;
+    if (packageName) {
+        const prefix = `package:${packageName.toLowerCase()}/`;
+        if (f.startsWith(prefix))
+            return true;
+    }
+    // 已归一化为 lib/... 的 package URI
+    return false;
+}
+/** 从 pubspec.yaml 文本解析 name */
+export function parsePubspecPackageName(pubspecText) {
+    const m = pubspecText.match(/^\s*name:\s*['"]?([A-Za-z0-9_]+)['"]?\s*$/m);
+    return m?.[1];
+}
+//# sourceMappingURL=session-types.js.map

package/dist/services/session-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-types.js","sourceRoot":"","sources":["../../src/services/session-types.ts"],"names":[],"mappings":"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"}