Sorun giderme

"Service is experiencing high traffic. Please try again later!"

Bu, kullanıcıların karşılaştığı en yaygın 1 numaralı hatadır. Verdent hizmetinin geçici olarak aşırı yüklendiğini gösterir.

Ne zaman olur:

• Yoğun kullanım saatlerinde
• Arka uç hizmetleri ağır yük altındayken
• Geçici hizmet bozulması

Kurtarma adımları (sırasıyla):

Kurulum ve yapılandırma sorunları

Sistem gereksinimleri:

• VS Code sürümü: 1.90.0 veya üzeri (gerekli)
• İnternet bağlantısı: Etkin bağlantı gerekir
• Abonelik: Etkin bir Verdent aboneliği

Temel tanılama kontrol listesi:

1. VS Code sürümünü doğrulayın: Help → About (1.90.0+ olmalı)
2. İnternet bağlantısını kontrol edin: Verdent etkin bir bağlantı gerektirir
3. Aboneliği doğrulayın: Verdent aboneliğinizin etkin olduğundan emin olun
4. VS Code'u yeniden başlatın: Kurulum veya yapılandırma değişikliklerinden sonra
5. Eklenti durumunu kontrol edin: View → Extensions → Verdent ("Enabled" göstermeli)

Temiz yeniden kurulum prosedürü:

Günlükleri kontrol edin:

• Output panelini açın: View → Output
• Açılır listeden "Verdent" öğesini seçin
• Hata mesajlarını veya yığın izlerini arayın

Verdent for VS Code'a giriş yapılamıyor

En yaygın neden: Proxy yapılandırma sorunu

Çözüm:

Ücretsiz deneme kredileri alınmadı

Hata: Ücretsiz deneme kredileri alınmadı veya ücretsiz deneme erişimi reddedildi

Neden: Kayıt sırasında hizmet şartları ihlali tespit edildi

Çözüm: Ücretsiz deneme erişiminizle ilgili yardım için support@verdent.ai ile iletişime geçin. Destek ekibi hesabınızı inceleyecek ve sorunu çözmenize yardımcı olacaktır.

Kayıt başarısız oldu

Hata: Hesap kaydı reddedildi veya kısıtlandı

Neden: Kayıt, Verdent'in hizmet şartlarını ihlal etti ve bu da erişim kısıtlamasına yol açtı

Çözüm: Yardım için support@verdent.ai ile iletişime geçin. Destek ekibi kaydınızı inceleyebilir ve sorunu çözme konusunda yönlendirme sağlayabilir.

Eksik modeller (Claude, GPT, Gemini)

Sorun: Model seçiminde Claude, GPT veya Gemini modelleri bulunamıyor

Neden: Model sağlayıcılarının konum tabanlı kısıtlamaları

Açıklama: Bazı yapay zeka model sağlayıcılarının, belirli modellerin belirli coğrafi konumlarda kullanılabilir olmasını engelleyen bölgesel kısıtlamaları vardır. Bu durumda:

• Kısıtlanan modeller model seçim menünüzde görünmez
• Diğer tüm mevcut modelleri kesintisiz kullanmaya devam edebilirsiniz
• Aboneliğiniz veya kredileriniz üzerinde herhangi bir etkisi olmaz

Mevcut modelleri kontrol edin: Bölgenizde hangi modellerin mevcut olduğunu görmek için https://www.verdent.ai/regions adresini ziyaret edin

Performans sorunları

Belirtiler:

• Yavaş yanıt süreleri
• Bağlam penceresi dolu hataları
• Araç yürütme zaman aşımları

Yaygın nedenler ve çözümler:

Görüntüyle ilgili hata mesajları

Yaygın görüntü işleme hataları için hızlı başvuru:

file_edit hataları

Hata: "Failed to find exact match"

Nedenler:

• Son file_read'den bu yana metin değişti
• Boşluk farklılıkları (sekmeler ile boşluklar)
• Dize dosyada benzersiz değil

Çözümler:

# 1. Read file again to get current state
file_read("file.js")

# 2. Use larger context string for uniqueness
file_edit("file.js",
  old_string="function foo() {\n  return 42;\n}",
  new_string="...")

# 3. For multiple identical strings, use replace_all
file_edit("file.js", old_string="TODO", new_string="DONE", replace_all=true)

bash komut hataları

Hata: Komut zaman aşımı veya yürütme hatası

Maksimum zaman aşımı: 120 saniye (2 dakika, kesin sınır)

Çözüm: Uzun komutları daha küçük işlemlere bölün:

# Instead of one long command, break into steps
bash("step1")  # Completes in < 2min
bash("step2")  # Completes in < 2min

Komut bulunamadı:

