@gracker/smartperfetto 1.0.20 → 1.0.21

package/skills/composite/device_state_snapshot.skill.yaml

@@ -0,0 +1,204 @@
+# 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）
+# =============================================================================
+# 采集指定窗口内的屏幕、电量、温度、频率、内存压力与 idle 状态。
+
+name: device_state_snapshot
+version: "2.0"
+type: composite
+category: system_context
+tier: B
+
+meta:
+  display_name: "设备环境状态快照"
+  description: "采集 trace 期间的设备环境信息（屏幕、电量、温度、CPU、内存、idle 窗口等）"
+  icon: "devices"
+  tags: [device, state, environment, context, composite]
+
+prerequisites:
+  required_tables:
+    - slice
+    - counter
+    - counter_track
+
+inputs:
+  - name: start_ts
+    type: timestamp
+    required: false
+    description: "分析起始时间戳(ns)"
+  - name: end_ts
+    type: timestamp
+    required: false
+    description: "分析结束时间戳(ns)"
+
+steps:
+  - id: environment_snapshot
+    type: atomic
+    name: "设备环境快照"
+    display:
+      level: summary
+      layer: overview
+      title: "设备环境状态"
+      columns:
+        - name: metric
+          label: "指标"
+          type: string
+        - name: value
+          label: "值"
+          type: string
+        - name: ts
+          label: "时间戳"
+          type: timestamp
+          unit: ns
+          clickAction: navigate_timeline
+    sql: |
+      WITH trace_bounds AS (
+        SELECT
+          COALESCE(${start_ts}, (SELECT MIN(ts) FROM slice)) as t_start,
+          COALESCE(${end_ts}, (SELECT MAX(ts + dur) FROM slice)) as t_end
+      ),
+      screen_state AS (
+        SELECT
+          'screen_state' as metric,
+          CASE WHEN c.value > 0 THEN 'ON' ELSE 'OFF' END as value,
+          c.ts as ts
+        FROM counter c
+        JOIN counter_track ct ON c.track_id = ct.id
+        CROSS JOIN trace_bounds tb
+        WHERE (ct.name GLOB '*ScreenState*' OR ct.name GLOB '*screen_state*')
+          AND c.ts >= tb.t_start AND c.ts <= tb.t_end
+        ORDER BY c.ts DESC
+        LIMIT 1
+      ),
+      battery_info AS (
+        SELECT
+          'battery_level' as metric,
+          CAST(c.value AS TEXT) as value,
+          c.ts as ts
+        FROM counter c
+        JOIN counter_track ct ON c.track_id = ct.id
+        CROSS JOIN trace_bounds tb
+        WHERE (ct.name GLOB '*battery_level*' OR ct.name GLOB '*BatteryLevel*')
+          AND c.ts >= tb.t_start AND c.ts <= tb.t_end
+        ORDER BY c.ts DESC
+        LIMIT 1
+      ),
+      charging_info AS (
+        SELECT
+          'charging_state' as metric,
+          CASE WHEN c.value > 0 THEN 'CHARGING' ELSE 'NOT_CHARGING' END as value,
+          c.ts as ts
+        FROM counter c
+        JOIN counter_track ct ON c.track_id = ct.id
+        CROSS JOIN trace_bounds tb
+        WHERE (ct.name GLOB '*battery_status*' OR ct.name GLOB '*charging*' OR ct.name GLOB '*BatteryStatus*')
+          AND c.ts >= tb.t_start AND c.ts <= tb.t_end
+        ORDER BY c.ts DESC
+        LIMIT 1
+      ),
+      thermal_info AS (
+        SELECT
+          'thermal_zone' as metric,
+          ct.name || ': ' || CAST(ROUND(MAX(CASE WHEN c.value > 1000 THEN c.value / 1000.0 ELSE c.value END), 1) AS TEXT) || ' C' as value,
+          MAX(c.ts) as ts
+        FROM counter c
+        JOIN counter_track ct ON c.track_id = ct.id
+        CROSS JOIN trace_bounds tb
+        WHERE (ct.name GLOB '*thermal_zone*' OR ct.name GLOB '*Temperature*' OR ct.name GLOB '*temp*')
+          AND c.ts >= tb.t_start AND c.ts <= tb.t_end
+        GROUP BY ct.name
+        ORDER BY MAX(c.value) DESC
+        LIMIT 5
+      ),
+      memory_info AS (
+        SELECT
+          'memory_pressure' as metric,
+          ct.name || ': ' || CAST(ROUND(MAX(c.value), 0) AS TEXT) as value,
+          MAX(c.ts) as ts
+        FROM counter c
+        JOIN counter_track ct ON c.track_id = ct.id
+        CROSS JOIN trace_bounds tb
+        WHERE (ct.name GLOB '*mem.*pressure*' OR ct.name GLOB '*MemFree*' OR ct.name GLOB '*MemAvailable*' OR ct.name GLOB '*psi*mem*')
+          AND c.ts >= tb.t_start AND c.ts <= tb.t_end
+        GROUP BY ct.name
+        ORDER BY MAX(c.value) DESC
+        LIMIT 5
+      )
+      SELECT metric, value, printf('%d', ts) as ts FROM screen_state
+      UNION ALL SELECT metric, value, printf('%d', ts) as ts FROM battery_info
+      UNION ALL SELECT metric, value, printf('%d', ts) as ts FROM charging_info
+      UNION ALL SELECT metric, value, printf('%d', ts) as ts FROM thermal_info
+      UNION ALL SELECT metric, value, printf('%d', ts) as ts FROM memory_info
+    save_as: environment_snapshot
+    synthesize:
+      role: overview
+      fields:
+        - key: metric
+          label: 指标
+        - key: value
+          label: 值
+
+  - id: idle_window_summary
+    type: atomic
+    name: "Idle 窗口摘要"
+    optional: true
+    display:
+      level: detail
+      layer: list
+      title: "Idle / 空闲窗口"
+      columns:
+        - name: start_ts
+          label: "开始"
+          type: timestamp
+          unit: ns
+          clickAction: navigate_timeline
+        - name: end_ts
+          label: "结束"
+          type: timestamp
+          unit: ns
+          clickAction: navigate_timeline
+        - name: dur_ms
+          label: "时长"
+          type: duration
+          unit: ms
+        - name: source
+          label: "来源"
+          type: string
+    sql: |
+      WITH trace_bounds AS (
+        SELECT
+          COALESCE(${start_ts}, (SELECT MIN(ts) FROM slice)) as t_start,
+          COALESCE(${end_ts}, (SELECT MAX(ts + dur) FROM slice)) as t_end
+      )
+      SELECT
+        printf('%d', s.ts) as start_ts,
+        printf('%d', s.ts + s.dur) as end_ts,
+        ROUND(s.dur / 1000000.0, 2) as dur_ms,
+        s.name as source
+      FROM slice s
+      CROSS JOIN trace_bounds tb
+      WHERE s.dur > 0
+        AND s.ts + s.dur > tb.t_start
+        AND s.ts < tb.t_end
+        AND (
+          s.name GLOB '*idle*'
+          OR s.name GLOB '*Idle*'
+          OR s.name GLOB '*suspend*'
+          OR s.name GLOB '*doze*'
+        )
+      ORDER BY s.dur DESC
+      LIMIT 20
+    save_as: idle_window_summary
+    synthesize:
+      role: list
+      fields:
+        - key: dur_ms
+          label: Idle 时长
+          format: "{{value}} ms"
+
+output:
+  format: structured

