第 1 课
安装 CLI,配置密钥并创建前端项目和环境
安装 TestSprite CLI 并配置工作区,创建 frontend 项目与 staging 环境。
课程目录第 1 / 3 课
学习位置仅保存在当前浏览器,有效期 180 天。
图文教材
本课对照官方文档 CLI Quickstart 编写。命令在 2026-11-22 用官方 CLI 0.17.0 核对。对照 JSON 来自官方 --dry-run 罐头样例,不是真实工作区的返回。
本课目标
- 安装官方 CLI 0.17.0,并确认版本号
- 用 setup 写入工作区 API Key,再用 auth status 确认当前工作区
- 创建 frontend 项目,记录返回的 projectId
- 为项目添加名为 staging 的环境,并指向你的预发布地址
前置条件
- 本机已安装 Node.js 与 npm,能执行全局安装
- 已有 TestSprite 账号,并在控制台准备好工作区 API Key。不要把真实密钥写进代码、笔记本或聊天记录
- 准备一个可公开访问的前端预发布 URL。官方示例假定访客结账页可以匿名打开;若需要测试账号,请看官方 Environments 文档,本课先走公开地址
- 课程阅读免费。跟做会消耗 credits,免费档额度以官方定价页为准
第 1 步:安装官方 CLI 并确认版本
官方 Quickstart 的安装命令是:
npm install -g @testsprite/testsprite-cli
testsprite setup
testsprite auth status
本课按 2026-11-22 核对到的正式版安装并检查版本:
npm install -g @testsprite/testsprite-cli@0.17.0
testsprite --version
对照结果:本机输出为
0.17.0
若版本号不是 0.17.0,先看官方文档是否已更新命令,再决定是否继续。setup 需要你的 API Key。官方帮助说明:setup 会校验密钥、写入本机 profile,并可为编程智能体安装技能。若只想先配密钥,可加 --no-agent。无交互环境必须用 --api-key 或 --from-env,否则 setup 会以退出码 5 结束。
示例(把 your_api_key_here 换成你自己的密钥,不要提交到仓库):
testsprite setup --api-key "your_api_key_here" --yes --no-agent
testsprite auth status --output json
没有真实密钥时,可以用官方罐头样例查看字段。本机执行:
testsprite --dry-run auth status --output json
标准错误会提示 sample response — not from the server。标准输出示例如下(节选):
{
"keyId": "key_dryrun_2026",
"env": "development",
"activeOrg": {
"name": "Dry Run Workspace",
"plan": "Standard",
"role": "owner",
"remaining": 1650,
"includedCredits": 1600
}
}
你用真实密钥时,name、plan 和 remaining 会不同。先确认 activeOrg 对应你要使用的工作区。
第 2 步:创建前端项目
官方建议先列出已有项目,再创建或复用:
testsprite project list
若要新建,官方命令是:
testsprite project create --type frontend --name "Checkout" --output json
请把 Checkout 换成你自己的项目名。本机用 --dry-run 得到的罐头样例如下:
testsprite --dry-run project create --type frontend --name "Checkout" --output json
{
"projectId": "p_dryrun_2026",
"id": "p_dryrun_2026",
"type": "frontend",
"name": "Checkout",
"createdFrom": "cli"
}
把返回的 projectId 记下来。后面的命令都要用它。真实创建时,这个 ID 不会是 p_dryrun_2026。
第 3 步:添加 staging 环境
官方 Quickstart 把项目 ID 和应用地址写成变量,再创建环境。新建项目的第一个环境会成为默认环境。
PROJECT_ID='your-project-id'
APP_URL='https://staging.example.com'
testsprite project env create "$PROJECT_ID" --name staging --url "$APP_URL"
请把 your-project-id 换成上一步的真实 ID,把 URL 换成你自己的预发布地址。不要使用示例域名去要求真实测试通过。
本机罐头样例如下:
testsprite --dry-run project env create "proj_dryrun0001" \
--name staging \
--url "https://staging.example.com" \
--output json
{
"environment": {
"name": "staging",
"url": "https://staging.example.com",
"authMode": "public",
"hasCredentials": false
},
"created": true
}
看到 created 为 true,且 name 为 staging 后,本课完成。下一课将请智能体规划一条测试。
官方文档还说明:若前端在你自己的机器上,需要看 Local apps;若测试 API,应创建 backend 项目并附上接口说明。本课只做可公开访问的 frontend。
