Skip to main content

title: تدقيق الجلسات السابقة (beta) description: “عد عدد المرات التي قام فيها الوكيل بعمليات غير ضرورية أو محفوفة بالمخاطر عبر النصوص السابقة”

ميزة تجريبية. يتم شحن التدقيق كإصدار تجريبي بينما نجمع الملاحظات المبكرة. قد تتغير كتالوج الكاشفات وتنسيق التقرير قبل الإصدار المستقر التالي. يرجى فتح مشكلة إذا بدا شيء غير صحيح.
يعيد التدقيق تشغيل نصوص مكتب وكيل CLI الخاصة بك عبر محرك السياسة في failproofai ويعرض تقريراً مرئياً قابلاً للمشاركة على صفحة لوحة التحكم /audit — نمط الوكيل، درجة من 0-100، والسياسات التي كان يمكنها اكتشاف ما بالضبط.

تشغيله

ثلاث طرق للدخول — جميعها تصل إلى نفس تقرير /audit.

بدون تثبيت

npx -y failproofai audit يجلب failproofai ويشغل المسح ويفتح لوحة التحكم لك — لا حاجة لتثبيت أي شيء أولاً.

من سطر الأوامر

failproofai audit يشغل المسح في طرفيتك، ثم يفتح localhost:8020/audit تلقائياً عند انتهائه.

من لوحة التحكم

شغّل failproofai وانقر على Audit في شريط التنقل (بين Policies و Projects)، أو افتح /audit مباشرة.
شغّل failproofai audit -h (أو --help) لرؤية الاستخدام. يعمل التدقيق بالكامل بلا اتصال — لا تحتاج إلى حساب أو شبكة — ولوحة التحكم تستمر في الخدمة حتى تيقفها باستخدام Ctrl+C.
تفحص لوحة التحكم نصوص agent CLI السابقة على هذا الجهاز (Claude Code, Codex, Copilot, Cursor, OpenCode, Pi) وتبلغ عن عدد المرات التي قام فيها الوكيل بأشياء مُعدّة failproofai للتوقف عنها — فحوصات متغيرات البيئة، push forces، بادئات cd <cwd> المكررة، حلقات sleep-polling، إعادة قراءة الملفات التي تم تعديلها للتو، والمزيد. لكل نص، يتم إعادة تشغيل كل حدث استخدام أداة عبر 39 سياسة مدمجة و عبر 8 كاشفات خاصة بالتدقيق التي تلتقط الأنماط غير المغطاة بعد بسياسات وقت التشغيل. يتم تجميع الأعداد لكل سياسة / كاشف عبر جميع الجلسات.

ما الذي تحصل عليه

صفحة /audit هي ملصق على شاشة واحدة قابل للمشاركة يتبعه أربعة أقسام تحت التوسيط:
  1. الملصق — هوية الوكيل في لمحة: النمط (أحد 8 — optimist، cowboy، explorer، goldfish، paranoid architect، precision builder، hammer، ghost)، كلمات الشخصية الخاصة به، مدى ندرة هذا النمط، ودرجة من 0-100 مع فئة (S إلى bottom tier). مُصنع للمشاركة — انشره على X أو LinkedIn، أو حمّله كصورة PNG.
  2. // strengths — ما يقوم به الوكيل جيداً بالفعل، كأرقام حقيقية من المسح (مثل clean-tool-call %، 0 push-to-main attempts)، معروضة فقط حيث تحتوي السياسة ذات الصلة على سجل نظيف.
  3. // quirks — ما انزلق عبره: جدول مصنف من السلوكيات التي كان failproofai سيكتشفها — متى حدثت آخر مرة، ما الذي انزلق (والأداة المدمجة التي كانت ستحجبها)، الخطورة، وعدد مرات مشاهدتها (new / recurring / N× seen).
  4. // how to improve — قائمة الإصلاح الموصوفة: صف واحد لكل سياسة مع failproofai policy add <slug> قابل للنسخ واللصق، بالإضافة إلى زر install all يفعّل كل توصية في وقت واحد ويعرض الدرجة المتوقعة إذا قمت بذلك.
  5. // come back better — بناء العادة: اضبط تذكير إعادة تدقيق بالبريد الإلكتروني (3d / 7d / 14d / 30d) أو أعد التدقيق الآن، وادعُ صديقاً لتشغيل التدقيق الخاص به (مرسل من failproof.ai، مع نسخة لك). التذكيرات والدعوات تتطلب تسجيل الدخول.

