用途:检测当前应用中已固定的 Convex 组件是否落后于 anteater 注册表推荐版本,并在获得用户明确同意后逐个升级,每个组件升级都经过构建门禁(typecheck + next build)与冒烟测试后才进行下一个。
主要能力:识别过时组件,列出组件名、已安装版本与当前版本、摘要以及是否为破坏性变更;安装新版本引用,应用 migration.steps 中的变更(convex/ 目录的修改交由 convex-expert 处理),运行 migration.gate 中的命令;失败时回滚(git checkout -- . 或重装旧引用),不会让应用处于半迁移状态。
使用方式:在项目根目录运行 curl -fsSL https://graceful-tiger-715.convex.site/check-updates.mjs -o /tmp/cu.mjs && node /tmp/cu.mjs。若输出 COMPONENTS_UP_TO_DATE 表示已是最新;若输出 COMPONENTS_STALE= 则列出每个过时条目并征求用户同意。用户同意后安装新引用并执行迁移步骤与门禁命令;每次成功升级后向用户提供 migration.smoke 冒烟检查;逐个组件重复。
适用场景:需要安全、可控地更新 Convex 依赖组件的开发流程。
限制与规则:没有用户明确同意不得升级,哪怕是次要版本;每个组件必须单独通过门禁后才能继续;标记 breaking:true 的升级在应用前需要快照(提交或分支);升级后未经用户确认不得自动重新发布线上 *.convex.app 站点。资料未提供具体价格、支持的平台或更多高级选项。