Understand-Anything/README.tr-TR.md

Understand Anything

Herhangi bir kod tabanını keşfedebileceğin, arayabileceğin ve hakkında sorular sorabileceğin interaktif bir bilgi grafiğine dönüştür.

English | 简体中文 | 繁體中文 | 日本語 | Türkçe

---

Tip

Topluluğa çok teşekkürler! Understand-Anything'e gösterilen destek inanılmaz oldu. Bu araç sana karmaşıklığı anlamak için birkaç dakika kazandırıyorsa, istediğim tek şey buydu. 🚀

Yeni bir ekibe katıldın. Kod tabanı 200.000 satır kod. Nereden başlayacaksın bile bilemiyorsun?

Understand Anything, projenizi çok-ajan hattıyla analiz eden, her dosya, fonksiyon, sınıf ve bağımlılığın bilgi grafiğini oluşturan ve hepsini görsel olarak keşfetmen için interaktif bir kontrol paneli sunan bir Claude Code eklentisidir. Kodu körü körüne okumayı bırak. Büyük resmi görmeye başla.

---

🤔 Neden?

Kod okumak zor. Bütün bir kod tabanını anlamak daha da zor. Dokümantasyon her zaman güncel değil, işe alıştırma haftalar alıyor ve her yeni özellik arkeoloji gibi hissettiriyor.

Understand Anything bunu LLM zekası ile statik analizi birleştirerek çözüyor ve projenin canlı, keşfedilebilir bir haritasını üretiyor — her şey için sade Türkçe açıklamalarla.

---

🎯 Kimler için?

👩‍💻 Junior Geliştiriciler Tanımadığın kodda boğulmayı bırak. Her fonksiyon ve sınıfın sade Türkçe açıklandığı, mimariyi adım adım anlatan rehberli turlar al.

📋 Ürün Yöneticileri ve Tasarımcılar Kod okumadan sistemin gerçekte nasıl çalıştığını nihayet anla. "Kimlik doğrulama nasıl çalışır?" gibi sorular sor ve gerçek kod tabanına dayalı net cevaplar al.

🤖 AI Destekli Geliştiriciler AI araçlarına projen hakkında derin bağlam ver. Kod incelemeden önce /understand-diff, herhangi bir modüle dalmak için /understand-explain veya mimari hakkında akıl yürütmek için /understand-chat kullan.

---

🚀 Hızlı Başlangıç

1. Eklentiyi yükle

/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything

2. Kod tabanını analiz et

/understand

Çok-ajan hattı projenizi tarar, her dosya, fonksiyon, sınıf ve bağımlılığı çıkarır, ardından .understand-anything/knowledge-graph.json dosyasına kaydedilen bir bilgi grafiği oluşturur.

3. Kontrol panelini keşfet

/understand-dashboard

Kod tabanın bir grafik olarak görselleştirilmiş, mimari katmana göre renklendirilmiş, aranabilir ve tıklanabilir interaktif bir web kontrol paneli açılır. Kodunu, ilişkilerini ve sade Türkçe açıklamasını görmek için herhangi bir düğüm seç.

4. Öğrenmeye devam et

# Kod tabanı hakkında her şeyi sor
/understand-chat Ödeme akışı nasıl çalışır?

# Mevcut değişikliklerinin etkisini analiz et
/understand-diff

# Belirli bir dosya veya fonksiyona derinlemesine dal
/understand-explain src/auth/login.ts

# Yeni ekip üyeleri için bir işe alıştırma rehberi oluştur
/understand-onboard

---

🌐 Çoklu Platform Kurulumu

Understand-Anything birden fazla AI kodlama platformunda çalışır.

Claude Code (Yerli)

/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything

Codex

Codex'e söyle:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.codex/INSTALL.md

OpenCode

OpenCode'a söyle:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.opencode/INSTALL.md

OpenClaw

OpenClaw'a söyle:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.openclaw/INSTALL.md

Cursor

Bu depo klonlandığında Cursor, eklentiyi .cursor-plugin/plugin.json aracılığıyla otomatik olarak keşfeder. Manuel kurulum gerekmez — sadece klonla ve Cursor'da aç.

VS Code + GitHub Copilot

GitHub Copilot uzantısı (v1.108+) yüklü VS Code, .copilot-plugin/plugin.json aracılığıyla eklentiyi otomatik keşfeder. Manuel kurulum gerekmez — sadece klonla ve VS Code'da aç.

Tüm projelerde kullanmak için kişisel beceri olarak kurmak istersen GitHub Copilot'a söyle:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.vscode/INSTALL.md

Antigravity

Antigravity'e söyle:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.antigravity/INSTALL.md

Gemini CLI

Gemini CLI'a söyle:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.gemini/INSTALL.md

Pi Agent

Pi Agent'a söyle:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.pi/INSTALL.md

Platform Uyumluluğu

