Podręcznik operacyjny Mantis dla aplikacji Slack na komputerze

Mantis Slack desktop QA to ścieżka testów z rzeczywistym interfejsem użytkownika dla błędów klasy Slack, które wymagają pulpitu Linux, awaryjnego dostępu przez VNC, Slack Web, rzeczywistego Gateway OpenClaw, zrzutów ekranu, nagrań wideo i komentarza z dowodami w PR. Używaj jej, gdy testy jednostkowe lub bezgłowa ścieżka testów Slack na żywo nie mogą potwierdzić błędu.

Model przechowywania

Mantis używa trzech warstw przechowywania:

• Obraz dostawcy — należy do Crabbox i jest przechowywany na koncie dostawcy chmury. Zawiera możliwości maszyny (Chrome/Chromium, ffmpeg, scrot, Node/corepack/pnpm, natywne narzędzia kompilacyjne) oraz puste katalogi pamięci podręcznej.
• Stan rozgrzanej dzierżawy — należy do bieżącej sesji operatora. Może zawierać zalogowany profil przeglądarki, /var/cache/crabbox/pnpm oraz przygotowaną kopię roboczą kodu źródłowego przez czas trwania dzierżawy.
• Artefakty Mantis — należą do uruchomienia OpenClaw. Znajdują się w .artifacts/qa-e2e/mantis/...; GitHub Actions je przesyła, a aplikacja Mantis GitHub App dodaje komentarz z dowodami bezpośrednio w PR.

Nigdy nie umieszczaj sekretów, plików cookie przeglądarki, stanu logowania do Slack, kopii roboczych repozytorium, node_modules ani dist/ w obrazie dostawcy.

Uruchamianie przez GitHub

Uruchom przepływ pracy z 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 podlega ograniczeniom, ponieważ przepływ pracy używa rzeczywistych danych uwierzytelniających: musi wskazywać element w historii bieżącej gałęzi main, tag wydania lub głowę otwartego PR w openclaw/openclaw.

Przepływ pracy generuje:

• przesłany artefakt mantis-slack-desktop-smoke-<run-id>-<attempt>
• komentarz bezpośrednio w PR od aplikacji Mantis GitHub App
• 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
• zdalne dzienniki: slack-desktop-command.log, openclaw-gateway.log, chrome.log, ffmpeg.log

Komentarz w PR jest aktualizowany w miejscu za pomocą ukrytego znacznika <!-- mantis-slack-desktop-smoke -->.

Lokalne CLI

Weryfikacja kodu źródłowego na zimno:

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

Zachowaj maszynę wirtualną do awaryjnego dostępu przez VNC:

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

Otwórz VNC:

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

Użyj ponownie rozgrzanej dzierżawy:

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

Używaj --hydrate-mode prehydrated tylko wtedy, gdy ponownie używany zdalny obszar roboczy ma już node_modules i skompilowany katalog dist/; w przeciwnym razie Mantis bezpiecznie przerywa działanie.

Potwierdź natywny interfejs zatwierdzania Slack:

pnpm openclaw qa mantis slack-desktop-smoke \  --provider aws \  --class standard \  --approval-checkpoints \  --credential-source convex \  --credential-role maintainer \  --hydrate-mode source

--approval-checkpoints i --gateway-setup wzajemnie się wykluczają. Ta opcja uruchamia dobrowolnie włączane scenariusze slack-approval-exec-native i slack-approval-plugin-native, chyba że przekażesz jawny scenariusz punktu kontrolnego zatwierdzania przez --scenario; pozostałe scenariusze Slack są odrzucane przed uruchomieniem maszyny wirtualnej. Program uruchamiający QA Slack zapisuje każdy plik JSON punktu kontrolnego na podstawie rzeczywistej wiadomości API Slack, którą zaobserwował, a następnie zdalny proces monitorujący renderuje tę wiadomość do approval-checkpoints/<scenario>-pending.png i approval-checkpoints/<scenario>-resolved.png. Uruchomienie kończy się niepowodzeniem, jeśli brakuje któregokolwiek pliku JSON punktu kontrolnego, dowodu wiadomości, pliku JSON potwierdzenia odbioru lub wyrenderowanego zrzutu ekranu albo jeśli którykolwiek z nich jest pusty.

