Ρυθμίσεις¶
Η σελίδα Ρυθμίσεων συγκεντρώνει όλα όσα μπορείς να τροποποιήσεις χωρίς να αγγίξεις κώδικα ή YAML. Ενότητες από πάνω προς τα κάτω:
- Γλώσσα — γλώσσα UI (DE / EN / ES / FR / EL / PT / TR / JA, πλήρως μεταφρασμένες όλες).
- Πάροχος + επιλογέας μοντέλου ΤΝ — ποιος πάροχος βλέπει τα μηνύματά σου και ποιο μοντέλο χρησιμοποιείται.
- API keys — ανά πάροχο, με απόδοση πηγής
(env /
secrets.yaml/ Ρυθμίσεις). - Λειτουργία αποθήκευσης — Διακομιστής (FastAPI + SQLite) ή Τοπική (browser IndexedDB).
- Συγχρονισμός — σύνδεση αυτής της συσκευής με άλλη μέσω τοπικού δικτύου.
- Αντίγραφο ασφαλείας — εξαγωγή / εισαγωγή / σύγκριση.
- Φωνή — TTS + STT + εναλλαγές προφοράς.
- Εμφάνιση — χειρονομίες + θέμα + πυκνότητα.
- Παιχνιδοποίηση — ειδοποιήσεις XP / σήματος + λειτουργία Σαββατοκύριακου.
- Πληροφορίες — έκδοση, πληροφορίες συστήματος, εκτιμήσεις, δωρεές, άδεια χρήσης.
Γλώσσα¶
Αντικαθιστά αμέσως κάθε συμβολοσειρά UI στην επόμενη απόδοση μέσω
PATCH /api/settings/{user_id}. Και οι 8 γλώσσες είναι πρωτεύουσες
— DE / EN / ES / FR / EL / PT / TR / JA — η καθεμία με πλήρως
μεταφρασμένο κατάλογο. Αποθηκεύεται μεταξύ επαναφορτώσεων μέσω
localStorage.
Πάροχος ΤΝ + επιλογέας μοντέλου¶
Το αναπτυσσόμενο μενού παρόχου γράφει active_provider στις
UserSettings· η επόμενη κλήση ΤΝ περνά από το plugin του νέου
παρόχου (Λειτουργία Διακομιστή) ή τον HTTP client του νέου παρόχου
(Τοπική λειτουργία).
Ο Επιλογέας μοντέλου (από v1.11.0) είναι ένα αναπτυσσόμενο μενού
με δυνατότητα αναζήτησης, ομαδοποιημένο σε Προτεινόμενα / Όλα,
με πληθυσμό από το live endpoint /v1/models κάθε παρόχου (cache 1h).
Κάθε γραμμή δείχνει το αναγνώσιμο όνομα + raw id + σήμα παραθύρου
περιβάλλοντος. Όταν η λίστα δεν είναι διαθέσιμη (χωρίς API key, χωρίς
δίκτυο), ο επιλογέας επιστρέφει στις στατικές προεπιλογές και εμφανίζει
υπόδειξη "χρήση offline προεπιλογής". Η κεφαλίδα Συνεδρίας δείχνει
<Πάροχος>: <Όνομα μοντέλου>· το πλήρες id + παράθυρο περιβάλλοντος
βρίσκονται στο tooltip.
API keys (Phase 34 / v1.20.0)¶
Κάθε πάροχος έχει τη δική του γραμμή: πεδίο εισαγωγής κλειδιού, κουμπί Αποθήκευση, κουμπί Αφαίρεση, σήμα ενεργού παρόχου, συν το νέο σήμα απόδοσης πηγής:
- Κλειδί από: Ρυθμίσεις — το κλειδί αποθηκεύεται κρυπτογραφημένο με Fernet στη βάση δεδομένων (Λειτουργία Διακομιστή) ή ως καθαρό κείμενο στο IndexedDB (Τοπική λειτουργία). Μπορείς να Αποθηκεύσεις / Αφαιρέσεις ελεύθερα.
- Κλειδί από: secrets.yaml — το κλειδί ρυθμίζεται στο
~/.config/adaptive-learner/secrets.yaml. Το κουμπί Αποθήκευση είναι απενεργοποιημένο· επεξεργάσου το αρχείο απευθείας για αλλαγή. Μια ενημερωτική κορδέλα κάτω από τη γραμμή σου υπενθυμίζει τη διαδρομή. - Κλειδί από: environment — το κλειδί ρυθμίζεται μέσω της μεταβλητής
περιβάλλοντος
ADAPTIVE_LEARNER_<PROVIDER>_API_KEY. Αποθήκευση απενεργοποιημένη· η μεταβλητή είναι η πηγή αλήθειας. - Κανένα ρυθμισμένο κλειδί — τίποτα δεν έχει οριστεί. Πληκτρολόγησε και πάτησε Αποθήκευση για να ξεκινήσεις.
Αλυσίδα επίλυσης (υψηλότερη προτεραιότητα κερδίζει): env > secrets.yaml
DB. Δες το έγγραφο Ρύθμισης για την πλήρη ανάλυση.
Λειτουργία αποθήκευσης¶
Εναλλαγή μεταξύ Διακομιστή και Τοπικής (Browser) αποθήκευσης:
- Διακομιστής — κάθε ανάγνωση και εγγραφή χτυπά το FastAPI backend. Απαιτεί λειτουργούν backend. Ιδανικό για χρήση πολλαπλών συσκευών με συγχρονισμό μέσω backend.
- Τοπική (Browser) — κάθε ανάγνωση και εγγραφή χτυπά το IndexedDB σε αυτό τον browser. Οι κλήσεις ΤΝ εκπέμπονται απευθείας στον πάροχο. Δεν απαιτείται backend. Ιδανικό για ιδιωτική, τοπική σε συσκευή εγκατάσταση.
Η εναλλαγή λειτουργιών αποθηκεύεται στο localStorage και εμφανίζει
μήνυμα "απαιτείται επαναφόρτωση". Τα δεδομένα ΔΕΝ συγχρονίζονται μεταξύ
λειτουργιών.
Συγχρονισμός¶
Σύνδεσε αυτή τη συσκευή με μια άλλη μέσω τοπικού δικτύου χρησιμοποιώντας τον σαρωτή QR code (πίσω κάμερα) ή επικολλώντας το URL σύνδεσης. Μόλις συνδεθεί, τα κουμπιά push + pull ανταλλάσσουν δεδομένα αμφίδρομα. Οι συγκρούσεις επιλύονται μέσω ενός αναλυτή AI-merge στο backend.
Εναλλακτική για browser με περιορισμούς: ανέβασε στιγμιότυπο οθόνης του
QR code από την άλλη συσκευή σου (Html5Qrcode.scanFile).
Αντίγραφο ασφαλείας¶
Τρία πράγματα σε μία ενότητα: Εξαγωγή (λήψη χρονοσφραγισμένου JSON), Εισαγωγή (επαναφορά από αρχείο) και Σύγκριση (παράθεση πλευρά με πλευρά έναντι της τρέχουσας κατάστασης). Τα API keys αφαιρούνται από κάθε εξαγωγή.
Η επαναφορά είναι ΣΥΓΧΩΝΕΥΣΗ, όχι αντικατάσταση: νέες γραμμές εισάγονται,
μεταβλητές γραμμές ενημερώνονται με νεότερο updated_at, γραμμές ιστορικού
(συνεδρίες / commits / αξιολογήσεις) αποκλείουν διπλότυπα βάσει UUID.
Η προεπισκόπηση σύγκρισης δείχνει ανά πίνακα προσθήκες / αφαιρέσεις /
αλλαγές πριν κάνεις κλικ Επαναφορά· η ετικέτα κουμπιού Επαναφοράς
διαβάζει "Επαναφορά (N προσθήκες, M ενημερώσεις)" μόλις τελειώσει η
σύγκριση.
Στην Τοπική λειτουργία η ενότητα δείχνει επίσης τον μπλοκ Αυτόματου αντιγράφου ασφαλείας: κυκλική ουρά 3 στιγμιότυπων σε ξεχωριστή βάση IndexedDB, εκτελείται κάθε 10 συνεδρίες Ή κάθε 7 ημέρες (όποιο πυρκαγεί πρώτο). Κάθε στιγμιότυπο έχει δικό του κουμπί Επαναφορά + Διαγραφή + Σύγκριση-ως-A/B.
Φωνή¶
Τρεις εναλλαγές (από v1.18.0):
- TTS ενεργό — προσθέτει κουμπί ▶ δίπλα στις απαντήσεις ΤΝ + αποτελέσματα Αξιολόγησης που τα διαβάζει δυνατά. Επιλέγει τη φωνή που ταιριάζει με τη γλώσσα όταν είναι διαθέσιμη· ρυθμός + τόνος περιορίζονται στο [0.5, 2.0].
- Αυτόματη αναπαραγωγή ΤΝ — μιλά κάθε απάντηση ΤΝ αυτόματα (προεπιλογή ΑΠΕΝΕΡΓΟΠΟΙΗΜΕΝΟ — ο αναπάντεχος ήχος σπάνια είναι αυτό που θέλεις).
- STT ενεργό — προσθέτει κουμπί 🎤 στην είσοδο Συνεδρίας που αποτυπώνει ομιλία και συμπληρώνει την περιοχή κειμένου με ενδιάμεσα αντίγραφα πριν την αποστολή.
- Εξάσκηση Προφοράς ενεργή — εμφανίζει τη σελίδα
/pronunciationαπό την γρήγορη εκκίνηση Ταμπλό για έργα με ετικέτα Γλώσσες.
Η ενότητα Φωνής κρύβεται όταν κανένα από τα δύο μέρη του Web Speech API (σύνθεση ή αναγνώριση) δεν υποστηρίζεται από τον browser.
Εμφάνιση (Phase 58 / v1.41.0)¶
Ο επιλογέας Θέματος στις Γενικές > Εμφάνιση προσφέρει έξι θέματα και μια αυτόματη λειτουργία:
- Φωτεινό — το προεπιλεγμένο, φωτεινό και υψηλής αντίθεσης.
- Σκοτεινό — μειωμένες επιφάνειες για χαμηλό φωτισμό.
- Ωκεανός — βαθιές μπλε αποχρώσεις, ήρεμο και ευχάριστο στα μάτια τη νύχτα.
- Δάσος — ζεστοί πράσινοι και κεχριμπαρένιοι τόνοι γης.
- Υψηλή Αντίθεση — προσβασιμότητα πρώτα: μαύρο, άσπρο και έντονα χρώματα σήματος, με καθαρά άκρα καρτών. Χρησιμοποίησέ το αν χρειάζεσαι μέγιστη αναγνωσιμότητα.
- Σέπια — ζεστοί τόνοι χαρτιού, άνετοι για παρατεταμένη ανάγνωση.
- Αυτόματο (Σύστημα) — ακολουθεί τη ρύθμιση φωτεινού/σκοτεινού του λειτουργικού σου συστήματος και αλλάζει αυτόματα μαζί του.
Επέλεξε θέμα από την κάρτα προεπισκόπησής του· η αλλαγή εφαρμόζεται αμέσως χωρίς επαναφόρτωση, και η επιλογή σου θυμάται μεταξύ επισκέψεων. Κάθε θέμα σχεδιάστηκε για να πληροί τον WCAG 2.1 AA, οπότε κείμενο, γραφήματα, σήματα και ανατροφοδότηση άσκησης παραμένουν ευανάγνωστα σε όλα.
Διεπαφή¶
Η εναλλαγή Χειρονομιών (από v1.10.0, προεπιλογή ΕΝΕΡΓΟ για συσκευές αφής) καλύπτει πλοήγηση με σάρωση Αξιολόγησης, αποκάλυψη θέματος Προγράμματος Σπουδών με σάρωση και ματιά κύκλου Συνεδρίας. Επίσης εδώ: tooltips κουμπιών και Λειτουργία Προγραμματιστή.
Παιχνιδοποίηση¶
Εναλλαγές για ειδοποιήσεις XP / σήματος / ανεβάσματος επιπέδου
(απενεργοποίηση σιγάζει τα toasts αλλά το σύστημα εξακολουθεί να
καταγράφει κατάσταση), λειτουργία σαββατοκύριακου (παράλειψη κενών
Σαβ/Κυρ στον χάρτη θερμότητας σερί), ημερήσιος στόχος συνεδριών (1..10)
και Επαναφορά προόδου (διπλή επιβεβαίωση· σβήνει γραμμές
user_xp + user_badges + user_streaks).
Πληροφορίες¶
Πέντε μπλοκ μόνο για ανάγνωση: Έκδοση (κανονική έκδοση από
pyproject.toml, hash build, ημερομηνία build), Σύστημα
(λειτουργία αποθήκευσης, κατάλογος δεδομένων, διαδρομή βάσης δεδομένων
σε Λειτουργία Διακομιστή, Python + πληροφορίες πλατφόρμας), Εκτιμήσεις
(συγγραφέας, αναγνώριση εξαρτήσεων), Υποστήριξη ανάπτυξης
(σύνδεσμοι Liberapay / GitHub Sponsors / Ko-fi), Άδεια χρήσης και
πόροι (σύνδεσμος MIT, αποθετήριο, έγγραφα, εργαλείο παρακολούθησης
θεμάτων).
Στην Τοπική λειτουργία ο πίνακας κρύβει τις γραμμές που έχουν νόημα μόνο για λειτουργούν backend (έκδοση Python, εκδόσεις FastAPI / SQLAlchemy / Pydantic / PluginForge, διαδρομή βάσης δεδομένων).