דלג לתוכן הראשי

​
title: לוח בקרה description: “עקוב אחר הפעלות של סוכן, בדוק קריאות כלים וניהול מדיניות” icon: chart-line

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

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

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

​
עמודים

​
Projects

מציג את כל פרויקטי 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 מרובים מתבטא כשורה אחת עם כל התגים התואמים. השתמש בתפריט הנפתח CLI מעל הטבלה כדי לסנן לפי סוכן CLI ספציפי; ה-URL שומר את בחירתך כ-?cli=claude|codex|copilot|cursor|opencode|pi|gemini. כל פרויקט מציג:
  • שם פרויקט (נגזר מנתיב התיקייה)
  • תג CLI — Claude Code (כתום), OpenAI Codex (סגול), GitHub Copilot (כחול), Cursor Agent (ירוק זמרד), OpenCode (חום), Pi (ורוד), ו/או Gemini CLI (תכלת)
  • תאריך של פעילות הפעלה האחרונה
לחץ על פרויקט כדי לראות את הפעלותיו.

​
Sessions

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

​
מציג הפעלה

מציג ההפעלה עונה על השאלה הקריטית לסוכנים אוטונומיים: מה עשה הסוכן, והאם היה על מסלול? תג CLI ליד הכותרת מציין האם ההפעלה היא תמליל Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor Agent, OpenCode, Pi, או Gemini CLI. הוא מציג ציר זמן של כל מה שקרה בהפעלה:
  • Messages - תגובות טקסט של Claude והנחיות משתמש
  • Tool calls - כל כלי שהפעיל Claude, עם הקלט והפלט שלו
  • Policy activity - לכל קריאת כלי, איזה מדיניות נורתה ואיזה החלטה היא החזירה
סרגל הסטטיסטיקה בחלק העליון מציג את משך ההפעלה, סך כל קריאות הכלים וסיכום החלטות ה-hook (ספירות allow / deny / instruct). לחץ על כפתור Download Logs כדי לייצא את ההפעלה. לאחסון Claude Code, Codex, Copilot, Cursor, Pi, ו-Gemini אתה מקבל את תמליל JSONL המקורי בדיסק בדיוק בתמונה; ל-OpenCode (שההפעלות שלו חיות ב-SQLite, לא על דיסק) אתה מקבל מסמך JSON המשקף את הטבלאות session / messages / parts הבסיסיות.

​
Audit

דוח מונע אישיות על איך הסוכן שלך התנהג בפועל על פני הפעלות קודמות. מריץ את אותה סריקה כמו CLI failproofai audit אבל מרנדר אותה כלוח בקרה של שישה סעיפים:
  1. Identity — מסווג את הסוכן שלך לאחד משמונה אב-טיפוסים (the optimist, the cowboy, the explorer, the goldfish, the paranoid architect, the precision builder, the hammer, the ghost) בהתבסס על איזה גלאים + מדיניות נורתה וכמה כבד. מרנדר סיגיל של 8×8 פיקסל, קו הרגשת האב-טיפוס, מסגור common in / primary risk, וקו הסיום של משפט אחד.
  2. Show off your agent — לוכד את כרטיס הזהות כ-PNG של 1200×630 המתאים להודעה על X / LinkedIn (לחץ על make poster).
  3. Strengths — התנהגויות בדקויות בירוק שהסוכן שלך כבר עושה נכון, נגזר מנתוני האודיט החיים (שיעור קריאות כלים נקי, אורך הפעלה ממוצע, אפס דליפות אישור, אפס סערות חזרה, וכו’).
  4. Score + leaderboard — ציון 0–100 עם ציון אות (S/A/B/C/D/F), היסטוגרמת הפצה המראה היכן אתה נופל בקוהורט, פרוזה (a B starts at 71. you’re 13 points away.), וטבלת לוח דירוג עם השורה שלך מודגשת.
  5. Findings — כרטיסי ממצאים בעל דרגה לפי השפעה. כל כרטיס משטח מה קרה, מה זה עולה, דוגמת ראיות עם פקודות נלכדות בפועל, והמדיניות failproofai שתוכל לתפוס את אותה דפוס ($ failproofai policy add <slug>, click-to-copy).
  6. Prescribed policies + return loop — רשת של כל מדיניות בנויה שאינה מופעלת שתסגור רווח, עם קריאה לפעולה של ציון צפוי, בתוספת CTA של re-audit in 7 days.
מופעל על ידי זמן ריצה של failproofai audit — ראה Audit CLI למנוע הסריקה הבסיסי, דגלים נתמכים, ו-per-transcript cache invariants. לוח הבקרה מטמן את התוצאה האחרונה ב-~/.failproofai/audit-dashboard.json (מצב 0600, משבצת יחידה, ריצות חדשות דורסות) כך שביקורים חוזרים מתבצעים במיידיות; גם המטמון ה-per-transcript וגם המטמון של כל התוצאה נדחים בקריאה ברגע שהם מעוד 7 ימים כך שלוח הבקרה לעולם לא מסרת בשקט תוצאה בן שבוע - עבר TTL /audit נופל לתוך המצב הריק שלו ומהנה ריצה טרייה. לחיצה על [ re-audit now ] ליד תחתית הדוח POSTs /api/audit/run עם noCache: true — re-audit עוקף את המטמון ה-per-transcript ו-rescans כל תמליל מאפס ולא שתיקה מחזיר את התוצאה המטמונה — ולוח הבקרה סקר /api/audit/status ב-1Hz עד שהריצה מסתיימת; רצועת התקדמות ורודה דביקה משטח קשוח לחלק העליון של ה-viewport במהלך הריצה עם טיימר עברתי, והתוצאה הטרייה מחליפה במקום בהצלחה (לא ריל עדכון עמוד מלא; re-audit שנכשל משאיר את הדוח הקודם שלם). בכישלון הרצועה הופכת לאדומה עם עותק שזכור שהם RerunError.kind (timeout / network / post_failed). המצב הריק (אין מטמון או פג תוקף) ומצב אפס הפעלות (מטמון קיים אבל הסריקה לא מצאה תמלילים) משטחים בנפרד.

​
Policies

עמוד שתי-לשונות לניהול מדיניות וביקורת פעילות.
  • בחר בעותות מרובים אילו סוכני CLIs failproofai מגנים מלוח יחיד — Claude Code, OpenAI Codex, GitHub Copilot, Cursor Agent, OpenCode, Pi, ו-Gemini CLI כולם יש שורה עם מצב התקנה (Active / Detected / Inactive), נתיב הגדרות ה-user-scope, והדגשה בצבע מותג. סימן או בטל סימן מ-CLIs שאתה רוצה ולחץ על Apply changes כדי להתקין/להסיר את ההבדל בשלב אחד. CLIs שלהם בינארי מתגלה ב-PATH מנוקבים מראש.
  • החלף מדיניות בודדות על או כבוי עם לחיצה אחת (כותב ל-~/.failproofai/policies-config.json — חולק על כל CLI מותקן)
  • הרחב מדיניות כדי להגדיר את הפרמטרים שלה (למדיניות תומכת policyParams)
  • הגדר נתיב קובץ מדיניות מותאם אישית

​
Auto-refresh

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

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

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

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

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

​
גישה מהוסט שאינו-localhost

כאשר מפעילים את לוח הבקרה ב-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 חוסם גישה cross-origin לתיקיית HMR (hot module reload) שלו, שהיא תכונה ב-dev-only. כדי לאפשר את ה-host שלך, השתמש בדגל --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
זה חל רק על dev mode. כאשר מפעילים failproofai (production mode), אין תיקיית HMR websocket ואין בעיית cross-origin dev resource.