@gracker/smartperfetto 1.0.13

package/skills/atomic/scroll_response_latency.skill.yaml

@@ -0,0 +1,131 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Copyright (C) 2024-2026 Gracker (Chris)
+# This file is part of SmartPerfetto. See LICENSE for details.
+
+# =============================================================================
+# 滚动响应延迟分析（原子 Skill）v2.0
+# =============================================================================
+# 使用 Perfetto stdlib android_input_events 测量滚动手势从输入到首帧渲染的响应延迟。
+# 基于 slice 解析（sendMessage/receiveMessage），兼容大多数 atrace 配置。
+#
+# v2.0 变更：
+# - 从 android_input_event_dispatch (proto) 迁移到 android_input_events (slice-based)
+# - event_action 使用大写格式（MOVE, DOWN, UP）
+# - 时间戳基准统一为 dispatch_ts
+#
+# 注意：android_input_events 仅包含完成完整 IPC 周期的事件。
+# 手势分割逻辑：连续 MOVE 事件间隔 > 500ms 视为新手势。
+
+name: scroll_response_latency
+version: "2.0"
+type: atomic
+category: input_response
+tier: B
+
+meta:
+  display_name: "滚动响应延迟 (区间)"
+  description: "基于 android_input_events 测量滚动手势从输入事件到首帧渲染的响应延迟"
+  icon: "swipe_right"
+  tags: [scroll, response, latency, input, atomic]
+  # ----- Phase F: pipeline-aware 接口标注 -----
+  pipeline_aware: true
+  pipeline_aware_note: |
+    滑动响应路径不同：标准 input→Choreographer→ViewRoot；
+    Flutter texture 模式额外多一层宿主采样；WebView Functor 含 Chromium 路径；
+    RN input→main→Bridge/JSI→mqt_js。未来按 pipeline_id 调整响应路径解析。
+
+prerequisites:
+  modules:
+    - android.input
+
+inputs:
+  - name: package
+    type: string
+    required: false
+    description: "目标进程名（支持 GLOB）"
+  - name: start_ts
+    type: timestamp
+    required: false
+    description: "分析起始时间戳(ns)"
+  - name: end_ts
+    type: timestamp
+    required: false
+    description: "分析结束时间戳(ns)"
+
+display:
+  level: key
+  layer: list
+  title: "滚动响应延迟"
+  columns:
+    - name: gesture_ts
+      label: "手势时间"
+      type: timestamp
+      unit: ns
+      clickAction: navigate_timeline
+    - name: process_name
+      label: "进程"
+      type: string
+    - name: response_latency_ms
+      label: "响应延迟"
+      type: duration
+      format: duration_ms
+    - name: first_frame_dur_ms
+      label: "首帧耗时"
+      type: duration
+      format: duration_ms
+    - name: rating
+      label: "评级"
+      type: string
+
+sql: |
+  WITH move_events AS (
+    SELECT
+      dispatch_ts as input_ts,
+      process_name,
+      upid,
+      ROW_NUMBER() OVER (PARTITION BY upid ORDER BY dispatch_ts) as move_idx
+    FROM android_input_events
+    WHERE (process_name GLOB '${package}*' OR '${package}' = '')
+      AND event_action = 'MOVE'
+      AND (${start_ts} IS NULL OR dispatch_ts >= ${start_ts})
+      AND (${end_ts} IS NULL OR dispatch_ts <= ${end_ts})
+  ),
+  gesture_starts AS (
+    SELECT
+      m1.input_ts as gesture_ts,
+      m1.process_name,
+      m1.upid
+    FROM move_events m1
+    LEFT JOIN move_events m2 ON m1.upid = m2.upid AND m2.move_idx = m1.move_idx - 1
+    WHERE m2.input_ts IS NULL OR (m1.input_ts - m2.input_ts) > 500000000
+  ),
+  first_frames AS (
+    SELECT
+      g.gesture_ts,
+      g.process_name,
+      MIN(f.ts) as frame_ts,
+      (SELECT f2.dur FROM actual_frame_timeline_slice f2
+       WHERE f2.upid = g.upid AND f2.ts >= g.gesture_ts
+       ORDER BY f2.ts LIMIT 1) as frame_dur
+    FROM gesture_starts g
+    LEFT JOIN actual_frame_timeline_slice f ON f.upid = g.upid AND f.ts >= g.gesture_ts
+    GROUP BY g.gesture_ts, g.process_name
+  )
+  SELECT
+    printf('%d', gesture_ts) as gesture_ts,
+    process_name,
+    printf('%d', frame_ts) as first_frame_ts,
+    ROUND((frame_ts - gesture_ts) / 1e6, 2) as response_latency_ms,
+    ROUND(frame_dur / 1e6, 2) as first_frame_dur_ms,
+    CASE
+      WHEN (frame_ts - gesture_ts) / 1e6 < 50 THEN '优秀'
+      WHEN (frame_ts - gesture_ts) / 1e6 < 100 THEN '良好'
+      WHEN (frame_ts - gesture_ts) / 1e6 < 200 THEN '需优化'
+      ELSE '严重'
+    END as rating
+  FROM first_frames
+  WHERE frame_ts IS NOT NULL
+  ORDER BY response_latency_ms DESC
+
+output:
+  format: structured

