Skip to content

README.tr.md

Latest commit

 

History

History
184 lines (134 loc) · 7.94 KB

README.tr.md

File metadata and controls

184 lines (134 loc) · 7.94 KB
Raw

Lemma Logo

Lemma — LLM'ler için Kalıcı Bellek (MCP)

English | Türkçe

Lemma, LLM'lere oturumlar arası kalıcı bellek sağlayan bir MCP sunucusudur. Bellekler her oturuma otomatik enjekte edilir — araç çağrısına gerek yoktur. Bilgi kullanım yoluyla evrilir: sık erişilenler güçlenir, kullanılmayanlar solar, örüntüler yeniden kullanılabilir yeteklere dönüştürülür. Arka planda otonom bir zeka katmanı çalışır — çelişkileri tespit eder, eylem önerileri sunar ve ilgili bilgileri otomatik bağlar. Mantık sürekliliği denenen/reddedilen yaklaşımları kaydeder ve her yeni oturumun başında çıkmaz sokakları (dead-end) hatırlatır, böylece aynı başarısız yol iki kez denenmez.

Hızlı Başlangıç

Lemma'yı MCP istemci yapılandırmanıza ekleyin:

Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json Claude Code (Linux): ~/.claude.json veya ~/.claude/settings.json opencode: ~/.config/opencode/opencode.json (Linux/macOS) veya %APPDATA%\opencode\opencode.json (Windows)

{
  "mcpServers": {
    "lemma": {
      "command": "npx",
      "args": ["-y", "lemma-mcp@latest"]
    }
  }
}

@latest kullanmak npx'in her zaman en yeni sürümü çekmesini sağlar.

Gereksinimler: Node.js 20.0.0 veya üzeri

CLI Kullanımı

lemma -lib    # Library Mode: bilgi tabanınızın tam anlık görüntüsü

Tüm bellekler, rehberler, ilişkiler, eski fragmanlar, damıtma adayları ve önerilen eylemlerin tam analizini çıkarır. Periyodik bakım ve inceleme için kullanışlıdır.

Nasıl Çalışır?

Bellekler tools/list üzerinden araç açıklamalarına enjekte edilir. LLM her oturuma en önemli belleklerini zaten bilerek başlar.

3 katmanlı enjeksiyon:

  • En önemli bellekler için tam içerik (token bütçeli)
  • Kalan bellekler için özet indeksi
  • Öğrenimleriyle aktif rehberler

Bellek türleri: fact, pattern, lesson, warning, context

Bilgi hattı: Memory (ne biliyorsun, lemma_memory_add) → Pattern (type: "pattern") → Guide (nasıl çalışıyorsun, lemma_guide_distill → lemma_guide_practice)

