التكوين المحلي

يحافظ Failproof AI على فصل ما يمكن للمستودع أن يلتزم به — توصيل الخطافات ومعاملات السياسة والسياسات المخصصة — عن حالة الجهاز مثل بيانات الاعتماد والحزم المثبتة والخادم.

اختر نطاقًا

يقرر النطاق مكان توصيل الخطافات وملف التكوين الذي تكتب فيه المعاملات ومسارات السياسات المخصصة:

المستخدم ينطبق على جميع المشاريع على هذا الجهاز.
المشروع ينتمي إلى المستودع ويمكن الالتزام به.
محلي يتجاوز مشروعًا واحدًا لمستخدم واحد ويجب أن يبقى معاملاً من قبل gitignore.

failproofai policies --install --cli claude --scope project   # wire hooks for this repository
failproofai policies --install --cli claude --scope user      # or for every project on this machine
failproofai policies

لا يدعم كل جهاز النطاق المحلي؛ يرفض CLI نطاقًا لا يمكن لجهاز التشغيل المختار تمثيله. سياسات الحزم التي تعمل لا تُحدد النطاق. يتم تسجيل المفتاح مع الحزمة المثبتة، لذا فإن failproofai policies add <name> يشغل سياسة على كامل الجهاز، مهما قال --scope.

النطاق	ملف تكوين السياسة
المشروع	`<project>/.failproofai/policies-config.json`
محلي	`<project>/.failproofai/policies-config.local.json`
المستخدم	`~/.failproofai/policies-config.json`

معاملات السياسة تستخدم أول نطاق يحدد معاملات لتلك السياسة، بترتيب المشروع → محلي → المستخدم. مسارات السياسات المخصصة الصريحة تستخدم أول نطاق يحددها.

قم بتكوين معاملات السياسة

لوحة التحكم
CLI

افتح السياسة في لوحة التحكم المحلية وعدّل معاملاتها المدعومة وحفظ في النطاق المختار. قم بتشغيل إجراء وكيل متطابق وغير متطابق، ثم افحص القرار في Observe → policy.

عدّل policies-config.json للنطاق المختار، ثم قم بتشغيل failproofai policies: سيحذرك عن إدخال policyParams يسمي سياسة لا تحملها أي حزمة مثبتة. لا يفحص المفاتيح داخل الإدخال، لذا تحقق من تهجئتها مقابل الجدول أدناه.

{
  "policyParams": {
    "block-rm-rf": {
      "allowPaths": ["/tmp/build-output"]
    }
  }
}

failproofai policies

المعاملات التي تقبلها سياسات Failproof AI

تتحقق كل سياسة من أنواع معاملاتها الخاصة.

السياسة	المعامل	النوع والإفتراضي
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`, `[]`؛ الإدخالات تحتوي على `regex` و `label`
`block-read-outside-cwd`	`allowPaths`	`string[]`, `[]`
`block-sudo`	`allowPatterns`	`string[]`, `[]`
`block-rm-rf`	`allowPaths`	`string[]`, `[]`
محجوبات البنية التحتية	`allowPatterns`	`string[]`, `[]`
`block-secrets-write`	`additionalPatterns`	`string[]`, `[]`
`block-push-master`	`protectedBranches`	`string[]`, `["main", "master"]`
`block-work-on-main`	`protectedBranches`	`string[]`, `["main", "master"]`
`prefer-package-manager`	`allowed`, `blocked`	`string[]`, `[]`
`warn-large-file-write`	`thresholdKb`	`number`, `1024`
`require-push-before-stop`	`remote`, `baseBranch`	`string`, `"origin"`؛ `string`, `"main"`
`require-pr-before-stop`	`baseBranch`	`string`, `"main"`
`require-no-conflicts-before-stop`	`baseBranch`	`string`, `"main"`

نمط السماح يوسع ما قد يفعله الوكيل. اختبر التجزئة الدقيقة وتباينات الأوامر على جهاز التشغيل الهدف قبل نشره عبر أسطول.

افهم ملفات الجهاز

~/.failproofai يحتوي على ملفات منفصلة لحدود الثقة المختلفة:

المسار	الغرض
`config.json`	إعدادات الخادم وعدم السرية والتدقيق والقياس عن بعد
`credentials.json`	بيانات اعتماد السحابة؛ مخزنة بأذونات المالك فقط
`policies-config.json`	معاملات نطاق المستخدم ومسارات السياسات المخصصة الصريحة
`policies/`	سياسات اتفاقية المستخدم والحزم المثبتة وأي من سياساتها مشغلة وتخطيطات السياسة المدارة من السحابة
`hook-activity/`	سجل قرارات السياسة المحلية
`state/`	حالة الخادم والصحة والإيقاف المؤقت وحالة التشغيل

استخدم FAILPROOFAI_HOME لنقل تخطيط الجهاز الكامل لحاوية أو اختبار معزول. لا تنقل مجلدات الحالة الفردية بشكل مستقل.

لا تلتزم أبدًا بـ credentials.json. التزم بتكوين السياسة على مستوى المشروع وسياسات اتفاقية المشروع فقط بعد مراجعتها كرمز إنفاذ.

Connect your agents

Reference

التكوين المحلي

اختر نطاقًا

قم بتكوين معاملات السياسة

المعاملات التي تقبلها سياسات Failproof AI

افهم ملفات الجهاز

​اختر نطاقًا

​قم بتكوين معاملات السياسة

​المعاملات التي تقبلها سياسات Failproof AI

​افهم ملفات الجهاز

اختر نطاقًا

قم بتكوين معاملات السياسة

المعاملات التي تقبلها سياسات Failproof AI

افهم ملفات الجهاز