Skip to content

README.hu.md

Latest commit

 

History

History
431 lines (316 loc) · 18.7 KB

README.hu.md

File metadata and controls

431 lines (316 loc) · 18.7 KB
Raw

🌐 Ez egy automatikus fordítás. Közösségi javítások szívesen fogadottak!


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

Tartós memória tömörítési rendszer a Claude Code számára.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview Star History Chart

Gyors kezdés • Hogyan működik • Keresési eszközök • Dokumentáció • Konfiguráció • Hibaelhárítás • Licenc

A Claude-Mem zökkenőmentesen megőrzi a kontextust munkamenetek között azáltal, hogy automatikusan rögzíti az eszközhasználati megfigyeléseket, szemantikus összefoglalókat generál, és elérhetővé teszi azokat a jövőbeli munkamenetekben. Ez lehetővé teszi Claude számára, hogy fenntartsa a projektekkel kapcsolatos tudás folytonosságát még a munkamenetek befejezése vagy újracsatlakozása után is.

Gyors kezdés

Telepítés egyetlen paranccsal:

npx claude-mem install

Vagy telepítés OpenCode-hoz:

npx claude-mem install --ide opencode

Vagy telepítés Antigravity CLI-hez (beállítási útmutató):

npx claude-mem install --ide antigravity

Vagy telepítés a plugin marketplace-ről a Claude Code-on belül:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

Indítsa újra a Claude Code-ot. A korábbi munkamenetek kontextusa automatikusan megjelenik az új munkamenetekben.

Megjegyzés: A Claude-Mem az npm-en is elérhető, de az npm install -g claude-mem csak a SDK/könyvtár részt telepíti — nem regisztrálja a plugin hookokat, és nem állítja be a worker szolgáltatást. Mindig a npx claude-mem install vagy a fenti /plugin parancsok segítségével telepítsen.

🦞 OpenClaw Gateway

Telepítse a claude-mem-et tartós memória pluginként az OpenClaw gateway-eken egyetlen paranccsal:

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

A telepítő kezeli a függőségeket, a plugin beállítását, az AI szolgáltató konfigurációját, a worker indítását, valamint az opcionális valós idejű megfigyelési feedeket Telegramra, Discordra, Slackre és másokra. Részletekért lásd az OpenClaw integrációs útmutatót.

Főbb jellemzők:

  • 🧠 Tartós memória - A kontextus túléli a munkameneteket
  • 📊 Progresszív felfedés - Többrétegű memória-visszakeresés token költség láthatósággal
  • 🔍 Skill-alapú keresés - Lekérdezheti projekt előzményeit a mem-search skill segítségével
  • 🖥️ Webes megjelenítő felület - Valós idejű memória stream a worker indításakor kiírt URL-en
  • 💻 Claude Desktop Skill - Memória keresése Claude Desktop beszélgetésekből
  • 🔒 Adatvédelmi kontroll - Használja a <private> címkéket az érzékeny tartalom kizárásához
  • ⚙️ Kontextus konfiguráció - Finomhangolt kontroll afelett, hogy milyen kontextus kerül beillesztésre
  • 🤖 Automatikus működés - Nincs szükség manuális beavatkozásra
  • 🔗 Hivatkozások - Hivatkozás múltbeli megfigyelésekre ID-k alapján a worker API-n keresztül, vagy megtekintés a webes felületen

Dokumentáció

📚 Teljes dokumentáció megtekintése - Böngészés a hivatalos weboldalon

Első lépések

Bevált gyakorlatok

Architektúra

Konfiguráció és fejlesztés

Hogyan működik

Fő komponensek:

  1. 5 életciklus hook - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook szkript)
  2. Intelligens telepítés - Gyorsítótárazott függőségellenőrző (pre-hook szkript, nem életciklus hook)
  3. Worker szolgáltatás - Helyi HTTP API webes megjelenítő felülettel és keresési végpontokkal, Bun által kezelve
  4. SQLite adatbázis - Munkamenetek, megfigyelések, összefoglalók tárolása
  5. mem-search Skill - Természetes nyelvi lekérdezések progresszív felfedéssel
  6. Chroma vektor adatbázis - Hibrid szemantikus + kulcsszó keresés intelligens kontextus-visszakereséshez

Részletekért lásd az Architektúra áttekintést.

MCP keresési eszközök

A Claude-Mem intelligens memóriakeresést biztosít 4 MCP eszközön keresztül, egy token-hatékony 3-rétegű munkafolyamat-minta alapján:

A 3-rétegű munkafolyamat:

  1. search - Kompakt index lekérése ID-kkal (~50-100 token/eredmény)
  2. timeline - Időrendi kontextus lekérése az érdekes eredmények körül
  3. get_observations - Teljes részletek lekérése KIZÁRÓLAG a szűrt ID-khez (~500-1000 token/eredmény)

Hogyan működik:

  • A Claude MCP eszközöket használ a memória kereséséhez
  • Kezdje a search-sel, hogy egy indexet kapjon az eredményekről
  • Használja a timeline-t, hogy lássa, mi történt egy adott megfigyelés körül
  • Használja a get_observations-t, hogy teljes részleteket kérjen le a releváns ID-khez
  • ~10x token megtakarítás azáltal, hogy a részletek lekérése előtt szűr

Elérhető MCP eszközök:

  1. search - Memóriaindex keresése teljes szöveges lekérdezésekkel, szűrés típus/dátum/projekt szerint
  2. timeline - Időrendi kontextus lekérése egy adott megfigyelés vagy lekérdezés körül
  3. get_observations - Teljes megfigyelési részletek lekérése ID-k alapján (mindig kötegelve, több ID-vel)

