IBM Bob
Sorun giderme

Bob Shell sorun giderme

Bob Shell kullanırken karşılaşabileceğin sorunlara çözüm bul.

Kimlik doğrulama

Sertifika hataları

Hata: Unable to verify certificate

Neden: SSL/TLS trafiğini durdurup inceleyen bir güvenlik duvarına sahip kurumsal bir ağdasın. Bu, özel bir kök CA sertifikasının Node.js tarafından güvenilir olarak kabul edilmesini gerektirir.

Çözüm: NODE_EXTRA_CA_CERTS ortam değişkenini kurumsal kök CA sertifika dosyasının mutlak yoluna ayarla:

 
export NODE_EXTRA_CA_CERTS=/path/to/your/corporate-ca.crt

IDE entegrasyonu

Bağlantı başarısız

Hata: Bob Shell IDE'ye bağlanamıyor.

Neden: Bob Shell Companion eklentisi yüklü veya çalışıyor olmayabilir ya da Bob Shell çalışma alanı dizininin dışında çalışıyor olabilir.

Çözüm:
  1. IDE'ne Bob Shell Companion eklentisini yükle.
    2.
  2. Terminalde çalışma alanı dizinine git.
    3.
  3. Bob Shell'i çalışma alanı dizininden başlat.
    4.
  4. Bob Shell'de /ide enable komutunu çalıştır.
    5.

Dev container'da bağlantı başarısız

Hata: Dev container içinde çalışırken Bob Shell IDE'ye bağlanamıyor.

Neden: Bob Shell portu dev container'dan host makineye yönlendirilmemiş.

Çözüm:
  1. Dev container içindeki terminalden Bob Shell portunu al: 
    echo $BOB_SHELL_CLI_IDE_SERVER_PORT
    Örnek çıktı: 42991
    2.
  2. IDE'nde Command Palette'i aç ve Forward a Port seçeneğini seç.
    3.
    1. adımda görünen portu ekle (örneğin, 42991).
    4.
  4. Bob Shell'i başlat: 
    bob
    5.
  5. IDE entegrasyonunu etkinleştir: 
    /ide enable
    Veya bağlantı durumunu kontrol et: 
    /ide status
    6.

IDE companion eklentisine bağlanılamadı

Hata: 🔴 Disconnected: Failed to connect to IDE companion extension

Neden: Bob Shell Companion eklentisi IDE'ne yüklenmemiş, etkinleştirilmemiş veya çalışmıyor.

Çözüm:
  1. Bob Shell Companion eklentisinin IDE'nde yüklü ve etkin olduğunu doğrula.
    2.
  2. IDE'nde yeni bir terminal aç.
    3.
  3. Bob Shell'de /ide enable komutunu çalıştır.
    4.

Bağlantı beklenmedik şekilde kesildi

Hata: 🔴 Disconnected: IDE connection error. The connection was lost unexpectedly

Neden: Bir ağ sorunu veya IDE yeniden başlatması nedeniyle IDE bağlantısı kesildi.

Çözüm:
  1. Yeniden bağlanmak için /ide enable komutunu çalıştır.
    2.
  2. Sorun devam ederse IDE'ni yeniden başlat.
    3.

Dizin uyuşmazlığı

Hata: 🔴 Disconnected: Directory mismatch

Neden: Bob Shell, IDE'nde açık olan çalışma alanından farklı bir dizinde çalışıyor.

Çözüm:
  1. IDE'nde açık olan dizine git.
    2.
  2. Bob Shell'i o dizinden yeniden başlat.
    3.

Çalışma alanı klasörü açık değil

Hata: 🔴 Disconnected: To use this feature, please open a workspace folder

Neden: IDE'nde açık bir klasör veya çalışma alanı yok.

Çözüm:
  1. IDE'nde bir klasör veya çalışma alanı aç.
    2.
  2. Bob Shell'i yeniden başlat.
    3.

IDE entegrasyonu desteklenmiyor

Hata: IDE integration is not supported in your current environment

Neden: Bob Shell, desteklenen bir IDE'nin entegre terminalinden çalışmıyor.

