用途:为 Convex 后端生成一份统一的上线就绪度报告,把原本分散的多个审计能力组合成一份去重、排序、可复现评分的清单,被形容为“后端版 Lighthouse”。它自身不执行修复,只决定改什么、按什么顺序改,再分派给对应的修复能力。
主要能力:
- 范围守卫:先由 deploy-guard 判定目标类型(本地匿名 / dev / preview / prod),识别是否存在 convex/ 目录、有流量的部署、认证基础;不满足前提的检查会被跳过并明确说明,跳过的检查不等于通过。
- 运行四类审计并汇集发现:convex-authz(身份取自参数、缺失归属校验、PII 泄露、写入时的父引用)、convex-reviewer(校验器、用索引而非 filter、惯用法、错误处理)、convex-advisor(读取上限 / OCC 实证,需有流量的部署,否则记为“skipped: no traffic”)、convex-insights(日志中的近期失败,需存在部署)。独立检查可并发执行。
- 归一化与去重:将每条发现的 identity 统一为函数/表键(如 messages:list),使同一缺陷从代码位置与部署位置两处被报告时合并为一条,避免重复计分;保留置信度更高的来源,不静默丢弃。
- 可审计评分:满分 100,按确认(CONFIRMED)发现严重度扣分——高 −15、中 −5、低 −1,下限 0;打印公式与按类别拆分。仅 plausible 的发现只作为候选列出,不影响分数。
- 报告:按严重度排序,每条含证据、位置、对应 fixCapability 与一行修复说明,并按 blockers / should-fix / nice-to-have 分组;结尾给出有序修复计划(先是 authz/数据丢失,再是性能与规模,最后是惯用法与可观测性)。
- 分派:用户接受某条发现后,调用其 fixCapability;修复后重跑受影响的检查并展示分数变化。
使用方式与限制:属于读取、聚合与分派类流程,修复由各修复能力在自身同意与部署目标规则下完成。报告头部会列明哪些检查已运行、哪些被跳过及原因;仅代码模式的绿色分数只代表“代码看起来就绪”,不等于生产已验证。资料未提供具体安装命令、收费与价格信息。