package/skills/atomic/sf_composition_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.
+
+# =============================================================================
+# SurfaceFlinger 合成分析 (Atomic Skill)
+# =============================================================================
+# 分析指定时间范围内 SurfaceFlinger 的合成耗时
+# 检测系统合成层是否是性能瓶颈
+
+name: sf_composition_in_range
+version: "1.0"
+type: atomic
+category: framework
+tier: B
+
+meta:
+  display_name: "SF 合成分析"
+  description: "分析 SurfaceFlinger 合成延迟"
+  icon: "layers"
+  tags: [surfaceflinger, composition, framework, atomic]
+  # ----- Phase F: pipeline-aware 接口标注 -----
+  pipeline_aware: true
+  pipeline_aware_note: |
+    SF 合成时多 layer 类型（SurfaceView/Mixed/HC overlay）的归因 SQL 与单 layer 类型不同。
+    未来按 pipeline_id + layer_count 切换合成成本分解 SQL。
+
+inputs:
+  - name: start_ts
+    type: timestamp
+    required: false
+    description: "分析起始时间戳(ns，可选)"
+  - name: end_ts
+    type: timestamp
+    required: false
+    description: "分析结束时间戳(ns，可选)"
+
+display:
+  level: detail
+  layer: deep
+  title: "SurfaceFlinger 合成"
+  columns:
+    - name: composition_type
+      label: "合成阶段"
+      type: string
+    - name: count
+      label: "次数"
+      type: number
+    - name: total_ms
+      label: "总耗时"
+      type: duration
+      format: duration_ms
+    - name: avg_ms
+      label: "平均耗时"
+      type: duration
+      format: duration_ms
+    - name: max_ms
+      label: "最大耗时"
+      type: duration
+      format: duration_ms
+
+sql: |
+  WITH sf_slices AS (
+    SELECT
+      s.name,
+      s.dur,
+      CASE
+        WHEN s.name GLOB '*onMessageInvalidate*' THEN 'Invalidate'
+        WHEN s.name GLOB '*onMessageRefresh*' THEN 'Refresh'
+        WHEN s.name GLOB '*composite*' OR s.name GLOB '*Composite*' THEN 'Composite'
+        WHEN s.name GLOB '*latchBuffer*' OR s.name GLOB '*Latch*' THEN 'Latch Buffer'
+        WHEN s.name GLOB '*updateTexImage*' THEN 'Update Texture'
+        WHEN s.name GLOB '*postComposition*' THEN 'Post Composition'
+        WHEN s.name GLOB '*present*' OR s.name GLOB '*Present*' THEN 'Present'
+        WHEN s.name GLOB '*commit*' OR s.name GLOB '*Commit*' THEN 'Commit'
+        ELSE NULL
+      END as composition_type
+    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
+    WHERE (p.name = 'surfaceflinger' OR p.name = '/system/bin/surfaceflinger')
+      AND (${start_ts} IS NULL OR s.ts >= ${start_ts}) AND (${end_ts} IS NULL OR s.ts < ${end_ts})
+      AND s.dur > 10000  -- > 10us
+  )
+  SELECT
+    composition_type,
+    COUNT(*) as count,
+    ROUND(SUM(dur) / 1e6, 2) as total_ms,
+    ROUND(AVG(dur) / 1e6, 2) as avg_ms,
+    ROUND(MAX(dur) / 1e6, 2) as max_ms
+  FROM sf_slices
+  WHERE composition_type IS NOT NULL
+  GROUP BY composition_type
+  HAVING total_ms > 0.05
+  ORDER BY composition_type
+
+output:
+  format: structured

