Ayarlar

Ayarlar sayfası, kod veya YAML'a dokunmadan değiştirebileceğiniz her şeyi bir araya getirir. Bölümler, yukarıdan aşağıya:

1. Dil — arayüz dili (DE / EN / ES / FR / EL / PT / TR / JA, tümü tam çevrilmiş).
2. Yapay zeka sağlayıcısı + model seçici — mesajlarınızı hangi sağlayıcının gördüğü ve hangi modelin kullanılacağı.
3. API anahtarları — sağlayıcı başına anahtarlar, kaynak atıfıyla (env / secrets.yaml / Ayarlar).
4. Depolama modu — Sunucu (FastAPI + SQLite) ile Yerel (tarayıcı IndexedDB) karşılaştırması.
5. Eşitleme — bu cihazı yerel ağ üzerinden başka bir cihazla eşleştirin.
6. Yedek — dışa aktar / içe aktar / karşılaştır.
7. Ses — TTS + STT + telaffuz geçişleri.
8. Arayüz — hareketler + tema + yoğunluk.
9. Oyunlaştırma — XP / rozet bildirimleri + hafta sonu modu.
10. Hakkında — sürüm, sistem bilgisi, katkıda bulunanlar, bağışlar, lisans.

Dil

PATCH /api/settings/{user_id} üzerinden bir sonraki render işleminde her arayüz dizesini canlı olarak değiştirir. Tüm 8 dil birinci sınıf — DE / EN / ES / FR / EL / PT / TR / JA — her biri tam çevrilmiş bir kataloğa sahip. localStorage aracılığıyla yeniden yüklemeler arasında kalıcıdır.

Yapay zeka sağlayıcısı + model seçici

Sağlayıcı açılır menüsü active_provider'ı UserSettings'e yazar; bir sonraki yapay zeka çağrısı yeni sağlayıcının eklentisinden (Sunucu modu) veya yeni sağlayıcının HTTP istemcisinden (Yerel mod) geçer.

