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 留言會透過隱藏的  標記原地更新。

本機 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 重新執行。不要將該瀏覽器設定檔烘焙進提供者映像檔。

Documentation Index

​儲存模型

​GitHub 分派

​本機 CLI

​Hydrate 模式

​時間解讀

​證據檢查清單

​失敗處理

​相關