blast-radius-analyzer

Blast Radius Analyzer

改动影响范围分析器 - 追踪代码改动的下游影响范围

特性

• 🔍 符号级追踪 - 精确定位符号的所有引用
• 📊 调用栈视图 - 完整展示调用链路
• 🔗 传播路径追踪 - 追踪常量、类型、嵌套属性的传播
• 🔬 数据流分析 - 商业级数据流追踪 (DataFlow Pro)
• 📈 类型流分析 - TypeFlow Pro 类型兼容性检查
• ⚡ CI/CD 集成 - 支持阈值告警和退出码
• 💾 智能缓存 - 增量分析，秒级响应

安装

# npm
npm install -g blast-radius-analyzer

# 或者直接运行
npx blast-radius-analyzer

使用

基本用法

# 分析改动影响
blast-radius -p ./src -c ./src/api/user.ts

# 指定符号
blast-radius -p ./src -c ./src/api/task.ts --symbol getTaskStats

# CI/CD 模式 - 阈值告警
blast-radius -p ./src -c ./src/api/task.ts --threshold files:5,score:100

# JSON 输出
blast-radius -p ./src -c ./src/api/task.ts -o result.json

# 轻量模式 (不加载完整项目)
blast-radius -p ./src -c ./src/api/task.ts -t

参数说明

参数	说明
-p, --project	项目根目录
-c, --change	改动的文件路径
--symbol	改动的符号名 (函数/变量/类型等)
-t, --symbol-only	轻量模式，不加载完整项目
--threshold	CI/CD 阈值 (files:N,score:N)
-o, --output	JSON 输出文件
--clear-cache	清除缓存后重新分析

示例输出

┌─────────────────────────────────────────────────────────────────┐
│                    📊 改动影响范围分析报告                         │
└─────────────────────────────────────────────────────────────────┘

📝 改动内容
   文件: task.ts
   符号: getTaskStats
   类型: 修改

🚨 风险等级: 🟢 低风险

📈 影响范围
   ├─ 受影响文件: 2 个
   ├─ 直接引用: 3 处
   └─ 调用点: 1 处

📞 调用栈视图

📍 getTaskStats (改动点) [function] → task.ts:7
   └─ fetchStats [function] → index.tsx:130
      ├─ handleRegenerate [arrow] → index.tsx:178
      └─ handleStop [arrow] → index.tsx:187

📊 数据流分析 (DataFlow Pro)
   基本块: 5 | 条件分支: 1 | 类型收窄: 1 | 置信度: medium

工作原理

• 符号分析 - 使用 TypeScript Language Service 查找符号的所有引用
• 调用链追踪 - 递归追踪函数的调用者，构建完整调用栈
• 传播追踪 - 追踪常量、类型、嵌套对象的传播路径
• 数据流分析 - 基于 CFG 和格论抽象解释的数据流追踪
• 风险评估 - 基于影响范围和调用深度计算风险等级

支持的场景

改动类型	追踪能力
导出函数	✅ 完整调用链
导出常量	✅ 传播路径
导出类型/接口	✅ 引用追踪
嵌套对象属性	✅ 传播路径
类/模块导出	✅ 实例化追踪

License

MIT