VS Code üzerinden projelerinizi saniyeler içinde analiz edip, yapay zeka (Google Gemini) destekli profesyonel PDF raporları oluşturan akıllı geliştirici asistanı.
✨ Özellikler
🧠 Yapay Zeka Destekli Analiz: Projenizin kod yapısını, amacını ve mimarisini Google Gemini ile otomatik analiz eder.
📄 Kusursuz PDF Raporları: Akademik ve profesyonel standartlarda, Türkçe karakter uyumlu ve yetim başlık/kod bloğu kayması gibi dizgi sorunları olmayan jilet gibi PDF'ler üretir.
🔒 Güvenli API Yönetimi: Gemini API anahtarınızı ilk kullanımda güvenle alır ve sadece yerel .env dosyanızda tutar. Dışarıya asla veri sızdırmaz.
🚀 Hızlı ve Kolay Kullanım: VS Code kenar çubuğundan (Sidebar) projenizi tek tıkla raporlayın.
🛠️ Gereksinimler
Bu eklentinin sorunsuz çalışması için sisteminizde şunların yüklü olması gerekir:
Python 3.8+: Güçlü arka plan (backend) servisinin ve PDF dizgi motorunun çalışması için sisteminizde Python yüklü olmalıdır.
Google Gemini API Key: Rapor analizlerini yapabilmek için gereklidir (Google AI Studio'dan ücretsiz alınabilir).
📦 Kurulum
VS Code Extensions (Eklentiler) sekmesini açın.
CodeBrief AI aratın ve yükleyin.
Raporlamak istediğiniz projenizi VS Code ile açın.
🚀 Kullanım
VS Code aktivite çubuğundaki (sol menü) CodeBrief AI ikonuna tıklayın veya Ctrl+Shift+P (Mac: Cmd+Shift+P) ile Command Palette'i açıp CodeBrief: Generate Report komutunu çalıştırın.
Eklentiyi ilk kez çalıştırdığınızda üstte şık bir pencere açılacak ve sizden Gemini API Key istenecektir. Anahtarınızı girip Enter'a basın.
Eklenti arka planda kodlarınızı okuyacak, analiz edecek ve kök dizininize mükemmel dizgili bir proje_raporu.pdf dosyası oluşturacaktır!
🔧 Sorun Giderme (Troubleshooting)
API Key Güncelleme: Eğer API anahtarınızı yanlış girdiyseniz veya süresi dolduysa, eklentinin kurulu olduğu dizindeki backend/.env dosyasını bularak içindeki GEMINI_API_KEY değerini elinizle güncelleyebilirsiniz.
Python Bulunamadı Hatası: Sistem PATH ayarlarınızda Python'un ekli olduğundan emin olun. Eklenti, gerekli kütüphaneleri ilk çalışmada otomatik olarak kurmayı dener.
