دليل تشغيل Mantis Slack لسطح المكتب

مسار QA لسطح مكتب Mantis Slack هو مسار الواجهة الحقيقية للأخطاء من فئة 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 ويعلّق Mantis GitHub App أدلة مضمّنة على 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 المسموح بها ضيقة عمدًا لأن سير العمل يستخدم بيانات اعتماد حية: نسب main الحالي، أو وسوم الإصدار، أو رأس PR مفتوح من openclaw/openclaw.

يكتب سير العمل:

• الأثر المرفوع: mantis-slack-desktop-smoke-<run-id>-<attempt>;
• تعليق PR مضمّن من 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;
• سجلات بعيدة مثل 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

استخدم --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

وضع نقطة تحقق الموافقة متنافي التفعيل مع --gateway-setup. يشغّل سيناريوهي الاشتراك slack-approval-exec-native وslack-approval-plugin-native ما لم تمرّر أعلام --scenario صريحة لنقطة تحقق الموافقة؛ تُرفض سيناريوهات Slack الأخرى قبل بدء VM. يكتب مشغّل Slack QA كل ملف JSON لنقطة تحقق من رسالة Slack API الحقيقية التي رصدها، ثم يعرض المراقب البعيد لقطة الرسالة تلك في approval-checkpoints/<scenario>-pending.png و approval-checkpoints/<scenario>-resolved.png. تفشل عملية التشغيل إذا كان أي JSON لنقطة تحقق، أو دليل رسالة، أو JSON إقرار، أو لقطة شاشة معروضة مفقودًا أو فارغًا.

لا تحتوي تأجيرات GitHub Actions الباردة على ملفات تعريف ارتباط Slack Web، لذلك يمكن أن ينتهي التقاط المتصفح عند تسجيل دخول Slack. لإثبات نقطة تحقق الموافقة، ثق بصور نقاط التحقق المعروضة وآثار Slack QA بدلًا من slack-desktop-smoke.png. استخدم تأجيرًا دافئًا محفوظًا مع ملف تعريف Slack Web مسجّل الدخول يدويًا فقط عندما يجب أن تُظهر لقطة شاشة المتصفح نفسها Slack Web.

أوضاع التهيئة

تُعد GitHub Actions دائمًا نسخة المرشح قبل تشغيل VM. ويُخزَّن مخزن pnpm مؤقتًا حسب OS، وإصدار Node، وملف القفل. يستخدم تشغيل مصدر VM أيضًا /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: النسخ عائدًا من VM عبر rsync.

يمكن وسم crabbox.remote_run بأنه accepted عندما يعيد Crabbox حالة بعيدة غير صفرية بعد أن يكون Mantis قد نسخ بيانات تعريف تثبت أن إعداد OpenClaw Gateway قد اكتمل أو أن أمر Slack QA نفسه خرج بنجاح. تعامل مع accepted على أنه نجاح مع تفسير، وليس سيناريو فاشلًا.

إذا كان التشغيل بطيئًا:

• يهيمن warmup: اخبز مسبقًا أو رقِّ صورة مزوّد Crabbox أفضل؛
• يهيمن remote_run في source: استخدم تأجيرًا دافئًا، أو حسّن إعادة استخدام مخزن pnpm، أو انقل متطلبات الجهاز المسبقة إلى صورة المزوّد؛
• يهيمن remote_run في prehydrated: لم تكن مساحة العمل البعيدة جاهزة فعليًا، أو أن إعداد Gateway/المتصفح/Slack بطيء؛
• يهيمن نسخ الآثار: افحص حجم الفيديو ومحتويات دليل الآثار.

قائمة تحقق الأدلة

يجب أن يُظهر تعليق PR الجيد:

• معرّف السيناريو وSHA المرشح؛
• عنوان URL لتشغيل GitHub Actions؛
• عنوان URL للأثر؛
• لقطة شاشة مضمنة لنقطة تحقق الموافقة، أو لقطة شاشة Slack Web من تأجير دافئ مسجّل الدخول؛
• معاينة متحركة مضمنة عند توفرها؛
• روابط MP4 الكامل وMP4 المقتطع؛
• حالة النجاح/الفشل؛
• ملخص التوقيت في التقرير المرفق.

لا تودع لقطات الشاشة أو مقاطع الفيديو في المستودع. أبقها في آثار GitHub Actions أو تعليق PR.

التعامل مع الفشل

إذا فشل سير العمل قبل تشغيل VM، فافحص مهمة Actions أولًا. الأسباب الشائعة هي 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

إذا أبقت عملية التشغيل التأجير، فافتح VNC باستخدام أمر crabbox vnc ... الموجود في التقرير. أوقف التأجير عند الانتهاء:

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

إذا انتهت صلاحية تسجيل دخول Slack، فأصلحه في VNC على تأجير محفوظ وأعد التشغيل باستخدام --lease-id. لا تخبز ملف تعريف المتصفح ذلك داخل صورة مزوّد.

ذات صلة

• نظرة عامة على QA
• قناة Slack
• الاختبار