用途:在已生成 .heapsnapshot 文件的前提下,分析 V8 堆快照,定位内存泄漏与对象为何无法被回收。适用于用户提供的前后快照对比、由其他技能或脚本采集的快照,以及需要查找持有已释放对象的引用链。
主要能力:提供解析快照并构建对象图的辅助函数,用于对比两份快照在对象数量与大小上的差异、按类型分组增量对象,并追踪对象的保留路径(retainer path),可跳过 weak 边以排除 WeakMap 等假引用。对大文件提供流式解析思路:先用字节扫描定位 nodes、edges、strings 等顶级区段偏移,单独解析 snapshot.meta,再分块流式读取数值数组,并避免物化完整字符串表。
使用方式:在 scratchpad 目录中编写分析脚本,从 helpers 目录导入辅助函数。常见流程为先解析快照并构建图,再调用前后对比函数获取面积与数量排名,或调用保留路径函数输出持有链。运行示例:cd .github/skills/heap-snapshot-analysis,node --max-old-space-size=24576 scratchpad/YYYY-MM-DD-topic/findOffsets.mjs /path/to/Heap.heapsnapshot。建议每次排查使用按日期命名的子目录,并写入 findings.md 记录思路、取舍与前后测量结果。
限制与注意事项:每次排查应重新开始,不要读取 /memories/ 或旧 scratchpad 中的历史结论,以免产生偏见;仅在用户明确要求时引用旧工作。约 2 GiB 以上的快照无法一次性读入 Buffer,会出现 ERR_FS_FILE_TOO_LARGE,此时不要仅调大 --max-old-space-size 重试全量读取,而应改用流式脚本。追踪保留路径时始终跳过 weak 边。若快照在打开 DevTools 后采集,全局句柄等路径可能属于调试器引入的假保留。典型分析每份快照需 30 至 120 秒,且是迭代、较慢的过程,建议缓存中间结果。文档中给出的 VS Code 保留模式属于示例场景,是否适用于其他环境需自行验证。