Skip to content

Häufige Probleme

Diese Anleitung behandelt die häufigsten Probleme, auf die Benutzer mit Sidian stoßen, und bietet schrittweise Lösungen, um sie schnell zu beheben.

KI-Funktionen funktionieren nicht

Wenn die KI-Funktionen von Sidian nicht reagieren oder nicht ordnungsgemäß funktionieren:

Authentifizierungsprobleme

KI-Funktionen erfordern eine Authentifizierung

  • Überprüfen Sie, ob Sie angemeldet sind (Kontostatus in der Seitenleiste suchen)
  • Versuchen Sie, sich ab- und wieder anzumelden
  • Überprüfen Sie, ob Ihr Abonnement aktiv ist
  • Leeren Sie den Browser-Cache, wenn Sie die Web-Authentifizierung verwenden

Netzwerkverbindung

Cloud-KI-Modelle erfordern eine Internetverbindung

  • Bei Cloud-Modellen: Überprüfen Sie Ihre Internetverbindung
  • Bei lokalen Modellen: Überprüfen Sie, ob der lokale KI-Server läuft (Ollama/LM Studio)
  • Stellen Sie sicher, dass die Firewall Sidian nicht blockiert
  • Versuchen Sie, das VPN vorübergehend zu deaktivieren, wenn Sie Cloud-Modelle verwenden
  • Prüfen Sie, ob ein Unternehmens-Proxy stört

Konfigurationsprobleme

Überprüfen Sie die Einstellungen für KI-Modelle und Anbieter

  • Vergewissern Sie sich, dass die API-Schlüssel korrekt konfiguriert sind
  • Überprüfen Sie, ob das ausgewählte KI-Modell verfügbar ist
  • Versuchen Sie, zu einem anderen KI-Anbieter zu wechseln
  • Setzen Sie die KI-Einstellungen auf die Standardwerte zurück

Probleme mit dem MCP-Server

Probleme mit den Model Context Protocol-Servern:

Server startet nicht

  • Überprüfen Sie, ob Node.js installiert und zugänglich ist
  • Verifizieren Sie, dass das Server-Paket installiert ist: npm list -g
  • Überprüfen Sie die Syntax der MCP-Konfigurationsdatei
  • Suchen Sie in den Server-Protokollen nach spezifischen Fehlermeldungen
  • Versuchen Sie, den Server-Befehl manuell im Terminal auszuführen

Berechtigungsfehler

  • Stellen Sie sicher, dass Sidian Lese-/Schreibzugriff auf die konfigurierten Verzeichnisse hat
  • Überprüfen Sie die Dateisystemberechtigungen der Projektordner
  • Führen Sie Sidian bei Bedarf als Administrator aus (Windows)
  • Vergewissern Sie sich, dass die MCP-Konfigurationsdatei lesbar ist

Server stürzt ständig ab

  • Aktualisieren Sie das MCP-Server-Paket auf die neueste Version
  • Suchen Sie nach widersprüchlichen Node.js-Versionen
  • Erhöhen Sie die Timeout-Werte in der Konfiguration
  • Überwachen Sie die Systemressourcen (CPU, Speicher)
  • Überprüfen Sie die Server-Protokolle auf Fehlermuster

Leistungsprobleme

Langsamer Start

  • Deaktivieren Sie unnötige Erweiterungen
  • Leeren Sie den Cache der Erweiterungen
  • Reduzieren Sie die Anzahl der geöffneten Dateien
  • Suchen Sie nach großen Dateien im Arbeitsbereich
  • Aktualisieren Sie auf die neueste Sidian-Version

Hohe Speichernutzung

  • Schließen Sie ungenutzte Dateien und Tabs
  • Deaktivieren Sie speicherintensive Erweiterungen
  • Reduzieren Sie den Umfang der Dateiüberwachung
  • Leeren Sie die Such- und Symbol-Caches
  • Starten Sie Sidian regelmäßig neu

Hohe CPU-Auslastung

  • Suchen Sie nach außer Kontrolle geratenen Erweiterungen
  • Deaktivieren Sie vorübergehend Echtzeitfunktionen
  • Reduzieren Sie die Häufigkeit der KI-Vorschläge
  • Schließen Sie ressourcenintensive Terminals
  • Überwachen Sie Hintergrundprozesse

Datei- und Editorprobleme

Dateien werden nicht geladen

  • Überprüfen Sie die Dateiberechtigungen
  • Vergewissern Sie sich, dass der Dateipfad korrekt ist
  • Versuchen Sie, den Datei-Explorer zu aktualisieren
  • Überprüfen Sie, ob die Datei von einem anderen Prozess gesperrt ist
  • Starten Sie Sidian neu, wenn Dateien beschädigt erscheinen

Automatisches Speichern funktioniert nicht

  • Überprüfen Sie die Einstellungen für das automatische Speichern in den Voreinstellungen
  • Überprüfen Sie die Schreibberechtigungen für die Datei
  • Stellen Sie sicher, dass genügend Speicherplatz vorhanden ist
  • Überprüfen Sie, ob die Datei schreibgeschützt ist
  • Versuchen Sie, manuell zu speichern, um die Schreibberechtigungen zu testen

Suche findet keine Dateien

  • Überprüfen Sie die Ausschlussmuster der Suche
  • Stellen Sie sicher, dass Dateierweiterungen nicht gefiltert werden
  • Versuchen Sie, den Suchindex neu zu erstellen
  • Überprüfen Sie, ob sich die Dateien in .gitignore befinden
  • Leeren Sie den Such-Cache und starten Sie neu

