用途:这是一个 Perfetto 跟踪分析技能(Skill),用于分析 Android、Linux 和 Chromium 的 Perfetto trace,覆盖启动(冷/温/热/首帧)、帧渲染与滑动卡顿、输入延迟、ANR 与阻塞链、CPU 调度、内存、GPU 渲染、功耗与温控、IO/网络/媒体、框架与游戏、渲染管线识别、场景重建以及多份 trace 对比等场景。许可证为 AGPL-3.0-or-later。
主要能力:强调从证据而非症状名称推断。内置 scripts/perfetto_probe.py、perfetto_query.py、perfetto_skill.py、perfetto_compare.py、perfetto_doctor.py、bootstrap_trace_processor.py 等脚本执行确定性查询;按工作流路由加载对应 Markdown 参考;区分观察、相关性、机制与已证实的根因;对比时先独立分析每条 trace 再计算增量;结果按 assets/report-schema.json 输出。
使用方式:需 Python 3.11+、本地文件系统与终端访问,以及经校验的 Perfetto trace_processor_shell。先运行 perfetto_probe.py 探查可用表/模块/轨道,再选定一个工作流加载其参考文件,通过 scripts/perfetto_skill.py run 或 perfetto_query.py --query-id 执行查询;修改或自写 SQL 前需运行 SQL 守卫脚本。可用 perfetto_doctor.py 独立核查处理器身份。参数通过 --param NAME=JSON 绑定,模块用 --module 加载,依赖结果用 --result 传入。
限制:若 trace_processor_shell 不可用需先 bootstrap 或通过 --trace-processor / PERFETTO_TRACE_PROCESSOR 指定;--allow-unsupported-processor 仅用于明确标记的金丝雀测试,--allow-unverified 不能绕过缺失能力;无本地文件或终端访问的云端智能体只能参考方法论,无法执行查询;运行时会拒绝未解析的占位符,并默认将输出上限设为 16 MiB。未提供的权威来源信息暂未提供。