Model seçici (v1.11.0'dan beri) Önerilen / Tümü olarak gruplandırılmış, her sağlayıcının canlı /v1/models uç noktasından (1 saatlik önbellek) doldurulan aranabilir bir açılır menüdür. Her satır insan adını + ham kimliği + bağlam penceresi rozetini gösterir. Keşfedilen liste mevcut değilse (API anahtarı yok, ağ yok), seçici statik varsayılanlara geri döner ve bir "çevrimdışı varsayılan kullanılıyor" ipucu gösterir. Oturum başlığı <Sağlayıcı>: <Model adı> okur; tam kimlik + bağlam penceresi araç ipucunda yer alır.

API anahtarları (Aşama 34 / v1.20.0)

Her sağlayıcının kendi satırı vardır: anahtar girişi, Kaydet düğmesi, Kaldır düğmesi, aktif sağlayıcı rozeti, artı yeni kaynak atıfı rozeti:

• Anahtar kaynağı: Ayarlar — anahtar, veritabanında Fernet şifrelemeli (Sunucu modu) veya IndexedDB'de açık metin (Yerel mod) olarak saklanır. Serbestçe Kaydet / Kaldır yapabilirsiniz.
• Anahtar kaynağı: secrets.yaml — anahtar ~/.config/adaptive-learner/secrets.yaml dosyasında yapılandırılmıştır. Kaydet düğmesi devre dışı; değiştirmek için dosyayı doğrudan düzenleyin. Satırın altında bir bilgi pankartı yolu hatırlatır.
• Anahtar kaynağı: ortam — anahtar ADAPTIVE_LEARNER_<PROVIDER>_API_KEY ortam değişkeni aracılığıyla yapılandırılmıştır. Kaydet devre dışı; env değişkeni gerçeğin kaynağıdır.
• Anahtar yapılandırılmamış — hiçbir yerde ayarlanmamış. Başlamak için yazın ve Kaydet'e basın.

Çözüm zinciri (en yüksek öncelik kazanır): env > secrets.yaml

Veritabanı. Tam döküm için Yapılandırma belgelerine bakın.

Depolama modu

Sunucu ile Yerel (Tarayıcı) depolama arasındaki geçiş:

• Sunucu — her okuma ve yazma FastAPI arka ucuna çarpar. Çalışan bir arka uç gerektirir. Arka uç taraflı eşitleme ile çoklu cihaz kullanımı için en iyisi.
• Yerel (Tarayıcı) — her okuma ve yazma bu tarayıcıdaki IndexedDB'ye çarpar. Yapay zeka çağrıları doğrudan sağlayıcıya gider. Arka uç gerekmez. Özel, cihaza yerel kurulum için en iyisi.

Modları değiştirmek localStorage'a kaydeder ve bir "yeniden yükleme gerekli" bildirim gösterir. Modlar arasında veri EŞİTLENMEZ.

Eşitleme

QR kodu tarayıcısını (arka kamera) kullanarak veya eşleştirme URL'sini yapıştırarak bu cihazı yerel ağınız üzerinden başka bir cihazla eşleştirin. Eşleştirildikten sonra, iter + çeker düğmeleri veriyi çift yönlü olarak değiştirir. Çakışmalar arka uçta yapay zeka birleştirme çözücüsünden geçer.

Kısıtlı tarayıcı geri dönüşü: diğer cihazınızdaki QR kodunun ekran görüntüsünü yükleyin (Html5Qrcode.scanFile).

Yedek

Bir bölümde üç şey: Dışa Aktar (zaman damgalı JSON indir), İçe Aktar (dosyadan geri yükle) ve Karşılaştır (mevcut durumla yan yana fark). API anahtarları her dışa aktarmadan çıkarılır.

Geri yükleme bir ÜZERINE YAZMA değil, BİRLEŞTİRMEDİR: yeni satırlar eklenir, değiştirilebilir satırlar daha yeni updated_at ile güncellenir, geçmiş satırlar (oturumlar / commitler / derecelendirmeler) UUID'ye göre tekilleştirilir. Karşılaştırma önizlemesi, Geri Yükle'ye tıklamadan önce tablo başına eklenen / kaldırılan / değiştirilen öğeleri gösterir; Geri Yükle düğmesi etiketini fark oluştuktan sonra "Geri Yükle (N eklendi, M güncellendi)" olarak okur.

Yerel modda bölüm ayrıca Otomatik yedek bloğunu da gösterir: ayrı bir IndexedDB veritabanında 3 anlık görüntüden oluşan dönen halka, her 10 oturumda BİR VEYA her 7 günde bir çalışır (her hangisi önce gelirse). Her anlık görüntünün kendi Geri Yükle + Sil + A/B Olarak Karşılaştır düğmeleri vardır.

Ses

Üç geçiş (v1.18.0'dan beri):

• TTS etkin — yapay zeka yanıtları + Değerlendirme sonuçları yanında onları yüksek sesle okuyan bir ▶ düğmesi ekler. Mümkün olduğunda dille eşleşen sesi seçer; hız + perde [0,5, 2,0] arasında sınırlandırılır.
• Yapay zekayı otomatik oynat — her yapay zeka yanıtını otomatik olarak seslendirin (varsayılan KAPALI — sürpriz ses nadiren istenen şeydir).
• STT etkin — Oturum giriş alanına konuşmayı yakalayan ve alanı göndermeden önce ara dökümlerle dolduran bir 🎤 düğmesi ekler.
• Telaffuz Pratiği etkin — Diller etiketli projeler için Gösterge Tablosu hızlı başlatıcısından /pronunciation sayfasını açar.

Ses bölümü, Web Speech API'nin hiçbir tarafı (sentez veya tanıma) tarayıcı tarafından desteklenmediğinde kendini gizler.

Görünüm (Aşama 58 / v1.41.0)

Genel > Görünüm altındaki Tema seçici, otomatik bir mod artı altı tema sunar:

• Açık - varsayılan, parlak ve yüksek kontrastlı.
• Koyu - düşük ışıklı kullanım için karartılmış yüzeyler.
• Okyanus - derin mavi tonlar, sakin ve geceleri göze hoş.
• Orman - sıcak yeşil ve kehribar toprak tonları.
• Yüksek Kontrast - önce erişilebilirlik: siyah, beyaz ve kalın sinyal renkleri, keskin kart kenarlarıyla. Maksimum okunabilirliğe ihtiyaç duyuyorsanız bunu kullanın.
• Sepya - sıcak kağıt tonları, uzun okumalar için rahat.
• Otomatik (Sistem) - işletim sisteminizin açık/koyu ayarını takip eder ve sistem değiştirdiğinde otomatik olarak geçiş yapar.

Tema, önizleme kartından seçin; değişiklik yeniden yükleme olmadan anında uygulanır ve tercihiniz ziyaretler arasında hatırlanır. Her tema WCAG 2.1 AA kontrastını karşılamak üzere tasarlanmıştır; bu nedenle metin, grafikler, rozetler ve alıştırma geri bildirimi tümünde okunabilir kalır.

Arayüz

Hareketler geçişi (v1.10.0'dan beri, dokunmatik cihazlar için varsayılan AÇIK) Değerlendirme kaydırma navigasyonunu, Müfredat konu kaydırma-gösterme özelliğini ve Oturum döngüsü gözetlemeyi kapsar. Ayrıca burada: düğme araç ipuçları ve Geliştirici Modu.

Oyunlaştırma

XP / rozet / seviye atlama bildirimleri için geçişler (kapalı toast'ları susturur ama sistem durumu kaydetmeye devam eder), hafta sonu modu (seri ısı haritasında Cmt/Paz boşluklarını atlar), günlük oturum hedefi (1..10) ve İlerlemeyi sıfırla (çift onay; user_xp + user_badges + user_streaks satırlarını siler).

Hakkında

Beş salt okunur blok: Sürüm (pyproject.toml'dan standart sürüm, derleme karması, derleme tarihi), Sistem (depolama modu, veri dizini, Sunucu modunda veritabanı yolu, Python + platform bilgisi), Katkıda bulunanlar (yazar, bağımlılık teşekkürleri), Geliştirmeyi destekle (Liberapay / GitHub Sponsors / Ko-fi bağlantıları), Lisans ve kaynaklar (MIT bağlantısı, depo, belgeler, sorun takipcisi).

Yerel modda panel yalnızca çalışan bir arka uç için anlamlı olan satırları gizler (Python sürümü, FastAPI / SQLAlchemy / Pydantic / PluginForge sürümleri, veritabanı yolu).