package/skills/composite/scene_reconstruction.skill.yaml

@@ -573,6 +573,9 @@ steps:
         - name: gesture_id
           label: "手势ID"
           type: number
+        - name: app_package
+          label: "前台应用"
+          type: string
         - name: category
           label: "类别"
           type: string
@@ -633,6 +636,7 @@ steps:
           ELSE ''
         END AS event,
         gesture_id,
+        app AS app_package,
         'scroll_start' AS category,
         '💡 此时刻手指已移动足够距离，系统开始响应滑动' AS explanation
       FROM scroll_starts
@@ -2785,4 +2789,4 @@ steps:
 
 output:
   format: layered
-  default_expanded: [L1, L2]
+  default_expanded: [L1, L2]

package/strategies/scene-reconstruction-verifier.template.md

@@ -0,0 +1,18 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-or-later -->
+<!-- Copyright (C) 2024-2026 Gracker (Chris) -->
+<!-- This file is part of SmartPerfetto. See LICENSE for details. -->
+
+你是 Android Perfetto trace 的场景还原复核器。请检查下面的 Smart 场景时间线是否存在明显的拆分、合并、类型或归因问题。
+
+只能基于输入证据判断，不要创造没有证据的场景。不要输出长报告。
+
+请只输出 JSON，格式：{"status":"passed|needs_review","summary":"一句中文复核意见"}。
+
+deterministic_summary:
+{{deterministicSummary}}
+
+deterministic_issues:
+{{deterministicIssues}}
+
+scenes:
+{{scenes}}

