Skip to content

README.he.md

Latest commit

 

History

History
303 lines (222 loc) · 14.6 KB

README.he.md

File metadata and controls

303 lines (222 loc) · 14.6 KB

🌐 זהו תרגום אוטומטי. תיקונים מהקהילה יתקבלו בברכה!


Claude-Mem

🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk

מערכת דחיסת זיכרון מתמשך שנבנתה עבור Claude Code.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview

התחלה מהירה • איך זה עובד • כלי חיפוש • תיעוד • הגדרות • פתרון בעיות • רישיון

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

התחלה מהירה

התחל הפעלה חדשה של Claude Code בטרמינל והזן את הפקודות הבאות:

> /plugin marketplace add thedotmack/claude-mem

> /plugin install claude-mem

הפעל מחדש את Claude Code. הקשר מהפעלות קודמות יופיע אוטומטית בהפעלות חדשות.

תכונות עיקריות:

  • 🧠 זיכרון מתמשך - הקשר שורד בין הפעלות
  • 📊 גילוי מדורג - אחזור זיכרון רב-שכבתי עם נראות עלות טוקנים
  • 🔍 חיפוש מבוסס-מיומנויות - שאל את היסטוריית הפרויקט שלך עם מיומנות mem-search
  • 🖥️ ממשק צופה אינטרנט - זרימת זיכרון בזמן אמת ב-http://localhost:37777
  • 💻 מיומנות Claude Desktop - חפש זיכרון משיחות Claude Desktop
  • 🔒 בקרת פרטיות - השתמש בתגיות <private> כדי להוציא תוכן רגיש מהאחסון
  • ⚙️ הגדרות הקשר - בקרה מדויקת על איזה הקשר מוזרק
  • 🤖 פעולה אוטומטית - אין צורך בהתערבות ידנית
  • 🔗 ציטוטים - הפנה לתצפיות קודמות עם מזהים (גישה דרך http://localhost:37777/api/observation/{id} או צפה בכולם בצופה האינטרנט ב-http://localhost:37777)
  • 🧪 ערוץ בטא - נסה תכונות ניסיוניות כמו Endless Mode דרך החלפת גרסאות

תיעוד

📚 צפה בתיעוד המלא - דפדף באתר הרשמי

תחילת העבודה

שיטות מומלצות

  • הנדסת הקשר - עקרונות אופטימיזציה של הקשר לסוכן AI
  • גילוי מדורג - הפילוסופיה מאחורי אסטרטגיית הכנת ההקשר של Claude-Mem

ארכיטקטורה

הגדרות ופיתוח

איך זה עובד

רכיבי ליבה:

  1. 5 Lifecycle Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 סקריפטי hook)
  2. התקנה חכמה - בודק תלויות עם מטמון (סקריפט pre-hook, לא lifecycle hook)
  3. שירות Worker - HTTP API על פורט 37777 עם ממשק צופה אינטרנט ו-10 נקודות קצה לחיפוש, מנוהל על ידי Bun
  4. מסד נתוני SQLite - מאחסן הפעלות, תצפיות, סיכומים
  5. מיומנות mem-search - שאילתות בשפה טבעית עם גילוי מדורג
  6. מסד נתוני וקטורים Chroma - חיפוש היברידי סמנטי + מילות מפתח לאחזור הקשר חכם

ראה סקירה כללית של הארכיטקטורה לפרטים.

מיומנות mem-search

Claude-Mem מספק חיפוש חכם דרך מיומנות mem-search שמופעלת אוטומטית כשאתה שואל על עבודה קודמת:

איך זה עובד:

  • פשוט שאל באופן טבעי: "מה עשינו בהפעלה האחרונה?" או "תיקנו את הבאג הזה קודם?"
  • Claude מפעיל אוטומטית את מיומנות mem-search כדי למצוא הקשר רלוונטי

