الانتقال إلى المحتوى الرئيسي

​
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 المجاورة. يتم عرض المشروع الذي تم استخدامه بواسطة عدة CLIs كصف واحد مع جميع الشارات المطابقة. استخدم القائمة المنسدلة CLI أعلى الجدول للتصفية حسب CLI وكيل معين; يحافظ الرابط على اختيارك كـ ?cli=claude|codex|copilot|cursor|opencode|pi|gemini. يعرض كل مشروع:
  • اسم المشروع (المشتق من مسار المجلد)
  • شارة CLI — Claude Code (برتقالي)، OpenAI Codex (بنفسجي)، GitHub Copilot (أزرق)، Cursor Agent (أخضر، OpenCode (كهرماني)، Pi (وردي)، و/أو Gemini CLI (سماوي)
  • تاريخ نشاط الجلسة الأخيرة
انقر فوق مشروع لرؤية جلساته.

​
الجلسات

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

​
عارض الجلسة

يجيب عارض الجلسة على السؤال الأساسي للوكلاء المستقلين: ماذا فعل الوكيل، وهل ظل على المسار الصحيح؟ تشير شارة CLI بجانب الرأس إلى ما إذا كانت الجلسة نسخة Claude Code أو OpenAI Codex أو GitHub Copilot CLI أو Cursor Agent أو OpenCode أو Pi أو Gemini CLI. يعرض خطة زمنية لكل ما حدث في جلسة:
  • الرسائل - الردود النصية من Claude ومحفوزات المستخدم
  • استدعاءات الأدوات - كل أداة استدعاها Claude، مع إدخالاتها ومخرجاتها
  • نشاط السياسة - لكل استدعاء أداة، السياسات التي تم تفعيلها والقرار الذي أرجعته
يعرض شريط الإحصائيات في الأعلى مدة الجلسة، إجمالي استدعاءات الأدوات، وملخص قرارات hook (عدادات السماح / الرفض / الإرشاد). انقر على زر تنزيل السجلات لتصدير الجلسة. بالنسبة لجلسات Claude Code و Codex و Copilot و Cursor و Pi و Gemini، تحصل على نسخة النص الأصلية على القرص بالكامل; بالنسبة لـ OpenCode (التي تكون جلساتها في SQLite، وليس على القرص) تحصل على وثيقة JSON تعكس جداول session / messages / parts الأساسية.

​
التدقيق

تقرير بطابع شخصي عن كيفية تصرف وكيلك فعلياً عبر الجلسات الماضية. يقوم بنفس المسح الذي يقوم به CLI failproofai audit لكن يعرضه كملصق واحد على الشاشة قابل للمشاركة + أربعة أقسام تحت الطية:
  1. الملصق — يملأ منفذ العرض الأول. منطقة التقاط PNG مكتفية ذاتياً مع علامة failproof_ai · تسمية التدقيق · فهرس النمط الأصلي (№ NN من 08) + تاريخ التدقيق · نقطة عددية (0–100) + حبة تصنيف مئوي (أفضل 15%) · اسم النمط الأصلي (أحد المتفائل أو الرعديد أو المستكشف أو سمك الذهب أو المهندس المريب أو بناء الدقة أو المطرقة أو الشبح) + شريط الكلمات الثلاث · // فقط N% من الوكلاء لديهم هذا النمط الأصلي سطر الندرة · بلاط sigil 8×8 بكسل · تدقيق لك → failproof.ai تذييل. ثلاثة أزرار مشاركة خارج مربع الالتقاط: انشر نمطك الأصلي (X intent)، مشاركة على linkedin، تنزيل الملصق. يتم تشغيل الالتقاط عبر html-to-image بحيث يطابق PNG العرض على الشاشة بكسل تلو الآخر (حدود مسسحة، قناع شعار SVG، تدرجات، مقاييس الخط — كل شيء محفوظ).
  2. نقاط القوة — قائمة صفوف هادئة من السلوكيات التي يقوم بها وكيلك بالفعل بشكل صحيح، مستمدة من بيانات التدقيق المباشر (معدل استدعاء أداة نظيف، بدون دفع مباشر إلى main، تسريب بيانات اعتماد صفري، عدم حدوث عواصف إعادة محاولة) — يتم عرض كل منها فقط عندما تكون السياسة ذات الصلة نظيفة عبر نافذة التدقيق.
  3. المميزات الغريبة — جدول ما تسرب، مرتب حسب الشدة: عندما · ما تسرب + السياسة التي كانت ستلتقطه · حبة الشدة · رؤية، حيث تقرأ التكرار جديد (مرة واحدة)، N× رؤية (2–9 مرات)، أو متكرر (10+).
  4. كيفية التحسن — قائمة صفوف هادئة، واحد لكل سياسة موصى بها: اسم السياسة بالأبيض، وصف سطر واحد، أمر التثبيت + زر النسخ على الجانب الأيمن. يقرأ رأس القسم تفعيل الكل N → مشروع <score> · <tier> (النقطة التي ستصل إليها مع تطبيق كل إصلاح)، وزر [تثبيت الكل] الخاص به ينسخ أمر failproofai policy add a b c … المدمج لكل سياسة موصى بها.
  5. عودة بشكل أفضل — بطاقتان جنباً إلى جنب. اليسار: ضبط تذكير (3d / 7d / 14d / 30d منتقي الإيقاع; يستمر عبر /api/auth/reminder بعد المصادقة). اليمين: فتح مزايا failproof — دعوة صديق يفتح نافذة حوار تأخذ قائمة برسائل البريد الإلكتروني للأصدقاء المفصولة بفواصل/مسافات/أسطر جديدة (الحد الأقصى 10 لكل إرسال)، POSTs إلى /api/audit/invite، والتي تنقل إلى POST /v0/invite في خادم api. يرسل خادم api بريداً إلكترونياً واحداً لكل مستقبل من invite@failproof.ai مع إضافة المرسل بـ Cc وتعيين Reply-To، بحيث يرى المستقبل من دعاهم والمرسل يحصل على نسخة في صندوق البريد الخاص به. يتم توجيه المستخدمين المجهولين عبر AuthDialog أولاً بحيث تكون رسالة البريد الإلكتروني للمرسل معروفة قبل إرسال الدعوات. تحقيق الأحقية / الامتيازات هو المتابعة.
مدفوع بـ failproofai audit runtime — انظر Audit CLI لمحرك المسح الأساسي والأعلام المدعومة وثوابت الذاكرة المؤقتة لكل نسخة. تخزن لوحة المعلومات مؤقتاً أحدث نتيجة في ~/.failproofai/audit-dashboard.json (الوضع 0600، فتحة واحدة، تستبدل التشغيلات الجديدة) بحيث تكون الزيارات اللاحقة فورية; يتم رفض كل من ذاكرة التخزين المؤقت لكل نسخة ونتيجة كاملة عند القراءة بمجرد أن تصبح أقدم من 7 أيام بحيث لا تخدم لوحة المعلومات أبداً بصمت نتيجة بعمر أسبوع — بعد انتهاء الصلاحية /audit يسقط إلى حالته الفارغة ويطالب بتشغيل جديد. النقر على [ إعادة تدقيق الآن ] بالقرب من أسفل التقرير POSTs /api/audit/run مع noCache: true — إعادة التدقيق تجاوز ذاكرة التخزين المؤقت لكل نسخة وتعيد مسح كل نسخة من البداية بدلاً من إرجاع النتيجة المخزنة بصمت — ولوحة المعلومات تستطلع /api/audit/status عند 1Hz حتى انتهاء التشغيل; شريط تقدم وردي لزج يدبس إلى أعلى viewport أثناء التشغيل مع مؤقت انقضى، وتبديل النتيجة الطازجة في المكان عند النجاح (بدون إعادة تحميل كاملة للصفحة; إعادة تدقيق فاشلة تترك التقرير السابق سليماً). عند الفشل، يتحول الشريط إلى اللون الأحمر مع نسخ مفتاح من RerunError.kind (timeout / network / post_failed). تتم سطح الحالة الفارغة (بدون ذاكرة تخزين مؤقت أو منتهية الصلاحية) والحالة الخالية من الجلسات (توجد ذاكرة تخزين مؤقت ولكن لم يجد المسح نسخ) بشكل منفصل.

​
السياسات

صفحة بلسانين لإدارة السياسات ومراجعة النشاط.
  • حدد متعدد مع CLIs التي يحمي failproofai من لوحة واحدة — Claude Code و OpenAI Codex و GitHub Copilot و Cursor Agent و OpenCode و Pi و Gemini CLI كلها لها صف يحتوي على حالة التثبيت (Active / Detected / Inactive)، مسار إعدادات نطاق المستخدم، وضفة مميزة بعلامة تجارية. تحقق من مربعات CLIs التي تريدها أو ألغ تحديد مربع الاختيار وانقر فوق تطبيق التغييرات لتثبيت/إلغاء تثبيت الفارق في خطوة واحدة. CLIs التي يتم الكشف عن ملف تنفيذي الخاص بها على PATH يتم فحصه مسبقاً.
  • بدّل السياسات الفردية على أو إيقاف بنقرة واحدة (يكتب إلى ~/.failproofai/policies-config.json — مشترك في كل CLI مثبت)
  • توسيع سياسة لتكوين معاملات (للسياسات التي تدعم policyParams)
  • تعيين مسار ملف سياسات مخصص

​
الإنعاش التلقائي

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

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

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

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

بشكل افتراضي، تقرأ لوحة المعلومات من دليل مشاريع Claude Code القياسي. استبدله للإعدادات المخصصة:

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

عند تشغيل لوحة المعلومات في وضع dev (npm run dev) والوصول إليها من اسم مضيف بخلاف localhost - على سبيل المثال، مجال مخصص أو IP بعيدة أو URL موصولة — قد تظهر تحذير مثل:
هذا هو Next.js يمنع الوصول عبر الأصول إلى مورد HMR dev الخاص به (إعادة تحميل الوحدة الساخنة)، وهي ميزة dev فقط. للسماح لمضيفك، استخدم العلم --allowed-origins:
لعدة مضيفات أو IPs، مرر قائمة مفصولة بفواصل:
يمكنك أيضاً تعيين متغير البيئة FAILPROOFAI_ALLOWED_DEV_ORIGINS بدلاً من ذلك:
هذا ينطبق فقط على وضع dev. عند تشغيل failproofai (وضع الإنتاج)، لا يوجد websocket HMR ولا مشكلة مورد dev عبر الأصول.