Αντιμετώπιση προβλημάτων

💡TL;DR

Τα περισσότερα Notemd προβλήματα ανήκουν σε τέσσερις κατηγορίες: βασικά προβλήματα API, σύνδεση δικτύου, σφάλματα αυθεντικοποίησης (401/403) και περιορισμοί ταχύτητας (429). Το ενσωματωμένο τεστ σύνδεσης και το πάνελ διαγνώσεων εντοπίζουν γρήγορα την ριζική αιτία. Αυτή η σελίδα καλύπτει κάθε συνηθισμένο μήνυμα σφάλματος, την αιτία του και τη λύση. Για προβλήματα που δεν αναφέρονται εδώ, αναφέρετέ τα στα GitHub Issues με τα αποτελέσματα διαγνώσεων.

Αυτό αποτελεί μέρος του Obsidian Οδηγού Διαχείρισης Γνώσης AI.

Επισκόπηση

Notemd εξαρτάται από εξωτερικές υπηρεσίες – πάροχους LLM και μηχανίσμους αναζήτησης API – οπότε τα περισσότερα προβλήματα προέρχονται από εκτός του ίδιου του προσθήκηματος. Το πάνελ διαγνώσεων στις ρυθμίσεις παρέχει μια δομημένη επισκόπηση της τελευταίας API κλήσης, συμπεριλαμβανομένης της αίτησης URL, του κωδικού κατάστασης απάντησης και του περιεχομένου σφάλματος. Πάντα ελέγξτε το πρώτο πριν εξετάσετε περαιτέρω.

Πώς λειτουργεί: Διαγνώσεις

Τεστ σύνδεσης

Κάθε ενότητα ρυθμίσεων πάροχου διαθέτει ένα κουμπί "Δοκιμάστε σύνδεση". Με το κλικ σε αυτό στέλνεται μια ελάχιστη API αίτηση (συνήθως μια λίστα μοντέλων ή μια σύντομη πλήρωση) και αναφέρεται επιτυχία ή το συγκεκριμένο HTTP σφάλμα. Αυτός είναι ο ταχύτερος τρόπος για να επαληθεύσετε ότι το API κλειδί και η βάση URL σας είναι σωστά.

Πάνελ διαγνώσεων

Ρυθμίσεις --> Notemd --> Διαγνώσεις δείχνει:

Πεδίο	Περιεχόμενο
Τελευταίος πάροχος	Ποιος πάροχος κλήθηκε τελευταία
Τελευταίο μοντέλο	Ποιο μοντέλο κλήθηκε τελευταία
Τελευταίος κατάσταση	Κωδικός κατάστασης HTTP ή σφάλμα μεταφοράς
Τελευταίο σφάλμα	Ακατέργαστο μήνυμα σφάλματος από το API
Τελευταία αιτήσεις URL	Πλήρης URL της τελευταίας αιτήσεως (συμπεριληφθέν συναισθητικά API)
Μέρος περιεχομένου απάντησης	Περικοπημένο μέρος περιεχομένου απάντησης (πρώτα 500 χαρακτήρες)

Αντιγράψτε την πλήρη έξοδο διαγνωστικών όταν αναφέρετε προβλήματα στο GitHub.

Συνηθισμένα σφάλματα

Κλειδί API μη έγκυρο ή απουσιάζει

Συμπτώματα: HTTP 401 ή "Παρεχόται λάθος API κλειδί"

Αιτία: Το κλειδί API απουσιάζει, περιέχει κενά ή ανήκει σε διαφορετικό πάροχο.

Λύση:

1. Επαληθεύστε ότι το κλειδί δεν έχει προηγούμενα/ακολουθούμενα κενά
2. Επαληθεύστε ότι το κλειδί ταιριάζει με τον επιλεγμένο πάροχο (ένα OpenAI κλειδί δεν θα λειτουργήσει με Anthropic)
3. Ελέγξτε αν το λογαριασμός σας διαθέτει πόρους ή ενεργή συνδρομή
4. Κάντε κλικ στο "Test Connection" για επαλήθευση

Σφάλματα δικτύου / σύνδεσης

Συμπτώματα: ERR_CONNECTION_REFUSED, ERR_TIMED_OUT, Socket hang up, Network request failed

Αιτία: Το τέλος API δεν είναι προσβάσιμο από το συστήμα σας.

Λύση:

1. Ελέγξτε τη σύνδεση Διαδικτύου σας
2. Αν βρίσκεστε πίσω από proxy ή firewall, επαληθεύστε ότι το δομένο API δεν είναι μπλοκαρισμένο
3. Για Ollama: επιβεβαιωθείτε ότι το ollama serve λειτουργεί (το ollama list θα πρέπει να επιστρέψει μοντέλα)
4. Για LMStudio: επιβεβαιωθείτε ότι ο διακομιστής λειτουργεί στο localhost:1234
5. Δοκιμάστε διαφορετικό τρανспорт – οι χρήστες μοβάιλ πρέπει να βεβαιωθούν ότι ο τρανспорт requestUrl είναι ενεργός
6. Ενεργοποιήστε το enableStableApiCall για αυτόματη επαναπροσπάθεια σε προσωρινά σφάλματα

403 Forbidden

Συμπτώματα: HTTP 403

Αιτία: Η κλειδί σας API είναι έγκυρη αλλά δεν διαθέτει άδειες για τον ζητούμενο πόρο.

Λύση:

