الانتقال إلى المحتوى الرئيسي

​
المتطلبات

  • Node.js >= 20.9.0
  • Bun >= 1.3.0 (اختياري - مطلوب فقط للبناء من المصدر)

​
التثبيت

npm install -g failproofai

​
البدء السريع

1

تفعيل السياسات

السياسات هي قواعد تعمل قبل وبعد كل استدعاء أداة من الوكيل. فهي تقبض على الأوامر المدمرة، تسرب الأسرار، وأوجه الفشل الأخرى قبل أن تسبب الضرر.
failproofai policies --install
يكتب هذا مدخلات hook في settings.json الخاص بـ Claude Code. يمكنك أيضاً التثبيت لمشروع واحد أو اختيار سياسات محددة:
failproofai policies --install --scope project
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
2

التحقق

failproofai policies
يعرض كل سياسة، ما إذا كانت مفعلة، وأي معاملات مكونة.
3

تشغيل لوحة المعلومات

failproofai
يفتح لوحة معلومات محلية على http://localhost:8020 حيث يمكنك تصفح الجلسات، فحص استدعاءات الأدوات، وإدارة السياسات.
4

تشغيل وكيلك

شغّل Claude Code كالمعتاد. إذا حاول الوكيل شيئاً محفوفاً بالمخاطر، فإن failproofai يقاطعه تلقائياً. اتركه يعمل دون مراقبة وراجع ما حدث في لوحة المعلومات.

​
كيفية عمل السياسات

في كل مرة يشغل فيها الوكيل أداة، يستدعي Claude Code failproofai كعملية فرعية: 
Claude Code  →  failproofai --hook PreToolUse  →  قراءة JSON من stdin
                                                 تقييم السياسات
                                                 كتابة القرار إلى stdout
كل سياسة ترجع أحد ثلاثة قرارات:
  • allow - يستمر الوكيل بشكل طبيعي
  • deny - يتم حظر الإجراء، ويُخبر الوكيل عن السبب
  • instruct - يُضاف سياق إضافي إلى فوری الوكيل
تعمل السياسات في عمليتك المحلية. لا يتم إرسال أي شيء إلى خدمة بعيدة.

​
تخزين البيانات

جميع الإعدادات والسجلات تبقى على جهازك:
المسارما يخزنه
~/.failproofai/policies-config.jsonإعدادات السياسة العامة
~/.failproofai/hook-activity.jsonlسجل تنفيذ Hook
~/.failproofai/hook.logسجل تصحيح الأخطاء لأخطاء hook المخصصة
.failproofai/policies-config.jsonإعدادات لكل مشروع (مرتكبة)
.failproofai/policies-config.local.jsonالتجاوزات الشخصية (مستثناة من git)

​
الإلغاء

failproofai policies --uninstall
يزيل مدخلات hook من ~/.claude/settings.json. يتم الاحتفاظ بملفات الإعدادات في ~/.failproofai/.

​
الخطوات التالية

الإعدادات

النطاقات وصيغة ملف الإعدادات

السياسات المدمجة

جميع 26 سياسة مع المعاملات

السياسات المخصصة

اكتب سياساتك الخاصة بلغة JavaScript

مراقب الوكيل

راقب الجلسات واستعرض نشاط السياسة