这个项目能做什么

Ultimate Bug Scanner (ubs) 是一款静态分析工具，可自动检测多种流行编程语言中的 1000 多种 bug 模式，包括 JavaScript/TypeScript、Python、C/C++、Rust、Go、Java、Ruby、Swift、C# 和 Elixir。它旨在充当 AI 编码代理的质量护栏，在常见错误（如空指针解引用、缺失 await、XSS 漏洞和资源泄漏）进入生产环境之前将其捕获。 该工具作为语言感知的元运行器运行，可自动检测仓库中存在的语言，并分发到各语言扫描器。每个扫描器独立运行，并支持多种输出格式（text、JSON、JSONL、SARIF 和 TOON），以便下游工具链保持一致。所有语言的结果会合并为单一报告，使 CI 系统和 AI 代理能够轻松解析单个产物。 主要功能包括： - **18 个专门检测类别**，涵盖空安全、安全漏洞、async/await bug、资源生命周期问题等。 - **供应链防护**：惰性下载的模块会根据固定的 SHA-256 校验和进行验证，并可选支持 minisign 签名验证。 - **类别包**用于聚焦扫描（例如 resource-lifecycle），以及**可共享报告**，支持基线比较、HTML 预览和 GitHub 永久链接。 - **机器可读输出**，适用于代理上下文，包括 JSON Schema 验证和针对 token 优化的 TOON 格式。 - **Git 感知扫描**，支持仅扫描已暂存或差异变更，并提供严格性配置（strict/loose）和内联抑制注释。 - **轻松安装**：通过一行 curl 脚本、Homebrew、Nix 或 Docker 安装，并提供 easy-mode（自动安装所有依赖）和完整性优先验证选项。 - **与 AI 编码代理集成**：自动检测 Claude Code、Codex、Cursor 和其他代理，并可在无需额外提问的情况下接入质量护栏（例如文件保存时扫描）。 - **自动更新**（可选启用）以及 `ubs doctor` 命令，用于审计环境并修复缺失或损坏的模块。 Ultimate Bug Scanner 定位为面向开发者和 AI 代理的快速、全面的 bug 猎手伙伴，旨在减少调试时间并提升多语言项目的代码质量。