Pensar Apex

اختبار اختراق مدعوم بالذكاء الاصطناعي باستخدام وكلاء مستقلين — مباشرةً في طرفيتك. شغّل اختبارات اختراق بالصندوق الأسود والصندوق الأبيض تستكشف وتستنتج وتكشف الثغرات الأمنية الحقيقية.

هل تريد التشغيل من السحابة أو دمجه مع CI/CD الخاص بك؟ راجع Pensar Console.

حالات الاستخدام

المطوّرون

• شغّل /pentest قبل دمج طلب سحب (PR) — اكتشف الثغرات بسهولة تشغيل الاختبارات
• احصل على نتائج قابلة للتنفيذ مع درجات الخطورة والأدلة والإصلاحات المقترحة — دون الحاجة إلى خلفية أمنية
• ادمجه في CI/CD عبر أوامر CLI بدون واجهة أو عبر Pensar Console

مهندسو الأمن

• انشر اختبارات سرب مدفوعة بالوكلاء عبر أسطح هجوم واسعة
• استخدم وضع /operator للتحقيق اليدوي وتسلسل الاستغلال والتحقق
• أتمت سير عمل الاختبار المتكرر بذاكرة دائمة تتراكم عبر المهام
• توسّع عبر الفرق والمشاريع من خلال Pensar Console

التثبيت

الطريقة	الأمر
تثبيت سريع (macOS/Linux)	curl -fsSL https://pensarai.com/install.sh | bash
Homebrew	brew tap pensarai/tap && brew install apex
npm	npm install -g @pensar/apex
Windows (PowerShell)	irm https://www.pensarai.com/apex.ps1 | iex

الاستخدام

افتح واجهة Apex TUI:

pensar

Herdr

يبلّغ Apex تلقائيًا عن حالته عند تشغيله داخل Herdr. يعرض الشريط الجانبي working أثناء الدور، وblocked عند الحاجة إلى موافقة أو مراجعة خطة أو إجابات، و idle عندما يكون Apex جاهزًا للإدخال. كما تبلّغ أوامر وكيل CLI المرتبطة بالطرفية عن نشاطها. لا حاجة إلى إضافة أو تكوين إضافي لـ Apex.

يمكن لـ Herdr 0.9.2 أو أحدث استعادة المحادثة الحالية بعد إعادة تشغيل الخادم. أبقِ pensar على PATH الخاص بك؛ يوفّر Apex أمر استئناف مع معرّف الجلسة، والنموذج النشط، وإعداد التعتيم. تستعيد الجلسة المحفوظة وضع المشغّل وإعدادات الموافقة الخاصة بها. تنتظر الجلسات المستعادة مطالبتك التالية.

يمكنك أيضًا إعادة فتح جلسة مباشرةً:

pensar --resume <session-id>
pensar --resume <session-id> --model <model-id>

يعمل الإبلاغ عن الحالة والإصدار أيضًا مع إصدارات Herdr الأقدم. تُنفَّذ التقارير في الخلفية بمهلة قصيرة، ولا تقاطع أعطال Herdr عمل Apex.

واجهة سطر أوامر بلا واجهة رسومية (Headless CLI)

شغّل اختبارات الاختراق دون واجهة TUI للسكربتات أو CI أو تكامل evalgate:

# Basic pentest
pensar pentest --target https://example.com

# With extended thinking and task-driven mode
pensar pentest --target https://example.com --extended-thinking --task-driven

# Whitebox (with source code access)
pensar pentest --target https://example.com --cwd ./my-app

# Targeted pentest with specific objectives
pensar targeted-pentest --target https://example.com --objective "Test authentication bypass"

