🌐 To jest automatyczne tłumaczenie. Korekty społeczności są mile widziane!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 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
System trwałej kompresji pamięci stworzony dla Claude Code.
Szybki Start • Jak To Działa • Narzędzia Wyszukiwania • Dokumentacja • Konfiguracja • Rozwiązywanie Problemów • Licencja
Claude-Mem płynnie zachowuje kontekst między sesjami, automatycznie przechwytując obserwacje użycia narzędzi, generując semantyczne podsumowania i udostępniając je przyszłym sesjom. To umożliwia Claude utrzymanie ciągłości wiedzy o projektach nawet po zakończeniu lub ponownym połączeniu sesji.
Uruchom nową sesję Claude Code w terminalu i wprowadź następujące polecenia:
> /plugin marketplace add thedotmack/claude-mem > /plugin install claude-mem
Uruchom ponownie Claude Code. Kontekst z poprzednich sesji automatycznie pojawi się w nowych sesjach.
Kluczowe Funkcje:
- 🧠 Trwała Pamięć - Kontekst przetrwa między sesjami
- 📊 Stopniowe Ujawnianie - Warstwowe pobieranie pamięci z widocznością kosztów tokenów
- 🔍 Wyszukiwanie Oparte na Umiejętnościach - Przeszukuj historię projektu za pomocą umiejętności mem-search
- 🖥️ Interfejs Przeglądarki Internetowej - Strumień pamięci w czasie rzeczywistym pod adresem http://localhost:37777
- 💻 Umiejętność Claude Desktop - Przeszukuj pamięć z konwersacji Claude Desktop
- 🔒 Kontrola Prywatności - Użyj tagów
<private>, aby wykluczyć wrażliwe treści z przechowywania - ⚙️ Konfiguracja Kontekstu - Szczegółowa kontrola nad tym, jaki kontekst jest wstrzykiwany
- 🤖 Automatyczne Działanie - Nie wymaga ręcznej interwencji
- 🔗 Cytowania - Odniesienia do przeszłych obserwacji za pomocą identyfikatorów (dostęp przez http://localhost:37777/api/observation/{id} lub wyświetl wszystkie w przeglądarce internetowej pod adresem http://localhost:37777)
- 🧪 Kanał Beta - Wypróbuj eksperymentalne funkcje, takie jak Endless Mode, poprzez przełączanie wersji
📚 Wyświetl Pełną Dokumentację - Przeglądaj na oficjalnej stronie
- Przewodnik Instalacji - Szybki start i zaawansowana instalacja
- Przewodnik Użytkowania - Jak Claude-Mem działa automatycznie
- Narzędzia Wyszukiwania - Przeszukuj historię projektu w języku naturalnym
- Funkcje Beta - Wypróbuj eksperymentalne funkcje, takie jak Endless Mode
- Inżynieria Kontekstu - Zasady optymalizacji kontekstu agenta AI
- Stopniowe Ujawnianie - Filozofia strategii przygotowania kontekstu Claude-Mem
- Przegląd - Komponenty systemu i przepływ danych
- Ewolucja Architektury - Droga od v3 do v5
- Architektura Hooków - Jak Claude-Mem wykorzystuje hooki cyklu życia
- Dokumentacja Hooków - 7 skryptów hooków wyjaśnionych
- Usługa Worker - HTTP API i zarządzanie Bun
- Baza Danych - Schemat SQLite i wyszukiwanie FTS5
- Architektura Wyszukiwania - Hybrydowe wyszukiwanie z bazą wektorów Chroma
- Konfiguracja - Zmienne środowiskowe i ustawienia
- Rozwój - Budowanie, testowanie, współpraca
- Rozwiązywanie Problemów - Typowe problemy i rozwiązania
Główne Komponenty:
- 5 Hooków Cyklu Życia - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 skryptów hooków)
- Inteligentna Instalacja - Buforowany sprawdzacz zależności (skrypt pre-hook, nie hook cyklu życia)
- Usługa Worker - HTTP API na porcie 37777 z interfejsem przeglądarki internetowej i 10 punktami końcowymi wyszukiwania, zarządzana przez Bun
- Baza Danych SQLite - Przechowuje sesje, obserwacje, podsumowania
- Umiejętność mem-search - Zapytania w języku naturalnym ze stopniowym ujawnianiem
- Baza Wektorów Chroma - Hybrydowe wyszukiwanie semantyczne + słowa kluczowe dla inteligentnego pobierania kontekstu
Zobacz Przegląd Architektury dla szczegółów.
Claude-Mem zapewnia inteligentne wyszukiwanie poprzez umiejętność mem-search, która automatycznie aktywuje się, gdy pytasz o przeszłą pracę:
Jak To Działa:
- Po prostu pytaj naturalnie: "Co robiliśmy w ostatniej sesji?" lub "Czy naprawiliśmy ten błąd wcześniej?"
- Claude automatycznie wywołuje umiejętność mem-search, aby znaleźć odpowiedni kontekst
Dostępne Operacje Wyszukiwania:
- Search Observations - Wyszukiwanie pełnotekstowe w obserwacjach
- Search Sessions - Wyszukiwanie pełnotekstowe w podsumowaniach sesji
- Search Prompts - Wyszukiwanie surowych żądań użytkownika
- By Concept - Znajdź według tagów koncepcyjnych (discovery, problem-solution, pattern, itp.)
- By File - Znajdź obserwacje odnoszące się do określonych plików
- By Type - Znajdź według typu (decision, bugfix, feature, refactor, discovery, change)
- Recent Context - Pobierz ostatni kontekst sesji dla projektu
- Timeline - Uzyskaj ujednoliconą oś czasu kontekstu wokół określonego punktu w czasie
- Timeline by Query - Wyszukaj obserwacje i uzyskaj kontekst osi czasu wokół najlepszego dopasowania
- API Help - Uzyskaj dokumentację API wyszukiwania
Przykładowe Zapytania w Języku Naturalnym:
"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?"
Zobacz Przewodnik Narzędzi Wyszukiwania dla szczegółowych przykładów.
Claude-Mem oferuje kanał beta z eksperymentalnymi funkcjami, takimi jak Endless Mode (biomimetyczna architektura pamięci dla rozszerzonych sesji). Przełączaj się między stabilnymi a beta wersjami z interfejsu przeglądarki internetowej pod adresem http://localhost:37777 → Settings.
Zobacz Dokumentacja Funkcji Beta dla szczegółów dotyczących Endless Mode i sposobu wypróbowania.
- Node.js: 18.0.0 lub wyższy
- Claude Code: Najnowsza wersja z obsługą wtyczek
- Bun: Środowisko uruchomieniowe JavaScript i menedżer procesów (automatycznie instalowany, jeśli brakuje)
- uv: Menedżer pakietów Python do wyszukiwania wektorowego (automatycznie instalowany, jeśli brakuje)
- SQLite 3: Do trwałego przechowywania (dołączony)
Ustawienia są zarządzane w ~/.claude-mem/settings.json (automatycznie tworzone z domyślnymi wartościami przy pierwszym uruchomieniu). Skonfiguruj model AI, port workera, katalog danych, poziom logowania i ustawienia wstrzykiwania kontekstu.
Zobacz Przewodnik Konfiguracji dla wszystkich dostępnych ustawień i przykładów.
Zobacz Przewodnik Rozwoju dla instrukcji budowania, testowania i przepływu pracy współpracy.
Jeśli napotkasz problemy, opisz problem Claude, a umiejętność troubleshoot automatycznie zdiagnozuje i dostarczy poprawki.
Zobacz Przewodnik Rozwiązywania Problemów dla typowych problemów i rozwiązań.
Twórz kompleksowe raporty błędów za pomocą automatycznego generatora:
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
Wkład jest mile widziany! Proszę:
- Forkuj repozytorium
- Utwórz gałąź funkcji
- Dokonaj zmian z testami
- Zaktualizuj dokumentację
- Prześlij Pull Request
Zobacz Przewodnik Rozwoju dla przepływu pracy współpracy.
Ten projekt jest licencjonowany na podstawie GNU Affero General Public License v3.0 (AGPL-3.0).
Copyright (C) 2025 Alex Newman (@thedotmack). Wszelkie prawa zastrzeżone.
Zobacz plik LICENSE dla pełnych szczegółów.
Co To Oznacza:
- Możesz używać, modyfikować i dystrybuować to oprogramowanie swobodnie
- Jeśli zmodyfikujesz i wdrożysz na serwerze sieciowym, musisz udostępnić swój kod źródłowy
- Dzieła pochodne muszą być również licencjonowane na podstawie AGPL-3.0
- Nie ma GWARANCJI dla tego oprogramowania
Uwaga o Ragtime: Katalog ragtime/ jest licencjonowany osobno na podstawie PolyForm Noncommercial License 1.0.0. Zobacz ragtime/LICENSE dla szczegółów.
- Dokumentacja: docs/
- Problemy: GitHub Issues
- Repozytorium: github.com/thedotmack/claude-mem
- Autor: Alex Newman (@thedotmack)
Zbudowano za pomocą Claude Agent SDK | Zasilane przez Claude Code | Wykonane w TypeScript
