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.