package/strategies/scrolling.strategy.md

@@ -107,7 +107,7 @@ phase_hints:
     critical: false
   - id: conclusion
     keywords: ['结论', 'conclusion', '输出', 'output', '报告', 'report', '总结']
-    constraints: '输出必须包含：全帧根因分布表（按 reason_code 聚合）+ 代表帧分析（含四象限+频率+根因推理链）+ 按优先级排序的优化建议。每个 CRITICAL/HIGH 必须有量化证据+因果链。'
+    constraints: '输出必须包含：全帧根因分布表（按 reason_code 聚合）+ 代表帧分析（含四象限+频率+根因推理链）+ 按优先级排序的优化建议。每个 CRITICAL/HIGH 必须有量化证据+因果链。若深钻证据纠正了 batch reason_code（例如 lock_binder_wait 但 binder_overlap_ms=0，render_slices_json 指向 cache_miss/makePipeline/shader 编译），最终结论必须使用纠正后的根因命名，并明确标注原 reason_code 为误分类。'
     critical_tools: []
     critical: false
 
@@ -347,6 +347,10 @@ Phase 1 的 `batch_frame_root_cause` 已包含每帧的**完整统计数据**（
 - **reason_code 为 unknown 且帧数 >5%**：必须对至少 1 帧调用 jank_frame_detail 获取更多线索，不能在分布表中仅标记"未分类"就跳过
 - reason_code 与实际数据矛盾时（如 `lock_binder_wait` 但 Binder 耗时 0ms）：应在结论中标注可能的误分类原因
 
