Destek

Uzantıyla ilgili sık sorulan sorular ve yaygın sorunların çözümü. Çözüm bulamazsanız aşağıdaki iletişim kanallarından ulaşabilirsiniz.

Sık sorulan sorular

Uzantı ücretli mi?

Hayır, uzantının kendisi tamamen ücretsiz ve MIT lisansı ile açık kaynaktır. Ancak uzantının kullandığı OpenAI API ücretlidir; kendi OpenAI hesabınızın bakiyesinden düşer. Ortalama bir Laracasts dersi için maliyet gpt-4o tarifesine göre cent mertebesinde kalır.

API anahtarımı nereden alırım?

platform.openai.com/api-keys adresinden "Create new secret key" ile oluşturabilirsiniz. Anahtar sk- ile başlar. Uzantı popup'ına yapıştırdığınızda otomatik kaydedilir ve AES-GCM ile şifrelenerek yerel olarak saklanır.

API anahtarım güvende mi?

Anahtar chrome.storage.local üzerinde AES-GCM 256-bit ile şifreli olarak tutulur ve hiçbir dış sunucuya gönderilmez. Yalnızca çeviri isteği sırasında api.openai.com adresine Authorization: Bearer başlığı olarak iletilir. Geliştiriciye veya başka üçüncü taraflara asla iletilmez.

Çevrilen altyazılar nerede saklanır?

Yerel chrome.storage.local'de translation_<videoId>_tr anahtarıyla tutulur. Aynı videoyu tekrar açtığınızda API çağrısı yapılmadan anında gösterilir. Önbellek kotası dolduğunda en eski %25 otomatik temizlenir.

Hangi Chrome sürümü gerekli?

Chrome 116 veya üzeri önerilir. Manifest V3 Service Worker uyumluluğu için gerekli.

Çeviri kalitesi nasıl?

Çeviri gpt-4o modeliyle, temperature: 0 ayarı ile yapılır. Programlama terimleri (Laravel, Eloquent, migration, controller, middleware vb.) orijinal İngilizce hâlinde bırakılır. Çeviri hızlı altyazı okumaya uygun olacak şekilde kısa ve akıcı hedeflenir. Mükemmel garantisi yoktur; yanlışlık gördüğünüzde hata bildirebilirsiniz.

Toggle'ı kapatınca ne oluyor?

Popup'taki aç/kapat düğmesi kapatıldığında uzantı chrome.management.setEnabled() API'si ile kendini chrome://extensions seviyesinde tamamen devre dışı bırakır. Böylece hiçbir izni çalışmaz, arka planda pasif bile durmaz. Tekrar açmak için chrome://extensions üzerinden manuel etkinleştirmek gerekir.

Başka bir dil eklenecek mi?

Şu an için yalnızca İngilizce → Türkçe çevirisi hedeflenmiştir. Farklı dil kombinasyonları ihtiyacınızsa GitHub issue açarak talep edebilirsiniz.

Yaygın sorunlar ve çözümleri

Altyazı görünmüyor

1. Uzantı simgesine tıklayıp API anahtarının dolu olduğunu doğrulayın.
2. Popup'taki aç/kapat düğmesinin açık olduğunu kontrol edin.
3. Sayfayı yenileyin; bazı SPA geçişlerinde yenileme gerekebilir.
4. Videonun İngilizce altyazısı olduğundan emin olun (Laracasts'in kendi altyazı göstergesi).

"Geçersiz API key" hatası

API anahtarının sk- ile başladığını, tamamının yapıştırıldığını ve OpenAI hesabınızın aktif olduğunu doğrulayın. platform.openai.com/api-keys adresinden yeni bir anahtar oluşturarak deneyin.

"OpenAI kota aşıldı" hatası

OpenAI hesabınızın bakiyesi bitmiş olabilir. platform.openai.com/usage adresinden kullanımınızı kontrol edin ve billing sayfasından bakiye yükleyin.

Çeviri yavaş başlıyor

Video başladığında altyazıların tamamının çevrilmesi için OpenAI'a istekler gönderilir. İlk birkaç saniye bekletebilir; sonraki batch'ler aynı anda gelir. Aynı videoyu tekrar açtığınızda önbellekten gelir ve anında görüntülenir.

Çeviri metni orijinalle eşleşmiyor

Bazen model sayı uyuşmazlığı yapar. Uzantı bu durumda batch'i ikiye bölerek yeniden dener (3 denemeye kadar). Hâlâ sorun yaşarsanız cache'i temizlemek için aynı videoyu yeni bir sekmede açın veya chrome://extensions üzerinden uzantı verilerini sıfırlayın.

Uzantıyı kapatınca Chrome yine izin istiyor

Uzantı kapatıldığında chrome.management.setEnabled() ile kendini devre dışı bırakır. Chrome, bu API'yi yalnızca management izniyle çağırabilmek için uzantıyı yüklerken izin ister. Bu izin yalnızca kendini kapatmak için kullanılır; diğer uzantılarınız etkilenmez.

Hata bildirimi

Bir hatayla karşılaştıysanız GitHub Issues üzerinden bildirmek en hızlı yoldur. Hızlı çözüm için şunları ekleyin:

• Chrome sürümü (chrome://version)
• Uzantı sürümü (popup alt bölümü veya chrome://extensions)
• Hatanın yaşandığı video URL'si (mümkünse)
• Adım adım tekrar etme yöntemi
• Beklenen davranış / gerçek davranış
• Chrome DevTools konsol çıktısı (varsa)

İletişim

• GitHub Issues: github.com/erhanurgun/laracasts-translator/issues
• E-posta: [email protected]
• Web: icin.tr/me

Güvenlik açığı bildirimi için doğrudan e-posta kullanın; halka açık issue açmayın.