SuperAPI AI 工具集

rspack-tracing

通用与其它

查看项目

更新于 10-15 22:32

技能介绍

用途:诊断 Rspack 构建为何缓慢,了解哪些插件或 loader 耗时最多,分析用户提供的 Rspack trace 文件,或指导用户捕获性能剖析数据。

主要能力:通过环境变量开启追踪并输出 trace 文件;用 tail 快速查看最后事件以定位崩溃或报错发生的阶段;用捆绑脚本做完整性能分析,找出瓶颈;结合参考文档把 span 名称映射到可执行的修复建议;根据“最慢 Hook”定位可疑插件源码位置。

使用方式:先让用户带追踪运行构建,例如 RSPACK_PROFILE=TRACE RSPACK_TRACE_LAYER=logger RSPACK_TRACE_OUTPUT=./trace.json pnpm build,会生成形如 .rspack-profile-{timestamp}-{pid}/trace.json 的文件。快速诊断崩溃时进入该目录执行 tail -n 20 trace.json,查看最后事件的 span 名称与 target。完整分析需征得用户同意后运行 node "<skill-root>/scripts/analyze_trace.mjs" trace.json,工作目录保持在用户项目内。随后依据脚本输出的“Top Slowest Hooks”,读取 rspack.config.js 或 rsbuild.config.ts,把 Hook 映射到对应插件,并输出可疑插件源码的路径、行与列。

适用场景:构建变慢的性能排查、插件与 loader 耗时分析、构建失败阶段定位、已有 trace 文件的解读。

限制:需用户先自行开启追踪并生成 trace 文件;完整分析脚本需用户同意后运行;具体配置细节见 references/tracing-guide.md,瓶颈映射见 references/bottlenecks.md。资料未提供收费、价格、平台支持范围等信息。