1. Μερικά μοντέλα απαιτούν ειδική πρόσβαση (π.χ., το GPT-4 μέσω Azure απαιτεί όνομα ανάπτυξης)
2. Μερικοί πάροχοι περιορίζουν τα μοντέλα ανά επίπεδο πλάνου – ελέγξτε τον λογαριασμό σας
3. Μπορεί να ισχύουν περιοχαίες περιορισήσεις (κάποιοι πάροχοι στην Κίνα μπλοκάρουν διεθνείς IPs και το αντίστροφο)
4. Επαληθεύστε ότι το όνομα του μοντέλου γράφεται σωστά (π.χ., gpt-4o και όχι gpt-4o-mini όταν το μικρό μοντέλο είναι όλο αυτό που επιτρέπει ο πλάνος σας)

Rate Limit (429)

Συμπτώματα: HTTP 429 ή "Περιορισμός ταχύτητας υπερβλήθηκε"

Αιτία: Πάρα πολλές αιτήσεις σε μια κοντή περίοδο χρόνου.

Λύση:

1. Μειώστε το batchConcurrency σε 1 ή 2
2. Περιμένετε μερικά λεπτά πριν προσπαθήσετε ξανά
3. Ελέγξτε την τεκμηρίωση περιορισμών ταχύτητας του πάροχου σας για το επίπεδο πλάνου σας
4. Ενεργοποιήστε το enableStableApiCall για αυτόματη επαναπροσπάθεια με backoff
5. Σκεφτείτε να μεταβείτε σε πάροχο με υψηλότερους περιορισμούς (DeepSeek, Ollama)

Μοντέλο δεν βρέθηκε

Συμπτώματα: "Μοντέλο δεν βρέθηκε" ή HTTP 404

Αιτία: Το όνομα του μοντέλου δεν υπάρχει στον επιλεγμένο πάροχο.

Λύση:

1. Κάντε κλικ στο "Get Model List" για να δείτε όλα τα διαθέσιμα μοντέλα για τον πάροχό σας
2. Ορισμένα ονόματα μοντέλων αλλάζουν με την πάροδο του χρόνου -- επαληθεύστε το τρέχον ονόμα στην τεκμηρίωση του πάροχου
3. Για Ollama: εκτελέστε ollama list για να δείτε τα μοντέλα που έχουν αντληθεί· μόνο τα μοντέλα που έχουν κατεβαστεί είναι διαθέσιμα

Χωρίς συνδέσμους / Χωρίς γενημένες έννοιες

Σύμπτωμα: Η εντολή εκτελείται αλλά δεν παράγει καμία έξοδο

Αιτία: Το LLM επέστρεψε άδεια ή μη αναλυσιμή απάντηση.

Λύση:

1. Ελέγξτε το πάνελ διαγνώσεων για την πραγματική απάντηση LLM
2. Δοκιμάστε ένα πιο ισχυρό μοντέλο (κάποια μικρά μοντέλα δυσκολεύονται με δομημένη έξοδο)
3. Βεβαιωθείτε ότι το σημείωμα έχει αρκετό περιεχόμενο (>50 λέξεις)
4. Επανεξετάστε το προσαρμοσμένο πρόμπτ σας για συγκρουούμενες οδηγίες
5. Απενεργοποιήστε προσωρινά την καταστολή συνώνυμων για να δείτε αν φιλτράρει υπερβολικά έντονα

Στερεότυπο Doubao λείπει

Σύμπτωμα: Σφάλμα κατά τη χρήση του πάροχου ByteDance Doubao

Αιτία: Το Doubao απαιτεί ένα ID στερεότυπου Ark (μορφή: ep-xxxxxxxx-xxxx-xxxx) αντί για ονόμα μοντέλου.

Λύση: Αντικαταστήστε το προεπιλεγμένο μοντέλο-τόπος με τον πραγματικό αναγνωριστικό του τελικού σημείου από το παράθυρο ελέγχου Volcengine.

Ρυθμίσεις

Ρυθμίσεις Διάγνωσης	Τοποθεσία	Σκοπός
Δοκιμή Σύνδεσης	Μένου Ρυθμίσεις --> Ενότητα Πάροχος	Επαληθεύστε τον κλειδί API και τη σύνδεση
Λήψη Λίστας Μοντέλων	Μένου Ρυθμίσεις --> Ενότητα Πάροχος	Επιβεβαιώστε ποια μοντέλα είναι προσβάσιμα
enableStableApiCall	Μένου Ρυθμίσεις --> Προχωρημένες ρυθμίσεις	Ενεργοποιήστε επαναπροσπάθειες με αναβάθμιση χρόνου
batchConcurrency	Μένου Ρυθμίσεις --> Μαζικές εργασίες	Ελέγξτε τον παράλληλισμο για να αποφύγετε όρια ταχύτητας

Πώς να αναφέρετε προβλήματα

Αν το πρόβλημά σας δεν καλύπτεται παραπάνω:

1. Ανοίξτε Settings --> Notemd --> Diagnostics
2. Αντιγράψτε την πλήρη έξοδο διαγνωστικών
3. Ανοίξτε ένα GitHub Issue στη διεύθυνση github.com/Jacobinwwey/obsidian-NotEMD/issues
4. Περιλάβετε: την έκδοση Obsidian, την έκδοση Notemd, τον πάροχο, το μοντέλο, την έξοδο διαγνωστικών και τα βήματα για αναπαραγωγή
5. Αφαιρέστε τον κλειδί API σας από οποιουδήποτε κοινοποιημένο λογ

---

Επόμενα βήματα

• LLM Providers -- Πλήρης αναφορά διαμόρφωσης παρόχων
• Batch Processing -- Ρυθμίσεις συγχρονισμού και επανεπιχείρήσεων για μεγάλες επιχειρήσεις
• Custom Prompts -- Διόρθωση απροσδόκητης συμπεριφοράς LLM με την προσαρμογή προτάσεων