Avouch

Avouch 是一款轻量级、Git 感知的 Python 静态分析 CLI 工具，专注于审查你即将提交的代码，而非你继承的全部代码。

它在每次运行时会通过 Git 确定即将提交的文件列表，使用 Python 标准库 ast 模块解析每个变更的 .py 文件，然后对照 avouch.toml 中配置的规则报告结构性问题。整个过程无守护进程、无网络请求、无需维护路径列表，在 git push 前几秒即可完成审查。

与现有工具不同，Avouch 的审查范围是 Diff 而非整个仓库，每个发现都可以精确归因到即将推送的工作内容，而非历史遗留代码。其指标完全精确——参数数量、嵌套深度、行范围均来自 AST 而非正则匹配，无法精确计算时不声称结果。错误即数据：无法读取或语法错误的文件会产生 ERROR 条目进入报告，一个坏文件不会取消其他文件的审查。

Avouch 提供 JSON 输出和安静模式，GitHub Actions 和其他 CI 系统开箱即用，Python 3.10 以上版本和 Git on PATH 即可运行。