العلامة	الأمر	الوصف
--target <url>	pentest, targeted-pentest	عنوان URL الهدف (مطلوب)
--cwd <path>	pentest	مسار الشيفرة المصدرية لوضع الصندوق الأبيض
--mode <mode>	pentest	exfil لتحويل المسار واستخراج الأعلام
--model <model>	pentest, targeted-pentest	نموذج الذكاء الاصطناعي (افتراضي: يُختار تلقائيًا)
--extended-thinking	pentest	تفعيل التفكير الموسّع للنماذج المدعومة
--task-driven	pentest	تفعيل البنية القائمة على المهام (تجريبية)
--prompt <text|@file>	pentest	إرشادات مخصصة للوكيل
--threat-model <text|@file>	pentest	نموذج التهديد لتوجيه الاختبار
--objective <text>	targeted-pentest	هدف الاختبار (قابل للتكرار)

استدلال Hoonify

اربط Hoonify في /providers أو عيّن HOONIFY_API_KEY، ثم اختر نموذجًا مكتشفًا في /models. تقبل الأوامر بدون واجهة --model-provider hoonify --model <catalog-model-id>. راجع إعداد Hoonify لاكتشاف النماذج وميزانيات الرموز والفحوصات الحية.

نقاط نهاية الاستدلال المخصصة

أحضر نقطة نهاية متوافقة مع OpenAI ورمز حامل عبر إعداد customProviders أو متغير بيئة العامل APEX_CUSTOM_PROVIDERS. اخترها باستخدام --model-provider <id> --model <model>، أو اختر نماذجها المعلنة في منتقي /models الخاص بالمشغّل. راجع إعداد الاستدلال المخصص لإعدادات GLM وتكوين المهام بدون واجهة واختبار اتصال حي.

التسجيل

يوجّه Apex تسجيل التشخيص/التشغيل عبر مسجّل منظم مركزي (src/core/logger). يكتب JSON بسطر واحد إلى stderr عندما لا يكون الإخراج طرفية — مما يبقيه منفصلًا عن stdout الخاص بالبرنامج وسهل الإرسال إلى خط أنابيب السجلات (مثل CloudWatch) — ويُخرج إخراجًا منسقًا وملونًا في طرفية تفاعلية. يبقى إخراج CLI/TUI الموجّه للمستخدم على stdout.

عيّن المستوى (من الأكثر إلى الأقل تفصيلًا: debug < info < warn < error، الافتراضي info):

pensar pentest --target https://example.com --log-level debug   # or --verbose / --quiet
PENSAR_LOG_LEVEL=debug pensar ...                                # via environment
PENSAR_DEBUG=1 pensar ...                                        # back-compat alias for debug

ترتيب الأولوية: علامة CLI → PENSAR_LOG_LEVEL → PENSAR_DEBUG → الافتراضي info. يفرض PENSAR_LOG_FORMAT=json|pretty صيغة الإخراج. عندما يعمل Apex كعميل مُدار، يتم توفير PENSAR_LOG_LEVEL من بيئة المضيف.

تتبع W&B Weave

بث تتبعات الوكيل على مستوى الخطوات إلى Weights & Biases Weave للتحليل والضبط الدقيق:

export WANDB_API_KEY=your-key
export WANDB_ENTITY=your-entity
# WANDB_PROJECT defaults to "apex-traces"
pensar pentest --target https://example.com

تتضمن التتبعات خطوات الاستدلال، واستدعاءات الأدوات، واستخدام الرموز (tokens)، ونقاط تفتيش الحالة. عندما لا يتم تعيين بيانات الاعتماد، يتم تعطيل التتبع بصمت.

OpenTelemetry (الرصد)

يُصدر Apex امتدادات OpenTelemetry لتشغيلات الوكيل، واستدعاءات LLM، وتنفيذ الأدوات عبر @opentelemetry/api. تكون الامتدادات بلا تأثير (no-ops) ما لم يسجّل عمليةً ما حزمة تطوير OpenTelemetry SDK كمزوّد التتبع العام (global tracer provider)؛ لا يشحن Apex أي SDK.

سجّل SDK قبل استيراد كود Apex: