راهنمای عملیاتی دسکتاپ Slack برای Mantis

QA دسکتاپ Slack در Mantis مسیر رابط کاربری واقعی برای باگ‌های رده Slack است که به دسکتاپ Linux، بازیابی از طریق VNC، Slack Web، یک Gateway واقعی OpenClaw، اسکرین‌شات، ویدیو و نظر شواهد در PR نیاز دارند. زمانی از آن استفاده کنید که آزمون‌های واحد یا مسیر زنده بدون رابط گرافیکی Slack نتوانند باگ را اثبات کنند.

مدل ذخیره‌سازی

Mantis از سه لایه ذخیره‌سازی استفاده می‌کند:

• تصویر ارائه‌دهنده - متعلق به Crabbox و ذخیره‌شده در حساب ارائه‌دهنده ابری است. قابلیت‌های ماشین (Chrome/Chromium، ffmpeg، scrot، Node/corepack/pnpm، ابزارهای بومی ساخت) و دایرکتوری‌های خالی کش را نگه می‌دارد.
• وضعیت اجاره گرم - متعلق به نشست اپراتور فعلی است. تا زمانی که اجاره فعال است، می‌تواند نمایه مرورگر واردشده، /var/cache/crabbox/pnpm و یک وارسی منبع آماده‌شده را نگه دارد.
• مصنوعات Mantis - متعلق به اجرای OpenClaw هستند. در .artifacts/qa-e2e/mantis/... قرار می‌گیرند؛ GitHub Actions آن‌ها را بارگذاری می‌کند و GitHub App متعلق به Mantis شواهد درون‌خطی را در PR نظر می‌دهد.

هرگز اسرار، کوکی‌های مرورگر، وضعیت ورود Slack، وارسی‌های مخزن، 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 محدود شده است، زیرا گردش‌کار از اعتبارنامه‌های زنده استفاده می‌کند: باید به ancestry فعلی main، یک برچسب انتشار، یا سرِ یک PR باز در openclaw/openclaw تفکیک شود.

گردش‌کار موارد زیر را تولید می‌کند:

• مصنوع بارگذاری‌شده mantis-slack-desktop-smoke-<run-id>-<attempt>
• نظر درون‌خطی PR از GitHub App متعلق به Mantis
• 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

ماشین مجازی را برای بازیابی از طریق 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

تنها زمانی از --hydrate-mode prehydrated استفاده کنید که فضای کاری راه دورِ استفاده‌شده از قبل دارای node_modules و یک dist/ ساخته‌شده باشد؛ در غیر این صورت Mantis به‌صورت بسته و ایمن شکست می‌خورد.

رابط کاربری بومی تأیید 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 با --gateway-setup ناسازگار و متقابلاً انحصاری است. این گزینه سناریوهای اختیاری slack-approval-exec-native و slack-approval-plugin-native را اجرا می‌کند، مگر اینکه یک --scenario صریح برای نقطه وارسی تأیید ارسال کنید؛ سایر سناریوهای Slack پیش از شروع ماشین مجازی رد می‌شوند. اجراکننده QA در Slack هر فایل JSON نقطه وارسی را از پیام واقعی API در Slack که مشاهده کرده است می‌نویسد، سپس ناظر راه دور آن پیام را در approval-checkpoints/<scenario>-pending.png و approval-checkpoints/<scenario>-resolved.png رندر می‌کند. اگر هر فایل JSON نقطه وارسی، شواهد پیام، JSON تأیید دریافت یا اسکرین‌شات رندرشده وجود نداشته یا خالی باشد، اجرا شکست می‌خورد.

اجاره‌های سرد GitHub Actions کوکی‌های Slack Web را ندارند، بنابراین ثبت مرورگر آن‌ها ممکن است به صفحه ورود Slack برسد. برای اثبات نقطه وارسی تأیید، به‌جای slack-desktop-smoke.png به تصاویر رندرشده نقطه وارسی و مصنوعات QA در Slack اعتماد کنید. تنها زمانی از یک اجاره گرمِ نگه‌داشته‌شده با نمایه Slack Web که به‌صورت دستی وارد شده است استفاده کنید که خود اسکرین‌شات مرورگر باید Slack Web را نشان دهد.