Platform	Durum	Kurulum Yöntemi
Claude Code	✅ Yerli	Eklenti pazarı
Codex	✅ Destekleniyor	AI güdümlü kurulum
OpenCode	✅ Destekleniyor	AI güdümlü kurulum
OpenClaw	✅ Destekleniyor	AI güdümlü kurulum
Cursor	✅ Destekleniyor	Otomatik keşif
VS Code + GitHub Copilot	✅ Destekleniyor	Otomatik keşif
Antigravity	✅ Destekleniyor	AI güdümlü kurulum
Gemini CLI	✅ Destekleniyor	AI güdümlü kurulum
Pi Agent	✅ Destekleniyor	AI güdümlü kurulum

---

✨ Özellikler

🗺️ İnteraktif Bilgi Grafiği Dosyalar, fonksiyonlar, sınıflar ve ilişkileri React Flow ile görselleştirildi. Kodunu ve bağlantılarını görmek için herhangi bir düğüme tıkla.	💬 Sade Türkçe Özetler Her düğüm bir LLM tarafından açıklanır, böylece herkes — teknik olsun ya da olmasın — ne yaptığını ve neden var olduğunu anlayabilir.
🧭 Rehberli Turlar Bağımlılığa göre sıralanmış, mimarinin otomatik oluşturulmuş gözden geçirmeleri. Kod tabanını doğru sırayla öğren.	🔍 Bulanık ve Anlamsal Arama İsme veya anlamına göre her şeyi bul. "Kimlik doğrulamayı hangi parçalar yönetiyor?" ara ve grafik boyunca ilgili sonuçları al.
📊 Diff Etki Analizi Değişikliklerinin sistemin hangi bölümlerini etkilediğini commit etmeden önce gör. Kod tabanı boyunca dalgalanma etkilerini anla.	🎭 Kişiye Uyarlanabilir UI Kontrol paneli, kim olduğuna göre ayrıntı seviyesini ayarlar — junior geliştirici, ürün yöneticisi veya güçlü kullanıcı.
🏗️ Katman Görselleştirmesi Mimari katmana göre otomatik gruplama — API, Servis, Veri, UI, Yardımcı — renk kodlu efsaneyle.	📚 Dil Kavramları 12 programlama deseni (generikler, kapanışlar, dekoratörler, vb.) göründükleri her yerde bağlam içinde açıklanır.

---

🔧 Kaputun Altında

Çok-Ajan Hattı

/understand komutu 5 özel ajan düzenler:

Ajan	Rol
project-scanner	Dosyaları keşfet, dilleri ve çerçeveleri tespit et
file-analyzer	Fonksiyonları, sınıfları, içe aktarmaları çıkar; grafik düğümleri ve kenarları üret
architecture-analyzer	Mimari katmanları tanımla
tour-builder	Rehberli öğrenme turları oluştur
graph-reviewer	Grafik bütünlüğünü ve referans bütünlüğünü doğrula

Dosya analizörleri paralel çalışır (en fazla 3 eşzamanlı). Artımlı güncellemeleri destekler — yalnızca son çalıştırmadan bu yana değişen dosyaları yeniden analiz eder.

Proje Yapısı

understand-anything-plugin/
  .claude-plugin/  — Eklenti manifestosu
  agents/          — Özel AI ajanları
  skills/          — Yetenek tanımları (/understand, /understand-chat, vb.)
  src/             — TypeScript kaynağı (context-builder, diff-analyzer, vb.)
  packages/
    core/          — Analiz motoru (tipler, kalıcılık, tree-sitter, arama, şema, turlar)
    dashboard/     — React + TypeScript web kontrol paneli

Teknoloji Yığını

TypeScript, pnpm workspaces, React 18, Vite, TailwindCSS v4, React Flow, Zustand, web-tree-sitter, Fuse.js, Zod, Dagre

Geliştirme Komutları

Komut	Açıklama
pnpm install	Tüm bağımlılıkları yükle
pnpm --filter @understand-anything/core build	Core paketini derle
pnpm --filter @understand-anything/core test	Core testlerini çalıştır
pnpm --filter @understand-anything/skill build	Eklenti paketini derle
pnpm --filter @understand-anything/skill test	Eklenti testlerini çalıştır
pnpm --filter @understand-anything/dashboard build	Kontrol panelini derle
pnpm dev:dashboard	Kontrol paneli geliştirme sunucusunu başlat

---

🤝 Katkıda Bulunma

Katkılar memnuniyetle karşılanır! Başlamak için:

1. Depoyu fork'la
2. Bir özellik dalı oluştur (git checkout -b feature/benim-ozellligim)
3. Testleri çalıştır (pnpm --filter @understand-anything/core test)
4. Değişikliklerini commit et ve bir pull request aç

Büyük değişiklikler için lütfen önce bir issue aç ki yaklaşımı tartışalım.

---

Kodu körü körüne okumayı bırak. Her şeyi anlamaya başla.

Star Geçmişi

MIT Lisansı © Lum1104