SuperAPI AI 工具集

graphql-inspector-audit

测试与质量

查看项目

更新于 10-16 03:38

技能介绍

用途:该技能提供 GraphQL Inspector 的 audit 命令知识,用于分析 GraphQL 操作的复杂度,提前识别可能导致性能问题的操作。

主要能力:审计查询深度、别名数量、指令数量、令牌数量与复杂度等指标,并输出每个操作的详细指标表格;支持针对指定 schema 审计,也支持通过配置文件设置阈值。

使用方式:基础审计运行 npx @graphql-inspector/cli audit './src/**/*.graphql',也可审计 TSX 文件或使用多个 glob 模式;指定 schema 使用 --schema './schema.graphql';可通过 .graphql-inspector.yaml 配置 documents 与 thresholds(如 depth、aliases、directives、tokens、complexity);支持 --json 生成 JSON 报告,并可在 GitHub Actions 中按 pull_request 或定时任务集成。

适用场景:PR 前检查、定期分析、复杂度预算、发布前质量门禁及开发者优化培训。

限制:具体版本、平台支持与并行参数等细节暂未提供;输出内容依赖文件中的有效 GraphQL 操作与 glob 匹配。

最佳实践:定期审计、设置阈值、跟踪趋势、审查异常指标、优化高频路径、记录例外并自动化告警。