package/skills/atomic/sf_frame_consumption.skill.yaml

@@ -0,0 +1,133 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Copyright (C) 2024-2026 Gracker (Chris)
+# This file is part of SmartPerfetto. See LICENSE for details.
+
+name: sf_frame_consumption
+version: "1.0"
+type: atomic
+category: rendering
+tier: B
+
+meta:
+  display_name: "SurfaceFlinger 帧消费分析"
+  description: "分析 SurfaceFlinger 消费帧的情况"
+  icon: "layers"
+  tags: [surfaceflinger, frame, consumption, atomic]
+  # ----- Phase F: pipeline-aware 接口标注 -----
+  pipeline_aware: true
+  pipeline_aware_note: |
+    多 layer 类型（SurfaceView/Multi-Window/Mixed/Flutter HC）时 SF 合成成本要归因到具体 layer。
+    未来按 pipeline_id 切换 layer 维度的合成耗时分组 SQL。
+
+triggers:
+  keywords:
+    zh: [SurfaceFlinger, SF 帧消费, 消费端, present, 显示节奏]
+    en: [surfaceflinger frame consumption, sf consumption, present cadence]
+  patterns:
+    - ".*(SurfaceFlinger|SF).*(消费|present|帧).*"
+    - ".*surfaceflinger.*(consumption|present|frame).*"
+
+prerequisites:
+  required_tables:
+    - actual_frame_timeline_slice
+  modules:
+    - android.frames.timeline
+
+inputs:
+  - name: package
+    type: string
+    required: false
+  - name: start_ts
+    type: timestamp
+    required: false
+  - name: end_ts
+    type: timestamp
+    required: false
+  - name: layer_name
+    type: string
+    required: false
+
+steps:
+  - id: sf_consumption_stats
+    type: atomic
+    name: "SF 帧消费统计"
+    sql: |
+      WITH
+      time_bounds AS (
+        SELECT
+          COALESCE(${start_ts}, MIN(ts)) as start_ts,
+          COALESCE(${end_ts}, MAX(ts + dur)) as end_ts
+        FROM actual_frame_timeline_slice
+      ),
+      sf_frames AS (
+        SELECT
+          a.ts as present_ts,
+          a.dur,
+          a.layer_name,
+          a.surface_frame_token,
+          a.display_frame_token,
+          a.jank_type,
+          a.on_time_finish,
+          a.present_type,
+          ROW_NUMBER() OVER (ORDER BY a.ts) as frame_num,
+          LAG(a.ts) OVER (ORDER BY a.ts) as prev_ts
+        FROM actual_frame_timeline_slice a
+        LEFT JOIN process p ON a.upid = p.upid
+        WHERE a.surface_frame_token IS NOT NULL
+          AND (p.name GLOB '${package}*' OR '${package}' = '' OR a.layer_name GLOB '*${package}*')
+          AND a.ts >= (SELECT start_ts FROM time_bounds)
+          AND a.ts <= (SELECT end_ts FROM time_bounds)
+      ),
+      frame_intervals AS (
+        SELECT
+          present_ts - prev_ts as interval_ns,
+          jank_type,
+          on_time_finish,
+          present_type
+        FROM sf_frames
+        WHERE prev_ts IS NOT NULL
+      ),
+      consumption_stats AS (
+        SELECT
+          COUNT(*) as total_consumed_frames,
+          (SELECT end_ts - start_ts FROM time_bounds) as total_duration_ns,
+          COUNT(CASE WHEN jank_type = 'None' THEN 1 END) as on_time_frames,
+          COUNT(CASE WHEN jank_type != 'None' THEN 1 END) as janky_frames,
+          AVG(interval_ns) as avg_interval_ns,
+          PERCENTILE(interval_ns, 0.5) as median_interval_ns,
+          MIN(interval_ns) as min_interval_ns,
+          MAX(interval_ns) as max_interval_ns
+        FROM frame_intervals
+      )
+      SELECT
+        total_consumed_frames,
+        ROUND(total_duration_ns / 1e6, 1) as duration_ms,
+        ROUND(total_duration_ns / 1e9, 2) as duration_sec,
+        on_time_frames,
+        janky_frames,
+        ROUND(100.0 * janky_frames / NULLIF(total_consumed_frames, 0), 2) as jank_rate,
+        ROUND(1e9 / NULLIF(avg_interval_ns, 0), 1) as avg_fps,
+        ROUND(1e9 / NULLIF(median_interval_ns, 0), 1) as median_fps,
+        ROUND(1e9 * total_consumed_frames / NULLIF(total_duration_ns, 0), 1) as actual_fps,
+        ROUND(avg_interval_ns / 1e6, 2) as avg_interval_ms,
+        ROUND(median_interval_ns / 1e6, 2) as median_interval_ms,
+        ROUND(min_interval_ns / 1e6, 2) as min_interval_ms,
+        ROUND(max_interval_ns / 1e6, 2) as max_interval_ms
+      FROM consumption_stats
+    save_as: sf_consumption
+
+output:
+  format: single_row
+  fields:
+    - name: total_consumed_frames
+      type: integer
+      description: "SF 消费的总帧数"
+    - name: actual_fps
+      type: number
+      description: "实际 FPS（基于消费端）"
+    - name: median_fps
+      type: number
+      description: "中位数 FPS"
+    - name: jank_rate
+      type: number
+      description: "掉帧率 %"