التدقيقات المجدولة

إذا شغّلت daemon failproofaid (انظر failproofai config)، يمكنه إعادة تشغيل التدقيق لك على جدول زمني وتحديث تقرير /audit في الخلفية. يكون معطلاً بشكل افتراضي، لأن المسح يقرأ المحتويات من كل نص جلسة وكيل على هذا الجهاز — لا يفحص أي شيء على مؤقت حتى تطلب ذلك. شغّله في ~/.failproofai/config.toml:
  • الجدول الزمني هو wall-clock، لذا فهو ينجو من التعليق والتمهيد: جهاز محمول كان في وضع السكون بعد وقت استحقاقه ينفذ مرة واحدة عند الاستيقاظ، أبداً لا توجد قائمة انتظار.
  • كل تشغيل هو عملية منفصلة ذات أولوية منخفضة (nice 19) — أبداً لا طريق hook الخاص بـ daemon، الذي يبقى حراً للإجابة على استدعاءات الأدوات.
  • يتم تخطي المسح إذا كان failproofai audit أو إعادة تشغيل لوحة التحكم قيد الرحلة بالفعل؛ تتم إعادة محاولته قريباً بدلاً من اعتباره فشلاً.
  • يتم كتابة التقدم إلى ~/.failproofai/state/audit-schedule.json (آخر تشغيل، التالي المستحق). يمتلك daemon هذا الملف — غيّر الإيقاع في config.toml.
إذا فعّلت هذا على جهاز تم إعداده بواسطة failproofai أقدم، شغّل failproofai config مرة واحدة. تعريف خدمة daemon يحتاج إلى إدخال إضافي واحد قبل أن تتمكن من تشغيل CLI، والتحديث هو جزء من هذا الأمر.

كاشفات خاصة بالتدقيق فقط

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

التخزينات المؤقتة

  • تخزين مؤقت لكل نص في ~/.failproofai/cache/audit/<sha1>.json مفهرسة بـ (mtime, size, engineVersion, detectorVersion) — تبطل تلقائياً عند تغيير النص أو كود السياسة/الكاشف. يخزن كل إدخال أيضاً طابع زمني cachedAt كـ بيانات وصفية TTL (ليست جزءاً من مفتاح التخزين المؤقت)؛ يتم رفض الإدخالات الأقدم من 7 أيام عند القراءة بحيث لا تتجاوز النتائج طويلة العمر الهدف المتطور للكاشف.
  • تخزين مؤقت للنتيجة الكاملة في ~/.failproofai/audit-dashboard.json (mode 0600). يسمح لوحة التحكم بالعرض الفوري عند التنقل بدون إعادة تشغيل. يتم رفضه أيضاً عند القراءة بعد 7 أيام TTL — ثم ينخفض /audit إلى حالته الفارغة ويطالب بتشغيل جديد. انقر على [ re-audit now ] بالقرب من أسفل التقرير للتحديث — تُرسل إعادة التدقيق noCache: true، لذا فهو يتجاوز التخزين المؤقت لكل نص ويعيد فحص كل نص بدلاً من إرجاع النتيجة المخزنة مؤقتاً؛ يتدفق التشغيل التقدم عبر شريط ثابت في الأعلى ويستبدل النتيجة في المكان عند النجاح (بدون إعادة تحميل الصفحة؛ فشل إعادة التدقيق يحتفظ بالتقرير السابق).

ملاحظات

  • بدون تعديل. يعاد تشغيل التدقيق في وضع القراءة فقط. يتم تخطي warn-repeated-tool-calls لأن الملف الجانبي لكل جلسة قد يتم تعديله بخلاف ذلك.
  • سياسات سير العمل معطلة. سياسات require-*-before-stop تعمل فقط على أحداث Stop و execSync ضد حالة git الحية — ليس لديها تفسير “ماذا كان سيحدث في 2025” ذو معنى، لذا لا تظهر في عدد التدقيق.
  • السياسات المخصصة معطلة. السنانير المخصصة المُزودة من قبل المستخدم لا تتم إعادة تشغيلها (قد تكون قد تغيرت منذ الجلسة الأصلية).