SuperAPI AI 工具集

fallow-analysis

编程与开发

查看项目

更新于 10-16 05:08

技能介绍

用途:分析 JavaScript/TypeScript 项目的代码库卫生状况,包括死代码(未使用文件、导出、类型、枚举/类成员)、未使用或未列出的依赖、循环依赖、重复导出、代码重复与函数复杂度热点。适合发布或重构前清理、项目审计、为死代码或重复率设置 CI 检查,以及从 knip 或 jscpd 迁移。不适用于运行时错误分析、类型检查(用 tsc)、代码风格检查(用 ESLint/Biome/Prettier)、安全漏洞扫描、打包体积分析,也不适用于非 JS/TS 项目。

安装:npm install -g fallow,或 npx fallow check,或 cargo install fallow-cli。

主要命令:check 做死代码分析(默认);dupes 检测代码重复;fix 自动移除未使用导出/依赖;init 生成配置;migrate 转换 knip/jscpd 配置;list 查看项目结构;health 做函数复杂度分析;schema 输出 CLI 定义。常用标志包括 --format json --quiet、--explain、--changed-since、--production、--ci、--dry-run、--yes、--workspace、--trace 等。

典型用法:fallow check --format json --quiet 输出各类问题数组与统计;fallow check --format json --quiet --unused-exports 只看未使用导出;fallow check --format json --quiet --changed-since main --fail-on-issues 检查 PR 是否引入新死代码;fallow dupes --format json --quiet --mode semantic 检测重命名变量后的重复;修复前先 fallow fix --dry-run --format json --quiet 预览,再 fallow fix --yes --format json --quiet 应用。

限制与注意:仅做语法分析,不调用 TypeScript 编译器,完全动态的 import(variable) 无法解析;非 TTY 环境(如智能体子进程)执行 fix 必须加 --yes,否则退出码为 2;默认零配置,84 个框架插件自动检测;退出码 0 表示无错误级问题,1 表示发现错误级问题,2 表示运行时错误。配置读取顺序为 .fallowrc.json > fallow.toml > .fallow.toml,规则可设为 error、warn 或 off,并支持 fallow-ignore-next-line 等内联抑制注释。具体收费、价格与平台支持信息暂未提供。