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

Understand Anything — Herhangi bir kod tabanını interaktif bir bilgi grafiğine dönüştür

--- > [!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](https://docs.anthropic.com/en/docs/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 ```bash /plugin marketplace add Lum1104/Understand-Anything /plugin install understand-anything ``` ### 2. Kod tabanını analiz et ```bash /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 ```bash /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 ```bash # 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) ```bash /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: ```text Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.vscode/INSTALL.md ``` ### Antigravity Antigravity'e söyle: ```text 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: ```text 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: ```text 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

Kontrol Paneli Ekran Görüntüsü

🗺️ İ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