+如果深钻结果已给出更具体的根因，不要在最终报告继续把原始 `reason_code` 当作根因名称。典型例子：
+- `lock_binder_wait` 但 `binder_overlap_ms=0`，且 `render_slices_json` 出现 `cache_miss: makePipeline` / shader 编译 / Vulkan finish frame / `postAndWait`，最终根因应写成 **shader_compile + sync_wait** 或等价机制，并说明 `lock_binder_wait` 是批量分类误判。
+- `workload_heavy` 但 `main_slices_json` 明确指向应用自定义方法，最终根因应写具体方法名和所处阶段，例如 `CustomScroll_longFrameLoad` 在 ANIMATION 回调同步执行，而不是只写 "workload_heavy"。
+
 `frame_blocking_calls` 是 Phase 1.9 的帧内阻塞证据补充，不占 `jank_frame_detail` 的 2 帧上限。遇到 Binder/IO/futex/锁相关根因时，优先用它确认阻塞调用是否真的与掉帧帧重叠。
 
 ```

package/strategies/smart.strategy.md

@@ -0,0 +1,53 @@
+<!--
+SPDX-License-Identifier: AGPL-3.0-or-later
+Copyright (C) 2024-2026 Gracker (Chris)
+This file is part of SmartPerfetto. See LICENSE for details.
+-->
+---
+scene: smart
+strategy_kind: contract_only
+priority: 5
+effort: high
+keywords:
+  - smart
+  - 智能
+  - mixed trace
+  - 场景混合
+required_capabilities: []
+optional_capabilities: []
+final_report_contract:
+  required_sections:
+    - id: scene_timeline
+      label: 场景时间线
+      description: 按时间顺序列出 trace 中检测到的关键用户操作和设备状态场景。
+      pattern_groups:
+        - ["场景时间线", "timeline", "时间线"]
+        - ["冷启动", "热启动", "滑动", "点击", "返回", "Home", "亮屏", "熄屏", "ANR"]
+    - id: per_scene_summary
+      label: 分场景摘要
+      description: 对每个被深度分析的场景给出关键指标、结论和证据引用。
+      pattern_groups:
+        - ["分场景", "逐场景", "per-scene"]
+        - ["证据", "指标", "耗时", "延迟", "帧"]
+    - id: cross_scene_narrative
+      label: 跨场景叙事
+      description: 总结多个场景之间的关联、共同瓶颈或前后影响。
+      pattern_groups:
+        - ["跨场景", "整体", "关联", "链路"]
+        - ["原因", "影响", "共同", "瓶颈"]
+    - id: bottleneck_ranking
+      label: 瓶颈排序
+      description: 按影响范围、严重度和可行动性给出优化优先级。
+      pattern_groups:
+        - ["瓶颈排序", "优先级", "ranking"]
+        - ["P0", "P1", "优先", "建议"]
+---
+
+# Smart Analysis Contract
+
+This strategy is intentionally contract-only. It must not be injected as a
+normal scene strategy and must not participate in scene classification.
+
+Smart Analysis Mode combines Scene Story detection with profile-specific
+deep-dive routes, then projects the resulting scene report into a readable chat
+summary and the standard HTML report chain.

package/skills/atomic/device_state_snapshot.skill.yaml

@@ -1,171 +0,0 @@
-# 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）
-# =============================================================================
-# 采集 trace 期间的设备环境信息：屏幕状态、电量、温度、CPU 频率、内存压力等。
-
-name: device_state_snapshot
-version: "1.0"
-type: atomic
-category: system_context
-tier: B
-
-meta:
-  display_name: "设备环境状态快照"
-  description: "采集 trace 期间的设备环境信息（屏幕、电量、温度、CPU、内存等）"
-  icon: "devices"
-  tags: [device, state, environment, context, atomic]
-
-prerequisites:
-  required_tables:
-    - counter
-    - counter_track
-
-inputs:
-  - name: start_ts
-    type: timestamp
-    required: false
-    description: "分析起始时间戳(ns)"
-  - name: end_ts
-    type: timestamp
-    required: false
-    description: "分析结束时间戳(ns)"
-
-display:
-  level: summary
-  layer: overview
-  title: "设备环境状态"
-  columns:
-    - name: metric
-      label: "指标"
-      type: string
-    - name: value
-      label: "值"
-      type: string
-    - name: ts
-      label: "时间戳"
-      type: timestamp
-      unit: ns
-      clickAction: navigate_timeline
-
-sql: |
-  WITH trace_bounds AS (
-    SELECT
-      COALESCE(${start_ts}, (SELECT MIN(ts) FROM slice)) as t_start,
-      COALESCE(${end_ts}, (SELECT MAX(ts + dur) FROM slice)) as t_end
-  ),
-  screen_state AS (
-    SELECT
-      'screen_state' as metric,
-      CASE WHEN c.value > 0 THEN 'ON' ELSE 'OFF' END as value,
-      c.ts as ts
-    FROM counter c
-    JOIN counter_track ct ON c.track_id = ct.id
-    WHERE ct.name GLOB '*ScreenState*' OR ct.name GLOB '*screen_state*'
-    ORDER BY c.ts DESC
-    LIMIT 1
-  ),
-  battery_info AS (
-    SELECT
-      'battery_level' as metric,
-      CAST(c.value AS TEXT) as value,
-      c.ts as ts
-    FROM counter c
-    JOIN counter_track ct ON c.track_id = ct.id
-    WHERE ct.name GLOB '*battery_level*' OR ct.name GLOB '*BatteryLevel*'
-    ORDER BY c.ts DESC
-    LIMIT 1
-  ),
-  charging_info AS (
-    SELECT
-      'charging_state' as metric,
-      CASE WHEN c.value > 0 THEN 'CHARGING' ELSE 'NOT_CHARGING' END as value,
-      c.ts as ts
-    FROM counter c
-    JOIN counter_track ct ON c.track_id = ct.id
-    WHERE ct.name GLOB '*battery_status*' OR ct.name GLOB '*charging*' OR ct.name GLOB '*BatteryStatus*'
-    ORDER BY c.ts DESC
-    LIMIT 1
-  ),
-  thermal_info AS (
-    SELECT
-      'thermal_zone' as metric,
-      ct.name || ': ' || CAST(ROUND(MAX(c.value) / 1000.0, 1) AS TEXT) || '°C' as value,
-      MAX(c.ts) as ts
-    FROM counter c
-    JOIN counter_track ct ON c.track_id = ct.id
-    CROSS JOIN trace_bounds tb
-    WHERE (ct.name GLOB '*thermal_zone*' OR ct.name GLOB '*Temperature*')
-      AND c.ts >= tb.t_start AND c.ts <= tb.t_end
-    GROUP BY ct.name
-    ORDER BY MAX(c.value) DESC
-    LIMIT 5
-  ),
-  cpu_freq_summary AS (
-    SELECT
-      'cpu_max_freq' as metric,
-      'CPU' || ct.name || ': ' || CAST(ROUND(MAX(c.value) / 1e6, 2) AS TEXT) || 'GHz' as value,
-      MAX(c.ts) as ts
-    FROM counter c
-    JOIN cpu_counter_track ct ON c.track_id = ct.id
-    CROSS JOIN trace_bounds tb
-    WHERE ct.name = 'cpufreq'
-      AND c.ts >= tb.t_start AND c.ts <= tb.t_end
-    GROUP BY ct.cpu
-    ORDER BY ct.cpu
-  ),
-  memory_info AS (
-    SELECT
-      'memory_pressure' as metric,
-      CAST(ROUND(MAX(c.value), 0) AS TEXT) as value,
-      MAX(c.ts) as ts
-    FROM counter c
-    JOIN counter_track ct ON c.track_id = ct.id
-    CROSS JOIN trace_bounds tb
-    WHERE (ct.name GLOB '*mem.*pressure*' OR ct.name GLOB '*MemFree*' OR ct.name GLOB '*MemAvailable*')
-      AND c.ts >= tb.t_start AND c.ts <= tb.t_end
-  ),
-  process_count AS (
-    SELECT
-      'active_processes' as metric,
-      CAST(COUNT(DISTINCT p.upid) AS TEXT) as value,
-      NULL as ts
-    FROM process p
-    JOIN thread t ON t.upid = p.upid
-    JOIN thread_state ts_tbl ON ts_tbl.utid = t.utid
-    CROSS JOIN trace_bounds tb
-    WHERE ts_tbl.ts >= tb.t_start AND ts_tbl.ts <= tb.t_end
-      AND ts_tbl.state = 'Running'
-  ),
-  oom_adj AS (
-    SELECT
-      'foreground_apps' as metric,
-      GROUP_CONCAT(p.name, ', ') as value,
-      NULL as ts
-    FROM (
-      SELECT DISTINCT p.name, p.upid
-      FROM counter c
-      JOIN process_counter_track pct ON c.track_id = pct.id
-      JOIN process p ON p.upid = pct.upid
-      CROSS JOIN trace_bounds tb
-      WHERE pct.name = 'oom_score_adj'
-        AND c.value <= 0
-        AND c.ts >= tb.t_start AND c.ts <= tb.t_end
-        AND p.name IS NOT NULL AND p.name != ''
-      LIMIT 10
-    ) p
-  )
-  SELECT metric, value, printf('%d', ts) as ts FROM screen_state
-  UNION ALL SELECT metric, value, printf('%d', ts) as ts FROM battery_info
-  UNION ALL SELECT metric, value, printf('%d', ts) as ts FROM charging_info
-  UNION ALL SELECT metric, value, printf('%d', ts) as ts FROM thermal_info
-  UNION ALL SELECT metric, value, printf('%d', ts) as ts FROM cpu_freq_summary
-  UNION ALL SELECT metric, value, printf('%d', ts) as ts FROM memory_info
-  UNION ALL SELECT metric, value, printf('%d', ts) as ts FROM process_count
-  UNION ALL SELECT metric, value, printf('%d', ts) as ts FROM oom_adj
-
-output:
-  format: structured