Skip to content

README.cs.md

Latest commit

 

History

History
431 lines (316 loc) · 18.2 KB

README.cs.md

File metadata and controls

431 lines (316 loc) · 18.2 KB
Raw

🌐 Toto je automatický překlad. Komunitní opravy jsou vítány!


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

Systém trvalé komprese paměti vytvořený pro Claude Code.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview Star History Chart

Rychlý start • Jak to funguje • Vyhledávací nástroje • Dokumentace • Konfigurace • Řešení problémů • Licence

Claude-Mem bezproblémově zachovává kontext napříč sezeními tím, že automaticky zaznamenává pozorování použití nástrojů, generuje sémantické souhrny a zpřístupňuje je budoucím sezením. To Claude umožňuje udržovat kontinuitu znalostí o projektech i po ukončení sezení nebo jeho opětovném navázání.

Rychlý start

Nainstalujte jedním příkazem:

npx claude-mem install

Nebo instalace pro OpenCode:

npx claude-mem install --ide opencode

Nebo instalace pro Antigravity CLI (návod k nastavení):

npx claude-mem install --ide antigravity

Nebo instalace z tržiště pluginů uvnitř Claude Code:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

Restartujte Claude Code. Kontext z předchozích sezení se automaticky objeví v nových sezeních.

Poznámka: Claude-Mem je také publikován na npm, ale npm install -g claude-mem nainstaluje pouze SDK/knihovnu — neregistruje háčky pluginu ani nenastaví worker službu. Vždy instalujte pomocí npx claude-mem install nebo výše uvedených příkazů /plugin.

🦞 OpenClaw Gateway

Nainstalujte claude-mem jako plugin trvalé paměti na gateway OpenClaw jediným příkazem:

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

Instalátor se stará o závislosti, nastavení pluginu, konfiguraci AI poskytovatele, spuštění workeru a volitelné feedy pozorování v reálném čase do Telegramu, Discordu, Slacku a dalších. Podrobnosti najdete v Průvodci integrací OpenClaw.

Klíčové vlastnosti:

  • 🧠 Trvalá paměť - Kontext přetrvává napříč sezeními
  • 📊 Postupné odhalování - Vrstvené vyhledávání paměti s viditelností nákladů na tokeny
  • 🔍 Vyhledávání založené na dovednostech - Dotazujte se na historii projektu pomocí dovednosti mem-search
  • 🖥️ Webové uživatelské rozhraní - Tok paměti v reálném čase na adrese URL workeru vypsané při spuštění
  • 💻 Dovednost pro Claude Desktop - Vyhledávejte v paměti z konverzací Claude Desktop
  • 🔒 Kontrola soukromí - Použijte značky <private> k vyloučení citlivého obsahu z úložiště
  • ⚙️ Konfigurace kontextu - Jemně odstupňovaná kontrola nad tím, jaký kontext se vkládá
  • 🤖 Automatický provoz - Není vyžadován žádný manuální zásah
  • 🔗 Citace - Odkazujte na minulá pozorování pomocí ID přes API workeru nebo zobrazte vše ve webovém prohlížeči

Dokumentace

📚 Zobrazit kompletní dokumentaci - Procházet na oficiálních stránkách

Začínáme

Osvědčené postupy

Architektura

Konfigurace a vývoj

Jak to funguje

Hlavní komponenty:

  1. 5 Lifecycle Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook skriptů)
  2. Chytrá instalace - Kontrola cachovaných závislostí (pre-hook skript, ne lifecycle hook)
  3. Worker Service - Lokální HTTP API s webovým prohlížečem a vyhledávacími endpointy, spravováno pomocí Bun
  4. SQLite databáze - Ukládá sezení, pozorování, souhrny
  5. mem-search dovednost - Dotazy v přirozeném jazyce s postupným odhalováním
  6. Chroma vektorová databáze - Hybridní sémantické + klíčové vyhledávání pro inteligentní vyhledávání kontextu

Podrobnosti najdete v Přehledu architektury.

Vyhledávací nástroje MCP

Claude-Mem poskytuje inteligentní vyhledávání v paměti prostřednictvím 4 nástrojů MCP podle vzoru 3vrstvého pracovního postupu šetřícího tokeny:

3vrstvý pracovní postup:

  1. search - Získání kompaktního indexu s ID (~50-100 tokenů/výsledek)
  2. timeline - Získání chronologického kontextu kolem zajímavých výsledků
  3. get_observations - Získání úplných podrobností POUZE pro vyfiltrovaná ID (~500-1 000 tokenů/výsledek)

Jak to funguje:

  • Claude používá nástroje MCP k vyhledávání ve vaší paměti
  • Začněte s search, abyste získali index výsledků
  • Použijte timeline k zobrazení toho, co se dělo kolem konkrétních pozorování
  • Použijte get_observations k získání úplných podrobností pro relevantní ID
  • Úspora tokenů až ~10x díky filtrování před získáváním podrobností

Dostupné nástroje MCP:

  1. search - Vyhledávání v indexu paměti pomocí fulltextových dotazů, filtrování podle typu/data/projektu
  2. timeline - Získání chronologického kontextu kolem konkrétního pozorování nebo dotazu
  3. get_observations - Získání úplných podrobností pozorování podle ID (vždy dávkově s více ID)

