sapper-v2 کے ساتھ خودکار پین ٹیسٹنگ لیجن تیار کریں اور چلائیں

sapper-v2 کیا ہے؟

sapper-v2 ایک خودکار، کثیر ایجنٹ نظام ہے جو مجاز پینیٹریشن ٹیسٹنگ کے لیے بنایا گیا ہے۔ ایک increasingly پیچیدہ ایجنٹ پر انحصار کرنے کے بجائے، یہ متعدد AIs کو ایک لشکر کی صورت میں منظم کرتا ہے جو کام تقسیم کرتا ہے، دریافتوں کا تبادلہ کرتا ہے، اور ایجنٹوں کی تبدیلی کے دوران معلومات محفوظ رکھتا ہے۔

اس منصوبے نے تیسرے Tencent Cloud Intelligent Attack-Defense Challenge کا آن لائن کوالیفائر جیتا اور GeekCon 2026 AI Challenge میں First Prize حاصل کیا۔ Tencent کے مقابلے میں، اس نے آٹھ گھنٹے کا بغیر نگرانی والا رن 80.18 کے اسکور کے ساتھ مکمل کیا، 85 flags دریافت کیے، اور تقریباً one billion tokens استعمال کیے۔

sapper-v2 کو صرف ان نظاموں پر استعمال کریں جو آپ کی ملکیت ہوں یا جن کی جانچ کی آپ کو واضح اجازت حاصل ہو۔ انسٹالیشن یا آپریشن سے پہلے DISCLAIMER.md کا جائزہ لیں۔

نظام کیسے کام کرتا ہے

یہ منصوبہ تین بنیادی صلاحیتوں کے گرد بنایا گیا ہے:

• Create: نظام tmux میں نئے AI سیشن کھولتا ہے، جس سے کام کی ضرورت کے مطابق ماہر کارکن بنائے جا سکتے ہیں۔
• Language: ایجنٹس ایک دوسرے کے ان پٹ سیشنز میں پیغامات درج کر کے مواصلت کرتے ہیں۔
• History: دریافتوں کو ایک ایجنٹ کے context میں چھوڑنے کے بجائے layered fact-intent graph میں محفوظ کیا جاتا ہے۔

ہسٹری نظام کی تین پرتیں ہیں: title، summary، اور evidence document۔ ایجنٹس پہلے مختصر title پڑھ سکتے ہیں، مزید context درکار ہونے پر summary دیکھ سکتے ہیں، اور تفصیلی تصدیق کے لیے evidence کھول سکتے ہیں۔ یہ ڈیزائن context کے استعمال کو کم کرتا ہے اور غلط fact سے ہونے والے نقصان کو محدود کرتا ہے۔

رن ٹائم کردار

رن ٹائم کے دوران، sapper-v2 رابطہ کاری، عمل درآمد، اور دستیابی کو الگ رکھتا ہے:

• Commander: بورڈ پڑھتا ہے، اہداف کا جائزہ لیتا ہے، اور کام تقسیم کرتا ہے۔ یہ خود حملے نہیں کرتا۔
• Generals: مشکل حملوں کو سنبھالتے ہیں اور اپنے دستے بھرتی کر سکتے ہیں۔
• Scouts: مختصر reconnaissance انجام دیتے ہیں اور یہ تعین کرنے میں مدد دیتے ہیں کہ کسی ہدف کو بڑے پیمانے پر execution درکار ہے یا گہری تحقیق۔
• Soldiers: تفویض کردہ کاموں پر متوازی طور پر کام کرتے ہیں۔
• Signalman: ایک جگہ سے غیر رپورٹ شدہ flags جمع کر کے جمع کراتا ہے؛ یہ کردار پہلے سے code میں شامل نہیں تھا بلکہ آپریشن کے دوران سامنے آیا۔
• Watchdog: حکمتِ عملی سے آزاد script جو --continue کے ساتھ crashed commander کو دوبارہ شروع کر کے، keys rotate کر کے، اور رن کے اختتامی کام سنبھال کر نظام کو فعال رکھتا ہے۔

README میں رن ٹائم کی تین نمایاں ونڈوز بیان کی گئی ہیں: commander، tmux panes میں چلنے والا AI legion، اور watchdog۔

اہم خصوصیات

