Αντιμετώπιση προβλημάτων
Επισκόπηση
Καταγράψτε εκδόσεις Notemd/Obsidian, OS, ενέργεια, πρωτόκολλο, μοντέλο και ελάχιστα βήματα. Μην επανεκκινείτε όσο ολοκληρώνεται ακύρωση. Διατηρήστε αποτελέσματα και αρχεία ανάκτησης μέχρι να καταλάβετε την προέλευσή τους.
Διαγνωστικά
Έλεγχος σύνδεσης
Το Test connection μπορεί να ελέγχει μόνο λίστα μοντέλων ή σύντομη παραγωγή. Εκτελέστε μετά μικρή πραγματική εργασία με το επιλεγμένο μοντέλο και μορφή εξόδου.
Πρόοδος και διαγνωστικά προγραμματιστή
Η πρόοδος δείχνει κατάσταση, σφάλματα και θέσεις· η δραστηριότητα API διαχωρίζει αναμονή και ολοκλήρωση. Ενεργοποιήστε debug όταν χρειάζεται. Μακρά διαγνωστική κλήση μπορεί να καταναλώσει όρια. Αναφορές μπορεί να περιέχουν σημειώσεις, μερικά μηνύματα, endpoints και κλειδιά. Ελέγξτε και αποκρύψτε ευαίσθητα στοιχεία τοπικά πριν μοιραστείτε, ακόμη και μεταδεδομένα σε καθαρισμένα προφίλ.
Συνήθη σφάλματα
Άκυρο ή απόν κλειδί
401: σωστό προφίλ/endpoint, χωρίς ακούσια κενά. 403: λογαριασμός, έργο, πρόσβαση μοντέλου και χρέωση. Επαναλήψεις δεν διορθώνουν λάθος διαπιστευτήρια.
Δίκτυο
Ελέγξτε διακομιστή, θύρα, πρωτόκολλο και διαδρομή από τη συσκευή Obsidian. Ollama/LM Studio πρέπει να λειτουργούν με διαθέσιμο μοντέλο. Το localhost είναι αυτή η συσκευή, όχι άλλος υπολογιστής. Επιλέξτε σωστό προφίλ· το fallback επιλέγεται αυτόματα, όχι από κουμπί μεταφοράς.
Όριο 429
Μειώστε ταυτόχρονα αιτήματα και ελέγξτε όρια κλήσεων/tokens και άλλη χρήση του κλειδιού. Επαναλήψεις λύνουν μόνο ορισμένα παροδικά λάθη.
Μοντέλο δεν βρέθηκε
Χρησιμοποιήστε Fetch models ή γνωστό μοντέλο/deployment. Δείτε API και περιοχή. Παραδείγματα μπορεί να είναι παλιά· Azure απαιτεί deployment και Ark μπορεί να απαιτεί endpoint-ID.
Χωρίς συνδέσμους ή έννοιες
Ελέγξτε πραγματικό αρχείο αποτελέσματος, χρήσιμη πηγή, μορφή απάντησης και επιλεγμένο ενεργό φάκελο εννοιών. Ο αυτόνομος εντοπισμός αρχίζει με τίτλους χωρίς επιστροφές. Συγκρίνετε την προεπιλεγμένη οδηγία αν λείπουν δείκτες.
Έξοδος λείπει ή βρίσκεται αλλού
Διαβάστε την αναφερόμενη _processed.md, _<language>.md ή complete διαδρομή. Αποτυχία φακέλου μετάφρασης μπορεί να χρησιμοποιήσει τον φάκελο πηγής. Ελέγξτε συγκρούσεις και δικαιώματα πριν επαναλάβετε.
Αρχεία μετά από ακύρωση
Ολοκληρωμένες εγγραφές μένουν και αποδεκτά αιτήματα μπορούν να τελειώσουν. Εξετάστε αρχεία και συγκρούσεις ανάκτησης πριν διαγράψετε ή επαναλάβετε όλο τον φάκελο.
Διάγραμμα ή εξαγωγή σε εφαρμογή
Οι τύποι παράγονται διαδοχικά. Ένα σφάλμα δεν εμποδίζει τους υπόλοιπους· η ακύρωση σταματά τους εκκρεμείς και διατηρεί τα ολοκληρωμένα αρχεία. Επαναλάβετε εξαγωγές από προεπισκόπηση ή ιστορικό χωρίς νέο αίτημα στο μοντέλο. Αποτυχία δημιουργίας απαιτεί νέα δημιουργία του τύπου. Οι εγγραφές v1/v2 παραμένουν αναγνώσιμες.
Το HTML διαγράμματος περιέχει γραφικό με μεγέθυνση· το HTML δομημένης περίληψης περιέχει κείμενο, δομή και παραπομπές. Το επεξεργάσιμο HTML/SVG ονομάζει renderer, όχι διαδικτυακό επεξεργαστή. Για αλλαγές χρησιμοποιήστε την εγγενή πηγή. Οι παρουσιάσεις, μαζί με PPTX και MP4, κρατούν χωριστές ρυθμίσεις και εξαρτήσεις. Εγχειρίδιο διαγραμμάτων.
Αναφορά προβλήματος
- Αναπαράγετε με συνθετική σημείωση και δοκιμαστικό φάκελο.
- Δώστε εκδόσεις, ενέργεια, μοντέλο, αναγκαίες ρυθμίσεις και αναμενόμενο/πραγματικό αποτέλεσμα.
- Προσθέστε ελάχιστα αρχεία/logs χωρίς κλειδιά, ιδιωτικό περιεχόμενο ή περιττά μεταδεδομένα endpoint.
- Δηλώστε αν συμβαίνει σε ένα αρχείο με προεπιλεγμένες οδηγίες.
- Ανοίξτε GitHub Issue.
Ένα screenshot μόνο του σπάνια αποδεικνύει σφάλμα μορφής ή ακύρωσης. Δώστε πηγή/αποτέλεσμα ή ελάχιστα βήματα όταν είναι δυνατό.