Példa használat:

// 1. lépés: Index keresése
search(query="authentication bug", type="bugfix", limit=10)

// 2. lépés: Index áttekintése, releváns ID-k azonosítása (pl. #123, #456)

// 3. lépés: Teljes részletek lekérése
get_observations(ids=[123, 456])

Részletes példákért lásd a Keresési eszközök útmutatót.

Kiadási ágak

A stabil kiadások a main ágból jelennek meg, és az npm-re kerülnek publikálásra. A core-dev és a community-edge forráskódból futtatott ágak a korai megbízhatósági javításokhoz és a közösségi integrációkhoz. Lásd a Kiadási ágak oldalt az ágfolyamatért és a nem-stabil futtatási utasításokért.

Rendszerkövetelmények

  • Node.js: 20.0.0 vagy újabb
  • Claude Code: Legújabb verzió plugin támogatással
  • Bun: JavaScript futtatókörnyezet és folyamatkezelő (automatikusan települ, ha hiányzik)
  • uv: Python csomagkezelő vektor kereséshez (automatikusan települ, ha hiányzik)
  • SQLite 3: Tartós tároláshoz (mellékelve)

Windows telepítési megjegyzések

Ha az alábbihoz hasonló hibát lát:

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

Győződjön meg róla, hogy a Node.js és az npm telepítve van, és hozzá van adva a PATH-hoz. Töltse le a legújabb Node.js telepítőt a https://nodejs.org oldalról, és indítsa újra a terminált a telepítés után.

Konfiguráció

A beállítások a ~/.claude-mem/settings.json fájlban kezelhetők (automatikusan létrejön alapértelmezett értékekkel az első futtatáskor). Konfigurálható az AI modell, worker port, adatkönyvtár, naplózási szint és kontextus beillesztési beállítások.

Az összes elérhető beállításért és példákért lásd a Konfigurációs útmutatót.

Mód és nyelv konfiguráció

A Claude-Mem több munkafolyamat-módot és nyelvet támogat a CLAUDE_MEM_MODE beállításon keresztül.

Ez a beállítás mindkettőt vezérli:

  • A munkafolyamat viselkedését (pl. code, chill, investigation)
  • A generált megfigyelésekben használt nyelvet

Hogyan konfigurálja

Szerkessze a beállítási fájlt a ~/.claude-mem/settings.json helyen:

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

A módok a plugin/modes/ mappában vannak meghatározva. Az összes elérhető mód helyi megtekintéséhez:

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

Elérhető módok

Mód Leírás
code Alapértelmezett angol mód
code--zh Egyszerűsített kínai mód
code--ja Japán mód

A nyelvspecifikus módok a code--[lang] mintát követik, ahol a [lang] az ISO 639-1 nyelvkód (pl. zh kínaihoz, ja japánhoz, es spanyolhoz).

Megjegyzés: a code--zh (egyszerűsített kínai) már beépített — nincs szükség további telepítésre vagy plugin frissítésre.

A mód megváltoztatása után

Indítsa újra a Claude Code-ot az új mód konfiguráció alkalmazásához.

Fejlesztés

Az építési utasításokért, tesztelésért és hozzájárulási munkafolyamatért lásd a Fejlesztési útmutatót.

Hibaelhárítás

Problémák esetén írja le a problémát Claude-nak, és a troubleshoot skill automatikusan diagnosztizálja és javítási megoldásokat kínál.

Gyakori problémákért és megoldásokért lásd a Hibaelhárítási útmutatót.

Hibajelentések

Átfogó hibajelentések készítése az automatikus generátorral:

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

Hozzájárulás

A hozzájárulásokat szívesen fogadjuk! Kérjük:

  1. Fork-olja a tárolót
  2. Hozzon létre egy feature branchet
  3. Végezze el változtatásait tesztekkel
  4. Frissítse a dokumentációt
  5. Nyújtson be egy Pull Requestet

A Claude-Mem három ágból jelenik meg: main (stabil), core-dev és community-edge. Kizárólag a main kerül publikálásra az npm-en; a többi forráskódból fut. Lásd a Kiadási ágak oldalt a stratégiáért és a helyi futtatási utasításokért.

Lásd a Fejlesztési útmutatót a hozzájárulási munkafolyamatért.

Licenc

A Claude-Mem az Apache License 2.0 licenc alatt áll.

Az Apache-2.0-t azért választottuk, mert a tartós ágenskodó memóriának könnyen beágyazhatónak kell lennie fejlesztői eszközökbe, helyi ügynökökbe, MCP szerverekbe, vállalati rendszerekbe, robotikai stackekbe és éles ügynök-hordozókba.

A teljes részletekért lásd a LICENSE fájlt. Lásd a docs/license.md és a docs/ip-boundary.md fájlokat a licencelési hatókörért és a nyílt/kereskedelmi határvonalért.

Megjegyzés a Ragtime-ról: A ragtime/ mappa az Apache License 2.0 licenc alatt áll. Részletekért lásd a ragtime/LICENSE fájlt.

Támogatás

Claude Agent SDK-val építve | Claude Code-dal működik | TypeScript-tel készítve

Mi a helyzet a CMEM-mel?

A CMEM egy harmadik fél által létrehozott token, amelyet a Claude-Mem alkotója (Alex Newman, @thedotmack) hivatalosan is felkarolt. A token a közösségi növekedés katalizátoraként és a CMEM-et az azt leginkább igénylő fejlesztőkhöz és tudásmunkásokhoz eljuttató eszközként funkcionál.

Hivatalos BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3