@gracker/smartperfetto 1.0.13

package/dist/services/analysisTemplates/frameStatsAnalysis.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 帧率统计分析模板
+ * 分析应用的帧率性能：FPS、掉帧、P95/P99延迟等
+ */
+import { TraceProcessorService } from '../traceProcessorService';
+export interface FrameStatsResult {
+    summary: {
+        totalFrames: number;
+        avgFps: number;
+        jankCount: number;
+        jankPercentage: number;
+        avgFrameDurationMs: number;
+    };
+    percentiles: {
+        p50Ms: number;
+        p90Ms: number;
+        p95Ms: number;
+        p99Ms: number;
+        maxMs: number;
+    };
+    jankFrames: {
+        timestamp: number;
+        durationMs: number;
+        vsyncsMissed: number;
+    }[];
+    visualization: {
+        type: 'histogram';
+        data: {
+            bucketStart: number;
+            bucketEnd: number;
+            count: number;
+        }[];
+    };
+}
+export interface FrameStatsAnalyzerConfig {
+    /** Target frame time in milliseconds (default: derived from 60Hz) */
+    targetFrameTimeMs?: number;
+    /** Number of VSync periods missed before counting as jank (default: 2) */
+    jankVsyncThreshold?: number;
+    /** Detected VSync period in nanoseconds from trace metadata */
+    detectedVsyncPeriodNs?: string | bigint | number;
+    /** Device refresh rate in Hz from trace metadata */
+    deviceRefreshRate?: number;
+}
+export declare class FrameStatsAnalyzer {
+    private traceProcessor;
+    /**
+     * Target frame time in milliseconds.
+     * Derived from the configured VSync period (default 60Hz = 16.67ms).
+     */
+    private readonly targetFrameTimeMs;
+    /**
+     * Jank threshold in milliseconds.
+     * Default: 2 * targetFrameTimeMs (missing 2+ VSyncs = jank).
+     */
+    private readonly jankThresholdMs;
+    constructor(traceProcessor: TraceProcessorService, config?: FrameStatsAnalyzerConfig);
+    /**
+     * 执行帧率统计分析
+     * @param traceId Trace ID
+     * @param packageName 应用包名，可选
+     * @param startTs 开始时间戳（纳秒），可选
+     * @param endTs 结束时间戳（纳秒），可选
+     */
+    analyze(traceId: string, packageName?: string, startTs?: number, endTs?: number): Promise<FrameStatsResult>;
+    /**
+     * 简化版分析：基于 slice 表（适用于没有 actual_frame_timeline_slice 的trace）
+     */
+    analyzeFromSlices(traceId: string, processName: string, startTs?: number, endTs?: number): Promise<FrameStatsResult>;
+    private getPercentile;
+    private generateHistogram;
+    private buildTimeCondition;
+    private normalizeTimestamp;
+    private escapeLikePattern;
+    private resultToRows;
+}
+//# sourceMappingURL=frameStatsAnalysis.d.ts.map

package/dist/services/analysisTemplates/frameStatsAnalysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameStatsAnalysis.d.ts","sourceRoot":"","sources":["../../../src/services/analysisTemplates/frameStatsAnalysis.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,UAAU,EAAE;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,EAAE,CAAC;IACJ,aAAa,EAAE;QACb,IAAI,EAAE,WAAW,CAAC;QAClB,IAAI,EAAE;YACJ,WAAW,EAAE,MAAM,CAAC;YACpB,SAAS,EAAE,MAAM,CAAC;YAClB,KAAK,EAAE,MAAM,CAAC;SACf,EAAE,CAAC;KACL,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB;IACvC,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,qBAAqB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,kBAAkB;IAc3B,OAAO,CAAC,cAAc;IAbxB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAE3C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAG/B,cAAc,EAAE,qBAAqB,EAC7C,MAAM,CAAC,EAAE,wBAAwB;IAiBnC;;;;;;OAMG;IACG,OAAO,CACX,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC;IAoF5B;;OAEG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC;IAuE5B,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,iBAAiB;IA4BzB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,YAAY;CAarB"}

package/dist/services/analysisTemplates/frameStatsAnalysis.js