Probleme mit Erweiterungen

Erweiterung wird nicht installiert

  • Überprüfen Sie die Internetverbindung
  • Überprüfen Sie die Kompatibilität der Erweiterung
  • Leeren Sie den Cache der Erweiterungen
  • Versuchen Sie, aus einer VSIX-Datei zu installieren
  • Überprüfen Sie den verfügbaren Speicherplatz

Fehler bei Erweiterungen

  • Überprüfen Sie die Protokolle der Erweiterung im Ausgabefenster
  • Deaktivieren Sie widersprüchliche Erweiterungen
  • Aktualisieren Sie die Erweiterung auf die neueste Version
  • Setzen Sie die Einstellungen der Erweiterung zurück
  • Melden Sie das Problem dem Autor der Erweiterung

Erweiterung wird nicht geladen

  • Überprüfen Sie, ob die Erweiterung aktiviert ist
  • Überprüfen Sie die Abhängigkeiten der Erweiterung
  • Versuchen Sie, das Fenster neu zu laden (Strg+Umschalt+P → Fenster neu laden)
  • Suchen Sie nach Updates für die Erweiterung
  • Installieren Sie die Erweiterung neu

Probleme mit der Git-Integration

Git-Befehle schlagen fehl

  • Vergewissern Sie sich, dass Git installiert und im PATH ist
  • Überprüfen Sie den Status des Repositorys
  • Stellen Sie die korrekte Git-Konfiguration sicher
  • Versuchen Sie Git-Operationen im Terminal
  • Überprüfen Sie die Dateiberechtigungen

Merge-Konflikte

  • Verwenden Sie den integrierten Löser für Merge-Konflikte
  • Suchen Sie nach widersprüchlichen Änderungen
  • Stellen Sie sicher, dass alle Änderungen gestaged sind
  • Versuchen Sie eine manuelle Konfliktlösung
  • Verwenden Sie bei Bedarf externe Merge-Tools

Push/Pull-Probleme

  • Überprüfen Sie den Zugriff auf das Remote-Repository
  • Überprüfen Sie die Authentifizierungsdaten
  • Überprüfen Sie die Netzwerkverbindung
  • Versuchen Sie Git-Operationen im Terminal
  • Aktualisieren Sie Git auf die neueste Version

Terminalprobleme

Terminal öffnet sich nicht

  • Überprüfen Sie die Standard-Shell-Konfiguration
  • Vergewissern Sie sich, dass die ausführbare Shell-Datei existiert
  • Versuchen Sie eine andere Shell (bash, zsh, PowerShell)
  • Überprüfen Sie die Terminal-Einstellungen
  • Setzen Sie die Terminal-Konfiguration zurück

Befehle nicht gefunden

  • Überprüfen Sie die PATH-Umgebungsvariable
  • Überprüfen Sie die Installation des Befehls
  • Versuchen Sie den vollständigen Pfad zur ausführbaren Datei
  • Überprüfen Sie die Konfigurationsdateien der Shell
  • Starten Sie die Terminal-Sitzung neu

Anzeigeprobleme im Terminal

  • Überprüfen Sie die Schriftarteinstellungen des Terminals
  • Überprüfen Sie die Konfiguration des Farbschemas
  • Versuchen Sie einen anderen Terminal-Renderer
  • Überprüfen Sie die Unicode-Unterstützung
  • Setzen Sie die Erscheinungsbild-Einstellungen des Terminals zurück

Debugging-Probleme

Debugger startet nicht

  • Überprüfen Sie die Debug-Konfiguration
  • Überprüfen Sie die Installation des Debuggers
  • Überprüfen Sie die Syntax von launch.json
  • Versuchen Sie einen anderen Debug-Adapter
  • Überprüfen Sie die Port-Verfügbarkeit

Haltepunkte funktionieren nicht

  • Vergewissern Sie sich, dass die Source Maps korrekt sind
  • Überprüfen Sie, ob der Code optimiert ist
  • Versuchen Sie, Haltepunkte nach dem Start zu setzen
  • Überprüfen Sie den Anhang des Debuggers
  • Vergewissern Sie sich, dass die Dateipfade übereinstimmen

Variablen werden nicht angezeigt

  • Überprüfen Sie die Debug-Konsole auf Fehler
  • Überprüfen Sie den Geltungsbereich der Variablen
  • Versuchen Sie einen anderen Debug-Adapter
  • Überprüfen Sie die Ausdruckssyntax
  • Starten Sie die Debugging-Sitzung neu

Weitere Hilfe erhalten

Dokumentation

  • Überprüfen Sie die offizielle Dokumentation unter docs.sidian.dev
  • Überprüfen Sie die Dokumentation der Erweiterungen

Community-Support

  • Treten Sie dem Sidian Discord-Server bei
  • Suchen Sie auf Stack Overflow

Direkter Support

  • Kontaktieren Sie support@sidian.dev
  • Fügen Sie Fehlerprotokolle und Screenshots bei
  • Beschreiben Sie die Schritte zur Reproduktion
  • Erwähnen Sie Ihre Systemkonfiguration

Diagnoseinformationen

Wenn Sie Probleme melden, geben Sie Folgendes an:

  • Sidian-Version
  • Betriebssystem
  • Fehlermeldungen
  • Schritte zur Reproduktion
  • Liste der Erweiterungen
  • Systemspezifikationen

Die meisten Probleme können durch Befolgen dieser Schritte zur Fehlerbehebung gelöst werden. Wenn die Probleme weiterhin bestehen, zögern Sie nicht, sich an die Community oder das Support-Team zu wenden.