פעולות חיפוש זמינות:

  1. חיפוש תצפיות - חיפוש טקסט מלא על פני תצפיות
  2. חיפוש הפעלות - חיפוש טקסט מלא על פני סיכומי הפעלות
  3. חיפוש Prompts - חיפוש בקשות משתמש גולמיות
  4. לפי מושג - חיפוש לפי תגיות מושג (discovery, problem-solution, pattern, וכו')
  5. לפי קובץ - חיפוש תצפיות המתייחסות לקבצים ספציפיים
  6. לפי סוג - חיפוש לפי סוג (decision, bugfix, feature, refactor, discovery, change)
  7. הקשר אחרון - קבל הקשר הפעלות אחרון לפרויקט
  8. ציר זמן - קבל ציר זמן מאוחד של הקשר סביב נקודת זמן ספציפית
  9. ציר זמן לפי שאילתה - חפש תצפיות וקבל הקשר ציר זמן סביב ההתאמה הטובה ביותר
  10. עזרה ל-API - קבל תיעוד API חיפוש

דוגמאות לשאילתות בשפה טבעית:

"What bugs did we fix last session?"
"How did we implement authentication?"
"What changes were made to worker-service.ts?"
"Show me recent work on this project"
"What was happening when we added the viewer UI?"

ראה מדריך כלי חיפוש לדוגמאות מפורטות.

תכונות בטא

Claude-Mem מציע ערוץ בטא עם תכונות ניסיוניות כמו Endless Mode (ארכיטקטורת זיכרון ביומימטית להפעלות מורחבות). החלף בין גרסאות יציבות ובטא מממשק הצופה האינטרנט ב-http://localhost:37777 → Settings.

ראה תיעוד תכונות בטא לפרטים על Endless Mode ואיך לנסות אותו.

דרישות מערכת

  • Node.js: 18.0.0 ומעלה
  • Claude Code: גרסה אחרונה עם תמיכה בתוספים
  • Bun: סביבת ריצה ומנהל תהליכים של JavaScript (מותקן אוטומטית אם חסר)
  • uv: מנהל חבילות Python לחיפוש וקטורי (מותקן אוטומטית אם חסר)
  • SQLite 3: לאחסון מתמשך (מצורף)

הגדרות

ההגדרות מנוהלות ב-~/.claude-mem/settings.json (נוצר אוטומטית עם ברירות מחדל בהפעלה הראשונה). הגדר מודל AI, פורט worker, ספריית נתונים, רמת לוג, והגדרות הזרקת הקשר.

ראה מדריך הגדרות לכל ההגדרות הזמינות ודוגמאות.

פיתוח

ראה מדריך פיתוח להוראות בנייה, בדיקה, ותהליך תרומה.

פתרון בעיות

אם אתה נתקל בבעיות, תאר את הבעיה ל-Claude ומיומנות troubleshoot תאבחן אוטומטית ותספק תיקונים.

ראה מדריך פתרון בעיות לבעיות נפוצות ופתרונות.

דיווחי באגים

צור דיווחי באגים מקיפים עם המחולל האוטומטי:

cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report

תרומה

תרומות מתקבלות בברכה! אנא:

  1. עשה Fork למאגר
  2. צור ענף תכונה
  3. בצע את השינויים שלך עם בדיקות
  4. עדכן תיעוד
  5. שלח Pull Request

ראה מדריך פיתוח לתהליך תרומה.

רישיון

פרויקט זה מורשה תחת GNU Affero General Public License v3.0 (AGPL-3.0).

זכויות יוצרים (C) 2025 Alex Newman (@thedotmack). כל הזכויות שמורות.

ראה את קובץ LICENSE לפרטים מלאים.

משמעות הדבר:

  • אתה יכול לשימוש, שינוי והפצה של תוכנה זו בחופשיות
  • אם אתה משנה ופורס על שרת רשת, עליך להנגיש את קוד המקור שלך
  • עבודות נגזרות חייבות להיות מורשות גם כן תחת AGPL-3.0
  • אין אחריות לתוכנה זו

הערה על Ragtime: ספריית ragtime/ מורשית בנפרד תחת PolyForm Noncommercial License 1.0.0. ראה ragtime/LICENSE לפרטים.

תמיכה

נבנה עם Claude Agent SDK | מופעל על ידי Claude Code | נוצר עם TypeScript