@gracker/smartperfetto 1.0.13

package/skills/atomic/gc_events_in_range.skill.yaml

@@ -0,0 +1,118 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Copyright (C) 2024-2026 Gracker (Chris)
+# This file is part of SmartPerfetto. See LICENSE for details.
+
+# =============================================================================
+# GC Events in Range (Atomic Skill)
+# =============================================================================
+# Queries GC events for a given process and optional time range.
+# Centralizes the 3-clause GLOB filter and GC type classification logic
+# that was previously duplicated across 7+ steps in memory_analysis.
+#
+# GC Detection Pattern (unified):
+#   s.name GLOB '*GC*' OR s.name GLOB '*gc*' OR s.name GLOB '*ConcurrentCopying*'
+#
+# GC Type Classification:
+#   ConcurrentCopying, MarkSweep, Explicit, Alloc, Background, Young, Full, Other
+#
+# Usage: Call via `type: skill` step, then reference ${gc_base.data} or
+# use the saved data for subsequent aggregation steps.
+# =============================================================================
+
+name: gc_events_in_range
+version: "1.0"
+type: atomic
+category: memory
+tier: B
+
+meta:
+  display_name: "GC 事件查询"
+  description: "查询 GC 事件并分类，供后续分析步骤复用"
+  icon: "memory"
+  tags: [gc, memory, events, atomic]
+
+prerequisites:
+  modules:
+    - android.garbage_collection
+
+inputs:
+  - name: package
+    type: string
+    required: true
+    description: "应用包名"
+  - name: start_ts
+    type: timestamp
+    required: false
+    description: "分析起始时间戳（纳秒，可选）"
+  - name: end_ts
+    type: timestamp
+    required: false
+    description: "分析结束时间戳（纳秒，可选）"
+
+display:
+  level: detail
+  layer: list
+  title: "GC 事件"
+  columns:
+    - name: ts
+      label: "时间戳"
+      type: timestamp
+      clickAction: navigate_timeline
+    - name: dur
+      label: "持续时间"
+      type: duration
+      format: duration_ms
+      unit: ns
+    - name: gc_name
+      label: "GC 名称"
+      type: string
+    - name: gc_type
+      label: "GC 类型"
+      type: string
+    - name: thread_name
+      label: "线程"
+      type: string
+    - name: is_main_thread
+      label: "主线程"
+      type: number
+    - name: reclaimed_mb
+      label: "回收(MB)"
+      type: number
+    - name: gc_running_dur
+      label: "GC运行时间"
+      type: duration
+      format: duration_ms
+      unit: ns
+
+sql: |
+  -- Use Perfetto stdlib android_garbage_collection_events (precise gc_type classification,
+  -- heap metrics, and CPU state breakdown). Note: returns 0 rows on older traces that
+  -- lack GC tracepoints; the agent should fall back to manual GLOB-based slice query.
+  SELECT
+    gc_ts as ts,
+    gc_dur as dur,
+    gc_type as gc_name,
+    thread_name,
+    tid,
+    pid,
+    process_name,
+    CASE WHEN tid = pid THEN 1 ELSE 0 END as is_main_thread,
+    gc_type,
+    -- Stdlib bonus columns (not available in fallback)
+    is_mark_compact,
+    reclaimed_mb,
+    min_heap_mb,
+    max_heap_mb,
+    gc_running_dur,
+    gc_runnable_dur,
+    gc_unint_io_dur
+  FROM android_garbage_collection_events
+  WHERE process_name GLOB '${package}*'
+    AND (${start_ts} IS NULL OR gc_ts >= ${start_ts})
+    AND (${end_ts} IS NULL OR gc_ts < ${end_ts})
+  ORDER BY gc_ts
+
+save_as: gc_events
+
+output:
+  format: structured

package/skills/atomic/gl_standalone_swap_jank.skill.yaml