• کام کی متوازی تقسیم: Scouts، soldiers، generals، اور commander الگ الگ ذمہ داریوں کے ساتھ کام کرتے ہیں۔
• مستقل تنظیمی یادداشت: کسی انفرادی ایجنٹ کی تبدیلی کے بعد بھی معلومات محفوظ رہتی ہیں۔
• Context rotation: جن ایجنٹس کا context بھر جائے وہ جانشینوں کے لیے تحریری اسباق چھوڑ سکتے ہیں۔
• Model tiering: مقابلے کی configuration میں commander اور generals کے لیے GLM-5.3، جبکہ scouts اور soldiers کے لیے DeepSeek V4.1 Flash استعمال کیا گیا۔
• عملی لچک: watchdog commander کو دوبارہ شروع کر سکتا ہے، keys rotate کر سکتا ہے، اور حکمتِ عملی کے فیصلے کیے بغیر تسلسل برقرار رکھ سکتا ہے۔
• مختلف چیلنجز میں منتقلی: commander ساختی طور پر ملتے جلتے challenge families کی شناخت کر سکتا ہے اور کامیاب playbooks نئے تفویض کردہ ایجنٹس کو منتقل کر سکتا ہے۔
• Fact-intent CLI: یہ منصوبہ اپنے graph کو چلانے اور متعدد چیلنج workflows کے لیے commands اور رہنمائی فراہم کرتا ہے۔

sapper CLI انسٹال کریں

فوری آغاز کا installer sapper CLI کو مناسب جگہ پر link کرتا ہے۔ README کے مطابق، CLI صرف standard library استعمال کرتا ہے اور اس کی کوئی اضافی dependencies نہیں ہیں۔

repository root سے چلائیں:

bash install.sh

README میں اضافی local prerequisites یا platform-specific installation steps درج نہیں ہیں۔ اگر command آپ کے shell میں sapper دستیاب نہ کرے تو install.sh کا جائزہ لیں اور تصدیق کریں کہ اس کی symlink destination آپ کے executable path میں شامل ہے۔

مجاز assessment شروع کریں

sapper setup کے ذریعے نیا assessment بنائیں۔ درج ذیل مثال منصوبے کے quick start سے لی گئی ہے:

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

http://target کو صرف ایسے endpoint سے تبدیل کریں جو آپ کی تحریری اجازت کے دائرے میں ہو۔ goal میں منظور شدہ scope کو واضح طور پر بیان کرنا چاہیے تاکہ ایجنٹس کو غیر مبہم mission ملے۔

--agents option منصوبے میں دکھایا گیا agent-oriented workflow شروع کرتا ہے۔ setup کے بعد board اور موجودہ frontier کا جائزہ لیں:

sapper status

status view یہ جانچنے کے لیے quick start کا بنیادی command ہے کہ کام کس طرح آگے بڑھ رہا ہے۔ commander targets کا جائزہ لینے اور specialists کو کام دینے کے لیے board استعمال کرتا ہے، assessment tasks براہِ راست انجام دینے کے لیے نہیں۔

ایک کم سے کم CLI workflow

1. tool سے باہر target، time window، منظور شدہ techniques، اور stop conditions کو document کریں۔
2. CLI انسٹال کریں: cloned repository سے bash install.sh چلائیں۔
3. goal متعین کریں: منظور شدہ target کے ساتھ sapper setup --goal "assess http://target" --agents چلائیں۔
4. board کی نگرانی کریں: board اور frontier کا جائزہ لینے کے لیے sapper status چلائیں۔
5. محفوظ معلومات کا جائزہ لیں: جب single-graph operations یا multi-challenge sweeps درکار ہوں تو SKILL.md میں درج fact-intent workflow استعمال کریں۔

Docker کے ساتھ مکمل legion چلائیں

ریپوزٹری میں مکمل کمانڈر پر مبنی لیجن کے لیے Dockerfile شامل ہے۔ امیج ریپوزٹری کی روٹ سے بنائیں:

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

کنٹینر شروع کرنے سے پہلے ماڈل گیٹ ویز، کی پول، اور بجٹ کے ماحول کے متغیرات ترتیب دیں جن کی وضاحت docker/ENV.md میں کی گئی ہے۔ یہ ترتیبات اہم ہیں کیونکہ فن تعمیر مختلف ماڈل درجات کو مختلف ذمہ داریاں سونپتا ہے اور اس میں کی روٹیشن اور بجٹ سے باخبر آپریشن شامل ہے۔

