Mantis Slack masaüstü çalışma kılavuzu

Mantis Slack masaüstü QA, Linux masaüstü, VNC ile kurtarma, Slack Web, gerçek bir OpenClaw gateway'i, ekran görüntüleri, videolar ve PR kanıt yorumu gerektiren Slack sınıfı hatalar için gerçek kullanıcı arayüzü hattıdır. Birim testleri veya başsız Slack canlı hattı hatayı kanıtlayamadığında bunu kullanın.

Depolama modeli

Mantis üç depolama katmanı kullanır:

• Sağlayıcı imajı - Crabbox'a aittir ve bulut sağlayıcısı hesabında depolanır. Makine yeteneklerini (Chrome/Chromium, ffmpeg, scrot, Node/corepack/pnpm, yerel derleme araçları) ve boş önbellek dizinlerini içerir.
• Sıcak kiralama durumu - geçerli operatör oturumuna aittir. Kiralama etkin olduğu sürece oturum açılmış bir tarayıcı profilini, /var/cache/crabbox/pnpm dizinini ve hazırlanmış bir kaynak deposu çalışma kopyasını barındırabilir.
• Mantis yapıtları - OpenClaw çalıştırmasına aittir. .artifacts/qa-e2e/mantis/... altında bulunur; GitHub Actions bunları yükler ve Mantis GitHub App, PR'a satır içi kanıt yorumu ekler.

Gizli bilgileri, tarayıcı çerezlerini, Slack oturum açma durumunu, depo çalışma kopyalarını, node_modules veya dist/ dizinlerini hiçbir zaman sağlayıcı imajına gömmeyin.

GitHub tetikleme

İş akışını main üzerinden çalıştırın:

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

İş akışı canlı kimlik bilgileri kullandığından candidate_ref kısıtlanmıştır: geçerli main geçmişine, bir sürüm etiketine veya openclaw/openclaw içindeki açık bir PR'ın başına çözümlenmelidir.

İş akışı şunları üretir:

• yüklenen mantis-slack-desktop-smoke-<run-id>-<attempt> yapıtı
• Mantis GitHub App tarafından eklenen satır içi PR yorumu
• 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
• uzak günlükler: slack-desktop-command.log, openclaw-gateway.log, chrome.log, ffmpeg.log

PR yorumu, gizli <!-- mantis-slack-desktop-smoke --> işaretçisi aracılığıyla yerinde güncellenir.

Yerel CLI

Soğuk kaynak kanıtı:

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

VNC ile kurtarma için sanal makineyi koruyun:

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

VNC'yi açın:

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

Sıcak bir kiralamayı yeniden kullanın:

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

--hydrate-mode prehydrated seçeneğini yalnızca yeniden kullanılan uzak çalışma alanında zaten node_modules ve derlenmiş bir dist/ bulunduğunda kullanın; aksi takdirde Mantis güvenli biçimde başarısız olur.

Yerel Slack onay kullanıcı arayüzünü kanıtlayın:

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

--approval-checkpoints ile --gateway-setup birlikte kullanılamaz. Açık bir onay denetim noktası --scenario değeri vermediğiniz sürece isteğe bağlı slack-approval-exec-native ve slack-approval-plugin-native senaryolarını çalıştırır; diğer Slack senaryoları sanal makine başlamadan önce reddedilir. Slack QA çalıştırıcısı, gözlemlediği gerçek Slack API mesajından her denetim noktası JSON dosyasını yazar; ardından uzak izleyici bu mesajı approval-checkpoints/<scenario>-pending.png ve approval-checkpoints/<scenario>-resolved.png dosyalarına işler. Herhangi bir denetim noktası JSON'u, mesaj kanıtı, alındı JSON'u veya işlenmiş ekran görüntüsü eksik ya da boşsa çalıştırma başarısız olur.