Proje dosyasına müdahale yok: Lemma belleği MCP prompt katmanı (sistem prompt'u ve araç açıklamaları) üzerinden enjekte eder; AGENTS.md'ye veya herhangi bir proje dosyasına asla yazmaz. Tüm MCP istemcilerinde aynı çalışır. (Eski sürümlerin bıraktığı <!-- lemma:* --> blokları açılışta otomatik temizlenir.)

Otonom Zeka

Lemma arka planda zeka çalıştırır — manuel tetiklemeye gerek yoktur:

  • Çelişki Tespiti: Yeni bellekleri mevcut bilgiyle otomatik karşılaştırır. Çelişkileri çözüm önerileriyle raporlar.
  • Proaktif Öneriler: Bellek ekledikten veya rehber pratiği yaptıktan sonra örüntüleri damıtma, yinelenenleri birleştirme veya düşük performanslı rehberleri iyileştirme gibi eylemler önerir.
  • Otomatik Bağlama: Sık birlikte okunan bellekler ve konu örtüşen fragmanlar otomatik olarak ilişkilendirilir.

Manuel derin analiz de özel araçlarla kullanılabilir.

Araçlar (26)

Bellek (10)

Araç Açıklama
lemma_memory_read Fragmanları oku/ara. Özet modu veya ID ile tam detay
lemma_memory_add Bulguları kaydet. Gizli bilgileri otomatik sansürler, tekrarları ve çelişkileri algılar
lemma_memory_update ID ile fragman güncelle
lemma_memory_feedback Pozitif/negatif geri bildirim, güveni ayarlar
lemma_memory_forget Fragman sil
lemma_memory_merge Fragmanları birleştir, ilişkiler ve rehber bağlantıları aktarılır
lemma_memory_relate Tipli bağlantılar oluştur (contradicts, supersedes, supports, related_to)
lemma_memory_stats Fragman sayıları, güven, proje dağılımı
lemma_memory_audit Bütünlük kontrolü (yetim, tekrar, anomali)
lemma_memory_library Tüm bilgi tabanının analiz sinyalleri ve önerilerle tam anlık görüntüsü

Rehberler (7)

Araç Açıklama
lemma_guide_get Kullanıma göre sıralı rehberler, kategori veya görev filtresi
lemma_guide_practice Rehber kullanımını kaydet. Rehber yoksa otomatik oluşturur
lemma_guide_create Detaylı kılavuzla rehber oluştur
lemma_guide_distill Belleği rehber öğrenimine dönüştür (çift yönlü bağlantı)
lemma_guide_update Rehber özelliklerini, anti-örüntüleri, tuzakları güncelle
lemma_guide_forget Rehber sil
lemma_guide_merge Rehberleri birleştir, kaynak bellekleri aktar

Oturumlar (5)

Araç Açıklama
lemma_session_start İzlenen oturum başlat, ilgili bağlamı önceden yükle
lemma_session_attempt Denenen bir yaklaşımı kaydet (reddedilen/kısmi/umut verici) — çıkmaz sokaklar değerli bellektir
lemma_session_end İnceleme, otomatik bağlama ve önerilerle oturumu sonlandır
lemma_session_stats Sanal oturum istatistikleri
lemma_suggestion_respond Sunulan iyileştirme önerisini kabul et veya reddet (Lemma tercihlerini öğrenir)

Zeka (4)

Araç Açıklama
lemma_conflict_scan Tüm bellekleri çelişkiler için tara
lemma_proactive_analysis Tam bilgi tabanı analizi: eski, yetim, damıtma adayları, kullanım dışı
lemma_project_analytics Oturumlar arası proje sağlığı, büyüme oranı, beceri kapsama
lemma_semantic_search TF-IDF benzerlik araması

Yapılandırma

~/.lemma/config.json konumunda isteğe bağlı:

{
  "token_budget": {
    "full_content": 5000,
    "summary_index": 1000,
    "guides_detail": 1000
  },
  "injection": {
    "max_full_content_fragments": 15,
    "max_summary_fragments": 30,
    "max_guides": 20
  },
  "virtual_session": {
    "timeout_minutes": 30
  }
}

Dosya Konumları

İşletim Sistemi Yol
Windows C:\Users\{username}\.lemma\
macOS/Linux ~/.lemma/

Dosyalar: lemma.db (SQLite), config.json, sessions/, logs/

Arama

Lemma bellek arama, tekrar algılama ve konu örtüşme tespiti için SQLite FTS5 tam metin arama kullanır.

Veri Depolama

Tüm veriler tek bir SQLite veritabanında (~/.lemma/lemma.db) saklanır:

Tablo Amaç
memories Bellek fragmanları (FTS5 + metadata)
guides Prosedürel bilgi ve öğrenimler
sessions Oturum takibi ve sonuçlar
relations Bellekler arası tipli bağlantılar
guide_learnings Rehber bazlı biriken öğrenimler
guide_memory_links Çift yönlü rehber ↔ bellek bağlantıları

Eski JSONL dosyaları ilk çalıştırmada otomatik olarak taşınır.

Güvenlik

Lemma tasarım gerei yerel-önceliklidir:

  • Yerel depolama — tüm veriler ~/.lemma/ dizininde kalır; hiçbir şey harici sunuculara gönderilmez.
  • Gizli bilgi sansürleme — gizliler bellek fragmanlarından VE traffic log'larından otomatik temizlenir (API anahtarları, tokenlar, bağlantı dizgileri için 17 regex deseni; konum-tabanlı, aşırı-maskeleme ve overlap bug'ı yok).
  • Visualizer sertleştirme — visualizer yalnızca 127.0.0.1'e bağlanır (0.0.0.0 asla), X-Lemma-Token gerektirir ve dar bir localhost CORS allow-list kullanır (Access-Control-Allow-Origin: * yok).

Dokümantasyon

Lisans

MIT