Files

qiaoxinjiu e31a75d2bb Add under-anything knowledge dashboard

2026-05-27 15:40:32 +08:00

16 KiB

Raw Blame History

Understand Anything

Herhangi bir kod tabanını, bilgi tabanını veya dokümantasyonu keşfedebileceğin, arayabileceğin ve hakkında sorular sorabileceğin interaktif bir bilgi grafiğine dönüştür.
Claude Code, Codex, Cursor, Copilot, Gemini CLI ve daha fazlasıyla çalışır.

💬 Discord topluluğuna katıl →
Sorular sor, yaptıklarını paylaş, topluluktan yardım al.

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 Plugin'dir. Kodu körü körüne okumayı bırak. Büyük resmi görmeye başla.

Amaç, kod tabanının ne kadar karmaşık olduğunu görkemle gösteren bir grafik değil — her parçanın nasıl birbirine geçtiğini sessizce öğreten bir grafik.

✨ Özellikler

Note

Hemen denemek ister misiniz? Ana sayfamızda canlı demoyu deneyin — doğrudan tarayıcınızda kaydırma, yakınlaştırma, arama ve keşfetme yapabileceğiniz tam etkileşimli bir kontrol paneli.

Yapısal grafiği keşfedin

Kod tabanınızı interaktif bir bilgi grafiği olarak görüntüleyin — her dosya, fonksiyon ve sınıf tıklanabilir, aranabilir ve keşfedilebilir bir düğümdür. Herhangi bir düğümü seçerek anlaşılır özetleri, bağımlılıkları ve rehberli turları görün.

İş mantığını anlayın

Alan görünümüne geçin ve kodunuzun gerçek iş süreçleriyle nasıl eşleştiğini görün — alanlar, akışlar ve adımlar yatay bir grafik olarak sunulur.

Bilgi tabanlarını analiz et

/understand-knowledge komutunu bir Karpathy deseni LLM Wiki'sine yönlendirin ve topluluk kümeleme ile kuvvet yönelimli bir bilgi grafiği elde edin. Deterministik ayrıştırıcı index.md'den wikilinkleri ve kategorileri çıkarır, ardından LLM ajanları örtük ilişkileri keşfeder, varlıkları çıkarır ve iddiaları ortaya çıkarır — wiki'nizi gezinilebilir, birbirine bağlı fikirler grafiğine dönüştürür.

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

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

Yerelleştirilmiş çıktı: İstediğiniz dilde içerik oluşturmak için --language kullanın:

# İstediğiniz dilde içerik oluştur (düğüm açıklamaları ve dashboard UI)
/understand --language en

# Desteklenen diller: en (varsayılan), zh, zh-TW, ja, ko, ru

--language parametresi şunları etkiler:

Bilgi grafiğindeki düğüm özetleri ve açıklamalar
Dashboard UI etiketleri, butonlar ve araç ipuçları
Rehberli tur açıklamaları

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

# İş alanı bilgisini çıkar (alanlar, akışlar, adımlar)
/understand-domain

# Karpathy deseni LLM Wiki bilgi tabanını analiz et
/understand-knowledge ~/path/to/wiki

# İstediğin zaman tekrar çalıştır — varsayılan olarak artımlıdır (yalnızca değişen dosyaları analiz eder)
/understand

# Her commit'te otomatik artımlı güncelleme için post-commit kancası kur
/understand --auto-update

# Devasa monorepo'larda analizi bir alt dizinle sınırla
/understand src/frontend

🌐 Ç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

Tek satırlık kurulum (Codex / OpenCode / OpenClaw / Antigravity / Gemini CLI / Pi Agent / Vibe CLI / VS Code Copilot / Hermes / Cline / KIMI CLI)

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash
# veya platformu doğrudan geçirerek soruyu atla:
curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash -s codex

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.ps1 | iex

Kurulum betiği depoyu ~/.understand-anything/repo dizinine klonlar ve seçilen platform için uygun sembolik bağlantıları oluşturur. Sonrasında CLI/IDE'ni yeniden başlat.

Desteklenen <platform> değerleri: gemini, codex, opencode, pi, openclaw, antigravity, vibe, vscode, hermes, cline, kimi
Daha sonra güncelle: ./install.sh --update
Kaldır: ./install.sh --uninstall <platform>

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

Otomatik keşif çalışmazsa manuel kur: Cursor Settings → Plugins'i aç, arama alanına https://github.com/Lum1104/Understand-Anything yapıştır ve oradan ekle.

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 yukarıdaki install.sh'ı vscode platformuyla çalıştır.

Copilot CLI

copilot plugin install Lum1104/Understand-Anything:understand-anything-plugin

Platform Uyumluluğu

