AnaİçeriğeAtla

Sorun giderme

💡TL;DR
Sorunu aynı sağlayıcı, model ve görev ayarlarıyla tek deneme notunda tekrarlayın. İlerlemeyi ve çıktı yolunu okuyun. Kimlik doğrulama, üretim, ayrıştırma ve yazmayı ayırın; bağlantı testi tüm iş akışını kontrol etmez.

Genel bakış​

Notemd/Obsidian sürümü, işletim sistemi, eylem, protokol, model ve asgari adımları kaydedin. İptal sonlanmadan yeniden başlatmayın. Kökenlerini anlayana kadar çıktıları ve kurtarma dosyalarını koruyun.

Tanılama​

Bağlantı testi​

Bağlantıyı test et yalnız model listesi veya kısa üretimi kontrol edebilir. Sonra seçili model ve çıktı sözleşmesiyle küçük gerçek görev çalıştırın.

İlerleme ve geliştirici tanılaması​

İlerleme durum, hata ve konumları gösterir; API etkinliği bekleyen ve biten istekleri ayırır. Debug’ı ihtiyaç halinde açın. Uzun tanılama kota tüketebilir. Raporlar not, kısmi yanıt, uç nokta ve anahtar içerebilir. Paylaşmadan yerelde inceleyip maskeleyin; maskeli profillerin üstverisini de kontrol edin.

Yaygın hatalar​

Eksik veya geçersiz anahtar​

401: doğru profil/uç nokta ve istenmeyen boşluklar. 403: hesap, proje, model yetkisi ve ödeme. Tekrar denemek yanlış kimlik bilgilerini düzeltmez.

Ağ​

Obsidian cihazından sunucu, port, protokol ve yolu kontrol edin. Ollama/LM Studio çalışmalı, model hazır olmalıdır. localhost bu cihazdır, başka bilgisayar değil. Doğru profili seçin; fallback otomatik belirlenir, bir aktarım düğmesiyle değil.

429 sınırı​

Eşzamanlılığı azaltın; istek/token kotasını ve anahtarın başka kullanımlarını inceleyin. Tekrarlar yalnız bazı geçici hataları giderir.

Model bulunamadı​

Fetch models veya bilinen model/deployment kullanın. API sürümünü ve bölgeyi kontrol edin. Örnekler eski olabilir; Azure deployment, Ark uç nokta kimliği isteyebilir.

Bağlantı veya kavram yok​

Gerçek çıktı dosyasını, kullanılabilir kaynağı, yanıt biçimini ve seçili etkin kavram klasörünü kontrol edin. Bağımsız çıkarma başlıkla ve geri bağlantısız başlar. İşaretler çıkarılmışsa varsayılan istemle karşılaştırın.

Çıktı yok veya başka yerde​

Bildirilen _processed.md, _<language>.md veya complete yolunu okuyun. Çeviri klasörü oluşturulamazsa kaynak klasörüne dönülebilir. Tekrardan önce çakışmaları ve izinleri kontrol edin.

İptal sonrası dosyalar​

Bitmiş yazmalar kalır, kabul edilmiş istekler bitebilir. Silmeden veya tüm klasörü yeniden çalıştırmadan dosyaları ve kurtarma çakışmalarını inceleyin.

Diyagram veya yerel dışa aktarma​

Türler sırayla oluşturulur. Bir hata diğerlerini engellemez; iptal bekleyen türleri durdurur ve tamamlanan dosyaları korur. Dışa aktarımı önizleme veya geçmişten yeni model isteği olmadan yineleyin. Oluşturma hatası, o türün yeniden oluşturulmasını gerektirir. v1/v2 kayıtları okunabilir kalır.

Diyagram HTML’i yakınlaştırılabilir grafik; yapılandırılmış özet HTML’i metin, yapı ve kaynaklar içerir. Düzenlenebilir HTML/SVG bir oluşturucunun adıdır, web düzenleyicisi değildir. Düzenleme için yerel kaynak dosyasını kullanın. PPTX ve MP4 dahil sunum dışa aktarımı ayrı ayar ve bağımlılıklarını korur. Diyagram kılavuzu.

Hata bildirme​

  1. Yapay not ve deneme klasörüyle tekrarlayın.
  2. Sürümler, eylem, model, gerekli ayarlar ve beklenen/gerçek sonucu yazın.
  3. Anahtar, özel metin veya gereksiz uç nokta bilgisi içermeyen asgari dosya/günlük ekleyin.
  4. Tek dosyada varsayılan istemle olup olmadığını belirtin.
  5. GitHub Issues kaydı açın.

Ekran görüntüsü tek başına biçim veya iptal hatasını nadiren kanıtlar. Mümkünse kaynak/çıktı veya asgari tekrarlanabilir adımları verin.

Sonraki adımlar​