用途:通过 cy-cloud CLI 调查 Cypress Cloud 数据,包括组织、项目、运行(run)、规格(spec)、测试、失败截图和 Test Replay。要求直接执行命令、解析 JSON 并基于返回数据报告结论,CLI 能回答时不要引导用户去 Cloud UI。
主要能力:查询组织/项目/运行/规格/测试;检查尝试次数、flaky 与失败截图;查询 Test Replay 时间线;在测试某一时刻检查应用本身(DOM、ARIA、计算样式、实时截图)或定位改变元素的命令;诊断录制测试失败原因。
使用方式:需 Node.js 22.21.0 或更新版本。首次使用或环境未知时运行 node --version、cy-cloud status、cy-cloud --help。假定已安装并在 PATH 中,从用户当前工作区运行,不要克隆或构建源码仓库。安装命令:npm install -g @cypress/cloud。认证:cy-cloud login(交互式 OAuth)或 cy-cloud login --token "$PAT";CI 中 CYPRESS_CLOUD_TOKEN 优先于已存凭据且不写凭据文件。用 cy-cloud --help、<command> --help、<command> --schema 发现命令与字段。数据命令将 JSON 写到 stdout,直接解析;replay 下载进度写到 stderr,解析前不要合并 stderr 与 stdout,例如:cy-cloud replay timeline --testId <uuid> --attempt <failedAttemptNumber> 2>/dev/null。
限制:组织需启用 Cypress Cloud CLI 集成,未启用需管理员处理。Cloud 请求受安全沙箱与网络限制,需允许网络访问;Cloud API 按用户限流,超限应停止请求并报告,不要循环重试。Replay 下载有磁盘缓存,需保证缓存目录可写且持久,不要将缓存移入用户项目。不要打印、回显或提交 token,不要读取 ~/.config/cy-cloud/auth.json 或 cypress.env.json,改用 cy-cloud status。缓存维护用 cy-cloud cache info、cache cleanup、cache clear。部分字段可能与 schema 不符(如小数时长、小数 epoch),应按数字处理并如实报告。具体命令清单以已安装 CLI 的 --help 为准。