Code Keeper Bot - תיעוד API
ברוכים הבאים לתיעוד ה-API של Code Keeper Bot!
בוט זה מספק ממשק טלגרם מתקדם לניהול ושמירת קטעי קוד, עם תמיכה בשפות תכנות מרובות, אינטגרציה עם GitHub, וכלי ניהול מתקדמים.
למפתחים ולסוכני AI:
מדריכים בסיסיים:
API Reference:
עזרה ודוגמאות:
- דוגמאות שימוש
- Testing Guide
- דוגמאות טסטים – Rate Limiting ואסינכרוניות
- בדיקות ביצועים (Performance Tests)
- CI/CD Guide
- Conversation Handlers & States
- Troubleshooting Guide
- Development Workflow
- Pre-commit Hooks
- כלי עזר למפתחים
- סקריפטים שימושיים
- בינאום ותמיכה בשפות
- Integrations
- Repository Integrations
- Security Guide
- Smart Observability v7 – Predictive Health & Adaptive Feedback
- Git LFS Integration
- סימניות (Bookmarks)
- פתקים דביקים (Sticky Notes)
- תזכורות בבוט
- האוספים שלי (My Collections)
- שיתוף קוד (חשוב)
- עיון בקוד GitHub (כולל חיפוש בשם קובץ)
- הורדת ריפו
- תכנית בדיקות לבוט – Composition Root (Container) לשירות Snippet
זרימות עבודה:
מנועי המערכת:
- מנועי המערכת (System Engines)
- סקירה כללית
- מנוע חיפוש (Search Engine)
- מנוע רפקטורינג (Refactoring Engine)
- יכולות מתקדמות (Smart Clustering, Cycle Guard)
- מצב שכבות (Layered Mode)
- Safe Decomposition ל‑models.py (פיצול בטוח לחבילת models/)
- מעבד קוד (Code Processor)
- מנוע ניתוח (Code Analyzer)
- מנוע גיבויים (Backup Service)
- מנוע אינטגרציות (Integration Services)
- מנוע Observability
- קישורים
Edge Cases וטיפול בשגיאות:
הערה
חלק מהפיצ’רים (Bookmarks, Collections, Sticky Notes) זמינים ב‑WebApp בלבד (לא בבוט). ראו המיני Web App (סקירה) לפרטים נוספים.
איכות וקונבנציות:
WebApp:
- המיני Web App (סקירה)
- דפדפן קוד (Code Browser)
- Web Push – Sticky Notes Reminders
- ממשקי משתמשים (Web)
- ספריית סניפטים (Web)
- 🧭 WebApp Onboarding – Welcome Modal, Interactive Tour & Theme Wizard
- Caching & HTTP Validators (ETag / Last-Modified / 304)
- מערכת Caching מתקדמת עם TTL דינמי
- Cache Inspector (לוח בקרה של Redis)
- Static Performance & Security Checklist (gzip/br, Cache, SRI)
- תחזוקת קטלוג הפקודות (
commands.json) - הרצת קוד (Code Execution Playground)
- WebApp API Reference
- Bulk actions (בחירה מרובה)
- ⌨️ עורך קוד (WebApp Editor)
- Markdown – מצב מצומצם (קיפול כותרות ###) – אדמין בלבד
- מדריך סגנונות וארכיטקטורת Markdown
- Smooth Scrolling (WebApp) — מדריך תמציתי לסוכני AI
- מודולים פנימיים ב-WebApp
activity_tracker.py– דגימת פעילות משתמשיםcommunity_library_api.py– REST עבור אוסף הקהילהcommunity_library_ui.py– תצוגת Websnippet_library_api.pyו-snippet_library_ui.pypush_api.py– Web Push Subscriptionsworkspace_api.py– ניהול Kanban (Workspaces)config_radar.py– רנטגן קונפיגורציה- איך להשתמש בעמוד זה
Frontend > Theming
Observability
- אובזרווביליות (Observability)
- Background Jobs Monitor
- 📡 Observability Dashboard & API
- Query Performance Profiler
- 🧠 Quick Fix חכם (Queue Delay + עומס/DB) – הנחיות למפתחים ולסוכני AI
- Asyncio תחת WSGI: הרצת קורוטינות בבטחה
- Visual Rule Engine - מנוע כללים ויזואלי
- Coverage Report (Runbooks / Quick Fixes)
- 🧠 Observability AI Explain API
- Rate Limiting
- 📊 הנחיות Observability ואירועים
- סכמת לוגים ואירועים (Observability)
- מדדים (Metrics)
- Resilience לשירותים חיצוניים
- התראות (Alerts)
- התראות מבוססות לוגים (Log‑based Alerts)
- מה זה ולמה
- הרכיבים בקוד
- קבצי קונפיג
- Option B – חיבור בתוך הקוד (מומש)
- Option A – Sidecar מזרם לוגים
- ספים וקיבוץ – ברירות מחדל
- אסטרטגיית fingerprint וקנוניקליזציה
- צ’קליסט למפתחים
- בדיקה מקומית (סימולציה)
- הנחיות לסוכני AI
- אבטחה ופרטיות
- Rollout מומלץ
- Troubleshooting
- ראו גם
- קישורים לקוד
- טקסונומיית שגיאות וחתימות
- תצוגה ב‑ChatOps
- קריאת המשך –
classify_error()
- מנוע ניתוח לוגים (Log Event Aggregator)
- Sentry
- Incident Checklist (On‑Call)
- שינוי רמות לוגים
- GitHub Backup & Restore Runbook
- Runbooks – SLO Incidents
פריסה ו-Workers
ChatOps
- ChatOps – סקירה כללית
- פקודות ChatOps
- כרטיסיות חיפוש (Ctrl/Cmd+K)
- /status
- /health
- /uptime
- /system_info
- /check commands
- /metrics
- /observe
- /observe -v (מפורט)
- /observe -vv (מפורט מאוד)
- /errors
- /alerts
- /jobs
- /incidents
- /triage
- /predict
- /accuracy
- /rate_limit
- /enable_backoff
- /disable_backoff
- /sen
- /lang
- /lang_debug
- /dm
- /silence
- /unsilence
- /silences
- /cache_stats
- /clear_cache
- /cache_warm
- /cache_clear_stale
- /debug_cache
- /status_worker
- /version_history
- ChatOps – /observe: הרחבות -v ו- -vv
- הגבלת קצב לפקודות רגישות
- Playbooks – תרחישים נפוצים
- הרשאות ו-Rate Limit
- פתרון תקלות (FAQ)
- שאלות נפוצות
Observability – Advanced
סקירה כללית
Code Keeper Bot הוא בוט טלגרם מתקדם המאפשר:
💾 שמירה וניהול של קטעי קוד
🔍 חיפוש מתקדם בקוד
🎨 הדגשת תחביר לשפות תכנות מרובות
📊 סטטיסטיקות שימוש מפורטות
🔗 אינטגרציה עם GitHub
📦 גיבוי ושחזור נתונים
🔐 אבטחה והצפנה
📑 סימניות ואוספים - ארגון מתקדם של הקוד
📝 פתקים דביקים - הערות ויזואליות
⏰ תזכורות - ניהול זמן ומשימות
תכונות עיקריות
- ניהול קוד:
שמירת קטעי קוד עם מטא-דאטה
תמיכה בשפות תכנות מרובות
הדגשת תחביר אוטומטית
חיפוש וסינון מתקדם
- אינטגרציות:
העלאה ל-GitHub Gist
ייצוא לפורמטים שונים
שיתוף קוד בקלות
- כלי ניהול:
גיבוי אוטומטי
סטטיסטיקות שימוש
ניהול משתמשים
- ארגון וניהול אישי:
סימניות (Bookmarks) - סימון נקודות חשובות בקוד
אוספים (Collections) - ארגון קבצים לפי נושאים
פתקים דביקים (Sticky Notes) - הערות ויזואליות על הקוד
מועדפים (Favorites) - סימון קבצים חשובים
תזכורות (Reminders) - תזכורות זמן משימות
התחלה מהירה
from main import create_application
from config import config
# יצירת אפליקציית הבוט
app = create_application(config.BOT_TOKEN)
# הפעלת הבוט
app.run_polling()
דרישות מערכת
Python 3.9+
MongoDB 4.4+
Telegram Bot API Token
Redis (אופציונלי, לקאש)