package/skills/atomic/sf_layer_count_in_range.skill.yaml

@@ -0,0 +1,155 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Copyright (C) 2024-2026 Gracker (Chris)
+# This file is part of SmartPerfetto. See LICENSE for details.
+
+# =============================================================================
+# SurfaceFlinger Layer Count Analysis
+# =============================================================================
+# 统计指定时间范围内 SurfaceFlinger 活跃图层数量和合成特征。
+# 用于诊断 sf_composition_slow 根因：Layer 过多会增加 SF 合成开销。
+#
+# 典型使用场景：
+# - sf_composition_slow 帧的深钻：是 Layer 过多还是 HWC 回退？
+# - 比较不同滑动区间的 Layer 数差异
+# - 检测后台 Layer 对合成性能的影响
+
+name: sf_layer_count_in_range
+version: "1.0"
+type: composite
+category: diagnostics
+tier: B
+
+meta:
+  display_name: "SF 图层数统计"
+  description: "统计时间范围内 SurfaceFlinger 活跃图层数量，辅助 SF 合成性能诊断"
+  icon: "layers"
+  tags: [surfaceflinger, layer, composition, diagnostics]
+  # ----- Phase F: pipeline-aware 接口标注 -----
+  pipeline_aware: true
+  pipeline_aware_note: |
+    Layer 数量是 4 特征分型的"特征 2"。expected_layer_count 按 pipeline 不同：
+    标准/TextureView=1, SurfaceView/Mixed≥2, HC overlay=N, WebView Functor=0。
+    未来按 pipeline_id 标注期望 layer 数 + 偏离判定。
+
+prerequisites:
+  required_tables:
+    - actual_frame_timeline_slice
+
+inputs:
+  - name: start_ts
+    type: timestamp
+    required: true
+    description: "分析起始时间戳(ns)"
+  - name: end_ts
+    type: timestamp
+    required: true
+    description: "分析结束时间戳(ns)"
+  - name: process_name
+    type: string
+    required: false
+    description: "聚焦进程名（可选，用于区分前台 App Layer 和其他 Layer）"
+
+steps:
+  # Step 1: 活跃 Layer 统计
+  - id: layer_summary
+    type: atomic
+    name: "活跃图层统计"
+    display:
+      level: summary
+      layer: overview
+      title: "SF 图层概览"
+      columns:
+        - name: total_layers
+          label: "总图层数"
+          type: number
+        - name: app_layers
+          label: "App 图层数"
+          type: number
+        - name: system_layers
+          label: "系统图层数"
+          type: number
+        - name: avg_concurrent_layers
+          label: "平均并发图层数"
+          type: number
+        - name: max_concurrent_layers
+          label: "最大并发图层数"
+          type: number
+    sql: |
+      WITH
+      -- 时间范围内所有帧的 Layer 信息
+      active_layers AS (
+        SELECT DISTINCT
+          a.layer_name,
+          CASE
+            WHEN '${process_name}' != '' AND a.layer_name GLOB '*${process_name}*' THEN 'app'
+            WHEN a.layer_name GLOB '*StatusBar*' OR a.layer_name GLOB '*NavigationBar*'
+              OR a.layer_name GLOB '*Wallpaper*' OR a.layer_name GLOB '*InputMethod*'
+              OR a.layer_name GLOB '*SystemUI*' THEN 'system'
+            ELSE 'other'
+          END as layer_type
+        FROM actual_frame_timeline_slice a
+        WHERE a.ts >= ${start_ts} AND a.ts < ${end_ts}
+          AND a.layer_name IS NOT NULL
+      ),
+      -- 每个 SF 合成帧的并发 Layer 数
+      per_sf_frame_layers AS (
+        SELECT
+          a.display_frame_token,
+          COUNT(DISTINCT a.layer_name) as layer_count
+        FROM actual_frame_timeline_slice a
+        WHERE a.ts >= ${start_ts} AND a.ts < ${end_ts}
+          AND a.layer_name IS NOT NULL
+        GROUP BY a.display_frame_token
+      )
+      SELECT
+        (SELECT COUNT(*) FROM active_layers) as total_layers,
+        (SELECT COUNT(*) FROM active_layers WHERE layer_type = 'app') as app_layers,
+        (SELECT COUNT(*) FROM active_layers WHERE layer_type = 'system') as system_layers,
+        COALESCE((SELECT ROUND(AVG(layer_count), 1) FROM per_sf_frame_layers), 0) as avg_concurrent_layers,
+        COALESCE((SELECT MAX(layer_count) FROM per_sf_frame_layers), 0) as max_concurrent_layers
+    save_as: sf_layer_summary
+
+  # Step 2: Layer 列表（按出帧数排序）
+  - id: layer_list
+    type: atomic
+    name: "图层列表"
+    display:
+      level: detail
+      layer: list
+      title: "活跃图层列表"
+      columns:
+        - name: layer_name
+          label: "图层名"
+          type: string
+        - name: layer_type
+          label: "类型"
+          type: string
+        - name: frame_count
+          label: "帧数"
+          type: number
+        - name: avg_dur_ms
+          label: "平均耗时"
+          type: duration
+          format: duration_ms
+        - name: jank_count
+          label: "掉帧数"
+          type: number
+    sql: |
+      SELECT
+        a.layer_name,
+        CASE
+          WHEN '${process_name}' != '' AND a.layer_name GLOB '*${process_name}*' THEN 'app'
+          WHEN a.layer_name GLOB '*StatusBar*' OR a.layer_name GLOB '*NavigationBar*'
+            OR a.layer_name GLOB '*Wallpaper*' OR a.layer_name GLOB '*InputMethod*'
+            OR a.layer_name GLOB '*SystemUI*' THEN 'system'
+          ELSE 'other'
+        END as layer_type,
+        COUNT(*) as frame_count,
+        ROUND(AVG(a.dur) / 1e6, 2) as avg_dur_ms,
+        SUM(CASE WHEN a.jank_type IS NOT NULL AND a.jank_type != 'None' THEN 1 ELSE 0 END) as jank_count
+      FROM actual_frame_timeline_slice a
+      WHERE a.ts >= ${start_ts} AND a.ts < ${end_ts}
+        AND a.layer_name IS NOT NULL
+      GROUP BY a.layer_name
+      ORDER BY frame_count DESC
+    save_as: sf_layer_list

