14 KiB
🌐 Ez egy automatikus fordítás. Közösségi javítások szívesen fogadottak!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 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
Tartós memória tömörítési rendszer a Claude Code számára.
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
Indítson el egy új Claude Code munkamenetet a terminálban, és írja be a következő parancsokat:
> /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.
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 http://localhost:37777 címen
- 💻 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-kkal (hozzáférés: http://localhost:37777/api/observation/{id} vagy mindegyik megtekintése a webes felületen a http://localhost:37777 címen)
- 🧪 Béta csatorna - Kísérleti funkciók, mint az Endless Mode kipróbálása verziócserével
Dokumentáció
📚 Teljes dokumentáció megtekintése - Böngészés a hivatalos weboldalon
Első lépések
- Telepítési útmutató - Gyors indítás és haladó telepítés
- Használati útmutató - Hogyan működik automatikusan a Claude-Mem
- Keresési eszközök - Projekt előzmények lekérdezése természetes nyelvvel
- Béta funkciók - Kísérleti funkciók, mint az Endless Mode kipróbálása
Bevált gyakorlatok
- Kontextus tervezés - AI ügynök kontextus optimalizálási elvek
- Progresszív felfedés - A Claude-Mem kontextus előkészítési stratégiájának filozófiája
Architektúra
- Áttekintés - Rendszerkomponensek és adatfolyam
- Architektúra fejlődés - Az út a v3-tól a v5-ig
- Hooks architektúra - Hogyan használja a Claude-Mem az életciklus hookokat
- Hooks referencia - 7 hook szkript magyarázata
- Worker szolgáltatás - HTTP API és Bun kezelés
- Adatbázis - SQLite séma és FTS5 keresés
- Keresési architektúra - Hibrid keresés Chroma vektor adatbázissal
Konfiguráció és fejlesztés
- Konfiguráció - Környezeti változók és beállítások
- Fejlesztés - Építés, tesztelés, hozzájárulás
- Hibaelhárítás - Gyakori problémák és megoldások
Hogyan működik
Fő komponensek:
- 5 életciklus hook - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook szkript)
- Intelligens telepítés - Gyorsítótárazott függőség ellenőrző (pre-hook szkript, nem életciklus hook)
- Worker szolgáltatás - HTTP API a 37777-es porton webes megjelenítő felülettel és 10 keresési végponttal, Bun által kezelve
- SQLite adatbázis - Munkamenetek, megfigyelések, összefoglalók tárolása
- mem-search Skill - Természetes nyelvi lekérdezések progresszív felfedéssel
- Chroma vektor adatbázis - Hibrid szemantikus + kulcsszó keresés intelligens kontextus visszakereséshez
További részletekért lásd az Architektúra áttekintést.
mem-search Skill
A Claude-Mem intelligens keresést biztosít a mem-search skillen keresztül, amely automatikusan aktiválódik, amikor múltbeli munkáról kérdez:
Hogyan működik:
- Csak kérdezzen természetesen: "Mit csináltunk az előző munkamenetben?" vagy "Javítottuk már ezt a hibát korábban?"
- Claude automatikusan meghívja a mem-search skillet a releváns kontextus megtalálásához
Elérhető keresési műveletek:
- Megfigyelések keresése - Teljes szöveges keresés a megfigyelésekben
- Munkamenetek keresése - Teljes szöveges keresés munkamenet összefoglalókban
- Promptok keresése - Nyers felhasználói kérések keresése
- Koncepció szerint - Keresés koncepció címkék alapján (discovery, problem-solution, pattern, stb.)
- Fájl szerint - Adott fájlokra hivatkozó megfigyelések keresése
- Típus szerint - Keresés típus alapján (decision, bugfix, feature, refactor, discovery, change)
- Legutóbbi kontextus - Legutóbbi munkamenet kontextus lekérése egy projekthez
- Idővonal - Egységes idővonal kontextus lekérése egy adott időpont körül
- Idővonal lekérdezéssel - Megfigyelések keresése és idővonal kontextus lekérése a legjobb találat körül
- API segítség - Keresési API dokumentáció lekérése
Példa természetes nyelvi lekérdezésekre:
"Milyen hibákat javítottunk az előző munkamenetben?"
"Hogyan implementáltuk az autentikációt?"
"Milyen változtatások történtek a worker-service.ts fájlban?"
"Mutasd a legutóbbi munkát ezen a projekten"
"Mi történt, amikor hozzáadtuk a megjelenítő felületet?"
Részletes példákért lásd a Keresési eszközök útmutatót.
Béta funkciók
A Claude-Mem béta csatornát kínál kísérleti funkciókkal, mint az Endless Mode (biomimetikus memória architektúra hosszabb munkamenetekhez). Váltson a stabil és béta verziók között a webes megjelenítő felületről a http://localhost:37777 → Settings címen.
További részletekért az Endless Mode-ról és annak kipróbálásáról lásd a Béta funkciók dokumentációt.
Rendszerkövetelmények
- Node.js: 18.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)
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.
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:
- Fork-olja a tárolót
- Hozzon létre egy feature branchet
- Végezze el változtatásait tesztekkel
- Frissítse a dokumentációt
- Nyújtson be egy Pull Requestet
A hozzájárulási munkafolyamatért lásd a Fejlesztési útmutatót.
Licenc
Ez a projekt a GNU Affero General Public License v3.0 (AGPL-3.0) alatt licencelt.
Copyright (C) 2025 Alex Newman (@thedotmack). Minden jog fenntartva.
A teljes részletekért lásd a LICENSE fájlt.
Mit jelent ez:
- Szabadon használhatja, módosíthatja és terjesztheti ezt a szoftvert
- Ha módosítja és hálózati szerveren telepíti, elérhetővé kell tennie a forráskódot
- A származékos munkáknak szintén AGPL-3.0 alatt kell licencelve lenniük
- Ehhez a szoftverhez NINCS GARANCIA
Megjegyzés a Ragtime-ról: A ragtime/ könyvtár külön licencelt a PolyForm Noncommercial License 1.0.0 alatt. Részletekért lásd a ragtime/LICENSE fájlt.
Támogatás
- Dokumentáció: docs/
- Hibák: GitHub Issues
- Tároló: github.com/thedotmack/claude-mem
- Szerző: Alex Newman (@thedotmack)
Claude Agent SDK-val építve | Claude Code által hajtva | TypeScript-tel készítve