用途:对 Convex 项目做一次综合启动就绪度审计,把多个独立审计能力的结果合成一份去重、排序、打分的报告,并给出按优先级排列的修复清单。它自身不修问题,只决定修什么、按什么顺序修,再分派给对应的修复能力。
主要能力与流程:先做守卫与范围判断,deploy-guard 会判定目标是 local-anonymous、dev、preview 还是 prod;检测是否可评估(是否有 convex/ 目录、是否有带流量的部署、是否有鉴权基础),不满足前置条件的检查会被跳过并明确标注(跳过不等于通过)。随后并发运行各审计通道并输出 findings:convex-authz 检查鉴权(参数传入身份、缺少归属校验、PII 泄露、写入时的父引用),只要代码即可运行;convex-reviewer 检查校验器、以过滤代替索引、惯用法、错误处理;convex-advisor 需要存在带流量的部署,否则记录 skipped: no traffic;convex-insights 从日志提取近期失败,需要存在部署。
汇总与打分:所有 findings 汇总到一份报告,先按归一化的函数/表标识(如 messages:list)统一身份,使同一缺陷从代码位点和部署位点被报告时能通过 (class, identity) 去重合并为一条,保留置信度更高的来源,不静默丢弃,出错或跳过的通道记为覆盖缺口。评分从 100 起,按已确认 finding 的严重度扣分(高 −15、中 −5、低 −1),下限 0,并打印完整公式和分类明细以保证可复现;仅 plausible 的 finding 只列为候选项,不影响分数。
报告与分派:报告先给分数,再按严重度排列 findings,每条附证据、发生位置、对应 fixCapability 和一行修复说明,按 blockers / should-fix / nice-to-have 分组,最后给出有序修复计划:先鉴权与数据丢失,再性能与规模,最后惯用法与可观测性。用户接受后可按需调用对应修复能力(convex-authz、reviewer 的修复器、migrate-rehearse 处理 schema 变更、suggest 处理组件替换),修复后重跑受影响的通道并展示分数变化。
限制:这是一次读取、聚合与分派操作,实际修复由各修复能力完成并受其自身的同意与部署目标规则约束;报告头部会列出哪些通道已运行、哪些被跳过及原因,纯代码运行只能得到代码维度的分数,不代表已通过生产验证。资料未提供具体价格与收费方式。