# دليل التشغيل الآمن المختصر

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

## المتطلبات

- Python 3.11 أو أحدث.
- لا تحتاج مكتبات خارجية للتدقيق والتشغيل غير المتصل.
- تحفظ المفاتيح خارج مجلد المشروع في ملف `.env.local`، ولا تُدرج في Git أو الأرشيف.

## التحقق غير المتصل

```bash
cd PolicyFaultBench
PYTHONPATH=src python -m policyfaultbench.cli validate
PYTHONPATH=src python -m policyfaultbench.cli offline-pilot --limit 40
PYTHONPATH=src python -m unittest discover -s tests -v
```

## تفعيل التشغيل الحي لاحقاً

التشغيل الحي محجوب افتراضياً ببوابتين مستقلتين، ولا يفتح إلا بعد تثبيت أسعار النموذج واجتياز الاختبارات:

1. تغيير `live_enabled` إلى `true` في `config/experiment.json`.
2. تعيين متغير البيئة `PFB_LIVE_ENABLED=true`.
3. توفير مفتاح المزود في `.env.local`.
4. تشغيل حالة DEBUG واحدة فقط ومراجعة سجل الأحداث والتكلفة قبل التوسع.

لا تضع المفاتيح في الشفرة أو لقطات الشاشة المنشورة. إذا التقطت صورة للمفتاح، احتفظ بها سرياً واحذفها بعد التأكد من تخزينه بأمان.

## التجربة النهائية

استخدم دفتر `PolicyFaultBench_Colab_DEFINITIVE.ipynb` لتشغيل Claude وGemini.
الدفتر يحفظ السجل في Google Drive ويستأنف من آخر حالة مكتملة. لا تضع المفاتيح
داخل الخلايا؛ استخدم Colab Secrets فقط بالأسماء:

- `ANTHROPIC_API_KEY`
- `GEMINI_API_KEY`

الحزمة تكون مقفلة افتراضيًا. يفعّل الدفتر بوابتي التشغيل داخل نسخة Colab فقط،
ثم يعيد قفلهما بعد اكتمال التشغيل.
