title: لوحة التحكم description: “راقب جلسات الوكيل، استعرض استدعاءات الأدوات، وأدر السياسات” icon: chart-line
لوحة تحكم failproofai هي تطبيق ويب محلي لمراقبة جلسات وكيل الذكاء الاصطناعي الخاص بك وإدارة السياسات. اطلع على ما فعله وكلاؤك أثناء غيابك.بدء لوحة التحكم
http://localhost:8020.
تقرأ لوحة التحكم مباشرة من نظام الملفات - مشاريع Claude Code وملفات تكوين failproofai الخاصة بك. لا يتم كتابة أي شيء إلى خدمة بعيدة.
الصفحات
المشاريع
يسرد جميع مشاريع Claude Code و OpenAI Codex و GitHub Copilot CLI (beta) و Cursor Agent (beta) و OpenCode (beta) و Pi (beta) و Gemini CLI (beta) الموجودة على جهازك. يتم اكتشاف مشاريع Claude من~/.claude/projects/ (أو المسار المحدد بـ CLAUDE_PROJECTS_PATH)؛ يتم اكتشاف مشاريع Codex بمسح كل نسخة من النصوص تحت ~/.codex/sessions/<YYYY>/<MM>/<DD>/*.jsonl وتجميعها حسب cwd المسجل في السجل الأول لكل جلسة؛ يتم اكتشاف مشاريع Copilot CLI بمسح كل ~/.copilot/session-state/<sessionId>/workspace.yaml (قابل للتكوين عبر COPILOT_HOME) وتجميعها حسب حقل cwd الخاص به؛ يتم اكتشاف مشاريع Cursor Agent بمسح البيانات الوصفية لكل جلسة تحت ~/.cursor/agent-sessions/<sessionId>/ (قابل للتكوين عبر CURSOR_HOME، مع استقصاء conversations/ و sessions/ كبدائل) للبحث عن قيمة عددية cwd في meta.json / session.json / workspace.yaml؛ يتم اكتشاف مشاريع OpenCode من خلال الاستعلام عن قاعدة بيانات SQLite الخاصة بها في ~/.local/share/opencode/opencode.db عبر opencode db --format json (نقرأ الجداول session و project ونجمعها حسب project_id)؛ يتم اكتشاف مشاريع Pi بمسح نسخ JSONL للجلسات تحت ~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl (قابل للتكوين عبر PI_SESSIONS_DIR) واستخراج cwd من السجل الأول لكل جلسة؛ يتم اكتشاف مشاريع Gemini CLI بمسح ~/.gemini/tmp/<basename>/chats/session-<timestamp>-<uuid-prefix>.jsonl (قابل للتكوين عبر GEMINI_SESSIONS_DIR) واسترجاع cwd المعياري من علامة النص المجاورة .project_root. يتم عرض المشروع الذي تم استخدامه بواسطة عدة واجهات سطر أوامر كصف واحد مع جميع الشارات المطابقة. استخدم القائمة المنسدلة CLI فوق الجدول للتصفية حسب واجهة سطر أوامر محددة؛ يحافظ عنوان URL على اختيارك كـ ?cli=claude|codex|copilot|cursor|opencode|pi|gemini.
يظهر لكل مشروع:
- اسم المشروع (مشتق من مسار المجلد)
- شارة CLI —
Claude Code(برتقالي)،OpenAI Codex(بنفسجي)،GitHub Copilot(أزرق)،Cursor Agent(زمردي)،OpenCode(كهرماني)،Pi(وردي)، و/أوGemini CLI(سماوي) - تاريخ نشاط الجلسة الأحدث
الجلسات
يسرد جميع الجلسات ضمن مشروع. تعرض كل جلسة:- معرّف الجلسة
- طابع زمني للبدء والانتهاء
- عدد استدعاءات الأدوات
- عدد نشاط الخطاف (السياسات التي تم تفعيلها)
عارض الجلسة
يجيب عارض الجلسة على السؤال الأساسي للوكلاء المستقلين: ماذا فعل الوكيل، وهل ظل على المسار الصحيح؟ تشير شارة CLI بجانب الرأس إلى ما إذا كانت الجلسة نسخة Claude Code أو OpenAI Codex أو GitHub Copilot CLI أو Cursor Agent أو OpenCode أو Pi أو Gemini CLI. يعرض الجدول الزمني لكل ما حدث في جلسة:- الرسائل - استجابات Claude النصية وطلبات المستخدم
- استدعاءات الأدوات - كل أداة استدعاها Claude، مع مدخلاتها ومخرجاتها
- نشاط السياسة - لكل استدعاء أداة، السياسات التي تم تفعيلها والقرار الذي أرجعته
session / messages / parts الأساسية.
التدقيق
تقرير مشروط بالشخصية لكيفية تصرف وكيلك فعليًا عبر الجلسات السابقة. يقوم بتشغيل نفس الفحص الذي تقوم به واجهة سطر أوامرfailproofai audit لكنه يعرضه كلوحة تحكم بستة أقسام:
- الهوية — تصنف وكيلك إلى أحد 8 نماذج أولية (
المتفائل،رجل الغرب،المستكشف،سمك الذهب،معمار بارانويا،مُنشئ الدقة،المطرقة،الشبح) بناءً على محاكيات وسياسات فعلت و كم كانت ثقيلة. يعرض عديم الأبعاد بحجم 8×8 بكسل، والوسم النموذجي الأولي، و إطار عمل عام في/المخاطر الأساسية، والبيان الختامي الواحد. - اعرض وكيلك — يلتقط بطاقة الهوية كصورة PNG بحجم 1200×630 مناسبة للنشر على X / LinkedIn (انقر على
make poster). - القوى — السلوكيات المفحوصة باللون الأخضر التي يقوم بها وكيلك بالفعل بشكل صحيح، مشتقة من بيانات التدقيق الحية (معدل استدعاء الأداة النظيفة، متوسط طول الجلسة، عدم تسريب بيانات الاعتماد، عدم العواصف المتكررة، إلخ).
- النقاط + لوحة المتصدرين — درجة من 0 إلى 100 مع تقدير حرف واحد (S/A/B/C/D/F)، رسم بياني توزيع يوضح مكان وقوفك في المجموعة، وصياغة (البداية B في 71. أنت 13 نقطة بعيدًا)، وجدول لوحة المتصدرين مع تمييز صفك.
- الننتائج — بطاقات كل نتيجة مرتبة حسب التأثير. تعرض كل بطاقة ما حدث وما يكلفه، عينة إثبات مع أوامر مأسورة حقيقية، وسياسة failproofai التي ستلتقط نفس النمط (
$ failproofai policy add <slug>، اضغط للنسخ). - السياسات الموصوفة + حلقة العودة — شبكة من كل سياسة مدمجة غير مفعلة والتي ستسد الفجوة، مع تنبيه الدرجات المتوقعة، بالإضافة إلى رابط CTA للإعادة التدقيق خلال 7 أيام.
failproofai audit runtime — انظر Audit CLI للمحرك الفحص الأساسي والأعلام المدعومة وثوابت التخزين المؤقت لكل نسخة. تخزن لوحة التحكم النتيجة الأحدث في ~/.failproofai/audit-dashboard.json (الوضع 0600، فتحة واحدة، المسارات الجديدة تستبدل) بحيث تكون إعادات الزيارة فورية؛ يتم رفض كل من ذاكرة التخزين المؤقت لكل نسخة والنتيجة الكلية عند القراءة بمجرد أن تصبح أقدم من 7 أيام لذا فإن لوحة التحكم لا تخدم أبدًا بصمت نتيجة بعمر أسبوع — بعد انتهاء الصلاحية /audit يسقط إلى حالتها الفارغة ويطالب بتشغيل جديد. النقر على [ re-audit now ] بالقرب من أسفل التقرير ينشر /api/audit/run مع noCache: true — إعادة التدقيق تتجاوز ذاكرة التخزين المؤقت لكل نسخة وتعيد فحص كل نسخة من الصفر بدلاً من الإرجاع الصامت للنتيجة المخزنة مؤقتًا — ولوحة التحكم تستقصي /api/audit/status بتردد 1Hz حتى ينتهي التشغيل؛ شريط تقدم وردي لزج يتثبت في أعلى العرض أثناء التشغيل مع مقياس انقضاء الوقت، والنتيجة الطازجة تحل محل موضعها عند النجاح (بدون إعادة تحميل الصفحة الكاملة؛ قد تترك إعادة التدقيق الفاشلة التقرير السابق سليمة). عند الفشل يتحول الشريط إلى اللون الأحمر مع نسخ مفتاح من RerunError.kind (timeout / network / post_failed). يتم عرض الحالات الفارغة (لا توجد ذاكرة تخزين مؤقت أو انتهت صلاحيتها) وحالة الجلسات الصفر (توجد ذاكرة تخزين مؤقت لكن الفحص لم يجد نسخ) بشكل منفصل.
السياسات
صفحة ذات تبويبين لإدارة السياسات ومراجعة النشاط.- تبويب السياسات
- تبويب النشاط
- اختر متعدد التحديد أي واجهات سطر أوامر وكيل يحمي failproofai من لوحة واحدة — Claude Code و OpenAI Codex و GitHub Copilot و Cursor Agent و OpenCode و Pi و Gemini CLI جميعها لها صف مع حالة التثبيت (
نشط/مكتشف/غير نشط)، مسار إعدادات الدقة للمستخدم، وضغط ملون للعلامة التجارية. تحقق أو قم بإلغاء تحديد واجهات سطر الأوامر التي تريدها وانقر علىتطبيق التغييراتلتثبيت/إلغاء تثبيت الفرق في خطوة واحدة. يتم التحقق مسبقًا من واجهات سطر الأوامر التي تم اكتشاف الملف الثنائي الخاص بها على PATH. - قم بتبديل السياسات الفردية على أو إيقافها بنقرة واحدة (كتابة إلى
~/.failproofai/policies-config.json— مشترك في كل واجهة سطر أوامر مثبتة) - قم بتوسيع سياسة لتكوين معاملات الخاص بها (للسياسات التي تدعم
policyParams) - تعيين مسار ملف سياسات مخصص
التحديث التلقائي
تحتوي لوحة التحكم على مبدل التحديث التلقائي في الملاحة العليا. عند التفعيل، يتم تحديث الصفحة الحالية بشكل دوري لعرض الجلسات الجديدة ونشاط السياسة كما تظهر. ضرورية لمراقبة جلسات الوكيل المستقل طويلة المدى.تعطيل الصفحات
إذا كنت تحتاج فقط إلى بعض أجزاء لوحة التحكم، فقم بتعيينFAILPROOFAI_DISABLE_PAGES إلى قائمة مفصولة بفواصل من أسماء الصفحات:
policies، projects، audit.
تكوين مسار المشاريع
بشكل افتراضي، تقرأ لوحة التحكم من مجلد مشاريع Claude Code القياسي. قم بتجاوزه للإعدادات المخصصة:الوصول من مضيف غير localhost
عند تشغيل لوحة التحكم في وضع التطوير (npm run dev) والوصول إليها من اسم مضيف بخلاف localhost - على سبيل المثال، نطاق مخصص أو عنوان IP بعيد أو عنوان URL بنفق - قد ترى تحذيرًا مثل:
--allowed-origins:
FAILPROOFAI_ALLOWED_DEV_ORIGINS بدلاً من ذلك:
هذا ينطبق فقط على وضع التطوير. عند تشغيل
failproofai (وضع الإنتاج)، لا يوجد مأخذ HMR websocket ولا توجد مشكلة موارد dev عبر الأصول.