English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Get started

Mantis Slack 桌面版作業手冊

Mantis Slack 桌面 QA 是針對 Slack 類型錯誤的實際 UI 測試線，這些錯誤需要 Linux 桌面、VNC 救援、Slack Web、真正的 OpenClaw Gateway、螢幕截圖、 影片，以及 PR 證據留言。

當單元測試或無頭 Slack 即時測試線無法證明錯誤時，請使用它。

儲存模型

Mantis 使用三種不同的儲存層：

  • 提供者映像檔：由 Crabbox 擁有，並儲存在雲端提供者帳戶中。 它包含機器能力，例如 Chrome/Chromium、ffmpeg、scrot、 Node/corepack/pnpm、原生建置工具，以及空的快取目錄。
  • 暖租約狀態：由目前的操作者工作階段擁有。當租約仍有效時，它可以包含 已登入的瀏覽器設定檔、/var/cache/crabbox/pnpm，以及已準備好的原始碼 checkout。
  • Mantis 成品：由 OpenClaw 執行擁有。它們位於 .artifacts/qa-e2e/mantis/... 下，接著由 GitHub Actions 上傳，並由 Mantis GitHub App 在 PR 上留言內嵌證據。

絕不要將秘密、瀏覽器 Cookie、Slack 登入狀態、儲存庫 checkout、 node_modules 或 dist/ 放入預先烘焙的提供者映像檔。

GitHub 分派

從 main 執行工作流程：

gh workflow run mantis-slack-desktop-smoke.yml \
  --ref main \
  -f candidate_ref=<trusted-ref-or-sha> \
  -f pr_number=<pr-number> \
  -f scenario_id=slack-canary \
  -f crabbox_provider=aws \
  -f keep_vm=false \
  -f hydrate_mode=source

允許的 candidate_ref 值刻意收窄，因為工作流程會使用即時憑證：目前的 main 祖先、發行標籤，或來自 openclaw/openclaw 的開放 PR head。

工作流程會寫入：

  • 已上傳成品：mantis-slack-desktop-smoke-<run-id>-<attempt>；
  • 來自 Mantis GitHub App 的內嵌 PR 留言；
  • slack-desktop-smoke.png；
  • slack-desktop-smoke.mp4；
  • slack-desktop-smoke-preview.gif；
  • slack-desktop-smoke-change.mp4；
  • mantis-slack-desktop-smoke-summary.json；
  • mantis-slack-desktop-smoke-report.md；
  • 遠端日誌，例如 slack-desktop-command.log、openclaw-gateway.log、 chrome.log 和 ffmpeg.log。

PR 留言會透過隱藏的 <!-- mantis-slack-desktop-smoke --> 標記原地更新。

本機 CLI

冷來源證明：

pnpm openclaw qa mantis slack-desktop-smoke \
  --provider aws \
  --class standard \
  --gateway-setup \
  --credential-source convex \
  --credential-role maintainer \
  --provider-mode live-frontier \
  --model openai/gpt-5.4 \
  --alt-model openai/gpt-5.4 \
  --scenario slack-canary \
  --hydrate-mode source

保留 VM 以便 VNC 救援：

pnpm openclaw qa mantis slack-desktop-smoke \
  --provider aws \
  --class standard \
  --gateway-setup \
  --scenario slack-canary \
  --keep-lease

開啟 VNC：

crabbox vnc --provider aws --id <cbx_id> --open

重用暖租約：

pnpm openclaw qa mantis slack-desktop-smoke \
  --provider aws \
  --lease-id <cbx_id-or-slug> \
  --gateway-setup \
  --scenario slack-canary \
  --hydrate-mode source

只有在重用的遠端工作區已經有 node_modules 和已建置的 dist/ 時，才使用 --hydrate-mode prehydrated。如果缺少這些項目，Mantis 會以關閉方式失敗。

Hydrate 模式

模式 使用時機 遠端行為 取捨
source 一般 PR 證明、冷機器、CI 在 VM 內執行 pnpm install --frozen-lockfile --prefer-offline 和 pnpm build 最慢，但提供最強的原始碼 checkout 證明
prehydrated 你刻意準備了可重用租約 要求既有的 node_modules 和 dist/；跳過安裝/建置 快速，但只對操作者控制的暖租約有效

GitHub Actions 一律會在 VM 執行前準備候選 checkout。它的 pnpm store 會依 OS、Node 版本和 lockfile 進行快取。VM 來源執行在存在 /var/cache/crabbox/pnpm 時也會使用它。

時間解讀

mantis-slack-desktop-smoke-report.md 包含階段時間：

  • crabbox.warmup：雲端提供者開機、桌面/瀏覽器就緒，以及 SSH。
  • crabbox.inspect：租約中繼資料查詢。
  • credentials.prepare：Convex 憑證租約取得。
  • crabbox.remote_run：同步、瀏覽器啟動、OpenClaw 安裝/建置或 hydrate 驗證、Gateway 啟動、螢幕截圖，以及影片擷取。
  • artifacts.copy：從 VM rsync 回來。

當 Crabbox 在 Mantis 已複製證明 OpenClaw Gateway 存活且設定完成的中繼資料後 回傳非零遠端狀態時，crabbox.remote_run 可以標記為 accepted。請將 accepted 視為附帶說明的通過，而不是失敗場景。

如果執行很慢：

  • warmup 佔大宗：預先烘焙或推廣更好的 Crabbox 提供者映像檔；
  • source 中的 remote_run 佔大宗：使用暖租約、改善 pnpm store 重用， 或將機器前置需求移入提供者映像檔；
  • prehydrated 中的 remote_run 佔大宗：遠端工作區其實尚未就緒， 或 Gateway/瀏覽器/Slack 設定很慢；
  • 成品複製佔大宗：檢查影片大小和成品目錄內容。

證據檢查清單

好的 PR 留言應該顯示：

  • 場景 id 和候選 SHA；
  • GitHub Actions 執行 URL；
  • 成品 URL；
  • 內嵌螢幕截圖；
  • 可用時的內嵌動畫預覽；
  • 完整 MP4 和裁剪後 MP4 連結；
  • 通過/失敗狀態；
  • 附加報告中的時間摘要。

不要將螢幕截圖或影片提交到儲存庫中。請將它們保存在 GitHub Actions 成品或 PR 留言中。

失敗處理

如果工作流程在 VM 執行前失敗，請先檢查 Actions job。常見原因是 不受信任的 candidate_ref、缺少環境秘密，或候選安裝/建置失敗。

如果 VM 執行失敗但螢幕截圖已複製回來，請檢查：

cat mantis-slack-desktop-smoke-report.md
cat mantis-slack-desktop-smoke-summary.json
cat slack-desktop-command.log
cat openclaw-gateway.log
cat chrome.log
cat ffmpeg.log

如果執行保留了租約，請使用報告中的 crabbox vnc ... 命令開啟 VNC。 完成後停止租約：

crabbox stop --provider aws <cbx_id-or-slug>

如果 Slack 登入已過期，請在保留租約的 VNC 中修復它，並使用 --lease-id 重新執行。不要將該瀏覽器設定檔烘焙進提供者映像檔。

相關