Zimne dzierżawy GitHub Actions nie mają plików cookie Slack Web, więc przechwytywanie obrazu z przeglądarki może zakończyć się na ekranie logowania Slack. Przy weryfikacji punktów kontrolnych zatwierdzania należy polegać na wyrenderowanych obrazach punktów kontrolnych i artefaktach QA Slack, a nie na slack-desktop-smoke.png. Zachowanej rozgrzanej dzierżawy z ręcznie zalogowanym profilem Slack Web używaj tylko wtedy, gdy sam zrzut ekranu przeglądarki musi przedstawiać Slack Web.

Tryby przygotowania

GitHub Actions zawsze przygotowuje kopię roboczą kandydata przed uruchomieniem maszyny wirtualnej. Magazyn pnpm jest buforowany według systemu operacyjnego, wersji Node i pliku blokady. Uruchomienie maszyny wirtualnej w trybie source również używa ponownie /var/cache/crabbox/pnpm, jeśli jest dostępny.

Interpretacja czasów

mantis-slack-desktop-smoke-report.md zawiera czasy poszczególnych faz:

• crabbox.warmup — uruchomienie u dostawcy chmury, gotowość pulpitu/przeglądarki, SSH.
• crabbox.inspect — pobranie metadanych dzierżawy.
• credentials.prepare — pozyskanie dzierżawy danych uwierzytelniających Convex.
• crabbox.remote_run — synchronizacja, uruchomienie przeglądarki, instalacja/kompilacja OpenClaw lub weryfikacja przygotowania, uruchomienie Gateway, wykonanie zrzutu ekranu i nagranie wideo.
• artifacts.copy — synchronizacja zwrotna przez rsync z maszyny wirtualnej.

crabbox.remote_run może mieć stan accepted, gdy Crabbox zwróci niezerowy zdalny kod stanu, ale Mantis skopiuje metadane potwierdzające, że konfiguracja Gateway OpenClaw została ukończona albo samo polecenie QA Slack zakończyło się pomyślnie. Traktuj accepted jako powodzenie z wyjaśnieniem, a nie jako nieudany scenariusz.

Jeśli uruchomienie trwa długo:

• Dominuje rozgrzewanie: przygotuj wcześniej lub wypromuj lepszy obraz dostawcy Crabbox.
• remote_run dominuje w trybie source: użyj rozgrzanej dzierżawy, popraw ponowne użycie magazynu pnpm lub przenieś wymagania wstępne maszyny do obrazu dostawcy.
• remote_run dominuje w trybie prehydrated: zdalny obszar roboczy nie był faktycznie gotowy albo konfiguracja Gateway/przeglądarki/Slack jest powolna.
• Dominuje kopiowanie artefaktów: sprawdź rozmiar nagrania i zawartość katalogu artefaktów.

Lista kontrolna dowodów

Dobry komentarz w PR zawiera:

• identyfikator scenariusza i SHA kandydata
• adres URL uruchomienia GitHub Actions i adres URL artefaktu
• osadzony zrzut ekranu punktu kontrolnego zatwierdzania albo zrzut ekranu Slack Web z zalogowanej rozgrzanej dzierżawy
• osadzony animowany podgląd, jeśli jest dostępny
• odnośniki do pełnego i przyciętego pliku MP4
• stan powodzenia/niepowodzenia oraz podsumowanie czasów z raportu

Nie zatwierdzaj zrzutów ekranu ani nagrań wideo w repozytorium. Przechowuj je w artefaktach GitHub Actions lub komentarzu w PR.

Obsługa niepowodzeń

Jeśli przepływ pracy zakończy się niepowodzeniem przed uruchomieniem maszyny wirtualnej, najpierw sprawdź zadanie Actions. Typowe przyczyny: niezaufany candidate_ref, brak sekretów środowiska lub niepowodzenie instalacji/kompilacji kandydata.

Jeśli uruchomienie maszyny wirtualnej zakończy się niepowodzeniem, ale zrzuty ekranu zostały skopiowane z powrotem, sprawdź:

cat mantis-slack-desktop-smoke-report.mdcat mantis-slack-desktop-smoke-summary.jsoncat slack-desktop-command.logcat openclaw-gateway.logcat chrome.logcat ffmpeg.log

Jeśli uruchomienie zachowało dzierżawę, otwórz VNC za pomocą polecenia crabbox vnc ... z raportu, a po zakończeniu zatrzymaj dzierżawę:

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

Jeśli logowanie do Slack wygasło, napraw je przez VNC w zachowanej dzierżawie i uruchom ponownie z --lease-id. Nie umieszczaj tego profilu przeglądarki w obrazie dostawcy.

Powiązane

• Przegląd QA
• Kanał Slack
• Testowanie