@@ -0,0 +1,259 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Copyright (C) 2024-2026 Gracker (Chris)
+# This file is part of SmartPerfetto. See LICENSE for details.
+
+# =============================================================================
+# Standalone GL / Vulkan Swap Interval Jank
+# =============================================================================
+# Detects long intervals between eglSwapBuffers / vkQueuePresent / queueBuffer
+# calls for NativeActivity, GLSurfaceView, or custom graphics renderers.
+
+name: gl_standalone_swap_jank
+version: "1.0"
+type: atomic
+category: rendering
+tier: B
+
+meta:
+  display_name: "独立 GL/Vulkan Swap 卡顿"
+  description: "检测 eglSwapBuffers/vkQueuePresent/queueBuffer 间隔异常，定位 GLSurfaceView/NativeActivity 自渲染掉帧"
+  icon: "developer_board"
+  tags: [opengl, vulkan, swap_buffers, glsurfaceview, native_activity, jank, atomic]
+
+triggers:
+  keywords:
+    zh: [GLSurfaceView, NativeActivity, eglSwapBuffers, vkQueuePresent, OpenGL 卡顿, Vulkan 卡顿]
+    en: [glsurfaceview, nativeactivity, eglswapbuffers, vkqueuepresent, opengl jank, vulkan jank]
+  patterns:
+    - ".*(GLSurfaceView|NativeActivity|OpenGL|Vulkan).*(卡顿|掉帧|swap).*"
+    - ".*(glsurfaceview|nativeactivity|opengl|vulkan).*(jank|swap|present).*"
+
+prerequisites:
+  required_tables:
+    - slice
+    - thread_track
+    - thread
+    - process
+  modules:
+    - slices.with_context
+
+inputs:
+  - name: package
+    type: string
+    required: false
+    description: "目标进程名（支持 GLOB）"
+  - name: process_name
+    type: string
+    required: false
+    description: "目标进程名别名；当 package 为空时使用"
+  - name: start_ts
+    type: timestamp
+    required: false
+    description: "分析起始时间戳(ns)"
+  - name: end_ts
+    type: timestamp
+    required: false
+    description: "分析结束时间戳(ns)"
+
+steps:
+  - id: swap_interval_summary
+    type: atomic
+    name: "Swap 间隔汇总"
+    display:
+      level: summary
+      layer: overview
+      title: "GL/Vulkan Swap 间隔汇总"
+      columns:
+        - name: process_name
+          label: "进程"
+          type: string
+        - name: thread_name
+          label: "线程"
+          type: string
+        - name: swap_count
+          label: "Swap次数"
+          type: number
+          format: compact
+        - name: target_interval_ms
+          label: "目标间隔"
+          type: duration
+          format: duration_ms
+        - name: avg_interval_ms
+          label: "平均间隔"
+          type: duration
+          format: duration_ms
+        - name: p95_interval_ms
+          label: "P95间隔"
+          type: duration
+          format: duration_ms
+        - name: max_interval_ms
+          label: "最大间隔"
+          type: duration
+          format: duration_ms
+        - name: missed_like_count
+          label: "疑似掉帧"
+          type: number
+          format: compact
+        - name: rating
+          label: "评级"
+          type: string
+    sql: |
+      WITH
+      input AS (
+        SELECT
+          COALESCE(NULLIF('${package|}', ''), NULLIF('${process_name|}', ''), '') AS target_process,
+          COALESCE(${start_ts}, 0) AS start_ts,
+          COALESCE(${end_ts}, (SELECT COALESCE(MAX(ts + dur), 0) FROM slice)) AS end_ts
+      ),
+      swap_events AS (
+        SELECT
+          s.ts,
+          s.dur,
+          s.name AS slice_name,
+          t.utid,
+          t.name AS thread_name,
+          p.name AS process_name,
+          LAG(s.ts) OVER (PARTITION BY t.utid ORDER BY s.ts) AS prev_swap_ts
+        FROM slice s
+        JOIN thread_track tt ON s.track_id = tt.id
+        JOIN thread t ON tt.utid = t.utid
+        JOIN process p ON t.upid = p.upid
+        CROSS JOIN input i
+        WHERE (i.target_process = '' OR p.name GLOB i.target_process || '*')
+          AND s.ts >= i.start_ts
+          AND s.ts < i.end_ts
+          AND (i.target_process != '' OR COALESCE(t.name, '') NOT GLOB 'RenderThread*')
+          AND (
+            s.name GLOB '*eglSwapBuffers*' OR s.name GLOB '*SwapBuffers*' OR
+            s.name GLOB '*vkQueuePresent*' OR
+            s.name GLOB '*ANativeWindow_queueBuffer*'
+          )
+      ),
+      swap_intervals AS (
+        SELECT
+          *,
+          ts - prev_swap_ts AS interval_ns
+        FROM swap_events
+        WHERE prev_swap_ts IS NOT NULL
+          AND ts > prev_swap_ts
+          AND ts - prev_swap_ts BETWEEN 4000000 AND 100000000
+      ),
+      target AS (
+        SELECT COALESCE(
+          (SELECT CAST(PERCENTILE(interval_ns, 0.5) AS INTEGER) FROM swap_intervals),
+          16666667
+        ) AS target_interval_ns
+      )
+      SELECT
+        process_name,
+        thread_name,
+        COUNT(*) AS swap_count,
+        ROUND((SELECT target_interval_ns FROM target) / 1e6, 2) AS target_interval_ms,
+        ROUND(AVG(interval_ns) / 1e6, 2) AS avg_interval_ms,
+        ROUND(PERCENTILE(interval_ns, 0.95) / 1e6, 2) AS p95_interval_ms,
+        ROUND(MAX(interval_ns) / 1e6, 2) AS max_interval_ms,
+        SUM(CASE WHEN interval_ns > (SELECT target_interval_ns * 1.5 FROM target) THEN 1 ELSE 0 END) AS missed_like_count,
+        CASE
+          WHEN MAX(interval_ns) > (SELECT target_interval_ns * 4 FROM target) THEN 'critical'
+          WHEN PERCENTILE(interval_ns, 0.95) > (SELECT target_interval_ns * 2 FROM target) THEN 'warning'
+          WHEN SUM(CASE WHEN interval_ns > (SELECT target_interval_ns * 1.5 FROM target) THEN 1 ELSE 0 END) > 0 THEN 'notice'
+          ELSE 'normal'
+        END AS rating
+      FROM swap_intervals
+      GROUP BY process_name, thread_name
+      ORDER BY missed_like_count DESC, max_interval_ms DESC
+      LIMIT 50
+    save_as: swap_interval_summary
+
+  - id: slow_swap_events
+    type: atomic
+    name: "慢 Swap 事件"
+    display:
+      level: detail
+      layer: list
+      title: "慢 GL/Vulkan Swap 间隔"
+      columns:
+        - name: ts
+          label: "时间"
+          type: timestamp
+          unit: ns
+          clickAction: navigate_timeline
+        - name: interval_ms
+          label: "距离上次Swap"
+          type: duration
+          format: duration_ms
+        - name: swap_dur_ms
+          label: "Swap调用耗时"
+          type: duration
+          format: duration_ms
+        - name: slice_name
+          label: "Slice"
+          type: string
+        - name: thread_name
+          label: "线程"
+          type: string
+        - name: process_name
+          label: "进程"
+          type: string
+    sql: |
+      WITH
+      input AS (
+        SELECT
+          COALESCE(NULLIF('${package|}', ''), NULLIF('${process_name|}', ''), '') AS target_process,
+          COALESCE(${start_ts}, 0) AS start_ts,
+          COALESCE(${end_ts}, (SELECT COALESCE(MAX(ts + dur), 0) FROM slice)) AS end_ts
+      ),
+      swap_events AS (
+        SELECT
+          s.ts,
+          s.dur,
+          s.name AS slice_name,
+          t.utid,
+          t.name AS thread_name,
+          p.name AS process_name,
+          LAG(s.ts) OVER (PARTITION BY t.utid ORDER BY s.ts) AS prev_swap_ts
+        FROM slice s
+        JOIN thread_track tt ON s.track_id = tt.id
+        JOIN thread t ON tt.utid = t.utid
+        JOIN process p ON t.upid = p.upid
+        CROSS JOIN input i
+        WHERE (i.target_process = '' OR p.name GLOB i.target_process || '*')
+          AND s.ts >= i.start_ts
+          AND s.ts < i.end_ts
+          AND (i.target_process != '' OR COALESCE(t.name, '') NOT GLOB 'RenderThread*')
+          AND (
+            s.name GLOB '*eglSwapBuffers*' OR s.name GLOB '*SwapBuffers*' OR
+            s.name GLOB '*vkQueuePresent*' OR
+            s.name GLOB '*ANativeWindow_queueBuffer*'
+          )
+      ),
+      swap_intervals AS (
+        SELECT
+          *,
+          ts - prev_swap_ts AS interval_ns
+        FROM swap_events
+        WHERE prev_swap_ts IS NOT NULL
+          AND ts > prev_swap_ts
+          AND ts - prev_swap_ts BETWEEN 4000000 AND 100000000
+      ),
+      target AS (
+        SELECT COALESCE(
+          (SELECT CAST(PERCENTILE(interval_ns, 0.5) AS INTEGER) FROM swap_intervals),
+          16666667
+        ) AS target_interval_ns
+      )
+      SELECT
+        printf('%d', ts) AS ts,
+        ROUND(interval_ns / 1e6, 2) AS interval_ms,
+        ROUND(dur / 1e6, 2) AS swap_dur_ms,
+        slice_name,
+        thread_name,
+        process_name
+      FROM swap_intervals
+      WHERE interval_ns > (SELECT target_interval_ns * 1.5 FROM target)
+      ORDER BY interval_ns DESC
+      LIMIT 100
+    save_as: slow_swap_events
+
+output:
+  format: structured