README کنٹینر لانچ کو خاکے کی صورت میں پیش کرتا ہے:

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

یہ بیضوی نشان کوئی حقیقی، فوراً چلنے کے قابل آرگومنٹ نہیں ہے۔ اسے ریپوزٹری کی ماحول سے متعلق دستاویزات میں دیے گئے مطلوبہ ماحول کے متغیرات اور دیگر Docker اختیارات سے تبدیل کریں۔ پروڈکشن اسناد کا اندازہ نہ لگائیں اور جب زیادہ محفوظ رازوں کے انتظام کا طریقہ دستیاب ہو تو راز براہِ راست شیل ہسٹری میں درج نہ کریں۔

کمانڈر کے اصول سمجھیں

کمانڈر کا عملی نظریہ docker/commander/SKILL.md میں محفوظ ہے۔ README کئی اصول نمایاں کرتا ہے:

• آسان کام پہلے، متوازی شیڈولنگ: کام اس طرح تقسیم کریں کہ قابلِ حل اہداف بیک وقت حل کیے جا سکیں، بجائے اس کے کہ پوری لیجن کو ایک مشکل راستے سے گزارا جائے۔
• رکاوٹ کے وقت بازیافت: آپریشن کے اختتام کے قریب جزوی طور پر حل شدہ اہداف کا دوبارہ جائزہ لیں، جہاں موجودہ شواہد تیزی سے نتائج فراہم کر سکتے ہیں۔
• نقصان روکنے کا نظم: ایسے کام پر لامحدود وقت یا ٹوکن خرچ کرنے سے گریز کریں جس سے پیش رفت نہیں ہو رہی۔
• کرداروں کی علیحدگی: کمانڈر کی توجہ براہِ راست عمل درآمد کے بجائے بورڈ پڑھنے، فیصلہ سازی، اور کام سونپنے کے لیے محفوظ رکھیں۔

باضابطہ فن تعمیر کے معاہدے کے لیے docker/commander/SPEC.md پڑھیں۔ مقابلے کے دوران نظام کے طرزِ عمل کی وضاحت کرنے والی سابقہ جائزہ رپورٹ کے لیے BATTLE-REPORT.md دیکھیں۔

جدید آپریٹنگ نکات

مقاصد کو مجاز دائرۂ کار کے مطابق لکھیں

سیٹ اپ کا مقصد وہ مشن بن جاتا ہے جس کی جانب ایجنٹس کام کرتے ہیں۔ منظور شدہ ہدف کو درست طور پر بیان کریں اور ایسی وسیع زبان سے گریز کریں جسے غیر متعلقہ میزبانوں یا سروسز کو تلاش کرنے کی اجازت سمجھا جا سکتا ہو۔ بیرونی اجازت کی دستاویزات ہی اصل ماخذ رہتی ہیں۔

بڑے خلاصوں کے بجائے تہہ دار شواہد استعمال کریں

اعلیٰ سطحی حقائق مختصر رکھیں، جبکہ ان کے نیچے تفصیلی شواہد محفوظ رہیں۔ عنوان بنیادی نکتہ بیان کرے، خلاصہ متعلقہ اہمیت سمجھائے، اور شہادت کی دستاویز تصدیق میں مدد دے۔ یہ sapper-v2 کے ڈیزائن کے مطابق ہے اور ایجنٹ کے سیاق میں ہر تفصیل بار بار لوڈ کرنے سے بچاتا ہے۔

ایجنٹ کی تبدیلی کے دوران اسباق محفوظ رکھیں

پروجیکٹ نے اپنی مہم کے دوران سپاہی کے سیاق کی سیر شدگی تقریباً 260,000 ٹوکنز ناپی۔ اس کے جواب میں کارکن کو تبدیل کیا گیا جبکہ جانشین کے لیے ایک پلے بک چھوڑی گئی۔ آپریشن کے نتائج کا جائزہ لیتے وقت ایسی واضح حوالگی نوٹس کو ترجیح دیں جن میں تصدیق شدہ نتائج، آزمائے گئے طریقے، غیر حل شدہ سوالات، اور دوبارہ استعمال کے قابل طریقۂ کار شامل ہوں۔

