Problèmes Courants
Ce guide couvre les problèmes les plus courants que les utilisateurs rencontrent avec Sidian et fournit des solutions étape par étape pour les résoudre rapidement.
Les Fonctionnalités d'IA ne Fonctionnent Pas
Si les fonctionnalités d'IA de Sidian ne répondent pas ou ne fonctionnent pas correctement:
Problèmes d'Authentification
Les fonctionnalités d'IA nécessitent une authentification
- Vérifiez si vous êtes connecté (regardez le statut du compte dans la barre latérale)
- Essayez de vous déconnecter et de vous reconnecter
- Vérifiez que votre abonnement est actif
- Videz le cache du navigateur si vous utilisez l'authentification web
Connectivité Réseau
Les modèles d'IA cloud nécessitent une connexion Internet
- Pour les modèles cloud : Vérifiez votre connexion Internet
- Pour les modèles locaux : Vérifiez que le serveur d'IA local est en cours d'exécution (Ollama/LM Studio)
- Vérifiez que le pare-feu ne bloque pas Sidian
- Essayez de désactiver temporairement le VPN si vous utilisez des modèles cloud
- Vérifiez si un proxy d'entreprise interfère
Problèmes de Configuration
Vérifiez les paramètres du modèle et du fournisseur d'IA
- Vérifiez que les clés d'API sont correctement configurées
- Vérifiez si le modèle d'IA sélectionné est disponible
- Essayez de passer à un autre fournisseur d'IA
- Réinitialisez les paramètres d'IA par défaut
Problèmes de Serveur MCP
Problèmes avec les serveurs du Protocole de Contexte de Modèle (MCP) :
Le Serveur ne Démarre Pas
- Vérifiez si Node.js est installé et accessible
- Vérifiez que le paquet du serveur est installé :
npm list -g
- Vérifiez la syntaxe du fichier de configuration MCP
- Consultez les journaux du serveur pour des messages d'erreur spécifiques
- Essayez d'exécuter manuellement la commande du serveur dans le terminal
Erreurs de Permission
- Assurez-vous que Sidian a les droits de lecture/écriture sur les répertoires configurés
- Vérifiez les permissions du système de fichiers sur les dossiers du projet
- Exécutez Sidian en tant qu'administrateur si nécessaire (Windows)
- Vérifiez que le fichier de configuration MCP est lisible
Le Serveur Tombe en Panne Constamment
- Mettez à jour le paquet du serveur MCP à la dernière version
- Vérifiez les conflits de versions de Node.js
- Augmentez les valeurs de timeout dans la configuration
- Surveillez les ressources système (CPU, mémoire)
- Vérifiez les journaux du serveur pour des schémas d'erreur
Problèmes de Performance
Démarrage Lent
- Désactivez les extensions inutiles
- Videz le cache des extensions
- Réduisez le nombre de fichiers ouverts
- Vérifiez la présence de fichiers volumineux dans l'espace de travail
- Mettez à jour vers la dernière version de Sidian
Utilisation Élevée de la Mémoire
- Fermez les fichiers et onglets inutilisés
- Désactivez les extensions gourmandes en mémoire
- Réduisez la portée de la surveillance des fichiers
- Videz les caches de recherche et de symboles
- Redémarrez Sidian périodiquement
Utilisation Élevée du CPU
- Recherchez les extensions qui s'emballent
- Désactivez temporairement les fonctionnalités en temps réel
- Réduisez la fréquence des suggestions de l'IA
- Fermez les terminaux gourmands en ressources
- Surveillez les processus en arrière-plan
Problèmes de Fichiers et d'Éditeur
Les Fichiers ne se Chargent Pas
- Vérifiez les permissions des fichiers
- Vérifiez que le chemin du fichier est correct
- Essayez de rafraîchir l'explorateur de fichiers
- Vérifiez si le fichier est verrouillé par un autre processus
- Redémarrez Sidian si les fichiers semblent corrompus
L'Enregistrement Automatique ne Fonctionne Pas
- Vérifiez les paramètres d'enregistrement automatique dans les préférences
- Vérifiez les permissions d'écriture pour le fichier
- Assurez-vous qu'il y a suffisamment d'espace disque
- Vérifiez si le fichier est en lecture seule
- Essayez d'enregistrer manuellement pour tester les permissions d'écriture
La Recherche ne Trouve Pas les Fichiers
- Vérifiez les motifs d'exclusion de la recherche
- Vérifiez que les extensions de fichiers ne sont pas filtrées
- Essayez de reconstruire l'index de recherche
- Vérifiez si les fichiers sont dans le
.gitignore
- Videz le cache de recherche et redémarrez
Problèmes d'Extension
L'Extension ne s'Installe Pas
- Vérifiez la connexion Internet
- Vérifiez la compatibilité de l'extension
- Videz le cache des extensions
- Essayez d'installer à partir d'un fichier VSIX
- Vérifiez l'espace disque disponible
Erreurs d'Extension
- Consultez les journaux de l'extension dans le panneau de sortie
- Désactivez les extensions en conflit
- Mettez à jour l'extension à la dernière version
- Réinitialisez les paramètres de l'extension
- Signalez le problème à l'auteur de l'extension
L'Extension ne se Charge Pas
- Vérifiez si l'extension est activée
- Vérifiez les dépendances de l'extension
- Essayez de recharger la fenêtre (Ctrl+Shift+P → Recharger la Fenêtre)
- Recherchez les mises à jour de l'extension
- Réinstallez l'extension
Problèmes d'Intégration Git
Les Commandes Git Échouent
- Vérifiez que Git est installé et dans le PATH
- Vérifiez le statut du dépôt
- Assurez-vous que la configuration Git est correcte
- Essayez les opérations Git dans le terminal
- Vérifiez les permissions des fichiers
Conflits de Fusion
- Utilisez le résolveur de conflits de fusion intégré
- Recherchez les changements conflictuels
- Assurez-vous que toutes les modifications sont préparées (staged)
- Essayez la résolution manuelle des conflits
- Utilisez des outils de fusion externes si nécessaire
Problèmes de Push/Pull
- Vérifiez l'accès au dépôt distant
- Vérifiez les identifiants d'authentification
- Vérifiez la connectivité réseau
- Essayez les opérations Git dans le terminal
- Mettez à jour Git à la dernière version
Problèmes de Terminal
Le Terminal ne s'Ouvre Pas
- Vérifiez la configuration du shell par défaut
- Vérifiez que l'exécutable du shell existe
- Essayez un autre shell (bash, zsh, PowerShell)
- Vérifiez les paramètres du terminal
- Réinitialisez la configuration du terminal
Commandes Introuvables
- Vérifiez la variable d'environnement PATH
- Vérifiez l'installation de la commande
- Essayez le chemin complet de l'exécutable
- Vérifiez les fichiers de configuration du shell
- Redémarrez la session du terminal
Problèmes d'Affichage du Terminal
- Vérifiez les paramètres de police du terminal
- Vérifiez la configuration du schéma de couleurs
- Essayez un autre moteur de rendu de terminal
- Vérifiez la prise en charge de l'Unicode
- Réinitialisez les paramètres d'apparence du terminal
Problèmes de Débogage
Le Débogueur ne Démarre Pas
- Vérifiez la configuration de débogage
- Vérifiez l'installation du débogueur
- Vérifiez la syntaxe de
launch.json
- Essayez un autre adaptateur de débogage
- Vérifiez la disponibilité des ports
Les Points d'Arrêt ne Fonctionnent Pas
- Vérifiez que les source maps sont correctes
- Vérifiez si le code est optimisé
- Essayez de définir des points d'arrêt après le démarrage
- Vérifiez l'attachement du débogueur
- Vérifiez que les chemins de fichiers correspondent
Les Variables ne s'Affichent Pas
- Vérifiez les erreurs dans la console de débogage
- Vérifiez la portée des variables
- Essayez un autre adaptateur de débogage
- Vérifiez la syntaxe des expressions
- Redémarrez la session de débogage
Obtenir de l'Aide Supplémentaire
Documentation
- Consultez la documentation officielle sur docs.sidian.dev
- Consultez la documentation de l'extension
Support Communautaire
- Rejoignez le serveur Discord de Sidian
- Recherchez sur Stack Overflow
Support Direct
- Contactez support@sidian.dev
- Incluez les journaux d'erreurs et des captures d'écran
- Décrivez les étapes pour reproduire le problème
- Mentionnez la configuration de votre système
Informations de Diagnostic
Lors de la signalisation de problèmes, incluez :
- La version de Sidian
- Le système d'exploitation
- Les messages d'erreur
- Les étapes pour reproduire le problème
- La liste des extensions
- Les spécifications du système
La plupart des problèmes peuvent être résolus en suivant ces étapes de dépannage. Si les problèmes persistent, n'hésitez pas à contacter la communauté ou l'équipe de support.