package/skills/atomic/gpu_freq_in_range.skill.yaml

@@ -0,0 +1,99 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Copyright (C) 2024-2026 Gracker (Chris)
+# This file is part of SmartPerfetto. See LICENSE for details.
+
+# =============================================================================
+# GPU 频率分析 (Atomic Skill)
+# =============================================================================
+# 分析指定时间范围内 GPU 频率变化
+# 检测 GPU 频率是否跟上渲染需求
+
+name: gpu_freq_in_range
+version: "1.0"
+type: atomic
+category: gpu
+tier: B
+
+meta:
+  display_name: "GPU 频率分析"
+  description: "分析 GPU 频率变化情况"
+  icon: "speed"
+  tags: [gpu, frequency, atomic]
+
+prerequisites:
+  modules:
+    - android.gpu.frequency
+
+inputs:
+  - name: start_ts
+    type: timestamp
+    required: false
+    description: "分析起始时间戳(ns，可选)"
+  - name: end_ts
+    type: timestamp
+    required: false
+    description: "分析结束时间戳(ns，可选)"
+  - name: low_freq_threshold_pct
+    type: number
+    required: false
+    default: 40
+    description: "低频阈值百分比 (相对最大频率，默认 40%)"
+
+display:
+  level: detail
+  layer: deep
+  title: "GPU 频率"
+  columns:
+    - name: gpu_id
+      label: "GPU"
+      type: number
+    - name: avg_freq_mhz
+      label: "平均频率"
+      type: number
+    - name: max_freq_mhz
+      label: "最大频率"
+      type: number
+    - name: min_freq_mhz
+      label: "最小频率"
+      type: number
+    - name: freq_changes
+      label: "变频次数"
+      type: number
+    - name: low_freq_pct
+      label: "低频占比"
+      type: percentage
+      format: percentage
+
+sql: |
+  WITH gpu_raw AS (
+    SELECT gpu_id, gpu_freq, dur
+    FROM android_gpu_frequency
+    WHERE (${start_ts} IS NULL OR ts >= ${start_ts}) AND (${end_ts} IS NULL OR ts < ${end_ts})
+  ),
+  gpu_max AS (
+    SELECT gpu_id, MAX(gpu_freq) as max_freq
+    FROM gpu_raw
+    GROUP BY gpu_id
+  ),
+  gpu_samples AS (
+    SELECT
+      r.gpu_id,
+      r.gpu_freq,
+      r.dur,
+      CASE WHEN r.gpu_freq < m.max_freq * ${low_freq_threshold_pct|40} / 100.0
+           THEN r.dur ELSE 0 END as low_freq_dur
+    FROM gpu_raw r
+    JOIN gpu_max m ON r.gpu_id = m.gpu_id
+  )
+  SELECT
+    gpu_id,
+    ROUND(SUM(gpu_freq * dur) / NULLIF(SUM(dur), 0) / 1e6, 0) as avg_freq_mhz,
+    ROUND(MAX(gpu_freq) / 1e6, 0) as max_freq_mhz,
+    ROUND(MIN(gpu_freq) / 1e6, 0) as min_freq_mhz,
+    COUNT(DISTINCT gpu_freq) as freq_changes,
+    ROUND(100.0 * SUM(low_freq_dur) / NULLIF(SUM(dur), 0), 1) as low_freq_pct
+  FROM gpu_samples
+  GROUP BY gpu_id
+
+output:
+  format: structured

