用途：作为独立云端浏览器对已授权前端目标执行 TestSprite 测试，覆盖创建、运行、调试和发布门禁。后端 API 工作应交给 run-testsprite-backend，不适用于本前端流程。
主要能力：发现仓库与部署事实、冻结验证与授权契约、编写并审计声明式前端计划、创建测试、触发运行并等待终态、保留运行范围证据与失败工件、按产品/计划/生成代码/部署/认证环境/运行器等层分类修复、执行发布门禁。CLI 仅用于公共 HTTP(S) 目标；localhost/私有目标走一次性、显式授权的 MCP 流程。
使用方式：CLI 0.4.0 需 Node ^20.19.0 || ^22.13.0 || >=24。每次网络调用须自包含并固定包版本，例如：npm exec --yes --package=@testsprite/testsprite-cli@0.4.0 -- testsprite --version。认证检查用 testsprite --profile default --output json auth status，随后 doctor、usage。显式使用存储 profile 时可 env -u TESTSPRITE_API_KEY 并核对身份。只读发现用 project list/get、test list --type frontend。计划先用 test scaffold --type frontend 生成，经脚本与 test lint 审计，再 test create 创建但不运行。最终证明须在部署证明后新触发 test run（不加 --wait），记录新 run ID、入队时间、目标与 codeVersion，再 test wait 指定运行至通过；test steps 取步骤，失败时 test artifact get。批量用两阶段 create-batch（不 --run），要求 failed=0、created=total、每个输入对应唯一测试 ID，再逐个显式 ID 运行。
限制：任何网络写入、计费运行、部署、项目创建/更新、计划/代码操作、MCP 变更与浏览器副作用均须显式授权；不得打印或持久化密钥，凭证不得进入 URL、计划、源码、参数、日志或记录；缺少可用目标或一次性 MCP 边界时应停止并报告运行证明受阻。不得以 dispatch、rerun、auto-heal、取消、陈旧部署、部分批次或弱化断言作为发布证明。计划中不得包含选择器或凭证。资料未提供的具体收费、价格、平台支持范围和效果未予说明。