حکمتِ عملی کو دستیابی سے الگ رکھیں

واچ ڈاگ کا دانستہ طور پر کوئی حکمتِ عملی سے متعلق کردار نہیں ہے۔ بحالی کے رویے، کی روٹیشن، اور عمل کے دوبارہ آغاز کو اہداف اور حربوں سے متعلق فیصلوں سے الگ رکھیں۔ اس سے یہ سمجھنا آسان ہوتا ہے کہ کوئی کارروائی کمانڈر کی طرف سے آئی یا کیپ اَلائیو آٹومیشن سے۔

ٹوکن اور ماڈل کے اخراجات قابو میں رکھیں

sapper-v2 کے مقابلہ جاتی فن تعمیر میں اعلیٰ سطحی فیصلہ سازی کے لیے زیادہ طاقتور ماڈلز اور کثیر تعداد میں ہونے والی شناسائی اور عمل درآمد کے لیے ہلکے ماڈلز مختص کیے گئے تھے۔ اگر آپ دستاویزی ترتیب کو دوبارہ نافذ کرتے ہیں تو Docker کی ماحول سے متعلق رہنمائی کے ذریعے گیٹ ویز، کی پولز، اور بجٹ مقرر کریں، اور مجاز رَن کے دوران کھپت کی نگرانی کریں۔

منتقل شدہ علم پر بھروسا کرنے سے پہلے شواہد کا معائنہ کریں

جب اہداف ایک ساخت میں مشترک ہوں تو چیلنجز کے درمیان منتقلی کام کو تیز کر سکتی ہے، لیکن مماثلتیں تصدیق کی جگہ نہیں لے سکتیں۔ کسی دوسرے چیلنج پر وراثت میں ملی پلے بک لاگو کرنے سے پہلے تہہ دار گراف استعمال کرتے ہوئے خلاصوں اور معاون شواہد کا معائنہ کریں۔

حفاظت اور ذمہ دارانہ استعمال

sapper-v2 ایک جارحانہ سکیورٹی ٹول ہے اور اسے غیر مجاز رسائی کے لیے استعمال نہیں کیا جانا چاہیے۔ اس کا README واضح طور پر خبردار کرتا ہے کہ AI جارحانہ ٹولنگ سے ہونے والے نقصان میں اضافہ کر سکتی ہے۔ قابلِ اطلاق قانون کی پابندی کریں، واضح اجازت حاصل کریں، ہدف کا دائرۂ کار محدود رکھیں، بجٹ اور رکنے کی شرائط طے کریں، اور ماحول کے مطابق انسانی نگرانی برقرار رکھیں۔

پروجیکٹ مستقبل کے ایک taggant طریقۂ کار کی بھی تجویز دیتا ہے: ایسی نشانیاں جو کسی جارحانہ ہارنس سے منسلک ہوں اور غیر قانونی دراندازی کے دوران متاثرین تک شناختی معلومات پہنچا سکیں اور نسبت کا تعین کرنے میں مدد دیں۔ README اسے ایسی تجویز کے طور پر پیش کرتا ہے جس کے لیے کرپٹوگرافک اور کمیونٹی ڈیزائن درکار ہے، نہ کہ ایسی موجودہ حفاظت کے طور پر جس پر صارفین آج بھروسا کر سکیں۔

نتیجہ

sapper-v2 خودکار سکیورٹی جائزے کے لیے ایک باہمی تعاون پر مبنی طریقہ دکھاتا ہے: ایک کمانڈر کام سونپتا ہے، ماہرین متوازی طور پر کام کرتے ہیں، واچ ڈاگ تسلسل برقرار رکھتا ہے، اور تہہ دار حقائق کا گراف تنظیمی علم محفوظ رکھتا ہے۔ ہلکے CLI سے آغاز کریں، sapper status کے ذریعے بورڈ کی نگرانی کریں، اور مکمل لیجن کی ضرورت ہو تو Docker سیٹ اپ استعمال کریں۔ ہر رَن کو ہمیشہ واضح اجازت اور پروجیکٹ کے دستبرداری بیان کے اندر رکھیں۔