Résolution de problèmes

💡TL;DR

La plupart des problèmes Notemd se répartissent en quatre catégories : les problèmes majeurs de API, la connectivité réseau, les erreurs d’authentification (401/403) et les limites de fréquence (429). Le test de connexion intégré ainsi que le panneau de diagnostic permettent d’identifier rapidement la cause racine. Cette page couvre chaque message d’erreur courant, sa cause et la solution correspondante. Pour les problèmes non listés ici, signalez-les sur GitHub Issues en joignant les résultats des diagnostics.

Ceci fait partie du Obsidian Guide de gestion des connaissances IA.

Aperçu général

Notemd dépend de services externes -- des fournisseurs LLM et des moteurs de recherche API -- donc la plupart des problèmes proviennent en dehors du plugin lui-même. Le panneau de diagnostic dans les paramètres offre une vue structurée de la dernière appel API, y compris la requête URL, l’état de réponse et le corps de l’erreur. Vérifiez-le toujours en premier avant d’enquêter davantage.

Comment ça marche : Diagnostic

Test de connexion

Chaque section de configuration du fournisseur dispose d’un bouton « Tester la connexion ». En le cliquant, une requête minimale API est envoyée (généralement une liste de modèles ou une complétion courte) et un rapport indique si l’opération a réussi ou si une erreur spécifique HTTP est survenue. C’est le moyen le plus rapide de vérifier que votre clé API ainsi que la base URL sont correctes.

Panneau de diagnostic

Paramètres --> Notemd --> Diagnostic affiche :

Champ	Contenu
Dernier fournisseur	Quel fournisseur a été appelé en dernier
Dernier modèle	Quel modèle a été appelé en dernier
Dernier état	Code d'état HTTP ou erreur de transport
Dernière erreur	Message d’erreur brut provenant de API
Dernière demande URL	Total URL de la dernière demande (clé API supprimée)
Dernier corps de réponse	Corps de réponse tronqué (premiers 500 caractères)

Copiez la sortie complète des diagnostics lors de la signalement de problèmes sur GitHub.

Erreurs courantes

API Clé invalide ou manquante

Symptôme : HTTP 401 ou « Clé API incorrecte fournie »

Cause : La clé API est manquante, contient des espaces blancs, ou appartient à un fournisseur différent.

Correction :

1. Vérifier que la clé ne contient pas d’espaces en début ou en fin.
2. Veuillez confirmer que la clé correspond au fournisseur sélectionné (une clé OpenAI ne fonctionnera pas avec Anthropic).
3. Vérifiez que votre compte dispose de crédits ou d’une abonnement activé
4. Cliquez sur "Test Connection" pour vérifier

Erreurs de réseau / de connexion

Symptôme : ERR_CONNECTION_REFUSED, ERR_TIMED_OUT, Socket hang up, Network request failed

Cause : L’endpoint API n’est pas accessible depuis votre machine.

Correction :

1. Vérifiez votre connexion Internet.
2. Si vous êtes derrière un proxy ou un pare-feu, vérifiez que le domaine API n’est pas bloqué
3. Pour Ollama : confirmer que ollama serve est en cours d’exécution (ollama list doit retourner les modèles)
4. Pour LMStudio : confirmer que le serveur est en cours d’exécution sur localhost:1234
5. Essayez un transport différent – les utilisateurs mobiles doivent s’assurer que le transport requestUrl est actif
6. Activer enableStableApiCall pour une tentative automatique en cas d’erreurs temporaires

403 Interdit

Symptôme : HTTP 403

Cause : Votre clé API est valide, mais elle n’a pas les permissions nécessaires pour accéder au ressource demandée.

Correction :

1. Certains modèles nécessitent un accès spécial (par exemple, GPT-4 via Azure requiert un nom de déploiement).
2. Certains fournisseurs restreignent les modèles en fonction du niveau de plan – vérifiez votre compte
3. Des restrictions régionales peuvent s’appliquer (certains fournisseurs en Chine bloquent les adresses IP internationales et inversement).
4. Vérifiez que le nom du modèle est orthographié correctement (par exemple, gpt-4o et non gpt-4o-mini lorsque le mini-modèle correspond à tout ce que votre forfait autorise).

Limite de débit (429)

Symptôme : HTTP 429 ou « Limite de vitesse dépassée »

Cause : Trop de requêtes dans une courte période de temps.

Correction :

1. Réduire batchConcurrency en 1 ou 2
2. Attendez quelques minutes avant de réessayer.
3. Vérifiez la documentation sur les limites de débit de votre fournisseur pour votre niveau de forfait
4. Activer enableStableApiCall pour une tentative automatique avec retards progressifs
5. Envisagez de passer à un fournisseur offrant des limites plus élevées (DeepSeek, Ollama).

Modèle non trouvé

Symptôme : « Modèle non trouvé » ou HTTP 404

Cause : Le nom du modèle n’existe pas chez le fournisseur sélectionné.

Correction :

1. Cliquez sur "Obtenir la liste des modèles" pour voir tous les modèles disponibles pour votre fournisseur
2. Certains noms de modèles changent avec le temps – vérifiez le nom actuel dans la documentation du fournisseur
3. Pour Ollama : exécutez ollama list pour voir les modèles téléchargés ; seuls les modèles téléchargés sont disponibles

Aucun lien / Aucun concept généré

Symptôme : La commande s’exécute mais ne produit aucun résultat

Cause : Le LLM a renvoyé une réponse vide ou indéchiffrable.

Correction :

1. Vérifiez le panneau de diagnostic pour obtenir la réponse réelle LLM
2. Essayez un modèle plus performant (certains petits modèles ont du mal avec les sorties structurées)
3. Assurez-vous que la note contient suffisamment de contenu (plus de 50 mots).
4. Vérifiez votre prompt personnalisé pour détecter d’éventuelles instructions contradictoires
5. Désactivez temporairement la suppression des synonymes pour voir si elle filtre de manière trop agressive

Doubao Identifiant de l’endpoint manquant

Symptôme : Erreur lors de l’utilisation du fournisseur ByteDance Doubao

Cause : Doubao nécessite un identifiant d’endpoint Ark (format : ep-xxxxxxxx-xxxx-xxxx) plutôt qu’un nom de modèle.

Correction : Remplacez le modèle de placeholder par défaut par votre véritable ID d’endpoint provenant de la console de Volcengine.

Configuration

Paramètres de diagnostic	Location	But
Tester la connexion	Paramètres --> Section Fournisseur	Vérifier la clé API et la connectivité
Obtenir la liste des modèles	Paramètres --> Section Fournisseur	Confirmer quels modèles sont accessibles
enableStableApiCall	Paramètres --> Avancé	Activer la tentative de réessai avec un délai d’attente
batchConcurrency	Paramètres --> Groupe	Contrôler le parallélisme pour éviter les limites de débit

Comment signaler des problèmes

Si votre problème n’est pas couvert ci-dessus :

1. Ouvrez Paramètres --> Notemd --> Diagnostic
2. Copiez la sortie complète des diagnostics
3. Ouvrez un problème GitHub à github.com/Jacobinwwey/obsidian-NotEMD/issues
4. Inclure : version Obsidian, version Notemd, fournisseur, modèle, sortie des diagnostics, et étapes pour reproduire le problème
5. Rédigez votre clé API à partir de tout journal partagé

---

Prochaines étapes

• LLM Fournisseurs -- Référence complète de la configuration des fournisseurs
• Traitement par lots -- Paramètres de concurrence et de réessai pour les opérations volumineuses
• Custom Prompts -- Corriger le comportement inattendu de LLM en ajustant les prompts