Zum Hauptinhalt springen

Fehlerbehebung

💡TL;DR

Die meisten Notemd-Probleme fallen in vier Kategorien: grundlegende API-Probleme, Netzwerkverbindungen, Authentifizierungsfehler (401/403) sowie Rate-Limits (429). Der integrierte Verbindungs-Test und das Diagnosepanel helfen dabei, die Ursache schnell zu ermitteln. Auf dieser Seite werden alle gängigen Fehlermeldungen, ihre Ursachen sowie die Lösungen beschrieben. Bei Problemen, die hier nicht aufgeführt sind, melden Sie diese bitte über GitHub Issues zusammen mit dem Diagnoseausgabe.

Dies ist ein Teil des Obsidian AI-Know-how-Management-Leitfadens.

Überblick​

Notemd hängt von externen Diensten ab -- LLM-Anbietern und Such-API-Diensten -- daher entstehen die meisten Probleme außerhalb des Plugins selbst. Das Diagnosepanel in den Einstellungen bietet einen strukturierten Überblick über den letzten API-Aufruf, einschließlich der Anfrage URL, des Antwortstatus und des Fehlerinhalts. Überprüfen Sie es immer zuerst, bevor Sie weiter ermitteln.

Wie es funktioniert: Diagnose​

Verbindungsprüfung​

Jede Konfigurationssektion des Anbieters verfügt über einen Button „Testverbindung“. Durch Klicken darauf wird eine minimale API-Anfrage gesendet (in der Regel eine Liste von Modellen oder eine kurze Vervollständigung), und es wird angezeigt, ob die Verbindung erfolgreich war oder ein spezifischer HTTP-Fehler auftrat. Dies ist die schnellste Möglichkeit, um zu überprüfen, ob Ihre API-Einstellungen sowie der Basis-URL korrekt sind.

Diagnosepanel​

Einstellungen --> Notemd --> Diagnose zeigt an:

FeldInhalt
Letzter AnbieterWelchen Anbieter wurde zuletzt aufgerufen
Letztes ModellWelches Modell wurde zuletzt aufgerufen
Letzter StatusStatuscode HTTP oder Transportfehler
Letzter FehlerRohes Fehlermeldung vom API
Letzte Anfrage URLVollständiger URL des letzten Anfrages (redigierte API-Einstellung)
Letzter AntwortinhaltKurzer Antwortkörper (erste 500 Zeichen)

Kopieren Sie die vollständige Diagnoseausgabe, wenn Sie Probleme auf GitHub melden.

Häufige Fehler​

API Schlüssel ungültig oder fehlend​

Symptom: HTTP 401 oder „Falscher API-Schlüssel angegeben“

Ursache: Der Schlüssel API fehlt, enthält Leerzeichen oder gehört zu einem anderen Anbieter.

Lösung:

  1. Überprüfen Sie, ob der Schlüssel keine vorangehenden/nachfolgenden Leerzeichen hat.
  2. Bestätigen Sie, dass der Schlüssel zum ausgewählten Anbieter passt (ein OpenAI-Schlüssel funktioniert nicht mit Anthropic).
  3. Überprüfen Sie, ob Ihr Konto über Guthaben oder ein aktives Abonnement verfügt.
  4. Klicken Sie auf „Testverbindung“, um zu überprüfen

Netzwerk-/Verbindungsfehler​

Symptom: ERR_CONNECTION_REFUSED, ERR_TIMED_OUT, Socket hang up, Network request failed

Ursache: Die API-Endpunkt ist von Ihrem Rechner aus nicht erreichbar.

Lösung:

  1. Überprüfen Sie Ihre Internetverbindung.
  2. Wenn Sie sich hinter einem Proxy oder Firewall befinden, überprüfen Sie, ob die API-Domain nicht blockiert ist.
  3. Für Ollama: Bestätigen Sie, dass ollama serve läuft (ollama list sollte Modelle zurückgeben)
  4. Für LMStudio: Bestätigen Sie, dass der Server auf localhost:1234 läuft.
  5. Versuchen Sie einen anderen Transport – Mobilnutzer sollten sicherstellen, dass der requestUrl-Transport aktiv ist
  6. Aktivieren Sie enableStableApiCall für eine automatische Wiederholung bei vorübergehenden Fehlern

403 Verboten​

Symptom: HTTP 403

Ursache: Ihre API-Schlüssel ist gültig, besitzt jedoch keine Berechtigung für die angeforderte Ressource.

