דלג לתוכן הראשי
לוח הבקרה של failproofai היא אפליקציית ווב מקומית לניטור סשנים של סוכנים AI שלך וניהול מדיניות. ראה מה עשו הסוכנים שלך בזמן שלא היית.

​
הפעלת לוח הבקרה

failproofai
נפתח ב-http://localhost:8020. לוח הבקרה קורא ישירות מקובץ המערכת - תיקיות פרויקטי Claude Code שלך וקבצי הקונפיגורציה של failproofai. לא נכתב כלום לשירות מרחוק.

​
עמודים

​
Projects

מוצג רשימה של כל פרויקטי Claude Code שנמצאו במכונה שלך. פרויקטים מגוקלים מ-~/.claude/projects/ (או הנתיב שהוגדר על ידי CLAUDE_PROJECTS_PATH). כל פרויקט מוצג עם:
  • שם הפרויקט (נגזר מנתיב התיקייה)
  • מספר סשנים
  • תאריך של פעילות הסשן הקודם
לחץ על פרויקט כדי לראות את הסשנים שלו.

​
Sessions

מוצג רשימה של כל הסשנים בתוך פרויקט. כל סשן מוצג עם:
  • מזהה סשן
  • חותמות זמן של התחלה וסיום
  • מספר קריאות כלים
  • ספירת פעילות hook (מדיניות שהופעלו)
השתמש בסינון טווח התאריכים וחיפוש מזהה סשן כדי לצמצם את הרשימה. סשנים מחולקים לעמודים. לחץ על סשן כדי לפתוח את מציג הסשן.

​
Session viewer

מציג הסשן עונה על השאלה המרכזית עבור סוכנים עצמאיים: מה עשה הסוכן, והאם הוא נשאר בנתיב? הוא מוצג בציר הזמן של כל מה שקרה בסשן:
  • Messages - תגובות הטקסט של Claude והנושאים של המשתמש
  • Tool calls - כל כלי שClaude הפעיל, עם הקלט והפלט שלו
  • Policy activity - לכל קריאת כלים, איזו מדיניות הופעלה ואיזה החלטה היא החזירה
פס הסטטיסטיקה בחלק העליון מציג משך הסשן, סה”כ קריאות כלים וסיכום של החלטות hook (מספרי allow / deny / instruct). אתה יכול לייצא את הסשן כקובץ ZIP או JSONL באמצעות כפתור ההורדה.

​
Policies

עמוד דו-לשוני לניהול מדיניות ובדיקת פעילות.
  • הפוך מדיניות בודדות או כבויה בלחיצה יחידה (כותב ל-~/.failproofai/policies-config.json)
  • הרחב מדיניות כדי להגדיר את הפרמטרים שלה (עבור מדיניות התומכת ב-policyParams)
  • התקן או הסר hook עבור scope מסוים
  • הגדר נתיב קובץ מדיניות מותאם אישית

​
רענון אוטומטי

לוח הבקרה יש כפתור רענון אוטומטי בניווט העליון. כאשר הוא מופעל, הדף הנוכחי מרענן בתדירות קבועה כדי להציג סשנים חדשים ופעילות מדיניות כפי שהם מופיעים. חיוני לניטור סשנים של סוכן עצמאי שרץ לפי זמן.

​
השבתת עמודים

אם אתה צריך רק חלקים מסוימים של לוח הבקרה, הגדר את FAILPROOFAI_DISABLE_PAGES לרשימה מופרדת בפסיקים של שמות עמודים: 
FAILPROOFAI_DISABLE_PAGES=policies failproofai
ערכים חוקיים: policies, projects.

​
ערכת נושאים

לוח הבקרה תומך במצב בהיר וכהה. הפוך דרך הכפתור בסרגל הניווט. ההעדפה מאוחסנת בפחיות האחסון המקומי של הדפדפן שלך.

​
הגדרת נתיב הפרויקטים

כברירת מחדל, לוח הבקרה קורא מספרייה הפרויקטים הסטנדרטית של Claude Code. עקוף אותו להגדרות מותאמות אישית: 
CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai

​
גישה מחשב יחידה שלא localhost

כאשר מפעילים את לוח הבקרה ב-dev mode (npm run dev) וגישה אליו מ-hostname שאינו localhost - לדוגמה, דומיין מותאם אישית, IP מרחוק או URL מנהור - ייתכן שתראה אזהרה כמו: 
⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
זה Next.js חוסם גישה חוצה-origin ל-websocket HMR (hot module reload) שלו, שהיא תכונה dev-only. כדי לאפשר את ה-host שלך, השתמש בדגל --allowed-origins: 
npm run dev -- --allowed-origins dashboard.example.com
עבור מספר hosts או IPs, העבר רשימה מופרדת בפסיקים: 
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
זה חל רק על dev mode. כאשר מפעילים failproofai (production mode), אין websocket HMR ואין בעיית משאב dev cross-origin.