Çözüm: Bob Shell'i desteklenen bir IDE'nin entegre terminalinden çalıştır.

Yapılandırma sorunları

.bobignore çalışmıyor

Hata: Bob Shell erişmesini istediğin dosyaları yok sayıyor ya da yok saymasını istediğin dosyalara erişiyor.

Neden: .bobignore dosyasında çakışan desenler, yanlış desen sırası veya dosya yanlış konumda olabilir. Değişiklikler henüz etkili olmamış olabilir.

Çözüm:
  1. Çakışan desenler için .bobignore dosyasını kontrol et.
    2.
  2. Daha spesifik desenlerin (! ile olumsuzlamalar gibi) genel desenlerden sonra gelmesini sağla.
    3.
  3. .bobignore değişiklikleri yaptıktan sonra Bob Shell oturumunu yeniden başlat.
    4.
  4. Göreli yollar beklendiği gibi çalışmıyorsa mutlak yollar kullan.
    5.
  5. .bobignore dosyasının proje kök dizininde olduğunu doğrula.
    6.

Ayarlar uygulanmıyor

Hata: Bob Shell ayarları değişiklikleri geçerli olmuyor.

Neden: Ayar dosyası yanlış konumda olabilir, geçersiz JSON söz dizimi içerebilir veya daha yüksek öncelikli yapılandırma kaynakları tarafından geçersiz kılınıyor olabilir. Değişiklikler henüz etkili olmamış olabilir.

Çözüm:
  1. Ayar dosyasının konumunu kontrol et:
    • Proje ayarları: Proje dizininde .bob/settings.json
    • Kullanıcı ayarları: Ana dizininde ~/.bob/settings.json
    2.
  2. JSON söz diziminin geçerli olduğunu doğrula (JSON doğrulayıcı kullan).
    3.
  3. Yapılandırma öncelik sırasını hatırla:
    • Komut satırı argümanları (en yüksek öncelik)
    • Ortam değişkenleri
    • Proje ayarları
    • Kullanıcı ayarları
    • Sistem varsayılanları (en düşük öncelik)
    4.
  4. Ayar dosyalarını değiştirdikten sonra Bob Shell'i yeniden başlat.
    5.

Özel talimatlar yüklenmiyor

Hata: Özel talimatlar Bob Shell oturumlarına uygulanmıyor.

Neden: Özel talimat dosyaları yanlış konumda olabilir, yanlış dosya uzantısına sahip olabilir veya mevcut bağlama yüklenmemiş olabilir.

Çözüm:
  1. Dosyaların doğru konumda olduğunu doğrula:
    • Çalışma alanı geneli: Proje kökünde .bob/rules/
    • Moda özgü: Proje kökünde .bob/rules-{modeSlug}/
    2.
  2. Dosyaların doğru uzantılara sahip olduğunu kontrol et (.md, .txt veya .xml).
    3.
  3. Tüm bağlam dosyalarını yeniden yüklemek için /memory refresh kullan.
    4.
  4. Mevcut bağlamı doğrulamak için /memory show kullan.
    5.

Komut çalıştırma sorunları

Komut bulunamadı

Hata: command not found: bob

Neden: Bob Shell doğru yüklenmemiş veya sisteminin PATH'inde değil.

Çözüm:
  1. Bob Shell'in yüklü olduğunu doğrula: 
    which bob
    2.
  2. Bulunamazsa kurulum talimatlarını kullanarak Bob Shell'i yeniden yükle.
    3.
  3. Shell'inin PATH'inin Bob Shell kurulum dizinini içerdiğini kontrol et.
    4.

Shell modu çalışmıyor

Hata: Shell modu (! komutu) komutları çalıştırmıyor.

Neden: ! karakterini boş bir prompt'ta yazmıyor olabilirsin, gerekli izinlerin olmayabilir veya komutun kendisi geçersiz olabilir.

Çözüm:
  1. ! karakterini boş bir prompt'ta yazdığını doğrula.
    2.
  2. Shell komutlarını çalıştırmak için gerekli izinlere sahip olduğunu kontrol et.
    3.
  3. Komutun çalıştığını doğrulamak için önce doğrudan terminalinde dene.
    4.

