Sınırlamalar ve kısıtlamalar

İkili dosyalar desteklenmiyor

Verdent'in dosya araçları yalnızca metin tabanlı biçimlerle çalışır. Aşağıdakiler düzenlenemez:

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

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.

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.

İ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:

# 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

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:

# Cross-platform
bash("npm run build")

# Platform-specific conditional
bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then make; else nmake; fi")