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

​
بدء لوحة التحكم

failproofai
يفتح في http://localhost:8020. تقرأ لوحة التحكم مباشرة من نظام الملفات - مشاريع Claude Code والملفات الإعدادات الخاصة بـ failproofai. لا يتم كتابة أي شيء إلى خدمة بعيدة.

​
الصفحات

​
المشاريع

يسرد جميع مشاريع Claude Code الموجودة على جهازك. يتم اكتشاف المشاريع من ~/.claude/projects/ (أو المسار المحدد بواسطة CLAUDE_PROJECTS_PATH). يعرض كل مشروع:
  • اسم المشروع (مشتق من مسار المجلد)
  • عدد الجلسات
  • تاريخ أحدث نشاط للجلسة
انقر على مشروع لمشاهدة جلساته.

​
الجلسات

يسرد جميع الجلسات داخل مشروع. تعرض كل جلسة:
  • معرّف الجلسة
  • طوابع زمنية البدء والانتهاء
  • عدد استدعاءات الأدوات
  • عدد أنشطة الخطاف (السياسات التي تم تفعيلها)
استخدم مرشح نطاق التاريخ والبحث عن معرّف الجلسة لتضييق القائمة. يتم ترقيم الجلسات. انقر على جلسة لفتح عارض الجلسة.

​
عارض الجلسة

يجيب عارض الجلسة على السؤال الرئيسي للوكلاء المستقلين: ماذا فعل الوكيل، وهل ظل على المسار الصحيح؟ يعرض خط زمني لكل ما حدث في الجلسة:
  • الرسائل - الردود النصية من Claude وطلبات المستخدم
  • استدعاءات الأدوات - كل أداة استدعاها Claude، مع مدخلاتها ومخرجاتها
  • نشاط السياسة - لكل استدعاء أداة، السياسات التي تم تفعيلها والقرار الذي أرجعته
يعرض شريط الإحصائيات في الأعلى مدة الجلسة وإجمالي استدعاءات الأدوات وملخص قرارات الخطاف (عدد السماح / الرفض / التعليمات). يمكنك تصدير الجلسة كملف ZIP أو JSONL باستخدام زر التحميل.

​
السياسات

صفحة بتبويبين لإدارة السياسات ومراجعة النشاط.
  • تبديل السياسات الفردية بنقرة واحدة (الكتابة إلى ~/.failproofai/policies-config.json)
  • قم بتوسيع سياسة لتكوين معاملات بها (بالنسبة للسياسات التي تدعم policyParams)
  • تثبيت أو إزالة الخطافات لنطاق معين
  • تعيين مسار ملف سياسات مخصص

​
التحديث التلقائي

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

​
تعطيل الصفحات

إذا كنت تحتاج فقط إلى بعض أجزاء لوحة التحكم، اضبط FAILPROOFAI_DISABLE_PAGES على قائمة مفصولة بفواصل من أسماء الصفحات: 
FAILPROOFAI_DISABLE_PAGES=policies failproofai
القيم الصالحة: policies، projects.

​
المظهر

تدعم لوحة التحكم الوضع الفاتح والمظلم. بدّل عن طريق الزر في شريط التنقل. يتم تخزين التفضيل في ذاكرة التخزين المحلية للمتصفح.

​
تكوين مسار المشاريع

افتراضياً، تقرأ لوحة التحكم من دليل مشاريع Claude Code القياسي. تجاوزه للإعدادات المخصصة: 
CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai

​
الوصول من مضيف غير localhost

عند تشغيل لوحة التحكم في وضع التطوير (npm run dev) والوصول إليها من اسم مضيف بخلاف localhost - على سبيل المثال، مجال مخصص أو عنوان IP بعيد أو عنوان URL محفور - قد ترى تحذيراً مثل: 
⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
هذا هو Next.js يحظر الوصول عبر الأصول إلى موارد HMR (إعادة تحميل الوحدة الساخنة)، وهي ميزة تطوير فقط. للسماح بمضيفك، استخدم علم --allowed-origins: 
npm run dev -- --allowed-origins dashboard.example.com
لعدة مضيفات أو عناوين IP، مرر قائمة مفصولة بفواصل: 
npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
يمكنك أيضاً تعيين متغير البيئة FAILPROOFAI_ALLOWED_DEV_ORIGINS بدلاً من ذلك: 
FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
ينطبق هذا فقط على وضع التطوير. عند تشغيل failproofai (وضع الإنتاج)، لا توجد مقبس ويب HMR ولا توجد مشكلة موارد تطوير عبر الأصول.