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.