從零到您第一個真實的測試結果。
不需要先點開任何儀表板——安裝 CLI、驗證身分,並針對您的網站執行一次真實測試,全部都在終端機裡完成。以下是確切的順序,一步都不省略。
系統需求:Node.js 20.19+、22.13+,或 24+
testsprite doctor 會在您第一次執行測試之前告訴您。步驟 1 — 安裝
npm install -g @testsprite/testsprite-cli,或完全跳過安裝,直接用 npx @testsprite/testsprite-cli。
步驟 2 — 驗證身分
testsprite setup 會互動式提示輸入您的 API 金鑰。在腳本或 CI 中,可以跳過提示:TESTSPRITE_API_KEY=sk-... testsprite setup --from-env --yes。
步驟 3 — 建立測試計畫
testsprite test create --plan-template 產生一份可編輯的 JSON 計畫,或把 --plan-from 指向您的 PRD 或 API 文件來自動產生一份。
步驟 4 — 執行它
testsprite test create --project <id> --type frontend --plan-from plan.json --run --wait --output json 執行它,並等待真正的結果。
$ npm install -g @testsprite/testsprite-cli
$ testsprite doctor
✓ Node.js 22.13.0
✓ network reachable
$ testsprite setup
? Paste your API key: ****************************
✓ Authenticated
$ testsprite test create --plan-template > plan.json
$ testsprite test create --project prj_8f2a --type frontend \
--plan-from plan.json --run --wait --output json
✓ TC001_Login_Rejects_Empty_Password passed 1.2s
只差一個指令,就有真正的答案
以上這些不管是在您的筆電上、在 CI 裡,還是在編碼代理自己的 shell 裡,執行方式都一樣——安裝一次,之後 testsprite 就只是一個指令。
接下來可以做什麼
接入 CI
把同樣的指令加進 GitHub Actions、GitLab CI,或任何能執行 shell 指令的流水線,當作一個步驟。
接上您的編碼代理
testsprite agent install claude(或 cursor、codex、copilot、windsurf、cline、antigravity、kiro)會把 testsprite 註冊成它可以直接呼叫的工具。
免費社群版
提供免費社群版,讓所有人都能使用。
隨時檢查您的設定
如果之後覺得哪裡不對勁,testsprite doctor 可以重新執行環境診斷。
全球企業信賴
"TestSprite 提供豐富的測試案例生成、清晰的結構和易於閱讀的程式碼。它還支援簡單的線上調試,並能夠透過生成新的測試案例快速擴展。"
"TestSprite 的自動化幫助我們減少了大量的手動工作。開發人員可以更容易地在開發過程早期發現並解決錯誤。"
常見問題
除了 Node.js,我還需要安裝別的東西嗎?
不需要——npm install -g @testsprite/testsprite-cli(Node.js 20.19+、22.13+,或 24+)是唯一的相依套件。或者跳過全域安裝,直接執行 npx @testsprite/testsprite-cli。
不想用互動式提示,要怎麼驗證身分?
設定 TESTSPRITE_API_KEY,然後執行 testsprite setup --from-env --yes --agent <name>——為 CI 和腳本而生,不涉及瀏覽器或提示。
如果我的環境沒設定好怎麼辦?
testsprite doctor 會在您執行真正的測試之前先檢查環境,這樣設定上的問題就不會被誤認成測試失敗。
我一定要手寫測試計畫嗎?
不用——testsprite test create --plan-template 會幫您產生一份,或把 --plan-from 指向您的 PRD 或 API 文件,讓它自動幫您產生計畫。
試用需要付費嗎?
CLI 本身採用 Apache 2.0 授權,免費安裝——走完以上步驟、看到您第一個結果,不需要信用卡。