chainlesschain Fault Localizer - 自动故障定位
描述
给定错误堆栈或失败测试输出，自动解析并定位根因代码。通过频谱分析（suspiciousness scoring）和源代码导航，快速缩小故障范围。
使用方法
/fault-localizer [--trace|--test|--error] "错误信息或堆栈"
运行模式
| 模式 | 说明 | 输入类型 |
|---|---|---|
| --trace | 解析完整的错误堆栈跟踪 | Node.js/Python/Java堆栈 |
| --test | 分析失败的测试输出 | Jest/Vitest/Pytest输出 |
| --error | 解析简单的错误消息并推断上下文 | 错误消息字符串 |
分析流程
- 堆栈解析: 从堆栈跟踪中提取文件路径、行号、函数名
- 源代码读取: 读取每个栈帧对应的源文件，提取上下文代码
- 函数分析: 分析函数复杂度、是否有错误处理、参数验证
- Git历史: 检查文件最近修改时间，近期修改的代码更可能是根因
- 可疑度排名: 综合评分，按可能性从高到低排序
可疑度评分因素
| 因素 | 权重 | 说明 |
|---|---|---|
| 抛出点距离 | 0.35 | 越接近error throw点，可疑度越高 |
| 函数复杂度 | 0.20 | 复杂函数更容易出bug |
| 错误处理缺失 | 0.20 | 缺少try/catch的函数更可疑 |
| 近期修改 | 0.15 | 最近修改过的文件更可能引入bug |
| 参数验证 | 0.10 | 缺少输入验证的函数更可疑 |
输出格式
{
"errorType": "TypeError",
"errorMessage": "Cannot read properties of undefined (reading 'id')",
"frames": [
{
"file": "src/main/user.js",
"line": 42,
"column": 15,
"function": "processUser"
}
],
"suspiciousLocations": [
{
"file": "src/main/user.js",
"line": 42,
"function": "processUser",
"score": 0.95,
"reason": "Closest to error throw point, deep property access without null guard"
}
],
"suggestedFix": "Add null check: if (!user?.id) return null;"
}
示例
解析Node.js堆栈:
/fault-localizer --trace "TypeError: Cannot read properties of undefined (reading 'id')
at processUser (src/main/user.js:42:15)
at handler (src/main/api.js:18:10)"
分析失败测试:
/fault-localizer --test "FAIL src/tests/auth.test.js
● login flow › should reject invalid token
Expected: 401
Received: 500"
诊断错误消息:
/fault-localizer --error "ECONNREFUSED 127.0.0.1:5432"