本工具在 群：不粉不黑 JAVA GO 面向AI编程目标日入三万  群友：【风之痕】提供的1.9基础上，通过AI加强部分功能，详见readme.md

## 简介

`aalint` 是一个命令行工具，用于检查 `.aardio` 代码的语法错误和运行时错误。它模拟了 aardio IDE 中按 **F5** 运行时的错误检查能力。很适合编辑器插件、Git hooks、CI/CD 流水线等自动化场景，也是 AI 辅助编写 aardio 代码的重要工具。

**v2.0 新增**：

- `--lint` / `-l`：**aardio 陷阱规则检测**，内置 6 条 aardio 专属规则（字符串拼接运算符、try-return 语义、双引号转义、namespace 前缀、未使用导入、内置名遮蔽）

- `--symbols` / `-s`：**符号提取/代码大纲**，输出文件中的 import、函数、变量、namespace 声明

- `--imports` / `-i`：**依赖验证**，检查所有 import 语句能否解析到实际库文件（支持文件形式 `xxx.aardio` 和目录形式 `xxx\_.aardio`）

- `--api` / `-a`：**标准库 API 查询**，解析库文件并输出函数签名、类、属性（同样支持两种库形式）

- `--run --capture`：**输出捕获**，运行代码并捕获 stdout 输出（JSON 模式下放入 `output` 字段）

- `--eval` / `-e`：**内联表达式求值**，快速验证 aardio 语法/API 行为

- 所有新功能均支持 `--json` 输出和 `--dir` 递归

- 启用 Windows 虚拟终端处理（`ENABLE_VIRTUAL_TERMINAL_PROCESSING`），ANSI 彩色输出在 Windows 10+ 控制台正常显示

**v1.9 新增**：

- `--fix` 显示逐行 diff：每次修正输出 `-原文  →  +修复后`，辅助学习

- `--fix --dry-run` 同样显示 diff，可预览而不实际修改文件

- `--json --fix` 结果包含 `diffs` 字段（逐行差异数组）

- `--dir --run` 预编译优化：语法错误瞬间返回，不再等待超时

- `--dir --run` 进度显示：`[3/15] file.aardio ...` 格式 + 逐文件耗时

- `--dir --run` 末尾汇总总耗时

- `fixFile` 性能优化：`ide.aifix` 提升到顶层导入，批量修复不再重复加载