用途:TestSprite CLI 是 TestSprite AI 测试平台的命令行接口,面向开发者和编码智能体,对真实运行中的应用执行前端(Playwright 浏览器)与后端 API 测试,不使用 mock,浏览器与 API 在云端运行。核心工作流为验证闭环:创建测试 → 运行 → 获取自洽的失败包 → 修复 → 重跑。
安装与初始化:需 Node.js ≥ 20。全局安装 npm install -g @testsprite/testsprite-cli,或用 npx @testsprite/testsprite-cli <command>。testsprite init 交互式写入 API Key 到 ~/.testsprite/credentials 并校验;CI 可用 export TESTSPRITE_API_KEY=sk-... 配合 testsprite init --from-env --yes --agent claude。认证命令有 auth configure、auth whoami、status、auth logout。
主要能力:项目管理(project list/get/create/update);测试管理(test list/get/create/update/delete、create-batch、delete-batch、test plan put、test code get/put 支持 etag);运行与重跑(test run、test rerun、test wait,支持 --all、--wait、--output json);结果与步骤查询(test result、test steps);失败诊断(test failure get 下载 failure.json、截图、DOM 快照与测试源码;test artifact get 按 runId 下载)。前端测试用 plan JSON 描述步骤,动作含 navigate、click、fill、select、check、uncheck、hover、wait、assert。后端测试可声明 --produces/--needs 依赖,重跑时按依赖波次执行。支持 agent install claude/cursor/cline/codex/antigravity 与 agent list,为编码智能体写入技能文件。
用法要点:输出支持默认可读、--output json、--quiet;退出码 0=通过、1=测试失败、2=错误;可用 --dry-run 本地校验命令与 plan 结构;环境变量 TESTSPRITE_API_KEY、TESTSPRITE_API_URL、TESTSPRITE_PROFILE 可覆盖配置;凭据文件支持多 profile。典型场景:新功能验证、回归防护、CI 集成(GitHub Actions 脚本)。
限制:资料未提供收费与价格信息;凭据与测试执行依赖 TestSprite 平台与 API Key;测试卡在 running 时需查看状态,取消需通过网页控制台;失败的 failure 包仅在最近一次运行确实失败时存在。部分细节资料暂未提供。