Skip to content

README.pl.md

Latest commit

 

History

History
431 lines (316 loc) · 18.4 KB

README.pl.md

File metadata and controls

431 lines (316 loc) · 18.4 KB
Raw

🌐 To jest automatyczne tłumaczenie. Korekty społeczności są mile widziane!


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

System trwałej kompresji pamięci stworzony dla Claude Code.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview Star History Chart

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. Dzięki temu Claude może utrzymać ciągłość wiedzy o projektach nawet po zakończeniu sesji lub ponownym połączeniu.

Szybki Start

Zainstaluj za pomocą jednego polecenia:

npx claude-mem install

Lub zainstaluj dla OpenCode:

npx claude-mem install --ide opencode

Lub zainstaluj dla Antigravity CLI (przewodnik konfiguracji):

npx claude-mem install --ide antigravity

Lub zainstaluj z marketplace wtyczek wewnątrz Claude Code:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

Uruchom ponownie Claude Code. Kontekst z poprzednich sesji automatycznie pojawi się w nowych sesjach.

Uwaga: Claude-Mem jest również opublikowany na npm, ale npm install -g claude-mem instaluje wyłącznie SDK/bibliotekę — nie rejestruje hooków wtyczki ani nie konfiguruje usługi worker. Zawsze instaluj za pomocą npx claude-mem install lub powyższych poleceń /plugin.

🦞 OpenClaw Gateway

Zainstaluj claude-mem jako wtyczkę trwałej pamięci na bramkach OpenClaw za pomocą jednego polecenia:

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

Instalator obsługuje zależności, konfigurację wtyczki, konfigurację dostawcy AI, uruchomienie workera oraz opcjonalne strumienie obserwacji w czasie rzeczywistym do Telegram, Discord, Slack i innych. Zobacz Przewodnik Integracji OpenClaw, aby poznać szczegóły.

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 URL workera wyświetlonym przy uruchomieniu
  • 💻 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 przez API workera lub wyświetl wszystkie w przeglądarce internetowej

Dokumentacja

📚 Wyświetl Pełną Dokumentację - Przeglądaj na oficjalnej stronie

Pierwsze Kroki

Najlepsze Praktyki

Architektura

Konfiguracja i Rozwój

Jak To Działa

Główne Komponenty:

  1. 5 Hooków Cyklu Życia - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 skryptów hooków)
  2. Inteligentna Instalacja - Buforowany sprawdzacz zależności (skrypt pre-hook, nie hook cyklu życia)
  3. Usługa Worker - Lokalne HTTP API z interfejsem przeglądarki internetowej i punktami końcowymi wyszukiwania, zarządzane przez Bun
  4. Baza Danych SQLite - Przechowuje sesje, obserwacje, podsumowania
  5. Umiejętność mem-search - Zapytania w języku naturalnym ze stopniowym ujawnianiem
  6. Baza Wektorów Chroma - Hybrydowe wyszukiwanie semantyczne + słowa kluczowe dla inteligentnego pobierania kontekstu

Zobacz Przegląd Architektury, aby poznać szczegóły.

Narzędzia Wyszukiwania MCP

Claude-Mem zapewnia inteligentne wyszukiwanie pamięci poprzez 4 narzędzia MCP zgodnie z efektywnym pod względem tokenów wzorcem 3-warstwowego przepływu pracy:

3-Warstwowy Przepływ Pracy:

  1. search - Uzyskaj kompaktowy indeks z identyfikatorami (~50-100 tokenów/wynik)
  2. timeline - Uzyskaj chronologiczny kontekst wokół interesujących wyników
  3. get_observations - Pobierz pełne szczegóły TYLKO dla przefiltrowanych identyfikatorów (~500-1 000 tokenów/wynik)

Jak To Działa:

  • Claude używa narzędzi MCP do przeszukiwania Twojej pamięci
  • Zacznij od search, aby uzyskać indeks wyników
  • Użyj timeline, aby zobaczyć, co działo się wokół konkretnych obserwacji
  • Użyj get_observations, aby pobrać pełne szczegóły dla odpowiednich identyfikatorów
  • Oszczędność tokenów ~10x dzięki filtrowaniu przed pobraniem szczegółów

Dostępne Narzędzia MCP:

  1. search - Przeszukuj indeks pamięci za pomocą zapytań pełnotekstowych, filtruj według typu/daty/projektu
  2. timeline - Uzyskaj chronologiczny kontekst wokół konkretnej obserwacji lub zapytania
  3. get_observations - Pobierz pełne szczegóły obserwacji według identyfikatorów (zawsze grupuj wiele identyfikatorów)

Przykładowe Użycie:

// Krok 1: Wyszukaj indeks
search(query="authentication bug", type="bugfix", limit=10)

// Krok 2: Przejrzyj indeks, zidentyfikuj odpowiednie identyfikatory (np. #123, #456)

// Krok 3: Pobierz pełne szczegóły
get_observations(ids=[123, 456])

Zobacz Przewodnik Narzędzi Wyszukiwania, aby poznać szczegółowe przykłady.

Gałęzie Wydań

Stabilne wydania są publikowane z gałęzi main i trafiają do npm. core-dev i community-edge to gałęzie uruchamiane ze źródła, przeznaczone do wczesnych poprawek niezawodności i integracji społeczności. Zobacz Gałęzie Wydań, aby poznać przepływ gałęzi i instrukcje uruchamiania wersji niestabilnych.

Wymagania Systemowe

  • Node.js: 20.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)

Uwagi Dotyczące Konfiguracji na Windows

Jeśli widzisz błąd podobny do:

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

Upewnij się, że Node.js i npm są zainstalowane i dodane do zmiennej PATH. Pobierz najnowszy instalator Node.js ze strony https://nodejs.org i uruchom ponownie terminal po instalacji.

Konfiguracja

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, aby poznać wszystkie dostępne ustawienia i przykłady.

Konfiguracja Trybu i Języka

Claude-Mem obsługuje wiele trybów pracy i języków poprzez ustawienie CLAUDE_MEM_MODE.

Ta opcja kontroluje jednocześnie:

  • Zachowanie przepływu pracy (np. code, chill, investigation)
  • Język używany w generowanych obserwacjach

Jak Skonfigurować

Edytuj plik ustawień w ~/.claude-mem/settings.json:

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

Tryby są zdefiniowane w plugin/modes/. Aby zobaczyć wszystkie dostępne tryby lokalnie:

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

Dostępne Tryby

Tryb Opis
code Domyślny tryb angielski
code--zh Tryb uproszczonego chińskiego
code--ja Tryb japoński

Tryby specyficzne dla języka podążają za wzorcem code--[lang], gdzie [lang] to kod języka ISO 639-1 (np. zh dla chińskiego, ja dla japońskiego, es dla hiszpańskiego).

Uwaga: code--zh (uproszczony chiński) jest już wbudowany — nie jest wymagana dodatkowa instalacja ani aktualizacja wtyczki.

Po Zmianie Trybu

Uruchom ponownie Claude Code, aby zastosować nową konfigurację trybu.

Rozwój

Zobacz Przewodnik Rozwoju, aby poznać instrukcje budowania, testowania i przepływu pracy współpracy.

Rozwiązywanie Problemów

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

Zgłoszenia Błędów

Twórz kompleksowe raporty błędów za pomocą automatycznego generatora:

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

Współpraca

Wkład jest mile widziany! Proszę:

  1. Forkuj repozytorium
  2. Utwórz gałąź funkcji
  3. Dokonaj zmian z testami
  4. Zaktualizuj dokumentację
  5. Prześlij Pull Request

Claude-Mem jest wydawany z trzech gałęzi: main (stabilna), core-dev oraz community-edge. Tylko main jest publikowana na npm; pozostałe są uruchamiane ze źródła. Zobacz Gałęzie Wydań, aby poznać strategię i instrukcje lokalnego uruchamiania.

Zobacz Przewodnik Rozwoju dla przepływu pracy współpracy.

Licencja

Claude-Mem jest licencjonowany na podstawie Apache License 2.0.

Wybraliśmy Apache-2.0, ponieważ trwała pamięć agentowa powinna być łatwa do osadzenia w narzędziach deweloperskich, lokalnych agentach, serwerach MCP, systemach korporacyjnych, stosach robotyki i produkcyjnych środowiskach agentów.

Zobacz plik LICENSE, aby poznać pełne szczegóły. Zobacz docs/license.md oraz docs/ip-boundary.md, aby poznać zakres licencjonowania i granicę między wersją otwartą a komercyjną.

Uwaga dotycząca Ragtime: Katalog ragtime/ jest licencjonowany na podstawie Apache License 2.0. Zobacz ragtime/LICENSE, aby poznać szczegóły.

Wsparcie

Zbudowano za pomocą Claude Agent SDK | Działa z Claude Code | Wykonane w TypeScript

A Co z CMEM?

CMEM to token stworzony przez stronę trzecią, ale oficjalnie zaakceptowany przez twórcę Claude-Mem (Alex Newman, @thedotmack). Token pełni rolę katalizatora rozwoju społeczności i wehikułu wprowadzającego CMEM do deweloperów i pracowników wiedzy, którzy najbardziej go potrzebują.

Oficjalny adres kontraktu BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3