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 模式

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.mdcat mantis-slack-desktop-smoke-summary.jsoncat slack-desktop-command.logcat openclaw-gateway.logcat chrome.logcat ffmpeg.log

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

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

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

相關

• QA 概覽
• Slack 頻道
• 測試