Code Keeper Bot - תיעוד API
- summary:
ברוכים הבאים לתיעוד ה-API של Code Keeper Bot!
בוט זה מספק ממשק טלגרם מתקדם לניהול ושמירת קטעי קוד, עם תמיכה בשפות תכנות מרובות, אינטגרציה עם GitHub, וכלי ניהול מתקדמים.
למפתחים ולסוכני AI:
- התחלה מהירה - סוכני AI
- התחלה מהירה - מפתחים
- Quickstart לתרומה
- הנחיות מלאות לסוכני AI
- 🚦 מערכת Rate Limiting לסוכני AI ולווב
- Doc Authoring Guide (Sphinx/RTD)
- Style & Naming Glossary
- Versioning & Stable Anchors
- What’s New
- 2026-09-27
- 2026-09-23
- 2026-09-22
- 2026-09-21
- 2026-09-20
- 2026-09-17
- 2026-09-16
- 2026-09-15
- 2026-09-14
- 2026-09-13
- 2026-09-10
- 2026-09-09
- 2026-09-08
- 2026-09-07
- 2026-09-06
- 2026-09-02
- 2026-09-01
- 2026-08-31
- 2026-08-25
- 2026-08-21
- 2026-01-29
- 2025-12-11
- 2025-11-11
- 2025-11-06
- 2025-11-05
- 2025-10-30
- 2025-10-29
- 2025-10-15
- ארכיטקטורה
- עקרונות להוספת פיצ’ר לסטיקי-נוטס
- היעד: בדיוק אחד, ובשכבה טהורה אחת
- המכסה:
fail-closed, והפטור-לאדמין שהורג מכסות בשקט - אינדקס ייחודי: ממוספר, ונבנה לפני שמפילים
- אכיפה שנבנית רק בצד אחד היא הבטחה שהצד השני מפר בשקט
- זהות לעומת נורמליזציה: אותה פונקציה בשני הקצוות
- יתומים: זיהוי בקריאה, לא בכתיבה
- מצב התזכורת: שדה אחד מתאר, שניים סוטים
- הדגימה: כשל אינו ”אין“, ו-401 אינו כשל
- רינדור בתצוגה:
innerHTMLאף פעם לא על טקסט לא-מהימן - עיגון שורה בפתקי ריפו: למה
anchoredאינו זמין - סדר:
flushלפני כל פעולה הרסנית - אינדקס המשימות: התאמה מלאה בין שרת ללקוח
- מה לבדוק, ובמה
- טבלאות: בלוק רב-שורתי בתוך מנוע של שורה-לשורה
- קינון רשימות: שאלה אחת, מקום אחד, ומקור מדיד
- בלוק קוד: כשצריכה של בלוק שלם מוחקת שלושה סייגים
- בלוקי אלרט: הבלוק הראשון שמכיל שורות אחרות
- העדפה שיש לה גם מצב ”רק במכשיר זה“
- גודל: מה שנקבע לעומת מה שנכנס
- גודל הטקסט: טוקן אחד, ולמה דווקא בפיקסלים
- גודל הטקסט בעמוד ההגדרות: מה שמסוכן יושב סביב הבורר
- מקור אחד למחלקה, ומקור אחד לסדר
- צבע: מזהה במסד,
hexנגזר, וכינוי במקום מיגרציה - חיפוש בפתקים: למה רג’קס ולא
$text - התיעוד למשתמש הוא חלק מהפיצ’ר
- מדריך תרומה
- Branch Protection & PR Rules
מדריכים בסיסיים:
API Reference:
עזרה ודוגמאות:
- דוגמאות שימוש
- Testing Guide
- דוגמאות טסטים – Rate Limiting ואסינכרוניות
- בדיקות ביצועים (Performance Tests)
- CI/CD Guide
- Conversation Handlers & States
- Troubleshooting Guide
- Development Workflow
- Pre-commit Hooks
- כלי עזר למפתחים
- סקריפטים שימושיים
scripts/cleanup_repo_tags.pyscripts/migrate_reminder_acked_status.pyscripts/dev_seed.py- scripts/import_snippets_from_markdown.py
scripts/measure_md_parse_cost.pyscripts/md_parser_upgrade_zero_diff.py- scripts/migrate_workspace_collections.py
scripts/run_log_aggregator.pyscripts/start_webapp.shscripts/start_with_worker.shscripts/run_all.sh
- בינאום ותמיכה בשפות
- Integrations
- שרת ה-MCP — חיבור Claude ל-CodeKeeper
- מה זה נותן
- ארכיטקטורה בקצרה
- מודל הריצה של הכלים
- הכלים
- הקבועים, התקרות ואוצר המילים של התשובה
- אימות והרשאות
- גבולות הבקשה — גודל הגוף והקצב
- עדכון תיאור בלי גרסה חדשה
- גיל התיאור —
description_age_versions - קריאת פתק בודד —
codekeeper_get_note - היסטוריית פתקים
- התראה כשסוכן שומר קובץ
- פריימר לסוכן —
GET /api/agent/primer - הפעלה — צעד אחר צעד
- חיבור לקוחות
- דפדפן הריפו — איך זה עובד
- איזה קובץ
docs_get_sectionקורא, ובאיזה ריפו - איפה מפת ה-Markdown חולקת על GitHub
- איך
docs_get_sectionמוצא כותרת - מפת סימבולים (
outline) - קריאת טווח שורות
- כמה מופעים יש באמת (
totalמולtotal_at_least) - חיפוש בתוך קובץ שמור (
query) - גודל וספירת שורות ברשימת הריפו
- קריאה קבוצתית —
codekeeper_read_batch - מדידת שימוש (PostHog MCP Analytics)
- אבטחה — עקרונות
- פתרון תקלות
- ראו גם
- 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)
- ספריית סניפטים (Web)
- 🧭 WebApp Onboarding – Welcome Modal, Interactive Tour & Theme Wizard
- Caching & HTTP Validators (ETag / Last-Modified / 304)
- מערכת Caching מתקדמת עם TTL דינמי
- Cache Inspector (לוח בקרה של Redis)
- Config Inspector (סקירת משתני סביבה)
- MCP Analytics (מדידת השימוש בכלי ה-MCP)
- 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
- /ban
- /unban
- /blocked
- /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 — גרסת המינימום והסיבה לה: התקנה והגדרה
MongoDB — גרסת המינימום והסיבה לה: התקנה והגדרה
Telegram Bot API Token
Redis (אופציונלי, לקאש)