Skip to content

README.ro.md

Latest commit

 

History

History
431 lines (316 loc) · 18.5 KB

README.ro.md

File metadata and controls

431 lines (316 loc) · 18.5 KB
Raw

🌐 Aceasta este o traducere automată. Corecțiile din partea comunității sunt binevenite!


Claude-Mem
Vercel OSS Program

🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇵🇹 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

Sistem persistent de compresie a memoriei construit pentru Claude Code.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview Star History Chart

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

Instalați cu o singură comandă:

npx claude-mem install

Sau instalați pentru OpenCode:

npx claude-mem install --ide opencode

Sau instalați pentru Antigravity CLI (ghid de configurare):

npx claude-mem install --ide antigravity

Sau instalați din marketplace-ul de plugin-uri direct din Claude Code:

/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.

Notă: Claude-Mem este publicat și pe npm, dar npm install -g claude-mem instalează doar SDK-ul/biblioteca — nu înregistrează hook-urile plugin-ului și nu configurează serviciul worker. Instalați întotdeauna prin npx claude-mem install sau comenzile /plugin de mai sus.

🦞 OpenClaw Gateway

Instalați claude-mem ca plugin de memorie persistentă pe gateway-urile OpenClaw cu o singură comandă:

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

Programul de instalare gestionează dependențele, configurarea plugin-ului, configurarea furnizorului AI, pornirea worker-ului și fluxurile opționale de observații în timp real către Telegram, Discord, Slack și altele. Consultați Ghidul de Integrare OpenClaw pentru detalii.

Caracteristici Principale:

  • 🧠 Memorie Persistentă - Contextul supraviețuiește între sesiuni
  • 📊 Dezvăluire Progresivă - Recuperare stratificată a memoriei cu vizibilitate asupra 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 adresa URL a worker-ului afișată la pornire
  • 💻 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ținutul 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 prin API-ul worker-ului sau vizualizați-le pe toate în web viewer

Documentație

📚 Vizualizați Documentația Completă - Răsfoiți pe site-ul oficial

Introducere

Practici Recomandate

Arhitectură

Configurare și Dezvoltare

Cum Funcționează

Componente Principale:

  1. 5 Hook-uri de Ciclu de Viață - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 scripturi de hook)
  2. Instalare Inteligentă - Verificator de dependențe în cache (script pre-hook, nu un hook de ciclu de viață)
  3. Serviciu Worker - HTTP API local cu interfață web viewer și endpoint-uri de căutare, gestionat de Bun
  4. Bază de Date SQLite - Stochează sesiuni, observații, rezumate
  5. Abilitatea mem-search - Interogări în limbaj natural cu dezvăluire progresivă
  6. Bază de Date Vectorială Chroma - Căutare hibridă semantică + cuvinte cheie pentru recuperare inteligentă a contextului

Consultați Prezentarea Generală a Arhitecturii pentru detalii.

Instrumente de Căutare MCP

Claude-Mem oferă căutare inteligentă în memorie prin 4 instrumente MCP care urmează un tipar de flux de lucru eficient din punct de vedere al tokenilor, pe 3 niveluri:

Fluxul de Lucru pe 3 Niveluri:

  1. search - Obțineți un index compact cu ID-uri (~50-100 tokeni/rezultat)
  2. timeline - Obțineți context cronologic în jurul rezultatelor interesante
  3. get_observations - Preluați detalii complete DOAR pentru ID-urile filtrate (~500-1.000 tokeni/rezultat)

Cum Funcționează:

  • Claude folosește instrumente MCP pentru a căuta în memoria dumneavoastră
  • Începeți cu search pentru a obține un index de rezultate
  • Folosiți timeline pentru a vedea ce se întâmpla în jurul unor observații specifice
  • Folosiți get_observations pentru a prelua detalii complete pentru ID-urile relevante
  • Economii de aproximativ 10x în tokeni prin filtrare înainte de preluarea detaliilor

Instrumente MCP Disponibile:

  1. search - Căutați în indexul memoriei cu interogări full-text, filtrare după tip/dată/proiect
  2. timeline - Obțineți context cronologic în jurul unei observații sau interogări specifice
  3. get_observations - Preluați detalii complete ale observațiilor după ID-uri (grupați întotdeauna mai multe ID-uri)

Exemplu de Utilizare:

// Pasul 1: Căutați pentru index
search(query="authentication bug", type="bugfix", limit=10)

