وكيل لاختبار الأمان مدفوع بنماذج اللغة الكبيرة (LLM) يُشغّل حلقة استدعاء أدوات مستمرة ضد هدف ما، مع أكثر من 160 محوّلًا لأدوات الاستطلاع والويب والسحابة وActive Directory واستغلال ما بعد الاختراق، وتقارير تشغيل محفوظة.
وكيل اختبار أمني مدفوع بنموذج لغوي كبير (LLM): حلقة استدعاء أدوات مستمرة واحدة، وليست خط أنابيب استطلاع→استغلال على مراحل. يقرر النموذج ما الذي ينفّذه تالياً، دورةً بدورة، ضد هدف حقيقي.
إخلاء مسؤولية: قد تتسبب الأدوات في Tradecraft بضرر دائم إذا لم تُضبط بشكل صحيح. استخدمها فقط ضد أهداف تملكها أو لديك إذن صريح باختبارها. لا تعتمد على الإعدادات الافتراضية — افهم التكوين (
docs/tools.md،docs/policy.md،docs/profiles.md) قبل أول مهمة لك.
الأدوات (Tools) هي الإجراءات التي يمكن للنموذج استدعاؤها — كل واحدة منها عقد YAML
(ما تفعله، وما المدخلات التي تحتاجها) بالإضافة إلى محوّل ينفّذ
أمراً حقيقياً ويحلّل مخرجاته إلى بيانات منظّمة. راجع
docs/tools.md لمعرفة كيفية بناء أداة، أو القائمة
الكاملة لما هو مسجّل — أكثر من 160 أداة عبر الاستطلاع والويب والسحابة وAD
وKubernetes والاستغلال اللاحق — في docs/tool-list.md.
المهارات (Skills) هي ملاحظات markdown إرشادية تمنح النموذج معرفة
حرفية (tradecraft) عابرة للأدوات — متى يُفضّل أداة على أخرى، وكيف تتسلسل
مخرجات أداتين معاً. وهي ليست مرحلة مفروضة أبداً،
وتُعرض دائماً بالكامل. راجع docs/skills.md.
تُحفظ كل عملية تشغيل لمهمة على القرص ويمكن تحويلها إلى
تقرير (--report)، أو استكشافها لاحقاً في وحدة تحكم أسئلة وأجوبة (tradecraft chat)، أو تصديرها كبيانات ضبط دقيق SFT/DPO (tradecraft dataset).
راجع docs/report.md، وdocs/post-engagement.md،
وdocs/finetune.md.
config/tools/<id>.yaml model-facing contract (description, params, scope_param)
config/profiles/ curated tool sets per engagement shape (web, cloud, ad-network, ...)
tradecraft/domain.py pure shared types
tradecraft/adapters/<tool>/ execute.py (subprocess) + parse.py (pure parsing)
tradecraft/tools/ glues a YAML contract + adapter into one Tool.run()
tradecraft/memory/ append-only engagement log, facts, and evidence store
tradecraft/policy/ destructive-tool gate
tradecraft/skills/ advisory tradecraft markdown, rendered in full
tradecraft/execution/ the agentic loop + system-prompt assembly
tradecraft/reporting/ report generation + post-run investigation console
tradecraft/dataset/ offline SFT/DPO dataset extraction from persisted runs
tradecraft/cli.py entrypoint
اتجاه التبعية أحادي الاتجاه: domain → adapters → tools → execution → cli.
python -m venv .venv && source .venv/bin/activate
pip install -e ".[test]"
cp .env.example .env # configure LLM_MODEL, LLM_BASE_URL, and LLM_API_KEY
استخدم نموذجًا مُزال القيود (abliterated، أُزيلت منه حواجز الرفض الأمني) لـ LLM_MODEL — فالنموذج القياسي المضبوط أمنيًا سيرفض أجزاءً كبيرة مما يحتاج هذا الوكيل إلى القيام به أثناء المهمة.
يجب أن يكون الملف التنفيذي المطلوب لكل أداة (انظر config/tools/<id>.yaml الخاص بها) موجودًا على PATH؛ ويُعاد الملف التنفيذي المفقود إلى النموذج كخطأ في الأداة، لا كانهيار. يتحقق scripts/verify_container_tools.py من أيٍّ من الملفات التنفيذية للأدوات المسجّلة موجود. للحصول على مجموعة أدوات كاملة معروفة الصلاحية دون تثبيت كل شيء بنفسك، راجع docs/setup.md لبناء صورة Docker وتشغيلها بدلًا من ذلك.
tradecraft 10.0.0.5 --profile web
يختار --profile مجموعة أدوات منسّقة حسب شكل المهمة (web،
ad-network، cloud، kubernetes، post-exploitation، أو full لكل
أداة مسجّلة)؛ ويستبدلها --tools بقائمة صريحة.
الأدوات المدمِّرة معطّلة افتراضيًا — مرّر --allow-destructive لتمكينها.
شغّل tradecraft --help للحصول على قائمة الخيارات الكاملة، أو راجع
docs/cli.md للاطلاع على كل أمر فرعي (chat، report،
dataset، memory) في لمحة.
تُعالَج توجيهات الشبكة/الخروج (VPN، أو بوابة SOCKS/TUN، أو network_mode للحاوية) على
مستوى البيئة بدلًا من داخل المحوّلات؛ إذا قمت بتعيين
HTTP_PROXY/HTTPS_PROXY، فأضف مضيف LLM_BASE_URL إلى NO_PROXY.
pytest
docs/cli.md — كل أمر فرعي وعلامة في tradecraft في لمحة واحدة.docs/setup.md — بناء/تشغيل صورة Docker، والحصول على السجلات، واستخراج بيانات التشغيل.docs/tools.md — الأدوات والمحوّلات.docs/tool-list.md — كل أداة مسجّلة، في لمحة واحدة.docs/policy.md — تقييد الأدوات المدمّرة، وفئات نطاق التأثير، وميزانية قفل الحساب.docs/skills.md — ما هي المهارة، وكيف ومتى تُضاف.docs/profiles.md — ملفات تعريف شكل المهمة، والتداخل، وكيفية إضافة ملف تعريف.docs/report.md — إنشاء تقرير من عملية تشغيل.docs/post-engagement.md — وحدة تحكم الأسئلة والأجوبة بعد التشغيل.docs/finetune.md — تحويل عمليات تشغيل المهام إلى بيانات ضبط دقيق SFT/DPO.CONTRIBUTING.md — كيفية إضافة أداة جديدة.