Příklad použití:

// Krok 1: Vyhledání indexu
search(query="authentication bug", type="bugfix", limit=10)

// Krok 2: Prohlédnutí indexu, identifikace relevantních ID (např. #123, #456)

// Krok 3: Získání úplných podrobností
get_observations(ids=[123, 456])

Podrobné příklady najdete v Průvodci vyhledávacími nástroji.

Vydávací větve

Stabilní vydání jsou publikována z větve main a zveřejněna na npm. core-dev a community-edge jsou větve spouštěné ze zdrojového kódu určené pro včasné opravy spolehlivosti a komunitní integrace. Podrobnosti o toku větví a pokyny ke spuštění nestabilních verzí najdete v Vydávacích větvích.

Systémové požadavky

  • Node.js: 20.0.0 nebo vyšší
  • Claude Code: Nejnovější verze s podporou pluginů
  • Bun: JavaScript runtime a správce procesů (automaticky nainstalován, pokud chybí)
  • uv: Python správce balíčků pro vektorové vyhledávání (automaticky nainstalován, pokud chybí)
  • SQLite 3: Pro trvalé úložiště (součástí balíčku)

Poznámky k nastavení pro Windows

Pokud se zobrazí chyba jako:

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

Ujistěte se, že Node.js a npm jsou nainstalované a přidané do vaší proměnné PATH. Stáhněte nejnovější instalátor Node.js z https://nodejs.org a po instalaci restartujte terminál.

Konfigurace

Nastavení jsou spravována v ~/.claude-mem/settings.json (automaticky vytvořeno s výchozími hodnotami při prvním spuštění). Konfigurujte AI model, port workeru, datový adresář, úroveň logování a nastavení vkládání kontextu.

Všechna dostupná nastavení a příklady najdete v Průvodci konfigurací.

Konfigurace režimu a jazyka

Claude-Mem podporuje více pracovních režimů a jazyků prostřednictvím nastavení CLAUDE_MEM_MODE.

Tato volba ovládá jak:

  • Chování pracovního postupu (např. code, chill, investigation)
  • Jazyk používaný ve vygenerovaných pozorováních

Jak nakonfigurovat

Upravte svůj soubor nastavení v ~/.claude-mem/settings.json:

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

Režimy jsou definovány v plugin/modes/. Chcete-li zobrazit všechny dostupné režimy lokálně:

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

Dostupné režimy

Režim Popis
code Výchozí anglický režim
code--zh Zjednodušená čínština
code--ja Japonština

Jazykově specifické režimy se řídí vzorem code--[lang], kde [lang] je kód jazyka podle ISO 639-1 (např. zh pro čínštinu, ja pro japonštinu, es pro španělštinu).

Poznámka: code--zh (zjednodušená čínština) je již vestavěn — není potřeba žádná další instalace ani aktualizace pluginu.

Po změně režimu

Restartujte Claude Code, aby se použila nová konfigurace režimu.

Vývoj

Podrobné pokyny k sestavení, testování a pracovnímu postupu pro přispívání najdete v Průvodci vývojem.

Řešení problémů

Pokud zaznamenáváte problémy, popište problém Claude a dovednost troubleshoot automaticky diagnostikuje a poskytne opravy.

Běžné problémy a řešení najdete v Průvodci řešením problémů.

Hlášení chyb

Vytvořte komplexní hlášení chyby pomocí automatického generátoru:

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

Přispívání

Příspěvky jsou vítány! Prosím:

  1. Forkněte repositář
  2. Vytvořte feature branch
  3. Proveďte změny s testy
  4. Aktualizujte dokumentaci
  5. Odešlete Pull Request

Claude-Mem je vydáván ze tří větví: main (stabilní), core-dev a community-edge. Na npm je publikována pouze main; ostatní se spouštějí ze zdrojového kódu. Podrobnosti o strategii a pokyny ke spuštění lokálně najdete ve Vydávacích větvích.

Pracovní postup pro přispívání najdete v Průvodci vývojem.

Licence

Claude-Mem je licencován pod licencí Apache License 2.0.

Zvolili jsme Apache-2.0, protože trvalá agentní paměť by měla být snadno vložitelná do vývojářských nástrojů, lokálních agentů, MCP serverů, podnikových systémů, robotických stacků a produkčních harnessů pro agenty.

Úplné podrobnosti najdete v souboru LICENSE. Viz docs/license.md a docs/ip-boundary.md pro rozsah licencování a hranici mezi open source a komerčním využitím.

Poznámka k Ragtime: Adresář ragtime/ je licencován pod licencí Apache License 2.0. Podrobnosti najdete v ragtime/LICENSE.

Podpora

Vytvořeno pomocí Claude Agent SDK | Funguje s Claude Code | Vyrobeno s TypeScript

Co je to CMEM?

CMEM je token vytvořený třetí stranou, ale oficiálně přijatý tvůrcem Claude-Mem (Alex Newman, @thedotmack). Token funguje jako komunitní katalyzátor růstu a prostředek, jak přiblížit CMEM vývojářům a znalostním pracovníkům, kteří ho nejvíce potřebují.

Oficiální BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3