TestSprite

在 AI 辅助编程时代，代码生成的速度已不再是瓶颈，验证才是。TestSprite 推出的官方 CLI 工具，旨在填补这一空白。它不仅仅是一个测试运行器，更是一个专为 Claude Code、Cursor、Codex 等编码智能体设计的“验证层”。

通过模拟真实用户在云端实时环境中的操作，TestSprite 能够精准捕捉前端和后端的逻辑漏洞，并将失败信息打包成智能体可直接理解的“自洽捆绑包”，从而实现“发现-修复-重跑”的自动化闭环。

核心理念：验证胜过模型规模

TestSprite 提出一个颠覆性的观点：在拥有可靠验证机制的情况下，廉价模型的表現可以超越昂贵模型。

公开数据显示，配合 TestSprite CLI 的验证循环，行业内最便宜的模型在应用交付准确率上达到了 89%，而成本仅为最昂贵模型的一半。这是因为智能体不再依赖单一的推理能力来保证正确性，而是通过不断的“试错-反馈”迭代来逼近完美结果。

为什么专为智能体设计？

传统的测试工具输出的是给人类看的日志，而 TestSprite CLI 输出的是给 AI 看的结构化上下文：

1. 自洽的失败捆绑包 (Self-Contained Failure Bundle)：
   当测试失败时，testsprite test failure get 会返回一个包含失败步骤、相邻步骤、截图、DOM 快照、测试源码、根本原因假设及推荐修复目标的完整数据包。所有数据共享同一个 snapshotId，确保智能体基于一致的状态进行推理，避免因数据拼接导致的幻觉。
2. 像真实用户一样测试：
   不同于本地模拟环境，TestSprite 在云端针对真实运行的产品进行测试。真实的点击、导航和断言能捕捉到模拟环境无法复现的集成问题和边缘情况。
3. 持久化的测试套件：
   每一次成功的测试都会被存入持久化套件中。随着项目迭代，这套套件成为了项目“有史以来正确实现的每个需求”的活档案，其覆盖范围远超任何 LLM 的上下文窗口限制。
4. 确定性脚本接口：
   提供稳定的 JSON 输出契约、可预测的退出码（Exit Codes）以及 --dry-run 离线调试模式，完美契合 CI/CD 管道和自动化脚本的需求。

快速开始：一条命令激活智能体验证能力

TestSprite CLI 的安装与配置极其简便，旨在让开发者在最短时间内让智能体具备自我验证能力。

前置要求：Node.js ≥ 20

安装与设置：

npm install -g @testsprite/testsprite-cli
testsprite setup

运行 testsprite setup 后，系统会引导你输入 API Key，并自动为当前目录下的编码智能体（如 Claude, Cursor, Cline 等）安装专用的验证技能 (Verification Skills)。这意味着智能体将“学会”如何创建测试、解析失败报告并执行修复，无需你在 Prompt 中反复教导。

非交互式安装（适用于 CI/脚本）：

TESTSPRITE_API_KEY=sk-... testsprite setup --from-env --yes --agent claude

工作流示例：智能体的自我修正循环

以下是一个典型的由编码智能体驱动的会话流程：

1. 创建并运行测试：

   # 描述行为，运行测试，等待结果
   testsprite test create --project proj_8f0f6 --type frontend \
     --plan-from ./checkout-flow.plan.json --run --wait --output json
   # → 退出码 1：运行失败
   

2. 获取失败上下文：

   # 拉取自洽的失败捆绑包
   testsprite test failure get test_3a9f21c7 --out ./.testsprite/failure
   

   此时，智能体会读取该目录下的 JSON 和媒体文件，分析 DOM 快照和错误日志。

3. 修复并重跑：
   智能体根据分析结果修改代码，然后触发重跑：

   testsprite test rerun test_3a9f21c7 --wait --output json
   # → 退出码 0：通过。该测试现在已存入持久化套件。
   

常用命令速查