أجهزة التشغيل الوسيطة للعوامل

جهاز التشغيل الوسيط هو المكان الذي يعمل فيه العامل بالفعل. يدعم Failproof AI اثني عشر منها، موزعة على فئتين:

أدوات سطر الأوامر للبرمجة (10) — Claude Code وCodex وGitHub Copilot CLI وCursor وOpenCode وPi وFactory Droid وDevin CLI وAntigravity CLI وGoose
بوابات الدردشة والمساعدات (2) — Hermes (Slack وTelegram وcron) وOpenClaw (مساعد ذاتي التشغيل)

تنطبق نفس السياسات وسجل الجلسات نفسه بغض النظر عن جهاز التشغيل الوسيط الذي يعمل فيه العامل. تقوم طبقة محول واحدة بتعيين أسماء الأحداث الأصلية لكل جهاز تشغيل وسيط وأسماء الأدوات وحقول مدخلات الأدوات إلى 29 حدثًا معياريًا قبل تشغيل أي سياسة. عامل يعمل في أيٍ من الاثني عشر يتم تجهيزه مباشرة باستخدام Python SDK. هذا عقد مختلف ويستحق التوضيح صراحة: SDK يوفر التتبع والجلسات والتقييمات والتدقيقات — لا يفرض السياسات من تلقاء نفسه. يتطلب حجب إجراء غير آمن قبل تنفيذه خطاف إنفاذ عند حد أداة وقتك؛ تواصل معنا وسنقوم بتعيينه.

جهاز التشغيل الوسيط	نطاقات الخطاف المدعومة
Claude Code	مستخدم، مشروع، محلي
Codex وGitHub Copilot CLI وCursor وOpenCode وPi	مستخدم، مشروع
Factory Droid وDevin CLI وAntigravity CLI وGoose	مستخدم، مشروع
Hermes وOpenClaw	مستخدم

يقوم كل تكامل بتوحيد أسماء أحداث الخطاف الأصلية وأسماء الأدوات وحقول مدخلات الأدوات قبل تشغيل السياسات. لا يمكن للسياسة أن تعمل إلا على الأحداث التي يكشفها جهاز التشغيل الوسيط؛ اختبر سلوك نهاية الدور والتعليمات على جهاز التشغيل الوسيط والإصدار المحدد الذي تنشره.

القدرة على الإنفاذ

“حجب” يعني أن القرار المعاد من محول التيار الحالي يتم استهلاكه بواسطة جهاز التشغيل الوسيط المسمى. قد يستبدل الحجب بعد الأداة النتيجة المعروضة للنموذج لكنه لا يمكنه التراجع عن تأثير جانبي للأداة حدث بالفعل.

جهاز التشغيل الوسيط	أحداث الحجب المتحقق منها	تحذيرات الملاحظة فقط أو عدم الحجب
Claude Code	`PreToolUse` و`UserPromptSubmit` و`PermissionRequest` و`Stop` و`SubagentStop` و`PreCompact` وعدة أحداث مهام/إعدادات	`PostToolUse` ودورة حياة الجلسة والإخطارات وأحداث ما بعد الفشل تراقبة فقط.
Codex	`PreToolUse` و`PermissionRequest` و`UserPromptSubmit` و`Stop` و`SubagentStop` و`PostToolUse`	الحجب بعد الأداة يستبدل النتيجة بعد التنفيذ؛ أحداث بدء الجلسة والضغط تراقبة في المحول الحالي.
GitHub Copilot CLI	`PreToolUse` و`UserPromptSubmit` و`PermissionRequest` و`Stop` و`SubagentStop` و`PostToolUse`	الحجب بعد الأداة يستبدل النتيجة بعد التنفيذ؛ أحداث الجلسة والإخطارات تراقبة.
Cursor	`PreToolUse` و`UserPromptSubmit` و`Stop`	`PostToolUse` وأحداث الجلسة تراقبة.
OpenCode	`PreToolUse`	أحداث ما بعد الأداة ودورة الحياة تراقبة؛ المعالجة الحالية للإيقاف هي إرشادات لدور لاحق وليست بوابة محققة.
Pi	`PreToolUse` و`UserPromptSubmit`	أحداث ما بعد الأداة ودورة الحياة تراقبة؛ إرشادات الإيقاف تنطبق على دور لاحق.
Hermes	`PreToolUse`	يوفر مكون إضافي أصلي `instruct()` كمقاطعة واحدة محدودة مرئية للنموذج قبل السماح بتكرار API لاحق. قرارات ما بعد الأداة والجلسة وإيقاف العامل الثانوي ليست بوابات.
OpenClaw	`PreToolUse` و`UserPromptSubmit` و`Stop`	أحداث ما بعد الأداة والجلسة وإيقاف العامل الثانوي والضغط تراقبة.
Factory Droid	`PreToolUse` و`UserPromptSubmit` و`Stop` و`PreCompact`	قرارات ما بعد الأداة وإيقاف العامل الثانوي تراقبة.
Devin CLI	`PreToolUse` و`UserPromptSubmit` و`Stop` و`PermissionRequest` مشروط	لا تعمل خطاف الإذن في كل وضع إذن؛ أحداث ما بعد الأداة والجلسة تراقبة.
Antigravity CLI	`PreToolUse` و`Stop`	قرارات موجه المستخدم وما بعد الأداة تراقبة؛ يمكن حقن تعليمات الموجه.
Goose	`PreToolUse`	أحداث موجه المستخدم وما بعد الأداة والجلسة تراقبة. يوجد خطاف إيقاف حجب أصلي في المنطقة الأعلى لكن لا يتم تثبيته بواسطة المحول الحالي.