حالت‌های آماده‌سازی

GitHub Actions همیشه وارسی نامزد را پیش از اجرای ماشین مجازی آماده می‌کند. مخزن pnpm آن بر اساس سیستم‌عامل، نسخه Node و فایل قفل کش می‌شود. اجرای source در ماشین مجازی نیز در صورت وجود، از /var/cache/crabbox/pnpm دوباره استفاده می‌کند.

تفسیر زمان‌بندی

mantis-slack-desktop-smoke-report.md شامل زمان‌بندی مرحله‌ها است:

• crabbox.warmup - راه‌اندازی ارائه‌دهنده ابری، آماده‌بودن دسکتاپ/مرورگر و SSH.
• crabbox.inspect - جست‌وجوی فراداده اجاره.
• credentials.prepare - دریافت اجاره اعتبارنامه Convex.
• crabbox.remote_run - همگام‌سازی، راه‌اندازی مرورگر، نصب/ساخت OpenClaw یا اعتبارسنجی آماده‌سازی، راه‌اندازی Gateway، ثبت اسکرین‌شات و ویدیو.
• artifacts.copy - بازگرداندن با rsync از ماشین مجازی.

وقتی Crabbox یک وضعیت راه دور غیرصفر برمی‌گرداند اما Mantis فراداده‌ای را کپی کرده است که ثابت می‌کند یا راه‌اندازی Gateway متعلق به OpenClaw تکمیل شده یا خود فرمان QA در Slack با موفقیت خارج شده است، crabbox.remote_run می‌تواند accepted را نشان دهد. با accepted به‌عنوان قبولی همراه با توضیح برخورد کنید، نه یک سناریوی شکست‌خورده.

اگر اجرا کند است:

• زمان گرم‌سازی غالب است: یک تصویر بهتر از ارائه‌دهنده Crabbox را از پیش بسازید یا ارتقا دهید.
• remote_run در source غالب است: از یک اجاره گرم استفاده کنید، استفاده مجدد از مخزن pnpm را بهبود دهید، یا پیش‌نیازهای ماشین را به تصویر ارائه‌دهنده منتقل کنید.
• remote_run در prehydrated غالب است: فضای کاری راه دور واقعاً آماده نبوده، یا راه‌اندازی Gateway/مرورگر/Slack کند است.
• کپی مصنوعات غالب است: اندازه ویدیو و محتوای دایرکتوری مصنوعات را بررسی کنید.

فهرست بررسی شواهد

یک نظر PR مناسب موارد زیر را نشان می‌دهد:

• شناسه سناریو و SHA نامزد
• نشانی اینترنتی اجرای GitHub Actions و نشانی اینترنتی مصنوع
• اسکرین‌شات درون‌خطی نقطه وارسی تأیید، یا اسکرین‌شات Slack Web از یک اجاره گرم واردشده
• پیش‌نمایش متحرک درون‌خطی، در صورت وجود
• پیوندهای MP4 کامل و MP4 برش‌خورده
• وضعیت قبولی/شکست و خلاصه زمان‌بندی گزارش

اسکرین‌شات‌ها یا ویدیوها را در مخزن ثبت نکنید. آن‌ها را در مصنوعات GitHub Actions یا نظر PR نگه دارید.

مدیریت شکست

اگر گردش‌کار پیش از اجرای ماشین مجازی شکست خورد، ابتدا کار GitHub Actions را بررسی کنید. علت‌های معمول: candidate_ref نامطمئن، اسرار محیطی مفقود، یا شکست نصب/ساخت نامزد.

اگر اجرای ماشین مجازی شکست خورد اما اسکرین‌شات‌ها بازگردانده شدند، موارد زیر را بررسی کنید:

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

اگر اجرا اجاره را نگه داشت، VNC را با فرمان crabbox vnc ... موجود در گزارش باز کنید، سپس پس از پایان کار اجاره را متوقف کنید:

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

اگر ورود Slack منقضی شده است، آن را در VNC روی یک اجاره نگه‌داشته‌شده ترمیم کنید و با --lease-id دوباره اجرا کنید. آن نمایه مرورگر را در تصویر ارائه‌دهنده نگنجانید.

مرتبط

• نمای کلی QA
• کانال Slack
• آزمون