Platform	Durum	Kurulum Yöntemi
Claude Code	✅ Yerli	Eklenti pazarı
Cursor	✅ Destekleniyor	Otomatik keşif
VS Code + GitHub Copilot	✅ Destekleniyor	Otomatik keşif
Copilot CLI	✅ Destekleniyor	Eklenti kurulumu
Codex	✅ Destekleniyor	`install.sh codex`
OpenCode	✅ Destekleniyor	`install.sh opencode`
OpenClaw	✅ Destekleniyor	`install.sh openclaw`
Antigravity	✅ Destekleniyor	`install.sh antigravity`
Gemini CLI	✅ Destekleniyor	`install.sh gemini`
Pi Agent	✅ Destekleniyor	`install.sh pi`
Vibe CLI	✅ Destekleniyor	`install.sh vibe`
Hermes	✅ Destekleniyor	`install.sh hermes`
Cline	✅ Destekleniyor	`install.sh cline`
KIMI CLI	✅ Destekleniyor	`install.sh kimi`

📦 Grafı Ekibinizle Paylaşın

Graf yalnızca bir JSON dosyasıdır — bir kez commit'leyin, ekip arkadaşlarınız pipeline'ı çalıştırmadan kullansın. Yeni üye oryantasyonu, PR incelemeleri ve docs-as-code iş akışları için idealdir.

Örnek: GoogleCloudPlatform/microservices-demo (fork) — commit'lenmiş grafı içeren Go / Java / Python / Node çok dilli referans projesi.

Neyi commit'leyin: .understand-anything/ içindeki her şey, ancak intermediate/ ve diff-overlay.json hariç (bunlar yerel geçici dosyalardır).

.understand-anything/intermediate/
.understand-anything/diff-overlay.json

Güncel tutun: /understand --auto-update etkinleştirin — bir post-commit kancası grafı artımlı olarak yamalar, böylece her commit eşleşen bir grafla birlikte gelir. Veya sürümden önce /understand komutunu elle yeniden çalıştırın.

Büyük graflar (10 MB+): git-lfs ile takip edin.

git lfs install
git lfs track ".understand-anything/*.json"
git add .gitattributes .understand-anything/

🔧 Kaputun Altında

Tree-sitter + LLM hibriti

Deterministik olarak yapılabilecek işleri statik analiz, anlam çıkarımı gerektiren işleri LLM üstlenir:

Tree-sitter (deterministik) — kaynak kodu somut sözdizimi ağacına ayrıştırır ve yapısal gerçekleri çıkarır: import'lar, export'lar, fonksiyon/sınıf tanımları, çağrı noktaları, kalıtım. Tarama aşamasında önceden çözülmüş importMap olarak file-analyzer'a iletilir, böylece import'ları kaynaktan tekrar türetmek zorunda kalmaz. Aynı girdi her zaman aynı çıktıyı verir; ayrıca artımlı güncellemelerin parmak izlerinin de temelidir.
LLM (anlamsal) — ayrıştırılmış yapıyı ve orijinal kaynağı birlikte okuyarak ayrıştırıcıların üretemediği şeyleri üretir: düz dilde özetler, etiketler, mimari katman atamaları, iş alanı eşlemeleri, rehberli turlar, dil kavramı notları.

Bu ayrım sayesinde graf yapısal tarafta yeniden üretilebilir kalırken (aynı kod her zaman aynı kenarları üretir) anlamsal tarafta niyeti yakalayabilir (bir dosya yalnızca neyi import ettiği değil, ne için var olduğu da görülür).

Çok-Ajan Hattı

/understand komutu 5 özel ajan düzenler ve /understand-domain 6. ajanı ekler:

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
`domain-analyzer`	İş alanları, akışlar ve işlem adımlarını çıkar (`/understand-domain` tarafından kullanılır)
`article-analyzer`	Wiki makalelerinden varlıkları, iddiaları ve örtük ilişkileri çıkar (`/understand-knowledge` tarafından kullanılır)

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.

🎥 Topluluk

Better Stack tarafından hazırlanan topluluk tanıtım videosu.

YouTube'da izle →

Bir video, blog yazısı veya eğitim hazırladınız mı? Issue veya PR açın — burada yer vermekten mutluluk duyarız.

🤝 Katkıda Bulunma

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

Depoyu fork'la
Bir özellik dalı oluştur (git checkout -b feature/benim-ozellligim)
Testleri çalıştır (pnpm --filter @understand-anything/core test)
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

Kullanan ve katkıda bulunan herkese teşekkürler — bunun insanlara zaman kazandırdığını bilmek, yapmaya değer kılan tek şeydi.

16 KiB Raw Blame History Unescape Escape