JS Crash Analysis

目标

系统化分析 HarmonyOS / OpenHarmony 应用 JS Crash 日志，输出基于证据的根因、责任代码位置和应用侧修复建议。分析必须以日志真实字段为依据，不得编造未出现的堆栈、错误码或业务路径。

工作流

0. SourceMap 反解环境检查

   • 仅在调用 SourceMap 反解时执行本检查，普通 JS Crash 分析不依赖 hstack。
   • 先执行 node --version，确认 Node.js 可用；仓库已内置完整 hstack 工具，无需另行安装 npm 依赖。
   • Windows 执行 "<skill-root>\scripts\hstack\bin\hstack.bat" --help；Linux/macOS 执行 "<skill-root>/scripts/hstack/bin/hstack" --help。
   • 若 Node.js 缺失、启动脚本不存在、lib/index.js 或 lib/mappings.wasm 缺失，停止反解并明确报告缺失项，不得将 raw stack 标记为已反解。

1. 提取关键信息

   • 如果用户给了文件路径，读取文件内容并提取 Reason、Error name、Error message、Error code、page、Stacktrace、Uid/Pid、故障时间。
   • 如果用户直接粘贴日志，手动提取上述关键字段。
   • 保留原始 Error message 和最靠前的应用栈帧作为证据。