@@ -0,0 +1,232 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrameStatsAnalyzer = void 0;
+const thresholds_1 = require("../../config/thresholds");
+class FrameStatsAnalyzer {
+    constructor(traceProcessor, config) {
+        this.traceProcessor = traceProcessor;
+        // Use configured value or derive from centralized VSync config.
+        // For frame stats fallback, use 60Hz baseline unless trace metadata provides a better value.
+        const defaultVsyncMs = Number((0, thresholds_1.inferVsyncPeriodNs)({
+            detectedVsyncPeriodNs: config?.detectedVsyncPeriodNs,
+            deviceRefreshRate: config?.deviceRefreshRate ?? 60,
+        })) / 1000000;
+        this.targetFrameTimeMs = config?.targetFrameTimeMs ?? defaultVsyncMs;
+        // Jank threshold: default 2 VSyncs missed
+        const jankVsyncThreshold = config?.jankVsyncThreshold ?? 2;
+        this.jankThresholdMs = this.targetFrameTimeMs * jankVsyncThreshold;
+    }
+    /**
+     * 执行帧率统计分析
+     * @param traceId Trace ID
+     * @param packageName 应用包名，可选
+     * @param startTs 开始时间戳（纳秒），可选
+     * @param endTs 结束时间戳（纳秒），可选
+     */
+    async analyze(traceId, packageName, startTs, endTs) {
+        const timeCondition = this.buildTimeCondition(startTs, endTs, 'slice.ts');
+        const packageCondition = packageName
+            ? `AND process.name LIKE '%${this.escapeLikePattern(packageName)}%' ESCAPE '\\'`
+            : '';
+        // 查询所有帧的时长
+        // 使用 actual_frame_timeline_slice 表（Android 的帧时间线）
+        const query = `
+      SELECT
+        slice.ts AS ts,
+        slice.dur / 1e6 AS dur_ms,
+        slice.frame_number AS frame_number
+      FROM actual_frame_timeline_slice slice
+      JOIN process_track track ON slice.track_id = track.id
+      JOIN process ON track.upid = process.upid
+      WHERE slice.dur > 0
+        ${timeCondition}
+        ${packageCondition}
+      ORDER BY slice.ts
+    `;
+        const result = await this.traceProcessor.query(traceId, query);
+        const rows = this.resultToRows(result);
+        if (rows.length === 0) {
+            throw new Error('No frame data found. Make sure the trace contains frame timing information.');
+        }
+        // 计算基本统计
+        const durations = rows.map(r => parseFloat(r.dur_ms));
+        const totalFrames = durations.length;
+        const avgDuration = durations.reduce((sum, d) => sum + d, 0) / totalFrames;
+        // 计算时间范围（秒）
+        const firstTs = parseInt(rows[0].ts);
+        const lastTs = parseInt(rows[rows.length - 1].ts);
+        const rawTotalTimeSec = (lastTs - firstTs) / 1e9;
+        const totalTimeSec = rawTotalTimeSec > 0 ? rawTotalTimeSec : 1e-6;
+        const avgFps = totalFrames / totalTimeSec;
+        // 识别掉帧
+        const allJankFrames = rows
+            .filter(r => parseFloat(r.dur_ms) > this.jankThresholdMs)
+            .map(r => ({
+            timestamp: parseInt(r.ts),
+            durationMs: parseFloat(r.dur_ms),
+            vsyncsMissed: Math.floor(parseFloat(r.dur_ms) / this.targetFrameTimeMs),
+        }));
+        const jankFrames = allJankFrames.slice(0, 100); // 限制返回前 100 个掉帧点
+        const jankCount = allJankFrames.length;
+        const jankPercentage = (jankCount / totalFrames) * 100;
+        // 计算百分位数
+        const sortedDurations = [...durations].sort((a, b) => a - b);
+        const percentiles = {
+            p50Ms: this.getPercentile(sortedDurations, 50),
+            p90Ms: this.getPercentile(sortedDurations, 90),
+            p95Ms: this.getPercentile(sortedDurations, 95),
+            p99Ms: this.getPercentile(sortedDurations, 99),
+            maxMs: Math.max(...durations),
+        };
+        // 生成直方图数据
+        const histogram = this.generateHistogram(durations);
+        return {
+            summary: {
+                totalFrames,
+                avgFps,
+                jankCount,
+                jankPercentage,
+                avgFrameDurationMs: avgDuration,
+            },
+            percentiles,
+            jankFrames,
+            visualization: {
+                type: 'histogram',
+                data: histogram,
+            },
+        };
+    }
+    /**
+     * 简化版分析：基于 slice 表（适用于没有 actual_frame_timeline_slice 的trace）
+     */
+    async analyzeFromSlices(traceId, processName, startTs, endTs) {
+        const timeCondition = this.buildTimeCondition(startTs, endTs, 's.ts');
+        // 查找渲染相关的 slice
+        const query = `
+      SELECT
+        s.ts AS ts,
+        s.dur / 1e6 AS dur_ms,
+        s.name AS name
+      FROM slice s
+      WHERE (
+        s.name LIKE 'Choreographer#doFrame'
+        OR s.name LIKE 'DrawFrame'
+        OR s.name LIKE 'performTraversals'
+      )
+      ${timeCondition}
+      ORDER BY s.ts
+    `;
+        const result = await this.traceProcessor.query(traceId, query);
+        const rows = this.resultToRows(result);
+        if (rows.length === 0) {
+            throw new Error('No frame data found in slice table');
+        }
+        // 使用类似的统计方法
+        const durations = rows.map(r => parseFloat(r.dur_ms));
+        const totalFrames = durations.length;
+        const avgDuration = durations.reduce((sum, d) => sum + d, 0) / totalFrames;
+        const firstTs = parseInt(rows[0].ts);
+        const lastTs = parseInt(rows[rows.length - 1].ts);
+        const rawTotalTimeSec = (lastTs - firstTs) / 1e9;
+        const totalTimeSec = rawTotalTimeSec > 0 ? rawTotalTimeSec : 1e-6;
+        const avgFps = totalFrames / totalTimeSec;
+        const allJankFrames = rows
+            .filter(r => parseFloat(r.dur_ms) > this.jankThresholdMs)
+            .map(r => ({
+            timestamp: parseInt(r.ts),
+            durationMs: parseFloat(r.dur_ms),
+            vsyncsMissed: Math.floor(parseFloat(r.dur_ms) / this.targetFrameTimeMs),
+        }));
+        const jankFrames = allJankFrames.slice(0, 100);
+        const sortedDurations = [...durations].sort((a, b) => a - b);
+        return {
+            summary: {
+                totalFrames,
+                avgFps,
+                jankCount: allJankFrames.length,
+                jankPercentage: (allJankFrames.length / totalFrames) * 100,
+                avgFrameDurationMs: avgDuration,
+            },
+            percentiles: {
+                p50Ms: this.getPercentile(sortedDurations, 50),
+                p90Ms: this.getPercentile(sortedDurations, 90),
+                p95Ms: this.getPercentile(sortedDurations, 95),
+                p99Ms: this.getPercentile(sortedDurations, 99),
+                maxMs: Math.max(...durations),
+            },
+            jankFrames,
+            visualization: {
+                type: 'histogram',
+                data: this.generateHistogram(durations),
+            },
+        };
+    }
+    getPercentile(sortedArray, percentile) {
+        const index = Math.ceil((percentile / 100) * sortedArray.length) - 1;
+        return sortedArray[Math.max(0, index)];
+    }
+    generateHistogram(durations) {
+        // 创建直方图桶：0-8ms, 8-16ms, 16-24ms, 24-32ms, 32+ms
+        const buckets = [
+            { start: 0, end: 8, count: 0 },
+            { start: 8, end: 16, count: 0 },
+            { start: 16, end: 24, count: 0 },
+            { start: 24, end: 32, count: 0 },
+            { start: 32, end: Infinity, count: 0 },
+        ];
+        durations.forEach(dur => {
+            const bucket = buckets.find(b => dur >= b.start && dur < b.end);
+            if (bucket) {
+                bucket.count++;
+            }
+        });
+        return buckets.map(b => ({
+            bucketStart: b.start,
+            bucketEnd: b.end === Infinity ? 999 : b.end,
+            count: b.count,
+        }));
+    }
+    buildTimeCondition(startTs, endTs, tsColumn = 'ts') {
+        const safeStart = this.normalizeTimestamp(startTs);
+        const safeEnd = this.normalizeTimestamp(endTs);
+        if (safeStart === undefined && safeEnd === undefined)
+            return '';
+        if (safeStart !== undefined && safeEnd === undefined)
+            return `AND ${tsColumn} >= ${safeStart}`;
+        if (safeStart === undefined && safeEnd !== undefined)
+            return `AND ${tsColumn} <= ${safeEnd}`;
+        return `AND ${tsColumn} >= ${safeStart} AND ${tsColumn} <= ${safeEnd}`;
+    }
+    normalizeTimestamp(ts) {
+        if (ts === undefined || ts === null)
+            return undefined;
+        const n = Number(ts);
+        if (!Number.isFinite(n))
+            return undefined;
+        return Math.floor(n);
+    }
+    escapeLikePattern(value) {
+        return value
+            .replace(/\\/g, '\\\\')
+            .replace(/%/g, '\\%')
+            .replace(/_/g, '\\_')
+            .replace(/'/g, "''");
+    }
+    resultToRows(result) {
+        if (!result || !result.columns || !result.rows) {
+            return [];
+        }
+        return result.rows.map((row) => {
+            const obj = {};
+            result.columns.forEach((col, idx) => {
+                obj[col] = row[idx];
+            });
+            return obj;
+        });
+    }
+}
+exports.FrameStatsAnalyzer = FrameStatsAnalyzer;
+//# sourceMappingURL=frameStatsAnalysis.js.map

package/dist/services/analysisTemplates/frameStatsAnalysis.js.map

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

package/dist/services/analysisTemplates/templateManager.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 分析模板管理器
+ * 根据用户问题自动选择合适的分析模板
+ */
+import { TraceProcessorService } from '../traceProcessorService';
+import { FourQuadrantResult } from './fourQuadrantAnalysis';
+import { CpuCoreDistribution } from './cpuCoreAnalysis';
+import { FrameStatsResult } from './frameStatsAnalysis';
+export type AnalysisTemplateName = 'four_quadrant' | 'cpu_core_distribution' | 'frame_stats' | 'custom';
+export interface AnalysisTemplateResult {
+    templateName: AnalysisTemplateName;
+    data: FourQuadrantResult | CpuCoreDistribution | FrameStatsResult | any;
+    summary: string;
+}
+export interface TemplateSelectionContext {
+    question: string;
+    traceId: string;
+    metadata?: {
+        hasFrameData?: boolean;
+        hasSchedData?: boolean;
+        processNames?: string[];
+        detectedVsyncPeriodNs?: string | bigint | number;
+        deviceRefreshRate?: number;
+    };
+}
+export declare class AnalysisTemplateManager {
+    private traceProcessor;
+    private fourQuadrantAnalyzer;
+    private cpuCoreAnalyzer;
+    constructor(traceProcessor: TraceProcessorService);
+    /**
+     * 根据用户问题自动选择并执行分析模板
+     */
+    analyzeWithAutoTemplate(context: TemplateSelectionContext): Promise<AnalysisTemplateResult | null>;
+    /**
+     * 根据问题选择合适的模板
+     */
+    private selectTemplate;
+    /**
+     * 执行指定的分析模板
+     */
+    private executeTemplate;
+    private executeFourQuadrant;
+    private executeCpuCoreDistribution;
+    private executeFrameStats;
+    /**
+     * 查找主线程 utid
+     */
+    private findMainThread;
+    /**
+     * 查找主进程名称
+     */
+    private findMainProcess;
+    /**
+     * 从问题中提取四大象限分析参数
+     */
+    private extractFourQuadrantParams;
+    private parseTimeRange;
+    private resolveThreadId;
+    private findUtidByTid;
+    /**
+     * 生成分析摘要
+     */
+    private generateSummary;
+    private summarizeFourQuadrant;
+    private summarizeCpuCoreDistribution;
+    private summarizeFrameStats;
+    private getCategoryLabel;
+}
+//# sourceMappingURL=templateManager.d.ts.map

package/dist/services/analysisTemplates/templateManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateManager.d.ts","sourceRoot":"","sources":["../../../src/services/analysisTemplates/templateManager.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAwB,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAmB,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAsB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE5E,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,uBAAuB,GACvB,aAAa,GACb,QAAQ,CAAC;AAEb,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,oBAAoB,CAAC;IACnC,IAAI,EAAE,kBAAkB,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,GAAG,CAAC;IACxE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE;QACT,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,qBAAqB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;QACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED,qBAAa,uBAAuB;IAItB,OAAO,CAAC,cAAc;IAHlC,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,eAAe,CAAkB;gBAErB,cAAc,EAAE,qBAAqB;IAKzD;;OAEG;IACG,uBAAuB,CAC3B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAoBzC;;OAEG;IACH,OAAO,CAAC,cAAc;IA4CtB;;OAEG;YACW,eAAe;YAmBf,mBAAmB;YAYnB,0BAA0B;YAc1B,iBAAiB;IAwB/B;;OAEG;YACW,cAAc;IAmB5B;;OAEG;YACW,eAAe;IAoB7B;;OAEG;YACW,yBAAyB;IAQvC,OAAO,CAAC,cAAc;YAuDR,eAAe;YAqBf,aAAa;IAkB3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,4BAA4B;IAMpC,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,gBAAgB;CASzB"}