--- title: "Sınırlamalar ve kısıtlamalar" description: "Verdent'in sınırlamalarını ve kısıtlamalarını anlama" --- ### Neler öğreneceksiniz Verdent for VS Code'un dosya biçimi kısıtlamaları, araç sınırlamaları ve platforma özgü hususlar dahil bilinen sınırlamaları. --- ## Bilinen sınırlamalar ### İkili dosyalar desteklenmiyor Verdent'in dosya araçları yalnızca metin tabanlı biçimlerle çalışır. Aşağıdakiler düzenlenemez: | Biçim türü | Örnekler | | ----------------- | ------------------------------ | | **Görseller** | PNG, JPG, GIF, SVG (ikili olarak) | | **Videolar** | MP4, AVI, MOV | | **Derlenmiş kod** | EXE, DLL, SO | | **Arşivler** | ZIP, TAR, GZ | | **Office belgeleri** | DOCX, XLSX, PPTX | | **PDF'ler** | PDF dosyaları | **Geçici çözüm:** İkili dosyalara kodda başvurulabilir veya kavramsal olarak tartışılabilir, ancak değişiklik yapmak harici araçlar gerektirir. ### file_read satır sınırları **Sınırlama:** - Büyük dosyalar (\>10.000 satır) bölümler halinde okunmalıdır - Büyük dosyaların tamamını okumak bağlam tükenmesine neden olabilir **Çözüm:** Satır aralıkları kullanın: `file_read("file.js", start_line=100, max_lines=50)` --- ### bash komut zaman aşımları **Sınırlama:** - Maksimum zaman aşımı: 120 saniye (2 dakika) - Uzun süren işlemler otomatik olarak sonlandırılır **Çözüm:** İşlemleri 2 dakika içinde tamamlanan daha küçük komutlara bölün --- ### Arama performansı **Sınırlama:** - Geniş glob desenleri (`**/*`) binlerce sonuç döndürebilir - Regex aramaları, harfi harfine dizelerden daha yavaştır **Çözüm:** Belirli desenler kullanın ve gereksiz dizinleri hariç tutun ### Bağlam tükenmesi **Sorun:** Uzun oturumlar veya karmaşık işlemler sırasında yapay zekanın bağlam penceresi dolabilir ve önceki konuşmaya başvurma yeteneğini sınırlayabilir. **Azaltma stratejileri:** - Keşif amaçlı araştırma için alt aracıları kullanın (sonuçlar yalnızca ana bağlamı tüketir) - Dosyaları satır aralıklarıyla stratejik olarak okuyun - Tüm içeriği okumadan önce `grep_file` kullanın - Arka plan görevlerini Explorer alt aracısına devredin 500 satırdan büyük dosyalarda, bağlam alanını korumak için her zaman satır aralıkları kullanın. --- ## Verdent'in yapamadıkları ### Doğrudan sistem yönetimi yok **Yapamaz:** - VS Code ayarlarını programatik olarak değiştirme - VS Code uzantılarını otomatik olarak yükleme - Sistem düzeyindeki yapılandırmaları değiştirme - VS Code'u veya sistem hizmetlerini yeniden başlatma **Kapsam:** Verdent, sistem yönetimi düzeyinde değil, VS Code çalışma alanı içinde çalışır. ### Otonom yürütme yok **Manual Accept Mode denetimleri:** - Kullanıcılar Manual Accept Mode'da araç yürütmelerini onaylamalıdır - Onay olmadan otomatik arka plan işlemi yapılmaz - VS Code kapalıyken komut çalıştırılamaz **Amaç:** Tüm işlemler üzerinde güvenlik ve kullanıcı denetimi. Verdent, kullanıcı onayı olmadan komutları arka planda yürütemez. Tüm işlemler Manual Accept Mode'da açık onay gerektirir. ### Gerçek zamanlı izleme yok **Yapamaz:** - Çalışan işlemleri sürekli izleme - Dosya sistemi değişikliklerini gerçek zamanlı izleme - Sistem olaylarında uyarı verme - Günlük dosyalarını sürekli akıtma **Alternatif:** Harici izleme araçları için MCP entegrasyonlarını kullanın. ### MCP olmadan ağ işlemi yok **Yerleşik sınırlamalar:** - Rastgele HTTP istekleri yapamaz (belirli sayfalar için `web_fetch` kullanın) - Doğrudan veritabanı bağlantısı yok (MCP gerektirir) - Bulut hizmetlerine doğrudan erişemez (MCP gerektirir) - Gerçek zamanlı API entegrasyonu yok (MCP gerektirir) **Çözüm:** Harici sistem erişimi için MCP sunucularını yapılandırın. --- ## Platforma özgü kısıtlamalar ### İşletim sistemi farklılıkları **bash araç davranışı:** | Platform | Kabuk | Notlar | | --------------- | ---------- | ---------------------------------------------------------- | | **macOS/Linux** | bash/zsh | Tam bash işlevselliği | | **Windows** | PowerShell | Bazı bash komutları kullanılamaz, PowerShell karşılıklarını kullanın | | **WSL** | bash | Linux komutları WSL ortamında çalışır | **Yol işleme:** - Windows ters eğik çizgi (`\`), Unix eğik çizgi (`/`) kullanır - Platformlar arası projelerde dosya yollarının ayarlanması gerekebilir --- ### VS Code sürüm gereksinimleri **Minimum gereksinimler:** - VS Code sürüm uyumluluğu (güncel minimum için uzantı pazar yerini kontrol edin) - Bağlam önbelleğe alma için yeterli disk alanı Belirli sürüm gereksinimleri VS Code pazar yeri listesinde tutulur. Güncel uyumluluk için uzantı ayrıntılarını kontrol edin. --- ### Çalışma alanı kısıtlamaları **Tek çalışma alanı odağı:** - Verdent aynı anda tek bir VS Code çalışma alanı içinde çalışır - Birden fazla açık VS Code penceresinde aynı anda dosya değiştiremez - Çok köklü çalışma alanları desteklenir ancak bağlam yalnızca geçerli etkin çalışma alanıyla sınırlıdır --- ## Yaygın sınırlamalar için geçici çözümler ### İkili dosya değişikliği **Sınırlama:** Görseller, PDF'ler veya derlenmiş ikili dosyalar düzenlenemez **Geçici çözümler:** - bash komutlarında harici araçlara başvurun: `bash("convert input.png -resize 50% output.png")` - Harici araçların yürütebileceği betikler oluşturun - İkili dosya işlemleri için manuel adımları belgeleyin **Örnek:** ```bash # Image conversion bash("convert input.png -resize 50% output.png") # PDF to text bash("pdftotext document.pdf output.txt") ``` ### Büyük dosya işleme **Sınırlama:** 10.000 satırdan büyük dosyalar bağlam penceresini zorlar **Geçici çözümler:** - Satır aralıkları kullanın: `file_read("large.log", start_line=1000, max_lines=100)` - Önce arama yapın: ilgili bölümleri bulmak için `grep_content("ERROR", glob="large.log")` - Daha kolay yönetim için dosyaları daha küçük modüllere bölün İlgili bölümleri belirlemek için her zaman önce `grep_content` kullanın, ardından yalnızca o belirli satır aralıklarını okuyun. ### Bağlam penceresi tükenmesi **Sınırlama:** Uzun konuşmalar bağlam penceresini doldurur **Geçici çözümler:** - Kod tabanı araştırması için Explorer alt aracısına devredin - İzole doğrulama görevleri için Verifier alt aracısını kullanın - Farklı görevler için yeni konuşma başlatın - Oturumlar arası ilerlemeyi izlemek için `todo_update` kullanın **En iyi uygulama:** Etkin geliştirme için ana bağlamı korumak adına arka plan araştırmalarını alt aracılara devredin. ### Platform komut farklılıkları **Sınırlama:** bash komutları Windows ve Unix arasında farklılık gösterir **Geçici çözümler:** - Platformlar arası araçlar kullanın: ham bash yerine npm betikleri - Koşullu komutlar: `bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then ...; fi")` - Platform notları içeren projeye özgü AGENTS.md **Örnek:** ```bash # Cross-platform bash("npm run build") # Platform-specific conditional bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then make; else nmake; fi") ``` --- ## Gelecekteki iyileştirmeler Sınırlamalar sürekli olarak ele alınmaktadır. Genişletilmiş yetenekler, artırılmış sınırlar ve yeni entegrasyonlarla ilgili güncellemeler için Verdent sürüm notlarını kontrol edin. --- ## Ayrıca bakın Eksiksiz araç yetenekleri Verdent kullanımını optimize edin