README badges, system requirements, translated README copies, and public docs had drifted from package.json. Align them with version 13.4.0 and the Node >=20 engine requirement, and make the hook overview count explicit as Setup plus five lifecycle events. Constraint: package.json is the source of truth for current package version and engine requirements Rejected: Update only the root README | translated README files would still publish stale requirements Confidence: high Scope-risk: narrow Directive: Keep README badges and requirements synchronized with package.json during version or engine bumps Tested: rg found no remaining version-6.5.0, node >=18 badge, Node 18.0.0 requirement, or Hook System (5 events) references under README.md docs package.json Not-tested: Full docs build
13 KiB
🌐 Aceasta este o traducere automată. Corecțiile din partea comunității sunt binevenite!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 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
Sistem persistent de compresie a memoriei construit pentru Claude Code.
Start Rapid • Cum Funcționează • Instrumente de Căutare • Documentație • Configurare • Depanare • Licență
Claude-Mem păstrează contextul fără întrerupere între sesiuni prin capturarea automată a observațiilor de utilizare a instrumentelor, generarea de rezumate semantice și punerea lor la dispoziție în sesiunile viitoare. Aceasta permite lui Claude să mențină continuitatea cunoștințelor despre proiecte chiar și după încheierea sau reconectarea sesiunilor.
Start Rapid
Porniți o nouă sesiune Claude Code în terminal și introduceți următoarele comenzi:
> /plugin marketplace add thedotmack/claude-mem
> /plugin install claude-mem
Reporniți Claude Code. Contextul din sesiunile anterioare va apărea automat în sesiunile noi.
Caracteristici Principale:
- 🧠 Memorie Persistentă - Contextul supraviețuiește între sesiuni
- 📊 Dezvăluire Progresivă - Recuperare stratificată a memoriei cu vizibilitatea costurilor în tokeni
- 🔍 Căutare Bazată pe Abilități - Interogați istoricul proiectului cu abilitatea mem-search
- 🖥️ Interfață Web Viewer - Flux de memorie în timp real la http://localhost:37777
- 💻 Abilitate Claude Desktop - Căutați în memorie din conversațiile Claude Desktop
- 🔒 Control al Confidențialității - Utilizați etichete
<private>pentru a exclude conținut sensibil de la stocare - ⚙️ Configurare Context - Control fin asupra contextului care este injectat
- 🤖 Operare Automată - Nu necesită intervenție manuală
- 🔗 Citări - Referință la observații anterioare cu ID-uri (accesați prin http://localhost:37777/api/observation/{id} sau vizualizați toate în web viewer la http://localhost:37777)
- 🧪 Canal Beta - Încercați funcții experimentale precum Endless Mode prin comutarea versiunii
Documentație
📚 Vizualizați Documentația Completă - Răsfoiți pe site-ul oficial
Introducere
- Ghid de Instalare - Start rapid și instalare avansată
- Ghid de Utilizare - Cum funcționează Claude-Mem automat
- Instrumente de Căutare - Interogați istoricul proiectului cu limbaj natural
- Funcții Beta - Încercați funcții experimentale precum Endless Mode
Practici Recomandate
- Inginerie Context - Principii de optimizare a contextului pentru agenți AI
- Dezvăluire Progresivă - Filosofia din spatele strategiei de pregătire a contextului Claude-Mem
Arhitectură
- Prezentare Generală - Componente de sistem și flux de date
- Evoluția Arhitecturii - Parcursul de la v3 la v5
- Arhitectura Hooks - Cum folosește Claude-Mem hook-urile de ciclu de viață
- Referință Hooks - 7 scripturi de hook explicate
- Serviciu Worker - HTTP API și gestionare Bun
- Baza de Date - Schemă SQLite și căutare FTS5
- Arhitectura Căutării - Căutare hibridă cu baza de date vectorială Chroma
Configurare și Dezvoltare
- Configurare - Variabile de mediu și setări
- Dezvoltare - Construire, testare, contribuție
- Depanare - Probleme comune și soluții
Cum Funcționează
Componente Principale:
- 5 Hook-uri de Ciclu de Viață - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 scripturi de hook)
- Instalare Inteligentă - Verificator de dependențe în cache (script pre-hook, nu un hook de ciclu de viață)
- Serviciu Worker - HTTP API pe portul 37777 cu interfață web viewer și 10 endpoint-uri de căutare, gestionat de Bun
- Bază de Date SQLite - Stochează sesiuni, observații, rezumate
- Abilitatea mem-search - Interogări în limbaj natural cu dezvăluire progresivă
- Bază de Date Vectorială Chroma - Căutare hibridă semantică + cuvinte cheie pentru recuperare inteligentă a contextului
Consultați Prezentarea Generală a Arhitecturii pentru detalii.
Abilitatea mem-search
Claude-Mem oferă căutare inteligentă prin abilitatea mem-search care se invocă automat când întrebați despre lucrul trecut:
Cum Funcționează:
- Întrebați natural: "Ce am făcut în sesiunea trecută?" sau "Am rezolvat acest bug înainte?"
- Claude invocă automat abilitatea mem-search pentru a găsi contextul relevant
Operații de Căutare Disponibile:
- Search Observations - Căutare full-text în observații
- Search Sessions - Căutare full-text în rezumatele sesiunilor
- Search Prompts - Căutare în cererile brute ale utilizatorilor
- By Concept - Găsire după etichete de concept (discovery, problem-solution, pattern, etc.)
- By File - Găsire de observații care fac referire la fișiere specifice
- By Type - Găsire după tip (decision, bugfix, feature, refactor, discovery, change)
- Recent Context - Obținere context recent al sesiunii pentru un proiect
- Timeline - Obținere cronologie unificată a contextului în jurul unui punct specific în timp
- Timeline by Query - Căutare observații și obținere context cronologic în jurul celei mai bune potriviri
- API Help - Obținere documentație API de căutare
Exemple de Interogări în Limbaj Natural:
"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?"
Consultați Ghidul Instrumentelor de Căutare pentru exemple detaliate.
Funcții Beta
Claude-Mem oferă un canal beta cu funcții experimentale precum Endless Mode (arhitectură de memorie biomimetică pentru sesiuni extinse). Comutați între versiunile stabile și beta din interfața web viewer la http://localhost:37777 → Settings.
Consultați Documentația Funcțiilor Beta pentru detalii despre Endless Mode și cum să îl încercați.
Cerințe de Sistem
- Node.js: 20.0.0 sau superior
- Claude Code: Versiunea cea mai recentă cu suport pentru plugin-uri
- Bun: Runtime JavaScript și manager de procese (instalat automat dacă lipsește)
- uv: Manager de pachete Python pentru căutare vectorială (instalat automat dacă lipsește)
- SQLite 3: Pentru stocare persistentă (inclus)
Configurare
Setările sunt gestionate în ~/.claude-mem/settings.json (creat automat cu valori implicite la prima rulare). Configurați modelul AI, portul worker, directorul de date, nivelul de log și setările de injectare a contextului.
Consultați Ghidul de Configurare pentru toate setările disponibile și exemple.
Dezvoltare
Consultați Ghidul de Dezvoltare pentru instrucțiuni de construire, testare și flux de contribuție.
Depanare
Dacă întâmpinați probleme, descrieți problema lui Claude și abilitatea troubleshoot va diagnostica automat și va furniza soluții.
Consultați Ghidul de Depanare pentru probleme comune și soluții.
Rapoarte de Bug-uri
Creați rapoarte comprehensive de bug-uri cu generatorul automat:
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
Contribuție
Contribuțiile sunt binevenite! Vă rugăm:
- Faceți fork la repository
- Creați o ramură de funcție
- Faceți modificările cu teste
- Actualizați documentația
- Trimiteți un Pull Request
Consultați Ghidul de Dezvoltare pentru fluxul de contribuție.
License
This project is licensed under the Apache License 2.0 (Apache-2.0).
Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved.
See the LICENSE file for full details.
Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms.
Ragtime note: The ragtime/ directory is licensed under the Apache License 2.0. See ragtime/LICENSE for details.
Suport
- Documentație: docs/
- Probleme: GitHub Issues
- Repository: github.com/thedotmack/claude-mem
- Autor: Alex Newman (@thedotmack)
Construit cu Claude Agent SDK | Alimentat de Claude Code | Realizat cu TypeScript