Specreel icon

Specreel

Specreel 將 Playwright 瀏覽器流程或已部署應用程式情境轉為配有旁白、可分享的示範,並可重新執行作為端對端檢查,支援本機開源 CLI 與託管 Cloud 工作流程。

Specreel

產生可分享示範的瀏覽器測試

Specreel 是一款瀏覽器流程測試與示範發布工具,適合希望產品示範與應用程式保持一致的團隊。它將端對端測試與錄製的示範視為同一項成果:可重播、檢查和分享的瀏覽器流程。

開源 CLI 可在本機或 CI 中執行,並將 Playwright 追蹤檔案轉譯為配有旁白的 gallery。Specreel Cloud 則從已部署的 URL 開始,探索候選流程,在託管瀏覽器中執行,並提供具備排程檢查與中斷警示的託管 gallery。在這兩種工作流程中,變更或失敗的流程都能在過時的示範被分享前提供訊號。

功能

以追蹤檔案為基礎的示範轉譯

Playwright 追蹤檔案會轉換為配有旁白、可分享的示範 gallery。在標準工作流程中,字幕會根據記錄的點擊和斷言產生,不使用 AI。

CI 中的新鮮度檢查

GitHub Action 可以在每次建置成功後,將 gallery 重新發布至相同的 URL,讓已發布的示範與最新的成功建置保持一致。

變更與失敗訊號

對於已變更但仍通過的流程,轉譯器會以琥珀色的「已更新」徽章標示;流程失敗時,建置會變成紅色,而不會發布不正確的示範。

流程探索與腳本建立

recommend 指令會爬取執行中的應用程式,評估值得展示的流程並建立可執行的 Playwright 腳本。託管掃描器可以從已部署的 URL 建立可編輯的情境。

可攜式示範與匯出

本機工具可以建立自包含的 gallery.html、將 gallery 發布至 URL、使用 iframe 嵌入,並匯出包含真實螢幕截圖、字幕和配音的 MP4。

託管自動化介面

Specreel Cloud 提供 MCP server 和 JSON API,可用於建立專案、設定登入、加入情境、執行檢查,以及從相容的 AI 工具或 API 用戶端取得 gallery 結果。

使用情境

  • 讓版本發布示範保持最新

    在現有的 Playwright 套件中啟用追蹤,並在建置成功後發布產生的 gallery。這樣一來,示範會成為回歸測試涵蓋範圍的可見伴隨內容,而不是另外錄製的素材。

  • 沒有現有測試套件也能建立示範

    將 Specreel 指向暫存或正式環境的 URL,以找出表單、搜尋和導覽流程,接著使用一般英文編輯產生的情境,並在託管瀏覽器中執行。

  • 發布產品導覽

    使用本機套件、URL 或 iframe,在文件、銷售資料或內部審查中分享產品導覽。MP4 匯出適用於需要影片檔案的情境。

  • 自動化建立示範與檢查

    將託管 MCP server 或 JSON API 連接至 AI 程式碼工具或自動化用戶端,讓它掃描應用程式、設定存取權、執行情境,並回傳 gallery URL 與失敗流程結果。

Pros and Cons

Pros

  • 將錄製的瀏覽器流程與端對端檢查連結起來,而不必分別維護示範和測試。
  • 同時支援本機開源 CLI 與已部署應用程式的託管工作流程。
  • 提供多種發布格式,包括託管 gallery、HTML 套件、iframe 嵌入和 MP4 匯出。
  • 團隊尚未建立 Playwright 套件時,也能探索並建立流程腳本。
  • 將已變更但通過的流程與失敗流程分開呈現,有助於區分 UI 更新與失敗。

Cons

  • 本機工作流程依賴 Playwright 追蹤檔案與 Chromium 安裝。
  • 需要驗證的託管流程必須使用合適的測試帳號、工作階段或測試登入路由;工作階段可能會過期,並需要重新整理。
  • 已記錄的 /pricing URL 無法存取託管定價頁面,因此應在 Cloud 產品中確認方案詳細資訊。

FAQ

Specreel 可以與現有的 Playwright 測試套件搭配使用嗎?

Specreel 可以使用現有的 Playwright 工作流程。啟用追蹤功能,讓測試執行產生 trace.zip 檔案,接著對 test-results 目錄執行轉譯器。若沒有現有測試,CLI 也能從 URL 建立流程腳本。

如何設定開源 CLI?

對於本機工作流程,請安裝 specreel 與 Playwright 套件、安裝 Chromium、產生或執行流程,然後轉譯產生的追蹤檔案。您也可以將 gallery 產生為自包含的 HTML 檔案。

Specreel 可以測試需要驗證的應用程式嗎?

可以。託管工作流程接受已部署的應用程式 URL,掃描表單、搜尋和導覽等流程,並建立可編輯的情境。您可以使用專用測試帳號、已儲存的工作階段或測試登入 URL 設定驗證;公開頁面也可以不登入直接使用。

Specreel 會產生哪些內容?

本機工作流程可以建立 gallery、單一檔案 HTML 套件,以及包含旁白音軌的 MP4。託管執行會提供可分享的 gallery URL,而本機 gallery 可以發布至 URL 或使用 iframe 嵌入。

CLI 與 Specreel Cloud 有何不同?

開源 CLI 會在使用者的電腦或 CI 中執行。Specreel Cloud 則透過託管服務執行瀏覽器工作流程,並可排程檢查、傳送中斷警示及提供託管 gallery;可用的託管功能取決於所選方案。

Quick Facts

類別
開發者工具;瀏覽器測試與示範發布
本機引擎
搭配 Playwright 與 Chromium 的開源 Python CLI
託管引擎
位於 app.specreel.dev 的 Specreel Cloud
主要輸入
已部署的應用程式 URL 或 Playwright trace.zip 檔案
本機輸出
配有旁白的 gallery、自包含 HTML 套件和 MP4 匯出
發布方式
CI 發布的 URL、iframe 嵌入或託管 gallery 連結