واجهة سطر الأوامر Failproof AI

قم بتثبيت واجهة سطر الأوامر المحلية باستخدام npm install -g failproofai. قم بتشغيلها بدون وسائط لفتح لوحة التحكم للسياسات المحلية. تتطلب الحزمة Node.js 20.9 أو الإصدار الأحدث. Bun 1.3 أو الإصدار الأحدث مدعوم للتطوير والتثبيتات من المصدر. failproofai configure وfailproofai setup هي بدائل لـ failproofai config؛ failproofai p هي بديل لـ failproofai policies.

إعداد الجهاز

npm install -g failproofai
failproofai config \
  --connect https://app.befailproof.ai \
  --token <machine-key> \
  --machine-label checkout-prod-01
failproofai policies --install
failproofai config --status

قم بتشغيل failproofai بدون وسائط لفتح لوحة التحكم للسياسات المحلية.

الأمر	النتيجة
`failproofai config`	تشغيل إعداد الجهاز التفاعلي
`failproofai config --connect <url> --token <key>`	الاتصال بسحابة استقبال البيانات وتسليم السياسات
`failproofai config --status`	عرض حالة الاتصال والخادم والتسليم والإيقاف المؤقت
`failproofai policies`	قائمة السياسات المدمجة والمخصصة
`failproofai policies --install`	تثبيت الخطافات وتفعيل السياسات
`failproofai policy add <name>`	تفعيل سياسة مدمجة واحدة
`failproofai policy remove <name>`	تعطيل سياسة مدمجة واحدة
`failproofai policies --uninstall`	تعطيل السياسات أو إزالة خطافات الهيكل
`failproofai audit`	مسح سجل الوكيل المحلي وفتح عرض التدقيق المحلي
`failproofai audit --schedule [days] --email <address>`	جدولة عمليات مسح محلية متكررة وإرسال النتائج عبر البريد الإلكتروني
`failproofai audit --status`	عرض عنوان التقرير والفاصل الزمني والمسح المجدول التالي
`failproofai audit --no-schedule`	إيقاف عمليات المسح المتكررة دون حذف سجل التدقيق
`failproofai harness list`	قائمة المسارات الإضافية للالتقاط
`failproofai flush --wait`	تسليم ملف الأحداث الحالي
`failproofai backfill --since 30d`	إعادة قراءة السجل السابق الذي تم تمريره
`failproofai config --pause [duration]`	إيقاف جلسة محلية واحدة مؤقتاً لمدة 30 دقيقة افتراضياً، حتى 8 ساعات
`failproofai config --resume`	استئناف جلسة محلية معلقة واحدة؛ أضف `--all` لإزالة جميع الإيقافات المؤقتة
`failproofai update`	إنهاء ترحيلات الحزمة وتحديث الخادم
`failproofai migrate --dry-run`	معاينة أو تشغيل ترحيلات تخطيط المنزل المعلقة
`failproofai uninstall`	إزالة الخطافات والخادم قبل إزالة الحزمة
`failproofai --version`	طباعة إصدار الحزمة المثبتة
`failproofai --help`	عرض الأوامر والاستخدام العام

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

العلم	الاستخدام
`--connect <url> --token <key>`	الاتصال بشكل غير تفاعلي
`--machine-id <id>`	تعيين معرف الجهاز المستقر
`--machine-label <name>`	تعيين أو تغيير تسمية لوحة التحكم
`--no-transcripts`	إرسال القرارات بدون محتوى النص
`--disconnect`	إيقاف سحب سياسات السحابة وتسليم الأحداث
`--status`	عرض حالة الجهاز الحالية
`--pause [duration]`	إيقاف أحدث جلسة في المجلد الحالي مؤقتاً؛ تقبل الثواني أو الدقائق أو الساعات وتفترض 30 دقيقة
`--resume`	إنهاء إيقاف مطابق مبكراً
`--session <id>`	استهداف جلسة صريحة للإيقاف المؤقت أو الاستئناف
`--all`	مع `--resume`، أنهِ كل إيقاف نشط

تعليق الإيقافات المحلية السياسات المدمجة والمخصصة وسياسات الاتفاقية لجلسة واحدة. تنتهي دائماً ولا تعطل سياسات السحابة المدارة. block-self-pause يمنع وكيل مزود من استخدام هذا الثغر بنفسه.

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

العلم	الاستخدام
`--install`, `-i`	تفعيل السياسات وتثبيت خطافات الهيكل
`--uninstall`, `-u`	تعطيل السياسات أو إزالة الخطافات
`--cli <names...>`	استهدف هيكل واحد أو أكثر مدعوم
`--scope user\|project\|local\|all`	اختر نطاق التكوين؛ `all` للإزالة
`--beta`	تضمين سياسات بيتا
`--custom`, `-c <path>`	التحقق من صحة وتحميل ملف سياسة مخصص؛ قابل للتكرار

علامات التسليم والصيانة

