Dépannage
Reproduisez sur une note jetable avec le même fournisseur, modèle et réglages. Consultez progression et chemin annoncé. Distinguez authentification, génération, parsing et écriture : une connexion réussie ne valide pas tout le workflow.
Vue d’ensemble
Notez versions Notemd/Obsidian, OS, action, protocole, modèle et reproduction minimale. Attendez la stabilisation de l’annulation avant une autre tâche. Conservez sorties et récupération jusqu’à identification de leur opération d’origine.
Diagnostics
Connexion
Tester la connexion peut tester seulement la liste ou un petit dialogue selon le profil. Une vraie petite tâche vérifie le modèle et le format de sortie.
Progression et diagnostics développeur
La progression indique états, erreurs et destinations. L’activité API distingue attente, réussite et échec. Activez le débogage API seulement au besoin ; les diagnostics de requêtes longues consomment potentiellement le quota.
Corps de diagnostic, réponses partielles, adresses et identifiants peuvent révéler des données privées. Relisez et expurgez localement. Même un profil expurgé exige un contrôle des métadonnées.
Erreurs fréquentes
Clé absente ou invalide
401 : clé correspondant au fournisseur/adresse, sans espaces involontaires. 403 : permissions du compte/projet, accès au modèle et facturation. Les tentatives répétées ne réparent pas une clé invalide.
Connexion réseau
Vérifiez hôte, port, protocole et route depuis l’appareil Obsidian. Pour Ollama/LM Studio, serveur actif et modèle disponible. localhost vise cet appareil. Choisissez le bon profil ; les replis de transport sont automatiques, sans interrupteur utilisateur.
Quota 429
Réduisez concurrence, contrôlez quotas requêtes/tokens et autres clients de la clé. Les retries peuvent absorber des incidents transitoires, pas garantir tous les appels.
Modèle absent
Utilisez Fetch models ou un déploiement connu du compte. Vérifiez région et version API ; un défaut historique peut être retiré en amont. Azure attend un nom de déploiement ; Ark peut demander son endpoint ID.
Aucun lien ou concept
Ouvrez la sortie réelle, contrôlez source utile, format renvoyé et dossier de concepts non vide activé. L’extraction autonome produit des titres sans backlink par défaut. Revenez au prompt intégré si un remplacement a supprimé les marqueurs.
Sortie absente ou déplacée
Consultez le chemin annoncé : _processed.md pour les liens, _<language>.md pour la traduction, dossier complete pour les titres. Si la création du dossier de traduction échoue, le dossier source peut servir de repli. Vérifiez collisions et permissions.
Fichiers après annulation
Les écritures terminées restent et les opérations déjà acceptées peuvent finir. Inspectez résultats par fichier et conflits de récupération avant suppression ou relance globale.
Diagramme ou export natif en échec
Les types sont générés successivement. Un échec ne bloque pas les autres ; l’annulation arrête les types en attente et conserve les fichiers terminés. Relancez les exports depuis l’aperçu ou l’historique sans nouvelle requête au modèle. Un échec de génération nécessite de régénérer ce type. Les enregistrements v1/v2 restent lisibles.
Le HTML du diagramme contient un graphique avec zoom ; le HTML de synthèse structurée contient texte, structure et références. HTML/SVG éditable désigne un moteur de rendu, pas un éditeur web. Utilisez la source native pour modifier le diagramme. Les présentations, dont PPTX et MP4, gardent leurs réglages et dépendances distincts. Manuel des diagrammes.
Signaler un problème
- Reproduisez avec une note synthétique et un dossier dédié.
- Notez versions exactes, action, modèle, réglages, résultat attendu et observé.
- Joignez le minimum de progression, erreurs et artefacts expurgés ; retirez secrets, contenu privé et métadonnées inutiles.
- Précisez si une note et les prompts par défaut reproduisent le problème.
- Ouvrez GitHub Issues.
Une capture seule suffit rarement pour un défaut de format ou d’annulation. Ajoutez source/sortie ou séquence minimale lorsque possible.