// Pasul 2: Revizuiți indexul, identificați ID-urile relevante (de ex. #123, #456)

// Pasul 3: Preluați detaliile complete
get_observations(ids=[123, 456])

Consultați Ghidul Instrumentelor de Căutare pentru exemple detaliate.

Ramuri de Lansare

Lansările stabile pornesc din main și sunt publicate pe npm. core-dev și community-edge sunt ramuri rulate direct din sursă pentru remedieri timpurii de fiabilitate și integrări comunitare. Consultați Ramuri de Lansare pentru fluxul ramurilor și instrucțiunile de rulare non-stabile.

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)

Note de Configurare pentru Windows

Dacă vedeți o eroare de tipul:

npm : The term 'npm' is not recognized as the name of a cmdlet

Asigurați-vă că Node.js și npm sunt instalate și adăugate în PATH. Descărcați cel mai recent program de instalare Node.js de la https://nodejs.org și reporniți terminalul după instalare.

Configurare

Setările sunt gestionate în ~/.claude-mem/settings.json (creat automat cu valori implicite la prima rulare). Configurați modelul AI, portul worker-ului, 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.

Configurarea Modului și Limbii

Claude-Mem suportă mai multe moduri de lucru și limbi prin setarea CLAUDE_MEM_MODE.

Această opțiune controlează:

  • Comportamentul fluxului de lucru (de ex. code, chill, investigation)
  • Limba folosită în observațiile generate

Cum se Configurează

Editați fișierul de setări la ~/.claude-mem/settings.json:

{
  "CLAUDE_MEM_MODE": "code--zh"
}

Modurile sunt definite în plugin/modes/. Pentru a vedea toate modurile disponibile local:

ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/

Moduri Disponibile

Mod Descriere
code Mod implicit în engleză
code--zh Mod în chineză simplificată
code--ja Mod în japoneză

Modurile specifice limbii urmează tiparul code--[lang], unde [lang] este codul de limbă ISO 639-1 (de ex. zh pentru chineză, ja pentru japoneză, es pentru spaniolă).

Notă: code--zh (chineză simplificată) este deja integrat — nu este necesară nicio instalare suplimentară sau actualizare a plugin-ului.

După Schimbarea Modului

Reporniți Claude Code pentru a aplica noua configurație a modului.

Dezvoltare

Consultați Ghidul de Dezvoltare pentru instrucțiuni de construire, testare și fluxul de contribuție.

Depanare

Dacă întâmpinați probleme, descrieți problema lui Claude, iar abilitatea troubleshoot va diagnostica automat și va furniza soluții.

Consultați Ghidul de Depanare pentru probleme comune și soluții.

Rapoarte de Erori

Creați rapoarte de erori complete cu generatorul automat:

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

Contribuție

Contribuțiile sunt binevenite! Vă rugăm:

  1. Faceți fork la repository
  2. Creați o ramură de funcție
  3. Faceți modificările cu teste
  4. Actualizați documentația
  5. Trimiteți un Pull Request

Claude-Mem este lansat din trei ramuri: main (stabilă), core-dev și community-edge. Doar main este publicată pe npm; celelalte sunt rulate din sursă. Consultați Ramuri de Lansare pentru strategie și instrucțiuni de rulare locală.

Consultați Ghidul de Dezvoltare pentru fluxul de contribuție.

Licență

Claude-Mem este licențiat sub Apache License 2.0.

Am ales Apache-2.0 pentru că memoria agentică durabilă ar trebui să fie ușor de integrat în instrumente pentru dezvoltatori, agenți locali, servere MCP, sisteme enterprise, stive de robotică și medii de rulare agentice de producție.

Consultați fișierul LICENSE pentru detalii complete. Consultați docs/license.md și docs/ip-boundary.md pentru domeniul de aplicare al licenței și granița open-source/comercială.

Notă despre Ragtime: Directorul ragtime/ este licențiat sub Apache License 2.0. Consultați ragtime/LICENSE pentru detalii.

Suport

Construit cu Claude Agent SDK | Funcționează cu Claude Code | Realizat cu TypeScript

Ce Este cu CMEM?

CMEM este un token creat de o terță parte, dar îmbrățișat oficial de creatorul Claude-Mem (Alex Newman, @thedotmack). Token-ul acționează ca un catalizator comunitar pentru creștere și ca un vehicul pentru a aduce CMEM la dezvoltatorii și lucrătorii din domeniul cunoașterii care au cea mai mare nevoie de el.

CA Oficial BASE: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3