Troubleshooting

En küçük gerçek kontrolle başla. Sorunların çoğu beş kategoriden birine düşer: erişim, provider yapılandırması, yerel ortam, üretilen çıktı kalitesi veya bayat dokümantasyon.

Erişim sorunları

Belirti	Kontrol
Ürün sayfası çok yakında veya inşada diyor	Ürün henüz açık değil — etiket gerçek durumdur, login sorunu değil.
Ücretli bir özelliğin aktif olmasını bekliyordun	Üyelik checkout’u ve FC top-up’ları aktivasyon kapıları geçilene kadar kapalı kalır. Bak: FluxCore.
İndirme bulamıyorsun	Ürünler sayfasından ürünün live olduğunu doğrula.

CLI sorunları

Skillry için:

npx skillry init
skillry validate
skillry sync --dry-run

Bir komut başarısız olursa --verbose ile tekrar çalıştır ve hata metnini secret’sız kopyala.

Provider veya üretim sorunları

• Provider anahtarının beklenen ayarda veya environment değişkeninde olduğunu doğrula.
• Prompt’un provider limitlerine sığdığını kontrol et.
• Model değiştirmeden önce prompt belirsizliğini azalt.
• Çıktıda okunmayan metin varsa deterministik overlay’in düzeltip düzeltemeyeceğine ya da üretimin retry gerektirdiğine karar ver.
• Sebep anlaşılana kadar başarısız çıktıları ve manifestoları sakla.

Yerel masaüstü sorunları

• Uygulama sürümünü ve işletim sistemini doğrula.
• Uygulamanın yerel veritabanı klasörünü okuma/yazma izni olup olmadığını kontrol et.
• Gelişigüzel elle kontroller yerine yerleşik test veya health ekranlarını tercih et.
• Ürün rehberi açıkça güvenli demedikçe yerel state’i silme.

Doküman sorunları

Bir doküman sayfası belirsiz veya yanlışsa sayfa URL’sini ve başarısız olan cümleyi veya komutu bildir. Kesin bir rapor, genel bir “dokümanlar bozuk” notundan çok daha hızlı düzeltilir.