fault-forensics 是嵌入式工程技能中的故障取证能力，用于分析嵌入式崩溃现场。
用途：面对 HardFault 等崩溃时，把 panic 日志、Cortex-M 故障寄存器、核心转储与地址，对照匹配的固件 ELF 进行取证分析，区分已观察事实与推测原因。
主要能力：读取故障捕获与架构信息；在重启或重建前保留原始日志/寄存器转储、复位原因、确切的 ELF/map、版本、构建选项与架构。对 ARMv7-M Cortex-M3/M4/M7，可离线运行 uv run scripts/decode_cortex_fault.py CAPTURE.json，报告置位位、有效故障地址和未解决原因；它不读取硬件，也不确认栈中 PC 就是起始指令。可关联 CFSR/HFSR、栈帧完整性、EXC_RETURN 与匹配的 ELF，区分精确与不精确总线错误、栈压入/弹出失败，以及有效的 MMFAR/BFAR 位。可离线使用所选工具链的 addr2line，并保留其版本与未知地址输出。
使用方式与限制：需按文档 schema 提供捕获数据；Cortex-M0/M0+ 与 ARMv8-M 的故障设施不同，ESP32 Xtensa/RISC-V panic 格式应改用对应厂商解码器。不要仅因文件名匹配就对新二进制进行符号化；HardFault 升级本身不是根因。修改看门狗、断言处理或故障恢复前先保留证据，不得通过关闭检测来隐藏崩溃。平台覆盖以实际测试组合为准，来源步骤不代表所有目标均已测试。