@gracker/smartperfetto 1.0.19 → 1.0.21

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/strategies/startup.strategy.md

@@ -50,7 +50,7 @@ final_report_contract:
       label: 阶段耗时分解
       description: '包含 startup_detail / phase breakdown 口径，并优先使用 self_ms 解释阶段贡献。'
       pattern_groups:
-        - ['阶段耗时', '阶段分解', 'phase\s+breakdown', 'startup_detail']
+        - ['阶段耗时', '阶段分解', 'phase\s+breakdown', 'startup_detail', '根因分析树', 'Phase\s*\d+']
         - ['self_ms', 'dur_ms', '耗时', '\d+(?:\.\d+)?\s*ms']
     - id: root_cause_references
       label: 根因编号引用
@@ -61,8 +61,8 @@ final_report_contract:
       label: App/系统分层建议
       description: '优化建议必须区分 App 层和系统/平台/ROM 层。'
       pattern_groups:
-        - ['App层', '应用层', 'App\s+layer']
-        - ['系统/平台层', '系统层', '平台层', 'ROM层', 'System/Platform', 'platform\s+layer']
+        - ['App\s*层', '应用\s*层', 'App\s+layer']
+        - ['系统\s*/\s*平台\s*层', '系统\s*层', '平台\s*层', 'ROM\s*层', 'System/Platform', 'platform\s+layer']
 
 phase_hints:
   - id: detail_breakdown
@@ -644,7 +644,7 @@ TTID 和 TTFD 是两个不同的指标，必须区分：
    - **数据不足时**：标注"数据不足，无法归类"而非强行贴标签
    - **纯排除项**：编号可选（如"Binder 阻塞(B6) < 10ms ✓"）
 
-3. **根因分析树**：层级式展示启动耗时分解，**必须体现嵌套关系、使用 self_ms、标注根因编号**
+3. **根因分析树**：层级式展示启动耗时分解，**必须体现嵌套关系、使用 self_ms、标注根因编号**。树可以保持紧凑；不要让长树状图挤掉后面的 App/系统分层建议。
    ```
    启动总耗时 XXms
    ├── [Phase 1] bindApplication = XXms wall

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