Soğuk GitHub Actions kiralamalarında Slack Web çerezleri bulunmadığından tarayıcı yakalaması Slack oturum açma ekranına ulaşabilir. Onay denetim noktası kanıtı için slack-desktop-smoke.png yerine işlenmiş denetim noktası görüntülerine ve Slack QA yapıtlarına güvenin. Tarayıcı ekran görüntüsünün bizzat Slack Web'i göstermesi gerektiğinde yalnızca Slack Web profilinde elle oturum açılmış ve korunan sıcak bir kiralama kullanın.

Hazırlama modları

GitHub Actions, sanal makine çalıştırmasından önce aday çalışma kopyasını her zaman hazırlar. pnpm deposu işletim sistemine, Node sürümüne ve kilit dosyasına göre önbelleğe alınır. Sanal makinedeki source çalıştırması da mevcut olduğunda /var/cache/crabbox/pnpm dizinini yeniden kullanır.

Zamanlama yorumu

mantis-slack-desktop-smoke-report.md aşama sürelerini içerir:

• crabbox.warmup - bulut sağlayıcısının başlatılması, masaüstü/tarayıcı hazırlığı, SSH.
• crabbox.inspect - kiralama meta verisi sorgulaması.
• credentials.prepare - Convex kimlik bilgisi kiralamasının edinilmesi.
• crabbox.remote_run - eşitleme, tarayıcının başlatılması, OpenClaw kurulumu/derlemesi veya hazırlama doğrulaması, gateway'in başlatılması, ekran görüntüsü ve video yakalama.
• artifacts.copy - sanal makineden rsync ile geri kopyalama.

Crabbox sıfır olmayan bir uzak durum döndürdüğünde ancak Mantis, OpenClaw gateway kurulumunun tamamlandığını veya Slack QA komutunun başarıyla çıktığını kanıtlayan meta verileri kopyaladığında crabbox.remote_run, accepted gösterebilir. accepted durumunu başarısız bir senaryo olarak değil, açıklamalı geçiş olarak değerlendirin.

Bir çalıştırma yavaşsa:

• Hazırlık baskınsa: daha iyi bir Crabbox sağlayıcı imajını önceden oluşturun veya yükseltin.
• source modunda remote_run baskınsa: sıcak bir kiralama kullanın, pnpm deposunun yeniden kullanımını iyileştirin veya makine ön koşullarını sağlayıcı imajına taşıyın.
• prehydrated modunda remote_run baskınsa: uzak çalışma alanı gerçekte hazır değildir ya da gateway/tarayıcı/Slack kurulumu yavaştır.
• Yapıt kopyalama baskınsa: video boyutunu ve yapıt dizininin içeriğini inceleyin.

Kanıt denetim listesi

İyi bir PR yorumu şunları gösterir:

• senaryo kimliği ve aday SHA
• GitHub Actions çalıştırma URL'si ve yapıt URL'si
• satır içi onay denetim noktası ekran görüntüsü veya oturum açılmış sıcak kiralamadan alınan bir Slack Web ekran görüntüsü
• varsa satır içi animasyonlu önizleme
• tam MP4 ve kırpılmış MP4 bağlantıları
• başarılı/başarısız durumu ve raporun zamanlama özeti

Ekran görüntülerini veya videoları depoya işlemeyin. Bunları GitHub Actions yapıtlarında veya PR yorumunda tutun.

Hata işleme

İş akışı sanal makine çalıştırmasından önce başarısız olursa önce Actions işini inceleyin. Yaygın nedenler: güvenilmeyen candidate_ref, eksik ortam gizli bilgileri veya adayın kurulum/derleme hatası.

Sanal makine çalıştırması başarısız olur ancak ekran görüntüleri geri kopyalanırsa şunları inceleyin:

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

Çalıştırma kiralamayı koruduysa rapordaki crabbox vnc ... komutuyla VNC'yi açın, ardından işiniz bittiğinde kiralamayı durdurun:

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

Slack oturumu sona erdiyse korunan bir kiralamada VNC üzerinden düzeltin ve --lease-id ile yeniden çalıştırın. Bu tarayıcı profilini sağlayıcı imajına gömmeyin.

İlgili

• QA genel bakışı
• Slack kanalı
• Test etme