SuperAPI AI 工具集

trace-analysis

通用与其它

查看项目

更新于 10-16 00:03

技能介绍

用途:分析 Lynx 应用的 .ptrace 追踪文件,定位启动阶段性能瓶颈。Lynx 是使用 Web 技术栈构建 Native 视图的高性能跨平台框架,采用 Perfetto 作为性能分析工具,追踪以 .ptrace 文件形式存在,单个文件可能包含多个 LynxView 实例、多个 Bundle 加载事件与多条渲染管线。

主要能力:默认输出 Markdown 报告,包含追踪元数据(OS、设备、Lynx 引擎版本)、Lynx 实例列表(实例 ID 与 Bundle URL)、按实例的 FCP 与 Hydration 流程分析(关键路径与总耗时)以及总结建议。也可按用户要求执行特定 SQL 查询、输出指定格式或协助修复性能问题。

使用方式:通过 trace_processor_api 脚本执行 PerfettoSQL,无需额外工具配置。查看帮助:node <path_to_the_skill>/scripts/trace_processor_api.mjs --help;执行单行查询:node <path_to_the_skill>/scripts/trace_processor_api.mjs "<path_to_ptrace_file>" "SELECT * FROM metadata;";从文件读取 SQL:cat "some_sql_file.sql" | node <path_to_the_skill>/scripts/trace_processor_api.mjs "<path_to_ptrace_file>" -。分析步骤包括获取元数据、获取 Lynx 引擎版本、列出所有实例 ID,再逐实例分析 FCP 与 Hydration。

限制:输入需为 .ptrace 文件路径或链接,未提供时需参考 lynxjs.org 文档录制;编写 SQL 时需加 debug.instance_id 过滤条件,并用 debug.timing_flags 为 "Lynx FCP" 或 "react_lynx_hydrate" 筛选阶段事件;FCP 主要发生在 Engine 线程,Hydration 涉及 JS 线程与 Engine 线程,分析时需同时考虑两线程事件及依赖关系。其余细节暂未提供。