SuperAPI AI 工具集

launch-verify-debug

部署与运维

查看项目

更新于 10-16 06:09

技能介绍

用途

该技能用于 vercel-openclaw 的启动验证(launch verification)与远程冒烟调试(remote smoke debugging),主要面向 /api/admin/launch-verify、pnpm smoke:remote 以及 vclaw create 的就绪(readiness)失败场景。

主要能力

  • 证据收集(Evidence First):收集请求模式(destructive 或 read-only,JSON 或 NDJSON)、脱敏后的完整阶段载荷(phase payload)、可用的 GET /api/admin/preflight 与持久化的 GET /api/admin/launch-verify、用于检查通道就绪的 GET /api/channels/summary,以及按 launch.、preflight.、sandbox.、gateway.、channels. 过滤的 GET /api/admin/logs。
  • 阶段拆分(Phase Splits):分别报告每个阶段,包括 preflight、queuePing、ensureRunning、chatCompletions、wakeFromSleep、restorePrepared、channelReadiness。技能明确要求不要把 ready:false 归并为单一根因。failingChannelIds 是机器可读的通道失败列表;warningChannelIds 已弃用。
  • 修复边界(Fix Boundaries):preflight 对应 src/server/deploy-preflight.ts、src/app/api/admin/preflight/route.ts;launch verify 对应 src/app/api/admin/launch-verify/route.ts、src/app/api/queues/launch-verify/route.ts;smoke 对应 src/server/smoke/remote-smoke.ts、src/server/smoke/remote-phases.ts;restore 阶段对应 src/server/sandbox/restore-oracle.ts 及其生命周期调用方。

使用方式

先按上述清单收集证据,逐阶段拆分报告结果,并依据修复边界定位代码位置。验证命令包括:

node scripts/verify.mjs --steps=test,typecheck
pnpm smoke:remote --base-url <url> [--destructive] [--auth-cookie "session=..."]
lat check

对于线上启动修复,需附上终端中的启动验证载荷以及修复前后确切的失败阶段。

适用场景

适用于排查 vercel-openclaw 的启动验证失败、远程冒烟测试问题,以及 vclaw create 就绪失败。

限制

除上述命令、路径与阶段名称外,具体运行环境、依赖版本、价格与支持平台等信息暂未提供。