القدرات حساسة للإصدار. أعد الاختبار بعد ترقية عامل CLI، خاصة عندما تعتمد السياسة على سلوك الموجه أو الإيقاف أو الإذن أو ما بعد الأداة بدلاً من بوابة ما قبل الأداة الشائعة.

مكون إضافي أصلي من Hermes

يتم دمج Hermes من خلال مكون إضافي أصلي محلي للملف الشخصي بدلاً من أمر shell. يقوم التثبيت بنسخ المكون الإضافي في كل ملف شخصي Hermes افتراضي ومسمى، وتمكينه في config.yaml الخاص بذلك الملف الشخصي، والهجرة فقط إدخالات خطاف shell FailproofAI القديمة. يتجنب هذا عملية توليد العملية على كل خطاف ويسمح instruct() بالوصول إلى النموذج من خلال نتيجة الأداة المحجوبة الأصلية من Hermes. أول تعليمة متطابقة تحجب الاستدعاء المعلق. يبقى طلب API نفسه محجوبًا؛ قد تحاول تكرار نموذج لاحق. دفتر يومية محلي للملف الشخصي ومحدودية لكل دور تمنع التعليمات الاستشارية من أن تصبح حلقة غير محدودة. deny() يبقى حجبًا صعبًا. قم بتشغيل failproofai config --status لاكتشاف ملف شخصي معطل أو غير كامل أو مكرر أو تم إلغاء تكوينه للتو.

تثبيت خطاف الالتقاط والسياسة

لوحة التحكم
CLI

افتح الإدارة → المفاتيح وأنشئ مفتاحًا بـ events:add وpolicies:pull، مسمى للجهاز أو البيئة.
على الجهاز المستهدف، اربط CLI المحلي بالمفتاح المعروض وثبّت خطاف جهاز التشغيل الوسيط.
ابدأ جلسة عامل جديدة، ثم أكد خطافها وأحداث جلستها تحت المراقبة → الأحداث.
افتح المراقبة → السياسة للإطار الزمني نفسه وأكد أن قرار السياسة منسوب إلى الجهاز.

يبدأ الاتصال بمفتاح الجهاز. أكد أنه يتضمن كلا من أذونات الاستيعاب وتسليم السياسة قبل نسخ سره.

درج مفتاح API الجديد المستخدم لمنح أذونات استيعاب الأحداث وتسليم السياسة.

بعد تثبيت الخطافات، يجب أن يعرض دفق الأحداث أحداثًا جديدة من الجهاز والبيئة التي اتصلت بها.

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

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

صفحة السياسة المستخدمة للتحقق من قرارات السياسة من جهاز تشغيل وسيط متصل حديثًا.

اقرأ مفتاح الجهاز في shell. read -s يأخذه عند موجه لا يصدر صدى، لذا لا يظهر أبدًا في أمر أو في سجل shell:

read -rs FAILPROOFAI_CLOUD_TOKEN && export FAILPROOFAI_CLOUD_TOKEN

ثم قم بإعداد الجهاز — هذا يربط الخطافات لكل جهاز تشغيل وسيط تم اكتشافه، وينصب البرنامج الثابت، ويتصل بـ Cloud:

failproofai config
failproofai policies add FailproofAI/policies

الإعداد لا يمكّن أي سياسة من تلقاء نفسها، وهذا ما الأمر الثاني من أجله.أو استهدف أجهزة تشغيل وسيطة مسماة ونطاق إعداد:

failproofai policies --install \
  --cli claude codex cursor \
  --scope user

نطاق المشروع يحتفظ بإعداد الخطاف مع المستودع. نطاق المستخدم يغطي العمل عبر المستودعات. Claude Code يدعم أيضًا نطاق محلي؛ الدعم يختلف حسب جهاز التشغيل الوسيط و CLI يرفض المجموعات غير المدعومة.تحقق من الجهاز وأحداثه:

failproofai config --status
failproofai flush --wait
fp events --since 1h --event-type hook_triggered,hook_completed

أضف مسار جلسة غير افتراضي

لوحة التحكم
CLI

يتم تسجيل المسارات الإضافية على الجهاز وليس في Cloud. بعد إضافة واحد، افتح المراقبة → الجلسات، صفّي إلى بيئة الجهاز، وأكد أن الجلسات من المسار الجديد تظهر. افتح جلسة وتحقق من العامل والجهاز الوسيط وطوابع زمن الحدث قبل الاعتماد عليها في تدقيق.

قائمة الجلسات المصفاة إلى البيئة التي تتلقى البيانات من مسار الالتقاط الإضافي.

أضف مسارًا مع تسمية اختيارية، ثم افحص المسارات المكونة:

failproofai harness add-path claude checkout=/srv/checkout/.claude
failproofai harness list claude
failproofai backfill --since 7d --dry-run
failproofai backfill --since 7d

أزل مسارًا باستخدام failproofai harness remove-path claude checkout.

قم بتشغيل جلسة واحدة جديدة بعد التثبيت. تحقق من كل من دفق الأحداث المباشر وقرار سياسة فعلي قبل توسيع الطرح.

​القدرة على الإنفاذ

​مكون إضافي أصلي من Hermes

​تثبيت خطاف الالتقاط والسياسة

​أضف مسار جلسة غير افتراضي

القدرة على الإنفاذ

مكون إضافي أصلي من Hermes

تثبيت خطاف الالتقاط والسياسة

أضف مسار جلسة غير افتراضي