package/skills/atomic/startup_binder_in_range.skill.yaml

@@ -0,0 +1,106 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Copyright (C) 2024-2026 Gracker (Chris)
+# This file is part of SmartPerfetto. See LICENSE for details.
+
+# =============================================================================
+# 启动阶段 Binder 总览（原子 Skill）
+# =============================================================================
+
+name: startup_binder_in_range
+version: "1.0"
+type: atomic
+category: ipc
+tier: B
+
+meta:
+  display_name: "启动 Binder 总览 (区间)"
+  description: "统计启动阶段 Binder 调用分布"
+  icon: "call_split"
+  tags: [startup, binder, ipc, atomic]
+
+prerequisites:
+  modules:
+    - android.startup.startups
+    - android.binder
+
+inputs:
+  - name: package
+    type: string
+    required: false
+  - name: startup_id
+    type: integer
+    required: false
+  - name: startup_type
+    type: string
+    required: false
+  - name: start_ts
+    type: timestamp
+    required: false
+  - name: end_ts
+    type: timestamp
+    required: false
+  - name: top_k
+    type: integer
+    required: false
+
+display:
+  level: key
+  layer: overview
+  title: "启动期间 Binder 调用"
+  columns:
+    - name: server_process
+      label: "服务进程"
+      type: string
+    - name: aidl_name
+      label: "AIDL 方法"
+      type: string
+    - name: call_count
+      label: "调用次数"
+      type: number
+      format: compact
+    - name: total_dur_ms
+      label: "总耗时"
+      type: duration
+      format: duration_ms
+    - name: avg_dur_ms
+      label: "平均耗时"
+      type: duration
+      format: duration_ms
+    - name: max_dur_ms
+      label: "最大耗时"
+      type: duration
+      format: duration_ms
+    - name: main_thread_calls
+      label: "主线程调用"
+      type: number
+    - name: percent_of_startup
+      label: "启动占比"
+      type: percentage
+      format: percentage
+
+sql: |
+  SELECT
+    bt.server_process,
+    bt.aidl_name,
+    COUNT(*) as call_count,
+    SUM(bt.client_dur) / 1e6 as total_dur_ms,
+    ROUND(AVG(bt.client_dur) / 1e6, 2) as avg_dur_ms,
+    ROUND(MAX(bt.client_dur) / 1e6, 2) as max_dur_ms,
+    SUM(CASE WHEN bt.is_main_thread THEN 1 ELSE 0 END) as main_thread_calls,
+    '${startup_type}' as startup_type,
+    ROUND(100.0 * SUM(bt.client_dur) / s.dur, 1) as percent_of_startup
+  FROM android_binder_txns bt
+  JOIN android_startups s ON (
+    bt.client_ts >= s.ts AND bt.client_ts <= s.ts + s.dur
+    AND bt.client_process GLOB s.package || '*'
+  )
+  WHERE (s.package GLOB '${package}*' OR '${package}' = '')
+    AND (${startup_id} IS NULL OR s.startup_id = ${startup_id})
+    AND (${start_ts} IS NULL OR s.ts >= ${start_ts})
+    AND (${end_ts} IS NULL OR s.ts + s.dur <= ${end_ts})
+  GROUP BY bt.server_process, bt.aidl_name, s.startup_id
+  ORDER BY total_dur_ms DESC
+  LIMIT ${top_k|15}
+
+output:
+  format: structured