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

مسار ضمان الجودة لسطح مكتب Slack في Mantis هو مسار واجهة المستخدم الفعلية للأخطاء من فئة Slack التي تتطلب سطح مكتب Linux، واستعادة عبر VNC، وSlack Web، وGateway حقيقيًا لـ OpenClaw، ولقطات شاشة، ومقاطع فيديو، وتعليق أدلة على طلب السحب. استخدمه عندما لا تتمكن اختبارات الوحدات أو مسار Slack المباشر دون واجهة رسومية من إثبات الخطأ.

نموذج التخزين

يستخدم Mantis ثلاث طبقات تخزين:

• صورة المزوّد - مملوكة لـ Crabbox ومخزّنة في حساب المزوّد السحابي. تحتوي على إمكانات الجهاز (Chrome/Chromium، وffmpeg، وscrot، وNode/corepack/pnpm، وأدوات البناء الأصلية) وأدلة ذاكرة تخزين مؤقت فارغة.
• حالة مدة الاستخدام الدافئة - مملوكة لجلسة المشغّل الحالية. يمكن أن تحتوي على ملف تعريف متصفح مسجّل الدخول، و/var/cache/crabbox/pnpm، ونسخة عمل مصدرية مُعَدّة ما دامت مدة الاستخدام نشطة.
• عناصر Mantis الأثرية - مملوكة لتشغيل OpenClaw. توجد ضمن .artifacts/qa-e2e/mantis/...؛ ترفعها GitHub Actions ويعلّق تطبيق Mantis على GitHub بأدلة مضمّنة في طلب السحب.

لا تضمّن مطلقًا الأسرار، أو ملفات تعريف ارتباط المتصفح، أو حالة تسجيل الدخول إلى 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 الحالي، أو وسم إصدار، أو رأس طلب سحب مفتوح في openclaw/openclaw.

ينتج سير العمل:

• العنصر الأثري المرفوع mantis-slack-desktop-smoke-<run-id>-<attempt>
• تعليقًا مضمّنًا في طلب السحب من تطبيق Mantis على GitHub
• 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

يُحدَّث تعليق طلب السحب في موضعه عبر العلامة المخفية <!-- 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 الأخرى قبل بدء الآلة الافتراضية. يكتب مشغّل ضمان الجودة في Slack كل ملف JSON لنقطة تحقق استنادًا إلى رسالة Slack API الفعلية التي رصدها، ثم يعرض المراقب البعيد تلك الرسالة في approval-checkpoints/<scenario>-pending.png و approval-checkpoints/<scenario>-resolved.png. يفشل التشغيل إذا كان أي ملف JSON لنقطة تحقق، أو دليل رسالة، أو ملف JSON للإقرار، أو لقطة شاشة معروضة مفقودًا أو فارغًا.

لا تحتوي مدد الاستخدام الباردة في GitHub Actions على ملفات تعريف ارتباط Slack Web، لذلك قد ينتهي التقاط المتصفح عند شاشة تسجيل الدخول إلى Slack. لإثبات نقاط تحقق الموافقة، اعتمد على صور نقاط التحقق المعروضة وعناصر ضمان الجودة في Slack بدلًا من slack-desktop-smoke.png. لا تستخدم مدة استخدام دافئة مُبقاة مع ملف تعريف 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.remote_run الحالة accepted عندما يعيد Crabbox حالة بعيدة غير صفرية، لكن Mantis نسخ بيانات وصفية تثبت إما اكتمال إعداد Gateway في OpenClaw أو خروج أمر ضمان الجودة في Slack نفسه بنجاح. تعامل مع accepted على أنه نجاح مصحوب بتفسير، لا سيناريو فاشلًا.

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

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

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

يعرض تعليق طلب السحب الجيد:

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

لا تُضمّن لقطات الشاشة أو مقاطع الفيديو في المستودع. احتفظ بها ضمن عناصر GitHub Actions الأثرية أو تعليق طلب السحب.

معالجة الإخفاقات

إذا فشل سير العمل قبل تشغيل الآلة الافتراضية، فافحص مهمة 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. لا تضمّن ملف تعريف المتصفح هذا في صورة مزوّد.

ذو صلة

• نظرة عامة على ضمان الجودة
• قناة Slack
• الاختبار