🌐 Αυτή είναι μια αυτοματοποιημένη μετάφραση. Καλώς ορίζονται οι διορθώσεις από την κοινότητα!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 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.
Γρήγορη Εκκίνηση • Πώς Λειτουργεί • Εργαλεία Αναζήτησης • Τεκμηρίωση • Διαμόρφωση • Αντιμετώπιση Προβλημάτων • Άδεια Χρήσης
Το Claude-Mem διατηρεί απρόσκοπτα το πλαίσιο μεταξύ συνεδριών καταγράφοντας αυτόματα παρατηρήσεις χρήσης εργαλείων, δημιουργώντας σημασιολογικές περιλήψεις και καθιστώντας τες διαθέσιμες σε μελλοντικές συνεδρίες. Αυτό επιτρέπει στο Claude να διατηρεί τη συνέχεια της γνώσης για έργα ακόμη και μετά το τέλος ή την επανασύνδεση συνεδριών.
Ξεκινήστε μια νέα συνεδρία Claude Code στο τερματικό και εισάγετε τις ακόλουθες εντολές:
> /plugin marketplace add thedotmack/claude-mem > /plugin install claude-mem
Επανεκκινήστε το Claude Code. Το πλαίσιο από προηγούμενες συνεδρίες θα εμφανιστεί αυτόματα σε νέες συνεδρίες.
Βασικά Χαρακτηριστικά:
- 🧠 Μόνιμη Μνήμη - Το πλαίσιο διατηρείται μεταξύ συνεδριών
- 📊 Προοδευτική Αποκάλυψη - Ανάκτηση μνήμης σε επίπεδα με ορατότητα κόστους tokens
- 🔍 Αναζήτηση Βασισμένη σε Δεξιότητες - Ερωτήματα στο ιστορικό του έργου σας με τη δεξιότητα mem-search
- 🖥️ Διεπαφή Web Viewer - Ροή μνήμης σε πραγματικό χρόνο στο http://localhost:37777
- 💻 Δεξιότητα Claude Desktop - Αναζήτηση μνήμης από συνομιλίες Claude Desktop
- 🔒 Έλεγχος Απορρήτου - Χρησιμοποιήστε ετικέτες
<private>για να εξαιρέσετε ευαίσθητο περιεχόμενο από την αποθήκευση - ⚙️ Διαμόρφωση Πλαισίου - Λεπτομερής έλεγχος για το ποιο πλαίσιο εισάγεται
- 🤖 Αυτόματη Λειτουργία - Δεν απαιτείται χειροκίνητη παρέμβαση
- 🔗 Αναφορές - Αναφορά σε παλαιότερες παρατηρήσεις με IDs (πρόσβαση μέσω http://localhost:37777/api/observation/{id} ή προβολή όλων στο web viewer στο http://localhost:37777)
- 🧪 Κανάλι Beta - Δοκιμάστε πειραματικά χαρακτηριστικά όπως το Endless Mode μέσω εναλλαγής έκδοσης
📚 Προβολή Πλήρους Τεκμηρίωσης - Περιήγηση στον επίσημο ιστότοπο
- Οδηγός Εγκατάστασης - Γρήγορη εκκίνηση & προηγμένη εγκατάσταση
- Οδηγός Χρήσης - Πώς λειτουργεί αυτόματα το Claude-Mem
- Εργαλεία Αναζήτησης - Ερωτήματα στο ιστορικό του έργου σας με φυσική γλώσσα
- Χαρακτηριστικά Beta - Δοκιμάστε πειραματικά χαρακτηριστικά όπως το Endless Mode
- Μηχανική Πλαισίου - Αρχές βελτιστοποίησης πλαισίου για AI agents
- Προοδευτική Αποκάλυψη - Φιλοσοφία πίσω από τη στρατηγική προετοιμασίας πλαισίου του Claude-Mem
- Επισκόπηση - Συστατικά στοιχεία συστήματος & ροή δεδομένων
- Εξέλιξη Αρχιτεκτονικής - Το ταξίδι από το v3 στο v5
- Αρχιτεκτονική Hooks - Πώς το Claude-Mem χρησιμοποιεί lifecycle hooks
- Αναφορά Hooks - Επεξήγηση 7 hook scripts
- Υπηρεσία Worker - HTTP API & διαχείριση Bun
- Βάση Δεδομένων - Σχήμα SQLite & αναζήτηση FTS5
- Αρχιτεκτονική Αναζήτησης - Υβριδική αναζήτηση με βάση δεδομένων διανυσμάτων Chroma
- Διαμόρφωση - Μεταβλητές περιβάλλοντος & ρυθμίσεις
- Ανάπτυξη - Κατασκευή, δοκιμή, συνεισφορά
- Αντιμετώπιση Προβλημάτων - Συνήθη προβλήματα & λύσεις
Βασικά Συστατικά:
- 5 Lifecycle Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts)
- Έξυπνη Εγκατάσταση - Έλεγχος εξαρτήσεων με cache (pre-hook script, όχι lifecycle hook)
- Υπηρεσία Worker - HTTP API στη θύρα 37777 με διεπαφή web viewer και 10 endpoints αναζήτησης, διαχειριζόμενη από το Bun
- Βάση Δεδομένων SQLite - Αποθηκεύει συνεδρίες, παρατηρήσεις, περιλήψεις
- Δεξιότητα mem-search - Ερωτήματα φυσικής γλώσσας με προοδευτική αποκάλυψη
- Βάση Δεδομένων Διανυσμάτων Chroma - Υβριδική σημασιολογική + αναζήτηση λέξεων-κλειδιών για έξυπνη ανάκτηση πλαισίου
Δείτε Επισκόπηση Αρχιτεκτονικής για λεπτομέρειες.
Το Claude-Mem παρέχει έξυπνη αναζήτηση μέσω της δεξιότητας mem-search που ενεργοποιείται αυτόματα όταν ρωτάτε για παλαιότερη εργασία:
Πώς Λειτουργεί:
- Απλά ρωτήστε φυσικά: "Τι κάναμε την προηγούμενη συνεδρία;" ή "Διορθώσαμε αυτό το σφάλμα νωρίτερα;"
- Το Claude ενεργοποιεί αυτόματα τη δεξιότητα mem-search για να βρει σχετικό πλαίσιο
Διαθέσιμες Λειτουργίες Αναζήτησης:
- Search Observations - Αναζήτηση πλήρους κειμένου σε παρατηρήσεις
- Search Sessions - Αναζήτηση πλήρους κειμένου σε περιλήψεις συνεδριών
- Search Prompts - Αναζήτηση ακατέργαστων αιτημάτων χρήστη
- By Concept - Εύρεση βάσει ετικετών εννοιών (discovery, problem-solution, pattern, κ.λπ.)
- By File - Εύρεση παρατηρήσεων που αναφέρονται σε συγκεκριμένα αρχεία
- By Type - Εύρεση βάσει τύπου (decision, bugfix, feature, refactor, discovery, change)
- Recent Context - Λήψη πρόσφατου πλαισίου συνεδρίας για ένα έργο
- Timeline - Λήψη ενοποιημένης χρονολογικής γραμμής πλαισίου γύρω από συγκεκριμένο χρονικό σημείο
- Timeline by Query - Αναζήτηση παρατηρήσεων και λήψη πλαισίου χρονολογικής γραμμής γύρω από την καλύτερη αντιστοιχία
- API Help - Λήψη τεκμηρίωσης 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 προσφέρει ένα κανάλι beta με πειραματικά χαρακτηριστικά όπως το Endless Mode (βιομιμητική αρχιτεκτονική μνήμης για εκτεταμένες συνεδρίες). Εναλλαγή μεταξύ σταθερών και beta εκδόσεων από τη διεπαφή web viewer στο http://localhost:37777 → Settings.
Δείτε Τεκμηρίωση Χαρακτηριστικών Beta για λεπτομέρειες σχετικά με το Endless Mode και πώς να το δοκιμάσετε.
- Node.js: 18.0.0 ή νεότερο
- Claude Code: Τελευταία έκδοση με υποστήριξη plugin
- Bun: JavaScript runtime και διαχειριστής διεργασιών (εγκαθίσταται αυτόματα αν λείπει)
- uv: Διαχειριστής πακέτων Python για αναζήτηση διανυσμάτων (εγκαθίσταται αυτόματα αν λείπει)
- SQLite 3: Για μόνιμη αποθήκευση (συμπεριλαμβάνεται)
Οι ρυθμίσεις διαχειρίζονται στο ~/.claude-mem/settings.json (δημιουργείται αυτόματα με προεπιλογές κατά την πρώτη εκτέλεση). Διαμορφώστε το μοντέλο AI, τη θύρα worker, τον κατάλογο δεδομένων, το επίπεδο καταγραφής και τις ρυθμίσεις εισαγωγής πλαισίου.
Δείτε τον Οδηγό Διαμόρφωσης για όλες τις διαθέσιμες ρυθμίσεις και παραδείγματα.
Δείτε τον Οδηγό Ανάπτυξης για οδηγίες κατασκευής, δοκιμών και ροής εργασίας συνεισφοράς.
Εάν αντιμετωπίζετε προβλήματα, περιγράψτε το πρόβλημα στο Claude και η δεξιότητα troubleshoot θα διαγνώσει αυτόματα και θα παράσχει λύσεις.
Δείτε τον Οδηγό Αντιμετώπισης Προβλημάτων για συνήθη προβλήματα και λύσεις.
Δημιουργήστε περιεκτικές αναφορές σφαλμάτων με την αυτοματοποιημένη γεννήτρια:
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
Οι συνεισφορές είναι ευπρόσδεκτες! Παρακαλώ:
- Κάντε Fork το repository
- Δημιουργήστε ένα feature branch
- Κάντε τις αλλαγές σας με δοκιμές
- Ενημερώστε την τεκμηρίωση
- Υποβάλετε ένα Pull Request
Δείτε τον Οδηγό Ανάπτυξης για τη ροή εργασίας συνεισφοράς.
Αυτό το έργο διατίθεται με άδεια GNU Affero General Public License v3.0 (AGPL-3.0).
Copyright (C) 2025 Alex Newman (@thedotmack). Με επιφύλαξη παντός δικαιώματος.
Δείτε το αρχείο LICENSE για πλήρεις λεπτομέρειες.
Τι Σημαίνει Αυτό:
- Μπορείτε να χρησιμοποιήσετε, να τροποποιήσετε και να διανείμετε ελεύθερα αυτό το λογισμικό
- Εάν τροποποιήσετε και αναπτύξετε σε διακομιστή δικτύου, πρέπει να καταστήσετε διαθέσιμο τον πηγαίο κώδικά σας
- Τα παράγωγα έργα πρέπει επίσης να διατίθενται με άδεια AGPL-3.0
- ΔΕΝ υπάρχει ΕΓΓΥΗΣΗ για αυτό το λογισμικό
Σημείωση για το Ragtime: Ο κατάλογος ragtime/ διατίθεται χωριστά με άδεια PolyForm Noncommercial License 1.0.0. Δείτε το ragtime/LICENSE για λεπτομέρειες.
- Τεκμηρίωση: docs/
- Ζητήματα: GitHub Issues
- Repository: github.com/thedotmack/claude-mem
- Συγγραφέας: Alex Newman (@thedotmack)
Κατασκευασμένο με Claude Agent SDK | Τροφοδοτείται από Claude Code | Φτιαγμένο με TypeScript
