Skip to content

README.cs.md

Latest commit

 

History

History
304 lines (222 loc) · 13.4 KB

README.cs.md

File metadata and controls

304 lines (222 loc) · 13.4 KB

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


Claude-Mem

🇨🇳 中文 • 🇯🇵 日本語 • 🇧🇷 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

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

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 umožňuje Claude udržovat kontinuitu znalostí o projektech i po ukončení nebo opětovném připojení sezení.

Rychlý start

Spusťte nové sezení Claude Code v terminálu a zadejte následující příkazy:

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

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 http://localhost:37777
  • 💻 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řístup přes http://localhost:37777/api/observation/{id} nebo zobrazit vše ve webovém prohlížeči na http://localhost:37777)
  • 🧪 Beta kanál - Vyzkoušejte experimentální funkce jako Endless Mode přepnutím verze

Dokumentace

📚 Zobrazit kompletní dokumentaci - Procházejte dokumentaci v markdown na GitHubu

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 - HTTP API na portu 37777 s webovým prohlížečem a 10 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.

Dovednost mem-search

Claude-Mem poskytuje inteligentní vyhledávání prostřednictvím dovednosti mem-search, která se automaticky vyvolá, když se ptáte na minulou práci:

Jak to funguje:

  • Stačí se zeptat přirozeně: "Co jsme dělali minulé sezení?" nebo "Opravovali jsme tuto chybu dříve?"
  • Claude automaticky vyvolá dovednost mem-search k nalezení relevantního kontextu

Dostupné vyhledávací operace:

  1. Search Observations - Fulltextové vyhledávání napříč pozorováními
  2. Search Sessions - Fulltextové vyhledávání napříč souhrny sezení
  3. Search Prompts - Vyhledávání surových požadavků uživatelů
  4. By Concept - Hledání podle koncepčních značek (discovery, problem-solution, pattern, atd.)
  5. By File - Hledání pozorování odkazujících na konkrétní soubory
  6. By Type - Hledání podle typu (decision, bugfix, feature, refactor, discovery, change)
  7. Recent Context - Získání nedávného kontextu sezení pro projekt
  8. Timeline - Získání jednotné časové osy kontextu kolem konkrétního bodu v čase
  9. Timeline by Query - Vyhledávání pozorování a získání kontextu časové osy kolem nejlepší shody
  10. API Help - Získání dokumentace k vyhledávacímu API

Příklady dotazů v přirozeném jazyce:

"Jaké chyby jsme opravili minulé sezení?"
"Jak jsme implementovali autentizaci?"
"Jaké změny byly provedeny v worker-service.ts?"
"Ukaž mi nedávnou práci na tomto projektu"
"Co se dělo, když jsme přidávali viewer UI?"

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

Beta funkce

Claude-Mem nabízí beta kanál s experimentálními funkcemi jako Endless Mode (biomimetická architektura paměti pro prodloužená sezení). Přepínejte mezi stabilní a beta verzí z webového rozhraní na http://localhost:37777 → Settings.

Podrobnosti o Endless Mode a jak jej vyzkoušet najdete v Dokumentaci beta funkcí.

Systémové požadavky

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

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

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

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

Licence

Tento projekt je licencován pod GNU Affero General Public License v3.0 (AGPL-3.0).

Copyright (C) 2025 Alex Newman (@thedotmack). Všechna práva vyhrazena.

Úplné podrobnosti najdete v souboru LICENSE.

Co to znamená:

  • Software můžete volně používat, upravovat a distribuovat
  • Pokud jej upravíte a nasadíte na síťovém serveru, musíte zpřístupnit svůj zdrojový kód
  • Odvozená díla musí být také licencována pod AGPL-3.0
  • Pro tento software neexistuje ŽÁDNÁ ZÁRUKA

Poznámka k Ragtime: Adresář ragtime/ je licencován samostatně pod PolyForm Noncommercial License 1.0.0. Podrobnosti najdete v ragtime/LICENSE.

Podpora

Vytvořeno pomocí Claude Agent SDK | Poháněno Claude Code | Vyrobeno s TypeScript