🌐 זהו תרגום אוטומטי. תיקונים מהקהילה יתקבלו בברכה!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇵🇹 Português • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français • 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇵🇭 Tagalog • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk
מערכת דחיסת זיכרון מתמשך שנבנתה עבור Claude Code.
|
|
התחלה מהירה • איך זה עובד • כלי חיפוש • תיעוד • הגדרות • פתרון בעיות • רישיון
Claude-Mem משמר הקשר בצורה חלקה בין הפעלות על ידי לכידה אוטומטית של תצפיות על שימוש בכלים, יצירת סיכומים סמנטיים, והנגשתם להפעלות עתידיות. הדבר מאפשר ל-Claude לשמור על המשכיות של ידע לגבי פרויקטים גם לאחר שהפעלות מסתיימות או מתחברות מחדש.
התקן בפקודה בודדת:
npx claude-mem installאו התקן עבור OpenCode:
npx claude-mem install --ide opencodeאו התקן עבור Antigravity CLI (מדריך הגדרה):
npx claude-mem install --ide antigravityאו התקן משוק התוספים בתוך Claude Code:
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-memהפעל מחדש את Claude Code. הקשר מהפעלות קודמות יופיע אוטומטית בהפעלות חדשות.
הערה: Claude-Mem מפורסם גם ב-npm, אך
npm install -g claude-memמתקין רק את ה-SDK/ספרייה — הוא אינו רושם את hooks התוסף ואינו מגדיר את שירות ה-worker. תמיד יש להתקין באמצעותnpx claude-mem installאו פקודות/pluginשלעיל.
התקן את claude-mem כתוסף זיכרון מתמשך על שערי OpenClaw בפקודה בודדת:
curl -fsSL https://install.cmem.ai/openclaw.sh | bashתוכנת ההתקנה מטפלת בתלויות, בהגדרת התוסף, בהגדרת ספק ה-AI, בהפעלת ה-worker, ובאפשרות להזין זרימות תצפיות בזמן אמת ל-Telegram, Discord, Slack ועוד. עיין במדריך שילוב OpenClaw לפרטים.
תכונות עיקריות:
- 🧠 זיכרון מתמשך - הקשר שורד בין הפעלות
- 📊 גילוי מדורג - אחזור זיכרון רב-שכבתי עם נראות עלות טוקנים
- 🔍 חיפוש מבוסס-מיומנויות - שאל את היסטוריית הפרויקט שלך עם מיומנות mem-search
- 🖥️ ממשק צופה אינטרנט - זרימת זיכרון בזמן אמת בכתובת ה-worker שמודפסת בעת ההפעלה
- 💻 מיומנות Claude Desktop - חפש זיכרון משיחות Claude Desktop
- 🔒 בקרת פרטיות - השתמש בתגיות
<private>כדי להוציא תוכן רגיש מהאחסון - ⚙️ הגדרות הקשר - בקרה מדויקת על איזה הקשר מוזרק
- 🤖 פעולה אוטומטית - אין צורך בהתערבות ידנית
- 🔗 ציטוטים - הפנה לתצפיות קודמות עם מזהים דרך ה-API של ה-worker או צפה בכולם בצופה האינטרנט
📚 צפה בתיעוד המלא - דפדף באתר הרשמי
- מדריך התקנה - התחלה מהירה והתקנה מתקדמת
- מדריך שימוש - איך Claude-Mem עובד אוטומטית
- כלי חיפוש - שאל את היסטוריית הפרויקט שלך בשפה טבעית
- הנדסת הקשר - עקרונות אופטימיזציה של הקשר לסוכן AI
- גילוי מדורג - הפילוסופיה מאחורי אסטרטגיית הכנת ההקשר של Claude-Mem
- סקירה כללית - רכיבי המערכת וזרימת הנתונים
- התפתחות הארכיטקטורה - המסע מגרסה v3 לגרסה v5
- ארכיטקטורת Hooks - איך Claude-Mem משתמש ב-lifecycle hooks
- מדריך Hooks - 7 סקריפטי hook מוסברים
- שירות Worker - HTTP API וניהול Bun
- מסד נתונים - סכמת SQLite וחיפוש FTS5
- ארכיטקטורת חיפוש - חיפוש היברידי עם מסד נתוני וקטורים Chroma
- הגדרות - משתני סביבה והגדרות
- פיתוח - בנייה, בדיקה, תרומה
- ענפי שחרור - זרימת הענפים Stable, core-dev, ו-community-edge
- פתרון בעיות - בעיות נפוצות ופתרונות
רכיבי ליבה:
- 5 Lifecycle Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 סקריפטי hook)
- התקנה חכמה - בודק תלויות עם מטמון (סקריפט pre-hook, לא lifecycle hook)
- שירות Worker - HTTP API מקומי עם ממשק צופה אינטרנט ונקודות קצה לחיפוש, מנוהל על ידי Bun
- מסד נתוני SQLite - מאחסן הפעלות, תצפיות, סיכומים
- מיומנות mem-search - שאילתות בשפה טבעית עם גילוי מדורג
- מסד נתוני וקטורים Chroma - חיפוש היברידי סמנטי + מילות מפתח לאחזור הקשר חכם
ראה סקירה כללית של הארכיטקטורה לפרטים.
Claude-Mem מספק חיפוש זיכרון חכם באמצעות 4 כלי MCP לפי דפוס עבודה תלת-שכבתי יעיל מבחינת טוקנים:
דפוס העבודה התלת-שכבתי:
search- קבל אינדקס קומפקטי עם מזהים (כ-50-100 טוקנים לתוצאה)timeline- קבל הקשר כרונולוגי סביב תוצאות מעניינותget_observations- שלוף פרטים מלאים רק עבור מזהים מסוננים (כ-500-1,000 טוקנים לתוצאה)
איך זה עובד:
- Claude משתמש בכלי MCP כדי לחפש בזיכרון שלך
- התחל עם
searchכדי לקבל אינדקס של תוצאות - השתמש ב-
timelineכדי לראות מה קרה סביב תצפיות ספציפיות - השתמש ב-
get_observationsכדי לשלוף פרטים מלאים עבור מזהים רלוונטיים - חיסכון של פי 10 בטוקנים על ידי סינון לפני שליפת הפרטים
כלי MCP זמינים:
search- חפש באינדקס הזיכרון עם שאילתות טקסט מלא, סינון לפי סוג/תאריך/פרויקטtimeline- קבל הקשר כרונולוגי סביב תצפית או שאילתה ספציפיתget_observations- שלוף פרטי תצפית מלאים לפי מזהים (תמיד קבץ מספר מזהים יחד)
דוגמת שימוש:
// שלב 1: חיפוש לצורך קבלת אינדקס
search(query="authentication bug", type="bugfix", limit=10)
// שלב 2: סקור את האינדקס, זהה מזהים רלוונטיים (למשל, #123, #456)
// שלב 3: שלוף פרטים מלאים
get_observations(ids=[123, 456])ראה מדריך כלי חיפוש לדוגמאות מפורטות.
שחרורים יציבים משוחררים מהענף main ומפורסמים ל-npm. core-dev ו-
community-edge הם ענפים המורצים ממקור, המיועדים לתיקוני יציבות מוקדמים ולשילובים
קהילתיים. ראה ענפי שחרור
לזרימת הענפים ולהוראות הרצה לא-יציבות.
- Node.js: 20.0.0 ומעלה
- Claude Code: גרסה אחרונה עם תמיכה בתוספים
- Bun: סביבת ריצה ומנהל תהליכים של JavaScript (מותקן אוטומטית אם חסר)
- uv: מנהל חבילות Python לחיפוש וקטורי (מותקן אוטומטית אם חסר)
- SQLite 3: לאחסון מתמשך (מצורף)
אם אתה נתקל בשגיאה כמו:
npm : The term 'npm' is not recognized as the name of a cmdletודא ש-Node.js ו-npm מותקנים ומוספים ל-PATH שלך. הורד את תוכנת ההתקנה העדכנית ביותר של Node.js מ-https://nodejs.org והפעל מחדש את הטרמינל שלך לאחר ההתקנה.
ההגדרות מנוהלות ב-~/.claude-mem/settings.json (נוצר אוטומטית עם ברירות מחדל בהפעלה הראשונה). הגדר מודל AI, פורט worker, ספריית נתונים, רמת לוג, והגדרות הזרקת הקשר.
ראה מדריך הגדרות לכל ההגדרות הזמינות ודוגמאות.
Claude-Mem תומך במספר מצבי עבודה ושפות דרך ההגדרה CLAUDE_MEM_MODE.
אפשרות זו שולטת בשני דברים:
- התנהגות זרימת העבודה (למשל code, chill, investigation)
- השפה המשמשת בתצפיות שנוצרות
ערוך את קובץ ההגדרות שלך ב-~/.claude-mem/settings.json:
{
"CLAUDE_MEM_MODE": "code--zh"
}מצבים מוגדרים ב-plugin/modes/. כדי לראות את כל המצבים הזמינים מקומית:
ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/| מצב | תיאור |
|---|---|
code |
מצב ברירת מחדל באנגלית |
code--zh |
מצב סינית פשוטה |
code--ja |
מצב יפנית |
מצבי שפה ספציפיים עוקבים אחר התבנית code--[lang] כאשר [lang] הוא קוד השפה בתקן ISO 639-1 (למשל, zh עבור סינית, ja עבור יפנית, es עבור ספרדית).
הערה:
code--zh(סינית פשוטה) כבר מובנה — אין צורך בהתקנה נוספת או עדכון תוסף.
ראה מדריך פיתוח להוראות בנייה, בדיקה, ותהליך תרומה.
אם אתה נתקל בבעיות, תאר את הבעיה ל-Claude ומיומנות troubleshoot תאבחן אוטומטית ותספק תיקונים.
ראה מדריך פתרון בעיות לבעיות נפוצות ופתרונות.
צור דיווחי באגים מקיפים עם המחולל האוטומטי:
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-reportתרומות מתקבלות בברכה! אנא:
- עשה Fork למאגר
- צור ענף תכונה
- בצע את השינויים שלך עם בדיקות
- עדכן תיעוד
- שלח Pull Request
Claude-Mem משוחרר משלושה ענפים: main (יציב), core-dev, ו-
community-edge. רק main מפורסם ל-npm; האחרים מורצים ממקור.
ראה ענפי שחרור לאסטרטגיה ולהוראות
הרצה מקומיות.
ראה מדריך פיתוח לתהליך תרומה.
Claude-Mem מופץ תחת רישיון Apache License 2.0.
בחרנו ב-Apache-2.0 מכיוון שזיכרון סוכני עמיד צריך להיות קל לשילוב בכלי פיתוח, בסוכנים מקומיים, בשרתי MCP, במערכות ארגוניות, במערכי רובוטיקה, ובתשתיות סוכנים בייצור.
ראה את קובץ ה-LICENSE לפרטים מלאים. ראה docs/license.md ו-docs/ip-boundary.md להיקף הרישוי ולגבול הקוד הפתוח/מסחרי.
הערה בנוגע ל-Ragtime: הספרייה ragtime/ מופצת תחת Apache License 2.0. ראה ragtime/LICENSE לפרטים.
- תיעוד: docs/
- בעיות: GitHub Issues
- מאגר: github.com/thedotmack/claude-mem
- חשבון X רשמי: @Claude_Memory
- דיסקורד רשמי: הצטרף לדיסקורד
- מחבר: Alex Newman (@thedotmack)
נבנה עם Claude Agent SDK | פועל עם Claude Code | נוצר עם TypeScript
CMEM הוא טוקן שנוצר על ידי צד שלישי, אך מקבל תמיכה רשמית מיוצר Claude-Mem (Alex Newman, @thedotmack). הטוקן משמש כזרז קהילתי לצמיחה וככלי להנגשת CMEM למפתחים ולעובדי ידע הזקוקים לו ביותר.
כתובת חוזה רשמית ברשת BASE: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3