Performans sorunları

Yavaş yanıt süreleri

Hata: Bob Shell isteklere yavaş yanıt veriyor.

Neden: Ağ bağlantısı sorunları, bağlam olarak çok fazla dosya yüklenmesi veya bağlama büyük ikili dosyaların dahil edilmesi.

Çözüm:
  1. Ağ bağlantını kontrol et.
    2.
  2. .bobignore kullanarak bağlamdaki dosya sayısını azalt.
    3.
  3. node_modules/ gibi büyük ikili dosyaları veya dizinleri dahil etmekten kaçın.
    4.
  4. Tüm dosyaları yüklemek yerine @ ile daha spesifik dosya referansları kullanmayı düşün.
    5.

Yüksek bellek kullanımı

Hata: Bob Shell aşırı bellek tüketiyor.

Neden: Bağlam olarak çok fazla dosya yüklenmesi, dışlanmayan büyük dizinler veya bellek dosyalarında döngüsel import'lar.

Çözüm:
  1. Bağlam olarak yüklenen dosya sayısını sınırla.
    2.
  2. Büyük dizinleri dışlamak için .bobignore kullan.
    3.
  3. Uzun oturumlarda Bob Shell'i periyodik olarak yeniden başlat.
    4.
  4. Bellek dosyalarında döngüsel import'ları kontrol et.
    5.

Bob Shell hata ayıklama ipuçları

Debug loglamayı etkinleştirme

Bir oturum için log ayrıntısını artırmak amacıyla --log-level bayrağını veya BOB_LOG_LEVEL ortam değişkenini kullan:

 
bob run --log-level debug "Explain @app.js"
BOB_LOG_LEVEL=debug bob chat

Ayar dosyanda kalıcı bir log düzeyi de belirleyebilirsin:

 
{
  "logging": {
    "logLevel": "debug"
  }
}

Bob Shell sürümünü doğrulama

Bob Shell sürümünü görmek için şu komutu çalıştır:

İnteraktif oturum:

 
/about

İnteraktif olmayan oturum:

 
bob --version

Log dosyaları

Bob Shell, log dosyalarını ~/.bob/logs/shell/ dizinine yazar. Log dosyaları otomatik olarak döner:
  • En fazla 10 log dosyası saklanır
    •
  • Her dosya 5 MB ile sınırlıdır
    •

Bir oturumun mevcut log dosyasını bulmak için:

 
ls -lt ~/.bob/logs/shell/ | head

Sorunları bildirirken ilgili log alıntılarını paylaş.

Çalışma alanı kök belirleme

Bob Shell, çalışma alanı kökünü, mevcut çalışma dizininden yukarı doğru .git veya .bob dizini bulana kadar yürüyerek belirler. Bulunan ilk eşleşme çalışma alanı kökü olur.

.git veya .bob dizini bulunamazsa Bob Shell, mevcut çalışma dizinini çalışma alanı kökü olarak kullanır.

Bu konu nasıl?

Güvenilir klasörler

Güvenilir klasör güvenliğiyle hangi projelerin Bob Shell'in tüm özelliklerini kullanabileceğini kontrol et.

Proxy ayarlarını yapılandırma

Ağ kısıtlamaları olan kurumsal ortamlarda Bob Shell için proxy ayarlarını yapılandırma

Bu sayfada

Kimlik doğrulamaSertifika hatalarıIDE entegrasyonuBağlantı başarısızDev container'da bağlantı başarısızIDE companion eklentisine bağlanılamadıBağlantı beklenmedik şekilde kesildiDizin uyuşmazlığıÇalışma alanı klasörü açık değilIDE entegrasyonu desteklenmiyorYapılandırma sorunları.bobignore çalışmıyorAyarlar uygulanmıyorÖzel talimatlar yüklenmiyorKomut çalıştırma sorunlarıKomut bulunamadıShell modu çalışmıyorPerformans sorunlarıYavaş yanıt süreleriYüksek bellek kullanımıBob Shell hata ayıklama ipuçlarıDebug loglamayı etkinleştirmeBob Shell sürümünü doğrulamaLog dosyalarıÇalışma alanı kök belirleme