Skip to content

README.tr.md

Latest commit

 

History

History
431 lines (316 loc) · 18.2 KB

README.tr.md

File metadata and controls

431 lines (316 loc) · 18.2 KB
Raw

🌐 Bu otomatik bir çevirisidir. Topluluk düzeltmeleri memnuniyetle karşılanır!


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

Claude Code için geliştirilmiş kalıcı bellek sıkıştırma sistemi.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview Star History Chart

Hızlı Başlangıç • Nasıl Çalışır • Arama Araçları • Dokümantasyon • Yapılandırma • Sorun Giderme • Lisans

Claude-Mem, araç kullanım gözlemlerini otomatik olarak yakalayarak, anlamsal özetler oluşturarak ve bunları gelecekteki oturumlarda kullanılabilir hale getirerek bağlamı oturumlar arası sorunsuzca korur. Bu, Claude'un oturumlar sona erse veya yeniden bağlansa bile projeler hakkındaki bilgi sürekliliğini korumasını sağlar.

Quick Start

Tek bir komutla kurun:

npx claude-mem install

Ya da OpenCode için kurun:

npx claude-mem install --ide opencode

Ya da Antigravity CLI için kurun (kurulum kılavuzu):

npx claude-mem install --ide antigravity

Ya da Claude Code içindeki plugin pazaryerinden kurun:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

Claude Code'u yeniden başlatın. Önceki oturumlardaki bağlam otomatik olarak yeni oturumlarda görünecektir.

Not: Claude-Mem npm'de de yayımlanmıştır, ancak npm install -g claude-mem yalnızca SDK/kütüphaneyi kurar — plugin hook'larını kaydetmez veya worker servisini kurmaz. Her zaman npx claude-mem install veya yukarıdaki /plugin komutlarıyla kurun.

🦞 OpenClaw Gateway

Claude-mem'i tek bir komutla OpenClaw gateway'lerine kalıcı bellek eklentisi olarak kurun:

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

Kurulum programı bağımlılıkları, plugin kurulumunu, AI sağlayıcı yapılandırmasını, worker başlatmayı ve Telegram, Discord, Slack ve daha fazlasına isteğe bağlı gerçek zamanlı gözlem akışlarını yönetir. Detaylar için OpenClaw Entegrasyon Kılavuzu bölümüne bakın.

Temel Özellikler:

  • 🧠 Kalıcı Bellek - Bağlam oturumlar arası hayatta kalır
  • 📊 Aşamalı Açıklama - Token maliyeti görünürlüğü ile katmanlı bellek erişimi
  • 🔍 Beceri Tabanlı Arama - mem-search becerisi ile proje geçmişinizi sorgulayın
  • 🖥️ Web Görüntüleyici Arayüzü - Başlangıçta yazdırılan worker URL'sinde gerçek zamanlı bellek akışı
  • 💻 Claude Desktop Becerisi - Claude Desktop konuşmalarından bellek araması yapın
  • 🔒 Gizlilik Kontrolü - Hassas içeriği depolamadan hariç tutmak için <private> etiketlerini kullanın
  • ⚙️ Bağlam Yapılandırması - Hangi bağlamın enjekte edileceği üzerinde detaylı kontrol
  • 🤖 Otomatik Çalışma - Manuel müdahale gerektirmez
  • 🔗 Alıntılar - Worker API üzerinden ID'lerle geçmiş gözlemlere referans verin veya tümünü web görüntüleyicide görüntüleyin

Documentation

📚 Tam Dokümantasyonu Görüntüle - Resmi web sitesinde göz atın

Başlarken

En İyi Uygulamalar

Mimari

Yapılandırma ve Geliştirme

How It Works

Temel Bileşenler:

  1. 5 Yaşam Döngüsü Hook'u - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook betiği)
  2. Akıllı Kurulum - Önbelleğe alınmış bağımlılık kontrolcüsü (ön-hook betiği, yaşam döngüsü hook'u değil)
  3. Worker Servisi - Web görüntüleyici arayüzü ve arama uç noktaları ile yerel HTTP API, Bun tarafından yönetilir
  4. SQLite Veritabanı - Oturumları, gözlemleri, özetleri saklar
  5. mem-search Becerisi - Aşamalı açıklama ile doğal dil sorguları
  6. Chroma Vektör Veritabanı - Akıllı bağlam erişimi için hibrit anlamsal + anahtar kelime arama

Detaylar için Mimari Genel Bakış bölümüne bakın.

MCP Search Tools

Claude-Mem, token açısından verimli bir 3 katmanlı iş akışı düzenini takip eden 4 MCP aracı aracılığıyla akıllı bellek araması sağlar:

3 Katmanlı İş Akışı:

  1. search - ID'lerle kompakt bir indeks alın (~50-100 token/sonuç)
  2. timeline - İlgi çekici sonuçların çevresindeki kronolojik bağlamı alın
  3. get_observations - Yalnızca filtrelenmiş ID'ler için tam detayları getirin (~500-1.000 token/sonuç)

Nasıl Çalışır:

  • Claude, belleğinizi aramak için MCP araçlarını kullanır
  • Sonuçların bir indeksini almak için search ile başlayın
  • Belirli gözlemlerin çevresinde neler olduğunu görmek için timeline kullanın
  • İlgili ID'ler için tam detayları getirmek üzere get_observations kullanın
  • Detayları getirmeden önce filtreleme yaparak ~10 kat token tasarrufu sağlanır

Mevcut MCP Araçları:

  1. search - Tam metin sorgularıyla bellek indeksini arayın, türe/tarihe/projeye göre filtreleyin
  2. timeline - Belirli bir gözlem veya sorgu etrafındaki kronolojik bağlamı alın
  3. get_observations - ID'lere göre tam gözlem detaylarını getirin (her zaman birden fazla ID'yi toplu olarak işleyin)