الأمر	العلامات
`backfill`	`--since <30d\|6m\|YYYY-MM-DD>`, `--dry-run`
`flush`	`--wait`, `--timeout <seconds>`
`update`	`--no-daemon`
`migrate`	`--dry-run`
`uninstall`	`--purge`, `--dry-run`, `--yes`

يجب تشغيل failproofai update بعد npm install -g failproofai@latest؛ يقوم بإجراء ترحيلات تخطيط المنزل وتثبيت ملف الخادم المطابق وإعادة تشغيل الخدمة. --no-daemon يقوم بترحيل التخطيط فقط.

مسارات الهيكل

failproofai harness list [harness]
failproofai harness add-path <harness> [label=]<path>
failproofai harness remove-path <harness> <path-or-label>

أسماء الهياكل المدعومة هي claude وcodex وcopilot وcursor وopencode وpi وhermes وopenclaw وfactory وdevin وantigravity وgoose. تسميات الأسماء معرّفات الوكيل المشتقة عندما يحتوي جذران على نسخ من نفس المشروع. يتم رفض الجذور المتداخلة والتسميات المكررة لمنع الجمع المكرر أو تلف المؤشر. إعادة تحميل تكوين المسار الإضافي بدون إعادة تشغيل الخادم. يمكن لبيئات الحاوية استبدال المسارات الإضافية المكونة بالملف بمتغير مفصول بفواصل يسمى FAILPROOFAI_<HARNESS>_EXTRA_PATHS، على سبيل المثال:

export FAILPROOFAI_OPENCLAW_EXTRA_PATHS="user1=/srv/openclaw-a,user2=/srv/openclaw-b"

المتغيرات البيئية

استخدم ملفات التكوين لسلوك الجهاز الدائم. المتغيرات البيئية مفيدة جداً للحاويات والاختبارات وعملية واحدة.

المتغير	الاستخدام
`FAILPROOFAI_HOME`	نقل تخطيط `~/.failproofai` الكامل
`FAILPROOFAI_LOG_LEVEL`	ضبط مستوى التفاصيل للتسجيل المحلي
`FAILPROOFAI_HOOK_LOG_FILE`	كتابة تشخيصات الخطاف إلى ملف محدد
`FAILPROOFAI_TELEMETRY_DISABLED=1`	تعطيل التلمترا المجهولة لهذه العملية
`FAILPROOFAI_NO_FIRST_RUN=1`	تخطي إعداد التشغيل الأول التفاعلي
`FAILPROOFAI_NO_AUTO_AUDIT=1`	تخطي تدقيق ما بعد الإعداد المحلي
`FAILPROOFAI_LLM_BASE_URL`	تجاوز نقطة نهاية متوافقة مع OpenAI التي تستخدمها سياسات LLM
`FAILPROOFAI_LLM_API_KEY`	توفير مفتاح API الذي تستخدمه سياسات LLM
`FAILPROOFAI_LLM_MODEL`	تحديد النموذج الذي تستخدمه سياسات LLM
`FAILPROOFAI_POLICY_LOAD_TIMEOUT_MS`	ربط تحميل وحدة السياسة المخصصة
`FAILPROOFAI_<HARNESS>_EXTRA_PATHS`	استبدال مسارات الالتقاط الإضافية المكونة لهيكل واحد
`NO_COLOR`	تعطيل إخراج الطرفية الملون

متغيرات المنزل الخاصة بالوكيل مثل CLAUDE_PROJECTS_PATH وCURSOR_HOME وHERMES_HOME وOPENCLAW_HOME تتجاوز المكان الذي يكتشف فيه Failproof AI جلسات محلية لهذا الهيكل.

إيقاف أو إزالة جهاز بأمان

failproofai config --pause
failproofai config --status
failproofai config --resume

إيقاف جلسة محلية مؤقتاً لا يعطل سياسات السحابة المدارة. استعد نشرات السحابة من خلال سير عمل إنفاذ السحابة عندما تكون الطرح نفسه هو المشكلة. قبل إزالة حزمة npm، أزل الخطافات المثبتة والخادم:

failproofai uninstall --dry-run
failproofai uninstall --yes
npm rm -g failproofai

قم بتشغيل failproofai <command> --help للحصول على تفاصيل محددة للإصدار.

قم بتشغيل failproofai uninstall قبل npm rm -g failproofai؛ npm لا يزيل خطافات الوكيل المثبتة أو خدمة الخادم.

Connect your agents

Reference

HTTP API

واجهة سطر الأوامر Failproof AI

إعداد الجهاز

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

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

علامات التسليم والصيانة

مسارات الهيكل

المتغيرات البيئية

إيقاف أو إزالة جهاز بأمان

​إعداد الجهاز

​علامات التكوين

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

​علامات التسليم والصيانة

​مسارات الهيكل

​المتغيرات البيئية

​إيقاف أو إزالة جهاز بأمان

إعداد الجهاز

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

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

علامات التسليم والصيانة

مسارات الهيكل

المتغيرات البيئية

إيقاف أو إزالة جهاز بأمان