• Komutun var olup olmadığını kontrol edin: bash("which command-name")
• Doğru yolu sağlayın veya önce ortamı etkinleştirin
• Yürütülebilir dosyalar için tam yolları kullanın

İzin hataları:

• Komutlar kullanıcı izinleriyle yürütülür
• sudo yalnızca gerekliyse ve Manual Accept Mode'da kullanın
• Dosya/dizin izinlerini kontrol edin

Arama sonuç döndürmüyor

Sorun: grep_file veya glob beklenen dosyaları bulamıyor

Desen söz dizimini kontrol edin:

# Wrong
grep_file("*.ts")  # Missing ** for recursive

# Correct
grep_file("**/*.ts")  # Recursive search

Hariç tutmaları kontrol edin:

# Ensure not accidentally excluding target files
glob("**/*.js", exclude=["**/dist/**", "**/node_modules/**"])

Büyük/küçük harf duyarlılığı:

# Use case-insensitive search if needed
grep_content("pattern", case_insensitive=true)

Alt aracı çağrılmıyor

Sorun: Özel alt aracı otomatik olarak etkinleşmiyor

Kontrol listesi:

• Dosya konumu: ~/.verdent/subagents/[name].md
• name ve description ile geçerli YAML frontmatter
• Çağırma politikası kullanımla eşleşiyor (strict, @-bahsetme gerektirir)
• "When to use" yönergeleri istek deseniyle eşleşiyor
• Markdown dosyasında söz dizimi hatası yok

Manuel olarak test edin:

@subagent-name perform task

Yerleşik alt aracı davranışı

Sorun: @Explorer, @Verifier veya @Code-reviewer beklendiği gibi davranmıyor

Yaygın nedenler:

• İstek, alt aracının uzmanlığıyla eşleşmiyor
• Alt aracı bağlamı dolu (nadir)
• Ana konuşma bağlamı yönlendirmeyi etkiliyor

Çözüm:

• Belirli bir alt aracıyı zorlamak için açık @-bahsetme kullanın
• İsteği alt aracının uzmanlığıyla eşleşecek şekilde yeniden ifade edin
• Bağlam sorunsa yeni bir konuşma başlatın

AGENTS.md uygulanmıyor

Sorun: Proje kuralları Verdent davranışını etkilemiyor

Tanılama:

1. Konum: Dosya proje kök dizininde olmalı
2. Söz dizimi: Geçerli Markdown (söz dizimi hatalarını kontrol edin)
3. Belirlilik: Kurallar yönlendirici olmalı: "Try to use X" değil "Always use X"
4. Test: Yeni uygulamayı test etmek için yeni bir konuşma başlatın

Öncelik kontrolü:

# In AGENTS.md (highest priority)
- Use 4-space indentation

# In VERDENT.md (lower priority)
- Use 2-space indentation

# Result: 4-space indentation (AGENTS.md wins)

MCP bağlantı hataları

Hata: MCP sunucusuna bağlanılamıyor

Tanılama adımları:

1. mcp.json'ı kontrol edin: ~/.verdent/mcp.json içinde geçerli JSON söz dizimi
2. Sunucu çalışıyor: MCP sunucu sürecinin etkin olduğundan emin olun
3. Ağ: Sunucu uç noktasına bağlantıyı doğrulayın
4. Kimlik doğrulama: Kimlik bilgilerinin doğru olduğunu onaylayın
5. Günlükler: Hata ayrıntıları için MCP sunucu günlüklerini kontrol edin

Yaygın çözümler:

• MCP sunucusunu yeniden başlatın
• Bağlantı dizesi formatını doğrulayın
• MCP trafiğine izin veren güvenlik duvarı kurallarını kontrol edin
• API anahtarlarını veya belirteçleri doğrulayın

İkili dosya sınırlamaları

Sorun: Görüntüler, PDF'ler ve derlenmiş ikili dosyalar düzenlenemiyor

Geçici çözüm:

# Use bash to call external tools
bash("convert input.png -resize 50% output.png")
bash("pdftotext document.pdf output.txt")

Büyük dosya işleme

Sorun: 10.000 satırın üzerindeki dosyalar bağlam sorunlarına neden olur

Geçici çözüm:

# Always use line ranges for large files
file_read("large.log", start_line=1000, max_lines=100)

# Search first to find relevant sections
grep_content("ERROR", glob="large.log")

Platformlar arası komut farklılıkları

Sorun: bash komutları Windows ile Unix arasında farklılık gösterir

Geçici çözüm:

# Use cross-platform tools when possible
bash("npm run build")  # Works everywhere

# Or conditional execution
bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then ...; fi")

En iyi uygulama: Platformlar arası uyumluluk için npm betiklerini kullanın.