بنِ وشغّل فيلق مستقل لاختبار الاختراق باستعمال sapper-v2

شنو هو sapper-v2؟

sapper-v2 هو نظام ذاتي متعدد الوكلاء، مصمّم لـاختبارات الاختراق المصرّح بها. عوض الاعتماد على وكيل واحد كيولي معقّد أكثر فأكثر، كينظّم النظام عدة ديال الذكاءات الاصطناعية ففيلق كيقسم الخدمة، كيتبادل الاكتشافات، وكيحافظ على المعرفة ملي كيتبدلو الوكلاء.

المشروع ربح الإقصائيات عبر الإنترنت ديال الدورة الثالثة من Tencent Cloud Intelligent Attack-Defense Challenge، وحصل على الجائزة الأولى فـ GeekCon 2026 AI Challenge. ففعالية Tencent، كمّل تشغيل بلا مراقبة دام ثمان ساعات بنتيجة 80.18، ولقى 85 flag باستعمال حوالي مليار token.

استعمل sapper-v2 غير فالأنظمة اللي كتملكها أو عندك إذن صريح باش تختبرها. راجع DISCLAIMER.md قبل التثبيت أو التشغيل.

كيفاش كيخدم النظام

المشروع مبني على ثلاث قدرات أساسية:

• الإنشاء: النظام كيفتح جلسات AI جديدة فـ tmux، وكيقدر ينشئ عمّال متخصصين حسب الحاجة.
• اللغة: الوكلاء كيتواصلو بإدخال الرسائل فجلسات الإدخال ديال بعضياتهم.
• السجل: الاكتشافات كتتخزّن فـرسم بياني طبقي ديال الحقائق والنوايا، وما كتبقاش غير داخل سياق وكيل واحد.

نظام السجل فيه ثلاث طبقات: العنوان، الملخص، ووثيقة الأدلة. الوكلاء يقدرو يقراو العنوان المختصر أولا، ويفتحو الملخص ملي يحتاجو سياق أكثر، ويدخلو للأدلة من أجل التحقق بالتفصيل. هاد التصميم كيقلل استهلاك السياق وكيحد من الضرر اللي يقدر يسببو واقع غير دقيق.

الأدوار أثناء التشغيل

أثناء التشغيل، sapper-v2 كيفصل بين التنسيق والتنفيذ والاستمرارية:

• القائد: كيقرا اللوحة، كيقيّم الأهداف، وكيقسم الخدمة. ما كينفذش الهجمات بنفسو.
• الجنرالات: كيتكلفو بالهجمات الصعيبة وقدرو يجندو الفرق ديالهم.
• الكشافة: كيديرو استطلاع قصير وكيساعدو يحددو واش الهدف محتاج تنفيذ جماعي ولا بحث أعمق.
• الجنود: كيخدمو بالتوازي على المهام المعيّنة ليهم.
• مسؤول الإشارات: كيجمع وكيقدّم الـ flags اللي مازال ما تبلّغوش من بلاصة وحدة؛ وهو دور بان أثناء التشغيل وما كانش مبرمج من قبل.
• المراقب: سكريبت بلا استراتيجية كيخلي النظام خدام بإعادة تشغيل القائد اللي طاح باستعمال --continue، وتبديل المفاتيح، وتدبير ختام التشغيل.

الـ README كيصف ثلاث نوافذ ظاهرة أثناء التشغيل: القائد، وفيلق الذكاء الاصطناعي اللي خدام فلوحات tmux، والمراقب.

الميزات الرئيسية

• تقسيم العمل بالتوازي: الكشافة والجنود والجنرالات والقائد كيخدمو بمسؤوليات مختلفة.
• ذاكرة تنظيمية دائمة: المعرفة كتبقى موجودة ملي كيتبدل وكيل معيّن.
• تدوير السياق: الوكلاء اللي كيتشبع السياق ديالهم يقدرو يخليو دروس مكتوبة للخلفاء ديالهم.
• تدرّج النماذج: إعدادات المسابقة استعملات GLM-5.3 للقائد والجنرالات، وDeepSeek V4.1 Flash للكشافة والجنود.
• المرونة التشغيلية: المراقب يقدر يعاود يشغل القائد، ويبدل المفاتيح، ويحافظ على الاستمرارية بلا ما ياخذ قرارات استراتيجية.
• نقل الخبرة بين التحديات: القائد يقدر يعرّف عائلات التحديات المتشابهة بنيويا ويدوز أساليب النجاح للوكلاء المعيّنين حديثا.
• واجهة CLI ديال الحقائق والنوايا: المشروع كيوفر أوامر وإرشادات لتشغيل الرسم البياني وتنفيذ عمليات على تحديات متعددة.