Lösung:

  1. Einige Modelle erfordern einen speziellen Zugriff (z. B. GPT-4 über Azure benötigt einen Bereitstellungsnamen).
  2. Einige Anbieter beschränken die Modelle nach Tarifstufe – überprüfen Sie Ihr Konto.
  3. Es können regionale Einschränkungen gelten (einige chinesische Anbieter blockieren internationale IP-Adressen und umgekehrt).
  4. Überprüfen Sie, ob der Modellname korrekt geschrieben ist (z. B. gpt-4o und nicht gpt-4o-mini, wenn das Mini-Modell alles ist, was Ihr Plan zulässt).

Rate Limitierung (429)​

Symptom: HTTP 429 oder „Rate limit exceeded“

Ursache: Zu viele Anfragen innerhalb eines kurzen Zeitraums.

Lösung:

  1. Verringere batchConcurrency auf 1 oder 2
  2. Warten Sie ein paar Minuten, bevor Sie es erneut versuchen.
  3. Prüfen Sie die Dokumentation zu den Rate-Limit-Einschränkungen Ihres Anbieters für Ihre Tarifstufe.
  4. Aktivieren Sie enableStableApiCall für automatische Wiederholungsversuche mit Backoff.
  5. Überlegen Sie einen Wechsel zu einem Anbieter mit höheren Limits (DeepSeek, Ollama).

Modell nicht gefunden​

Symptom: „Modell nicht gefunden“ oder HTTP 404

Ursache: Der Modellname existiert beim ausgewählten Anbieter nicht.

Lösung:

  1. Klicken Sie auf „Modellliste anfordern“, um alle verfügbaren Modelle Ihres Anbieters anzusehen
  2. Einige Modellnamen ändern sich im Laufe der Zeit – überprüfen Sie den aktuellen Namen in der Dokumentation des Anbieters.
  3. Für Ollama: Führen Sie ollama list aus, um die heruntergeladenen Modelle anzuzeigen; nur heruntergeladene Modelle sind verfügbar

Keine Links / Keine Konzepte erzeugt​

Symptom: Der Befehl wird ausgeführt, aber es wird keine Ausgabe erzeugt

Ursache: Der LLM hat eine leere oder unverarbeitbare Antwort zurückgegeben.

Lösung:

  1. Überprüfen Sie das Diagnosepanel auf die tatsächliche LLM-Antwort
  2. Versuchen Sie ein leistungsstärkeres Modell (einige kleine Modelle haben Schwierigkeiten mit strukturierten Ausgaben).
  3. Stellen Sie sicher, dass die Notiz ausreichend Inhalt enthält (>50 Wörter).
  4. Überprüfen Sie Ihren benutzerdefinierten Prompt auf widersprüchliche Anweisungen
  5. Deaktivieren Sie vorübergehend die Unterdrückung von Synonymen, um zu prüfen, ob sie zu aggressiv filtert.

Doubao Endpunkt-ID fehlt​

Symptom: Fehler beim Verwenden des ByteDance Doubao-Anbieters

Ursache: Doubao erfordert eine Ark-Endpunkt-ID (Format: ep-xxxxxxxx-xxxx-xxxx) anstelle eines Modellnamens.

Lösung: Ersetzen Sie den Standard-Platzhaltermodell durch Ihre tatsächliche Endpoint-ID aus der Volcengine-Konsole.

Konfiguration​

DiagnoseeinstellungenStandortZweck
VerbindungsprüfungEinstellungen --> Abschnitt ProviderÜberprüfen Sie den Schlüssel API und die Verbindbarkeit
Modellliste abrufenEinstellungen --> Abschnitt ProviderBestätigen Sie, welche Modelle zugänglich sind
enableStableApiCallEinstellungen --> ErweitertWiederholung mit Zeitverzögerung aktivieren
batchConcurrencyEinstellungen --> BatchParallelität steuern, um Rate Limits zu vermeiden

Wie man Probleme melden kann​

Falls Ihr Problem nicht oben abgedeckt ist:

  1. Öffnen Sie Einstellungen --> Notemd --> Diagnose
  2. Kopiere die vollständige Diagnoseausgabe
  3. Öffnen Sie ein GitHub Issue unter github.com/Jacobinwwey/obsidian-NotEMD/issues
  4. Enthält: Obsidian Version, Notemd Version, Anbieter, Modell, Diagnoseausgabe sowie Schritte zur Wiederholung des Problems
  5. Reduzieren Sie Ihren API-Schlüssel in allen geteilten Protokollen.

Nächste Schritte​

  • LLM Anbieter -- Vollständige Referenz zur Anbieterkonfiguration
  • Batch Processing -- Konkurrenz- und Wiederholungs-Einstellungen für große Operationen
  • Custom Prompts -- Beheben Sie das unerwartete LLM-Verhalten durch Anpassung der Prompts