用途:把 Convex 的多项审计结果合并为一份带评分的启动就绪度报告,类似后端版 Lighthouse;解决“四个报告各说各话、无法判断先修哪个”的问题。
主要能力:先做 GUARD+SCOPE,用 deploy-guard 判定目标类型(local-anonymous/dev/preview/prod),探测是否存在 convex/ 目录、有流量的部署、认证基础,并对不满足前置条件的检查记录为跳过(跳过的检查不算通过)。随后并发运行各 pass 并在 findings bus 上产出发现:convex-authz 扫描身份来自参数、缺少归属校验、PII 泄漏、写入时父引用等问题;convex-reviewer 检查校验器、用 filter 而非索引、惯用法与错误处理;convex-advisor 依赖有流量的部署提供读限额/OCC 证据;convex-insights 依赖部署日志分析近期失败。
归一化与评分:把所有发现汇总为一份报告,将每条发现的 identity 归一为函数/表键(如 messages:list),使代码位置与部署位置指向同一缺陷时经 (class, identity) 去重合并为一条,保留置信度更高的来源,不静默丢弃。评分从 100 起,仅对已确认发现按严重度扣分(高 −15、中 −5、低 −1),下限 0,并打印公式与分类明细;plausible 级别的发现只列为候选,不影响分数。仅有代码、无部署无流量时报告“仅代码评分”并明确标注。
报告与派发:输出评分、按严重度排序的发现(含证据、位置、fixCapability 及一行修复说明),分组为 blockers/should-fix/nice-to-have,并以有序修复计划收尾(先数据丢失/授权,再性能规模,最后惯用法与可观测性)。用户接受后可调用对应 fixCapability(如 convex-authz、reviewer 的修复器、schema 变更用 migrate-rehearse、组件替换用 suggest),修复后重跑受影响的 pass 并展示分数变化。
限制:该能力只做读取、聚合与派发,不直接执行修复;不重新实现审计逻辑,只组合既有能力;声明覆盖范围不得超出实际运行的 pass,报告头部须列出已运行与跳过的检查及原因;仅代码运行得到的分只能代表“代码看起来就绪”,不等同生产验证。具体安装方式与价格信息暂未提供。