ثبّت sapper CLI

المثبّت السريع كيربط واجهة sapper فبلاصتها. حسب الـ README، الواجهة كتستعمل غير المكتبة القياسية وما عندها حتى تبعية إضافية.

من جذر المستودع، نفّذ:

bash install.sh

الـ README ما كيسرد حتى متطلبات محلية إضافية ولا خطوات تثبيت خاصة بالمنصة. إلا ما خلاش الأمر sapper متاح فـ shell ديالك، فتّش فـ install.sh وتأكد بلي الوجهة ديال الرابط الرمزي داخلة فالمسار ديال الملفات التنفيذية.

بدا تقييما مصرّحا به

أنشئ تقييما جديدا باستعمال sapper setup. المثال التالي مأخوذ من البداية السريعة ديال المشروع:

sapper setup --goal "assess http://target" --agents

بدّل http://target غير بعنوان طرفي داخل فالإذن المكتوب ديالك. خاص الهدف يوصف النطاق المسموح به بوضوح، باش يوصل للوكلاء كمهمة ما فيهاش الغموض.

الخيار --agents كيبدا سير العمل الموجّه بالوكلاء اللي كيعرضو المشروع. من بعد الإعداد، راجع اللوحة والحدّ الحالي:

sapper status

واجهة الحالة هي الأمر الرئيسي فالبداية السريعة باش تشوف كيفاش كتتقدم الخدمة. القائد كيستعمل اللوحة باش يقيّم الأهداف ويوزع المهام على المتخصصين، عوض ما ينفذ مهام التقييم مباشرة.

سير عمل أدنى عبر CLI

1. تحقق من الإذن: وثّق الهدف، والفترة الزمنية، والتقنيات المسموح بها، وشروط التوقف خارج الأداة.
2. ثبّت الواجهة: نفّذ bash install.sh من المستودع المستنسخ.
3. حدّد الهدف: نفّذ sapper setup --goal "assess http://target" --agents باستعمال هدف مصادق عليه.
4. راقب اللوحة: نفّذ sapper status باش تراجع اللوحة والحدّ الحالي.
5. راجع المعرفة المحتفظ بها: استعمل سير عمل الحقائق والنوايا الموثق فـ SKILL.md ملي تحتاج عمليات على رسم بياني واحد ولا جولات على تحديات متعددة.

شغّل الفيلق كامل باستعمال Docker

المستودع فيه Dockerfile ديال الـ legion الكاملة المبنية على commander. بنِ الصورة من جذر المستودع:

docker build -f docker/Dockerfile.commander -t sapper:latest .

قبل ما تشغّل الـ container، جهّز متغيّرات البيئة ديال model gateways وkey pool وbudget اللي موضّحة فـ docker/ENV.md. هاد الإعدادات مهمّة حيث المعمارية كتوزّع المسؤوليات على مستويات مختلفة ديال النماذج، وكتشمل تدوير المفاتيح والتشغيل مع مراعاة الميزانية.

الـ README كيقدّم تشغيل الـ container بشكل تخطيطي:

docker run -d --name sapper ... sapper:latest

علامة الحذف ماشي argument حرفي واجد للتشغيل. بدّلها بمتغيّرات البيئة المطلوبة وباقي خيارات Docker المذكورة فتوثيق البيئة ديال المستودع. ما تخمّنش credentials ديال الإنتاج، وما تحطّش الأسرار مباشرة فـ shell history إلا كان كاين أسلوب أكثر أماناً لتدبير الأسرار.

فهم عقيدة الـ commander

العقيدة التشغيلية ديال الـ commander مخزّنة فـ docker/commander/SKILL.md. الـ README كيسلّط الضوء على بزاف ديال المبادئ:

• الجدولة المتوازية، السهل أولاً: وزّع الخدمة بحيث الأهداف اللي يمكن حلّها بسهولة تتحلّ بالتوازي، بلا ما تفرض على الـ legion كاملة تدوز من مسار صعيب واحد.
• استغلال وقت عنق الزجاجة: قرب نهاية العملية، عاود راجع الأهداف اللي تحلّات جزئياً، حيث الأدلة الموجودة تقدر تعطي نتائج بسرعة.
• الانضباط ديال وقف الخسارة: تجنّب صرف وقت ولا tokens بلا حدود على خدمة ما كتجيبش تقدّم.
• فصل الأدوار: خلّي انتباه الـ commander مخصّص لقراية اللوحة، والحكم، والتوزيع، بدل التنفيذ المباشر.

