Skip to content

Latest commit

 

History

History
304 lines (223 loc) · 18.6 KB

README.el.md

File metadata and controls

304 lines (223 loc) · 18.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. Το πλαίσιο από προηγούμενες συνεδρίες θα εμφανιστεί αυτόματα σε νέες συνεδρίες.

Βασικά Χαρακτηριστικά:

  • 🧠 Μόνιμη Μνήμη - Το πλαίσιο διατηρείται μεταξύ συνεδριών
  • 📊 Προοδευτική Αποκάλυψη - Ανάκτηση μνήμης σε επίπεδα με ορατότητα κόστους 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 μέσω εναλλαγής έκδοσης

Τεκμηρίωση

📚 Προβολή Πλήρους Τεκμηρίωσης - Περιήγηση στον επίσημο ιστότοπο

Ξεκινώντας

Βέλτιστες Πρακτικές

Αρχιτεκτονική

Διαμόρφωση & Ανάπτυξη

Πώς Λειτουργεί

Βασικά Συστατικά:

  1. 5 Lifecycle Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts)
  2. Έξυπνη Εγκατάσταση - Έλεγχος εξαρτήσεων με cache (pre-hook script, όχι lifecycle hook)
  3. Υπηρεσία Worker - HTTP API στη θύρα 37777 με διεπαφή web viewer και 10 endpoints αναζήτησης, διαχειριζόμενη από το Bun
  4. Βάση Δεδομένων SQLite - Αποθηκεύει συνεδρίες, παρατηρήσεις, περιλήψεις
  5. Δεξιότητα mem-search - Ερωτήματα φυσικής γλώσσας με προοδευτική αποκάλυψη
  6. Βάση Δεδομένων Διανυσμάτων Chroma - Υβριδική σημασιολογική + αναζήτηση λέξεων-κλειδιών για έξυπνη ανάκτηση πλαισίου

Δείτε Επισκόπηση Αρχιτεκτονικής για λεπτομέρειες.

Δεξιότητα mem-search

Το Claude-Mem παρέχει έξυπνη αναζήτηση μέσω της δεξιότητας mem-search που ενεργοποιείται αυτόματα όταν ρωτάτε για παλαιότερη εργασία:

Πώς Λειτουργεί:

  • Απλά ρωτήστε φυσικά: "Τι κάναμε την προηγούμενη συνεδρία;" ή "Διορθώσαμε αυτό το σφάλμα νωρίτερα;"
  • Το Claude ενεργοποιεί αυτόματα τη δεξιότητα mem-search για να βρει σχετικό πλαίσιο

Διαθέσιμες Λειτουργίες Αναζήτησης:

  1. Search Observations - Αναζήτηση πλήρους κειμένου σε παρατηρήσεις
  2. Search Sessions - Αναζήτηση πλήρους κειμένου σε περιλήψεις συνεδριών
  3. Search Prompts - Αναζήτηση ακατέργαστων αιτημάτων χρήστη
  4. By Concept - Εύρεση βάσει ετικετών εννοιών (discovery, problem-solution, pattern, κ.λπ.)
  5. By File - Εύρεση παρατηρήσεων που αναφέρονται σε συγκεκριμένα αρχεία
  6. By Type - Εύρεση βάσει τύπου (decision, bugfix, feature, refactor, discovery, change)
  7. Recent Context - Λήψη πρόσφατου πλαισίου συνεδρίας για ένα έργο
  8. Timeline - Λήψη ενοποιημένης χρονολογικής γραμμής πλαισίου γύρω από συγκεκριμένο χρονικό σημείο
  9. Timeline by Query - Αναζήτηση παρατηρήσεων και λήψη πλαισίου χρονολογικής γραμμής γύρω από την καλύτερη αντιστοιχία
  10. 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?"

Δείτε Οδηγό Εργαλείων Αναζήτησης για λεπτομερή παραδείγματα.

Χαρακτηριστικά Beta

Το 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

Συνεισφορά

Οι συνεισφορές είναι ευπρόσδεκτες! Παρακαλώ:

  1. Κάντε Fork το repository
  2. Δημιουργήστε ένα feature branch
  3. Κάντε τις αλλαγές σας με δοκιμές
  4. Ενημερώστε την τεκμηρίωση
  5. Υποβάλετε ένα 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 για λεπτομέρειες.

Υποστήριξη

Κατασκευασμένο με Claude Agent SDK | Τροφοδοτείται από Claude Code | Φτιαγμένο με TypeScript