Örnek Kullanım:

// Adım 1: İndeks için arama yapın
search(query="authentication bug", type="bugfix", limit=10)

// Adım 2: İndeksi inceleyin, ilgili ID'leri belirleyin (örn. #123, #456)

// Adım 3: Tam detayları getirin
get_observations(ids=[123, 456])

Detaylı örnekler için Arama Araçları Kılavuzu bölümüne bakın.

Release Branches

Kararlı sürümler main dalından yayımlanır ve npm'e gönderilir. core-dev ve community-edge, erken güvenilirlik düzeltmeleri ve topluluk entegrasyonları için kaynaktan çalıştırılan dallardır. Dal akışı ve kararlı olmayan çalıştırma talimatları için Sürüm Dalları bölümüne bakın.

System Requirements

  • Node.js: 20.0.0 veya üzeri
  • Claude Code: Plugin desteği olan en son sürüm
  • Bun: JavaScript çalışma zamanı ve işlem yöneticisi (eksikse otomatik kurulur)
  • uv: Vektör arama için Python paket yöneticisi (eksikse otomatik kurulur)
  • SQLite 3: Kalıcı depolama için (dahildir)

Windows Kurulum Notları

Aşağıdaki gibi bir hata görürseniz:

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

Node.js ve npm'in kurulu olduğundan ve PATH'inize eklendiğinden emin olun. https://nodejs.org adresinden en son Node.js kurulum dosyasını indirin ve kurulumdan sonra terminalinizi yeniden başlatın.

Configuration

Ayarlar ~/.claude-mem/settings.json dosyasında yönetilir (ilk çalıştırmada varsayılanlarla otomatik oluşturulur). AI modelini, worker portunu, veri dizinini, log seviyesini ve bağlam enjeksiyon ayarlarını yapılandırın.

Tüm mevcut ayarlar ve örnekler için Yapılandırma Kılavuzu bölümüne bakın.

Mod ve Dil Yapılandırması

Claude-Mem, CLAUDE_MEM_MODE ayarı aracılığıyla birden fazla iş akışı modunu ve dili destekler.

Bu seçenek şunları kontrol eder:

  • İş akışı davranışını (örn. code, chill, investigation)
  • Oluşturulan gözlemlerde kullanılan dili

Nasıl Yapılandırılır

~/.claude-mem/settings.json konumundaki ayarlar dosyanızı düzenleyin:

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

Modlar plugin/modes/ içinde tanımlanır. Mevcut tüm modları yerel olarak görmek için:

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

Mevcut Modlar

Mod Açıklama
code Varsayılan İngilizce mod
code--zh Basitleştirilmiş Çince mod
code--ja Japonca mod

Dile özgü modlar code--[dil] düzenini takip eder; burada [dil], ISO 639-1 dil kodudur (örn. Çince için zh, Japonca için ja, İspanyolca için es).

Not: code--zh (Basitleştirilmiş Çince) zaten dahil edilmiştir — ek bir kurulum veya plugin güncellemesi gerekmez.

Mod Değiştirdikten Sonra

Yeni mod yapılandırmasını uygulamak için Claude Code'u yeniden başlatın.

Development

Derleme talimatları, test etme ve katkı iş akışı için Geliştirme Kılavuzu bölümüne bakın.

Troubleshooting

Sorunlarla karşılaşırsanız, sorunu Claude'a açıklayın ve troubleshoot becerisi otomatik olarak teşhis edip düzeltmeleri sağlayacaktır.

Yaygın sorunlar ve çözümler için Sorun Giderme Kılavuzu bölümüne bakın.

Bug Reports

Otomatik oluşturucu ile kapsamlı hata raporları oluşturun:

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

Contributing

Katkılar memnuniyetle karşılanır! Lütfen:

  1. Depoyu fork edin
  2. Bir özellik dalı oluşturun
  3. Testlerle değişikliklerinizi yapın
  4. Dokümantasyonu güncelleyin
  5. Pull Request gönderin

Claude-Mem üç daldan yayımlanır: main (kararlı), core-dev ve community-edge. Yalnızca main npm'e yayımlanır; diğerleri kaynaktan çalıştırılır. Strateji ve yerel çalıştırma talimatları için Sürüm Dalları bölümüne bakın.

Katkı iş akışı için Geliştirme Kılavuzu bölümüne bakın.

License

Claude-Mem, Apache License 2.0 lisansı altında lisanslanmıştır.

Apache-2.0'ı seçtik çünkü kalıcı ajan belleğinin geliştirici araçlarına, yerel ajanlara, MCP sunucularına, kurumsal sistemlere, robotik yığınlarına ve üretim ajan altyapılarına kolayca gömülebilir olması gerekiyor.

Tüm detaylar için LICENSE dosyasına bakın. Lisanslama kapsamı ve açık/ticari sınır için docs/license.md ve docs/ip-boundary.md bölümlerine bakın.

Ragtime ile ilgili not: ragtime/ dizini Apache License 2.0 altında lisanslanmıştır. Detaylar için ragtime/LICENSE bölümüne bakın.

Support

Claude Agent SDK ile geliştirilmiştir | Claude Code ile çalışır | TypeScript ile yapılmıştır

CMEM Ne Demek?

CMEM, 3. bir taraf tarafından oluşturulan ancak Claude-Mem'in yaratıcısı (Alex Newman, @thedotmack) tarafından resmi olarak benimsenen bir token'dır. Bu token, büyüme için bir topluluk katalizörü ve CMEM'i en çok ihtiyaç duyan geliştiricilere ve bilgi çalışanlarına ulaştırmak için bir araç olarak işlev görür.

Resmi BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3