// 反模式：概念压缩
if (order.type == 4) { ... }  // type 4 是什么？

// 这个枚举有 15 个值，在 12 个包中的 47 处被使用
enum OrderType {
    NORMAL, PREORDER, VIRTUAL, PRESALE, GROUP, FLASH_SALE, ...
}

// 显式、自文档化的数据
if (order.is_virtual) { ... }
if (order.requires_payment) { ... }
if (order.is_group_order) { ... }

cargo install code-lint-x

git clone https://github.com/iannil/code-lint-x.git
cd code-lint-x
cargo install --path .

# 扫描项目
code-lint-x scan ./src

# 生成 HTML 报告
code-lint-x scan ./src --format html --output report.html

# JSON 输出（用于 CI/CD）
code-lint-x scan ./src --format json --output results.json

[thresholds]
compression_index = "warning:30, error:60"

[detector.god_enum]
enabled = true
min_enum_values = 3

[detector.comment_smell]
enabled = true
keywords = ["special case", "except", "temporary", "hack", "TODO"]

[ignore]
paths = ["generated/", "vendor/", "*_test.go"]

[output]
format = "json"
sort_by = "severity"

# 安装 pre-commit hook
code-lint-x hook install

# 卸载 hooks
code-lint-x hook uninstall

# 查看时间趋势
code-lint-x trend --since "1 month ago"

# 按模块分组
code-lint-x trend --by-module

# 按作者分组
code-lint-x trend --by-author

压缩指数 = (控制流引用次数 × 涉及包数量) / 枚举值数量

正在扫描: /path/to/project
├── 发现 23 个可疑枚举
├── 发现 47 条注释异味

┌─ 全局枚举检测 ─────────────────────────────────────────┐
│                                                      │
│  OrderType (order/Order.java:42)                     │
│  ├── 压缩指数: 87.3  :x: 严重                          │
│  ├── 15 个枚举值                                      │
│  ├── 47 处控制流引用                                   │
│  ├── 用于 12 个包                                     │
│  │                                                   │
│  重构建议:                                            │
│  ├─ 拆分为: is_virtual, is_preorder, is_group         │
│  ├─ 新枚举: FulfillmentMode, PaymentMethod            │
│  └─ 预期压缩指数: 87.3 → 12.4                          │
│                                                      │
└──────────────────────────────────────────────────────┘

code-lint-x <命令> [选项]

命令:
    scan        扫描源码中的概念压缩
    trend       显示趋势分析
    dashboard   生成团队仪表板
    hook        管理 git hooks
    config      配置管理
    init        初始化配置文件
    help        显示帮助信息

扫描选项:
    -p, --path <PATH>           扫描路径 [默认: .]
    -f, --format <FORMAT>       输出格式: text|json|html [默认: text]
    -o, --output <FILE>         输出到文件
    -c, --config <FILE>         配置文件 [默认: .codelintrc]
    --since <COMMIT>            增量扫描（从指定提交开始）

src/
├── analyzer/      # 智能重构建议
│   ├── suggester.rs    # 生成可操作的建议
│   ├── impact.rs       # 分析变更影响和范围
│   └── context.rs      # 上下文感知过滤
├── cli/           # 命令行接口
├── config/        # 配置文件解析
├── core/          # AST 定义、追踪器、指标
├── detector/      # 检测算法
│   ├── god_enum.rs     # 压缩指数计算器
│   └── comment_smell.rs # 注释模式匹配
├── integration/   # Git hooks、CI/CD
├── lang/          # 语言特定解析器
│   ├── java/
│   ├── go/
│   ├── typescript/
│   └── python/
├── report/        # 报告生成
│   ├── trend.rs        # 历史趋势追踪
│   └── dashboard.rs    # 团队仪表板 HTML
└── scanner/       # 项目扫描协调器

# 克隆仓库
git clone https://github.com/iannil/code-lint-x.git
cd code-lint-x

# 运行测试
cargo test

# 带调试输出运行
cargo run -- scan ./tests/fixtures --format json

# 格式化代码
cargo fmt

# 运行 linter
cargo clippy