SuperAPI AI 工具集

heap-snapshot-inspection

智能体与模型

查看项目

更新于 10-16 03:16

技能介绍

用途:该技能面向 Chromium 系环境(Chrome、Node.js、Electron)的内存问题与泄漏排查,通过堆快照配合 @paulirish/agents 包中的 heap-snapshot CLI 进行分析。

主要能力:提供堆组成概览、快照对比找增长对象、按类列举对象、按 ID 检查对象详情,以及查看引用链(retainers)以判断对象为何仍驻留内存。

使用方式:建议始终通过 npx 调用以获取最新版本与依赖,命令形式为 npx -y @paulirish/agents heap-snapshot <command> [arguments]。典型流程:先用 summary 获取概览,如 npx -y @paulirish/agents heap-snapshot summary path/to/snapshot.heapsnapshot;再用 diff 对比前后快照,如 npx -y @paulirish/agents heap-snapshot diff baseline.heapsnapshot leak.heapsnapshot;按类列举用 list,如 npx -y @paulirish/agents heap-snapshot list leak.heapsnapshot --class Detached;按 ID 检查用 inspect,如 npx -y @paulirish/agents heap-snapshot inspect leak.heapsnapshot --id 12345;引用链分析用 retainers,如 npx -y @paulirish/agents heap-snapshot retainers leak.heapsnapshot --id 12345。

适用场景:Web 应用、Node.js 服务或 Electron 应用出现内存增长、疑似泄漏时,定位持续增长的对象类型与保留路径。

最佳实践与限制:截图前尽量先执行垃圾回收(GC);用最小可复现用例提升 diff 效果;列举对象时优先关注 retained size 较大的对象;Web 应用中留意 Detached 元素。资料未提供具体平台支持范围、性能开销与收费信息。