package/skills/atomic/gpu_frequency_analysis.skill.yaml

@@ -0,0 +1,94 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Copyright (C) 2024-2026 Gracker (Chris)
+# This file is part of SmartPerfetto. See LICENSE for details.
+
+# =============================================================================
+# GPU 频率分析 (Atomic Skill)
+# =============================================================================
+# 分析 GPU 频率变化和 thermal throttling
+# 检测 GPU 降频对渲染性能的影响
+
+name: gpu_frequency_analysis
+version: "1.0"
+type: atomic
+category: gpu
+tier: B
+
+meta:
+  display_name: "GPU 频率分析"
+  description: "分析 GPU 频率变化和 thermal throttling"
+  icon: "memory"
+  tags: [gpu, frequency, dvfs, thermal, atomic]
+
+inputs:
+  - name: start_ts
+    type: timestamp
+    required: false
+    description: "分析起始时间戳(ns)"
+  - name: end_ts
+    type: timestamp
+    required: false
+    description: "分析结束时间戳(ns)"
+
+display:
+  level: detail
+  layer: overview
+  title: "GPU 频率分析"
+  columns:
+    - name: metric
+      label: "指标"
+      type: string
+    - name: value
+      label: "值"
+      type: string
+    - name: assessment
+      label: "评估"
+      type: string
+
+sql: |
+  WITH gpu_freq AS (
+    SELECT
+      c.ts,
+      CAST(c.value AS INTEGER) as freq_khz,
+      ct.name as track_name
+    FROM counter c
+    JOIN counter_track ct ON c.track_id = ct.id
+    WHERE (ct.name GLOB '*gpu*freq*' OR ct.name GLOB '*mali*freq*'
+           OR ct.name GLOB '*adreno*freq*' OR ct.name GLOB '*img*freq*')
+      AND (${start_ts} IS NULL OR c.ts >= ${start_ts})
+      AND (${end_ts} IS NULL OR c.ts < ${end_ts})
+  ),
+  stats AS (
+    SELECT
+      COUNT(*) as sample_count,
+      MIN(freq_khz) as min_freq,
+      MAX(freq_khz) as max_freq,
+      ROUND(AVG(freq_khz), 0) as avg_freq,
+      track_name
+    FROM gpu_freq
+    GROUP BY track_name
+  )
+  SELECT 'GPU 频率源' as metric, COALESCE(track_name, '未检测到 GPU 频率 counter') as value,
+    CASE WHEN track_name IS NULL THEN '⚠️ 无 GPU 频率数据（trace 中无 gpu freq counter）' ELSE '' END as assessment
+  FROM stats
+  UNION ALL
+  SELECT 'GPU 频率源' as metric, '未检测到 GPU 频率 counter' as value, '⚠️ 无 GPU 频率数据' as assessment
+  WHERE NOT EXISTS (SELECT 1 FROM stats)
+  UNION ALL
+  SELECT 'GPU 均频' as metric,
+    ROUND(avg_freq / 1000.0, 0) || ' MHz' as value,
+    CASE WHEN avg_freq < max_freq * 0.6 THEN '⚠️ GPU 频率偏低，可能存在 thermal 限频'
+         ELSE '✓ 正常' END as assessment
+  FROM stats
+  UNION ALL
+  SELECT 'GPU 峰值频率' as metric, ROUND(max_freq / 1000.0, 0) || ' MHz' as value, '' as assessment FROM stats
+  UNION ALL
+  SELECT 'GPU 最低频率' as metric, ROUND(min_freq / 1000.0, 0) || ' MHz' as value,
+    CASE WHEN min_freq < max_freq * 0.3 THEN '⚠️ GPU 曾深度降频'
+         ELSE '✓ 频率波动正常' END as assessment
+  FROM stats
+  UNION ALL
+  SELECT 'GPU 频率变化次数' as metric, CAST(sample_count AS TEXT) as value, '' as assessment FROM stats
+
+output:
+  format: structured