باش تطّلع على العقد الرسمي ديال المعمارية، قرا docker/commander/SPEC.md. وباش تشوف مراجعة كتشرح كيفاش خدم النظام أثناء المنافسة، رجع لـ BATTLE-REPORT.md.

نصائح متقدمة للتشغيل

كتب أهداف كتناسب النطاق المسموح

هدف الإعداد هو المهمة اللي كيخدمو عليها الـ agents. حدّد الهدف المسموح بدقة، وتجنّب العبارات الواسعة اللي يمكن تتفهم كإذن لاستكشاف hosts ولا services ما عندهاش علاقة. وثائق التفويض الخارجية كتبقى هي المرجع الأساسي.

استعمل الأدلة على طبقات بدل الملخّصات الكبيرة

خلّي المعطيات العامة مختصرة، مع الاحتفاظ بالأدلة المفصّلة تحت منها. العنوان خاصو يوصّل الخلاصة، والملخّص يشرح علاش الموضوع مهم، ووثيقة الأدلة خاصها تدعم التحقّق. هاد الشي كيتبع تصميم sapper-v2 وكيجنّب إعادة تحميل كل التفاصيل فـ context ديال الـ agent.

حافظ على الدروس أثناء تدوير الـ agents

المشروع قاس تشبّع context ديال الجنود بحوالي 260,000 tokens أثناء الحملة ديالو. والحل كان هو تبديل worker مع ترك playbook للخلف. ملي كتراجع مخرجات العملية، فضّل ملاحظات تسليم واضحة فيها النتائج المتحقّق منها، والمقاربات اللي تجرّبات، والأسئلة اللي مازال ما تحلّاتش، والإجراءات القابلة لإعادة الاستعمال.

فرّق بين الاستراتيجية والتوفّر

الـ watchdog ما عندوش عن قصد حتى دور استراتيجي. خلّي سلوك الاسترجاع، وتدوير المفاتيح، وإعادة تشغيل العمليات منفصلين على القرارات المتعلقة بالأهداف والتكتيكات. بهاد الطريقة كيولي أسهل تعرف واش الإجراء جا من الـ commander ولا من أتمتة الحفاظ على التشغيل.

تحكّم فتكلفة الـ tokens والنماذج

معمارية المنافسة ديال sapper-v2 كانت كتخصّص النماذج الأقوى لاتخاذ القرارات على المستوى العالي، والنماذج الأخف للاستطلاع والتنفيذ بكميات كبيرة. إلا بغيتي تعاود نفس الإعداد الموثّق، حدّد gateways وkey pools وbudgets من خلال إرشادات بيئة Docker، وراقب الاستهلاك طول فترة التشغيل المسموح بها.

فتّش فالأدلة قبل ما تثق فالمعرفة المنقولة

النقل بين التحديات يقدر يسرّع الخدمة ملي كتكون الأهداف متشابهة فالبنية، ولكن التشابه ما خاصوش يعوّض التحقّق. استعمل الرسم البياني متعدد الطبقات باش تفتّش فالملخّصات والأدلة الداعمة قبل ما تطبّق playbook موروث على تحدٍّ آخر.

السلامة والاستعمال المسؤول

sapper-v2 أداة ديال الأمن الهجومي، وما خاصهاش تستعمل للوصول غير المصرّح به. الـ README ديالو كيحذّر بوضوح من أن الذكاء الاصطناعي يقدر يضخّم الضرر اللي تقدر تسبّبو أدوات الهجوم. تبع القوانين المعمول بها، وخذ إذناً صريحاً، وقيّد نطاق الأهداف، وحدّد الميزانية وشروط التوقّف، وخلي الإشراف البشري مناسب للبيئة.

المشروع كيقترح حتى آلية مستقبلية سميتها taggant: علامات مرتبطة بـ offensive harness تقدر تسرّب معلومات تعريفية للضحايا أثناء الاختراقات غير القانونية، وتعاون فالإسناد. الـ README كيقدّم هاد الشي كاقتراح محتاج لتصميم تشفيري ومجتمعي، وماشي كحماية موجودة يقدر المستخدم يعتمد عليها اليوم.

الخلاصة

sapper-v2 كيبين مقاربة تعاونية للتقييم الأمني الذاتي: commander كيفوّض الخدمة، والمتخصصون كيخدمو بالتوازي، وwatchdog كيحافظ على الاستمرارية، ورسم بياني طبقي للحقائق كيحافظ على المعرفة التنظيمية. بدا بـ CLI الخفيف، وراقب اللوحة باستعمال sapper status، واستعمل إعداد Docker ملي تحتاج الـ legion كاملة. ديماً خلّي كل تشغيل داخل التفويض الصريح وضمن إخلاء المسؤولية ديال المشروع.