Dépannage

L'application ne s'installe pas ou ne s'ouvre pas

Windows

Si SmartScreen bloque le programme d'installation, choisissez Plus d'informations → Exécuter quand même. La version de bureau est signée par code, donc cela n'apparaît normalement pas.

Si l'application s'installe mais ne se lance pas, essayez d'installer à partir du Microsoft Store au lieu du programme d'installation direct : la version du Store gère ses propres dépendances.

macOS

Si macOS refuse d'ouvrir l'application, ouvrez Paramètres système → Confidentialité et sécurité et autorisez-la ici, puis relancez-la.

Assurez-vous d'avoir fait glisser 9xchat dans Applications plutôt que de l'exécuter à partir de l'image disque montée.

Linux

Vérifiez que le fichier téléchargé est marqué comme exécutable. Si ce n'est pas le cas, définissez le bit exécutable dessus et exécutez-le à nouveau.

Mobile

Installez via Google Play ou App Store pour que les mises à jour arrivent automatiquement. Si l'application ne démarre pas, mettez-la à jour, puis redémarrez votre appareil.

Les réponses échouent ou s’arrêtent à mi-chemin

Parcourez-les dans l’ordre :

1. Vérifiez votre connexion. Les modèles cloud nécessitent un accès à Internet. Les modèles locaux le font non : si les requêtes cloud échouent mais que les requêtes locales fonctionnent, le problème vient du réseau ou du fournisseur, et non de 9xchat.

2. Vérifiez votre solde créditeur. Si vous utilisez des crédits 9xchat et qu'ils ont s'épuiser, les demandes s'arrêtent. Rechargez ou passez à votre propre clé API.

3. Vérifiez votre clé API. Si vous avez apporté votre propre clé, confirmez qu'elle est toujours valide et il reste un quota chez ce fournisseur.

4. Essayez un autre modèle. Si un modèle échoue et qu'un autre réussit, le problème est avec ce modèle ou ce fournisseur spécifique.

Un modèle est manquant ou ne se chargera pas

• Les modèles cloud nécessitent des crédits ou une clé API configurée pour cela. fournisseur. Sous Bibliothèque → Modèles, un fournisseur reste marqué Inactif jusqu'à ce que vous ajoutiez sa clé. Cette étiquette est le moyen le plus rapide de voir vers quoi vous n'avez aucun itinéraire.

• Les modèles locaux doivent démarrer votre coureur local avant que 9xchat puisse les atteindre. Démarrez-le d’abord, puis rouvrez la liste des modèles.

Votre clé API est rejetée

La panne est chez le fournisseur, donc le correctif est là aussi :

1. Collez à nouveau la clé, sans espaces de début ou de fin.
2. Confirmez que la clé appartient au fournisseur sous lequel vous l'avez ajoutée.
3. Vérifiez que la clé existe toujours et qu’elle n’a pas été révoquée ou pivotée.
4. Vérifiez que la facturation est configurée et que le quota restant auprès de ce fournisseur est un une clé valide sans solde échoue de la même manière qu’une mauvaise.
5. Confirmez que le modèle que vous avez choisi est celui que votre compte est autorisé à utiliser. Certains les modèles nécessitent un niveau distinct avec le fournisseur.

Les clés sont stockées cryptées sur votre machine. Si une clé ne fonctionne plus partout, remplacez-la chez le fournisseur plutôt que de réinstaller 9xchat.

Un modèle local ne se connectera pas

1. Démarrez votre coureur local et confirmez qu'il répond en dehors de 9xchat.
2. Confirmez qu'il écoute sur l'adresse et le port attendus par 9xchat.
3. Confirmez que le modèle lui-même est tiré et chargé, et pas seulement le coureur en marche.
4. Rouvrez Bibliothèque → Modèles pour que la liste soit actualisée.

Les modèles locaux n’ont besoin ni de clé ni de crédits. Si un modèle local fonctionne et pas un modèle cloud, le problème vient de votre clé, de votre solde ou du réseau.

Un outil ou un serveur MCP ne fonctionne pas

1. Vérifiez que l'outil est activé. Chaque outil dispose d'un commutateur Activé sous Bibliothèque → Outils.

2. Vérifiez le plan. Les outils agents et la recherche Web en direct nécessitent Pro — voir Crédits, Pro et utilisation.

3. Lisez la ligne de sécurité. Elle indique les autorisations dont l'outil a besoin. Un outil qui ne peut pas atteindre ce dont il a besoin échoue plutôt que de demander.

4. Pour les serveurs MCP, confirmez que les secrets requis ont été fournis : une entrée toujours marqué Configuration requise n'a pas été configuré. L'aperçu de la configuration montre la commande exacte qu'il exécute, ce qui mérite d'être relu si le serveur ne démarre jamais.

5. Isolez-le. Désactivez l'outil, posez la même question et voyez si le changements de comportement. Cela vous indique si l'outil est impliqué ou non.

La recherche de connaissances ne trouve rien

Une collection doit être indexée avant de pouvoir être recherchée.

• Confirmez que les fichiers ont été ajoutés à une collection, et pas seulement attachés à une discussion.
• Vérifiez que l'outil Search Knowledge est activé.
• Si votre fournisseur d'intégrations était inaccessible lorsque vous avez ajouté les fichiers, la recherche revient à la correspondance de mots clés et manquera tout ce qui nécessitait l'index. Ajoutez à nouveau les fichiers une fois que le fournisseur est joignable.

Voir Connaissances et souvenirs.

Une pièce jointe ne sera pas traitée

• Confirmez que le modèle que vous avez sélectionné accepte ce type de fichier. Un modèle texte uniquement ne peut pas lire une image et la liste des modèles marque les marques qui gèrent la vision.
• Les fichiers très volumineux peuvent dépasser le contexte d'un modèle. Essayez un extrait plus petit ou un modèle avec une fenêtre contextuelle plus grande.
• Si le fichier s'ouvre correctement ailleurs mais échoue ici, essayez de le convertir en format commun en premier.

La génération d'images échoue

• La génération d'images nécessite Pro.
• Confirmez que vous avez sélectionné un modèle d'image : il est choisi séparément de votre modèle de discussion.
• Vérifiez votre solde créditeur si vous générez via des crédits 9xchat.
• Certaines invites sont refusées par le fournisseur plutôt que par 9xchat ; la reformulation est généralement plus rapide que de réessayer.

La dictée ou la lecture à haute voix échoue

Les deux ont besoin d’un fournisseur audio fonctionnel et aucun n’a d’option locale.

• Confirmez que votre Fournisseur de transcriptionest défini sousParamètres → Par défaut. Modèles.
• Accordez l'autorisation du microphone 9xchat dans la confidentialité de votre système d'exploitation paramètres — sur macOS, Paramètres système → Confidentialité et sécurité → Microphone.
• Les deux ont besoin d’une connexion même lorsque votre modèle de discussion est local.

L'entrée du microphone nécessite Pro ; lire à haute voix ne le fait pas.

Les crédits s'épuisent plus vite que prévu

Chaque message affiche son propre coût, sa latence et sa répartition des jetons, et la session affiche un total cumulé. Si un total semble erroné, ouvrez les chiffres par message pour voir quel échange en tient compte : un contexte long, des jetons de raisonnement et des pièces jointes volumineuses augmentent tous le coût d'un seul tour.

Vous pouvez limiter ce montant par conversation en réduisant le nombre maximal de jetons d'achèvement et la limite de contexte dans les paramètres du modèle, et Context Shield réduit la quantité d'historique renvoyé avec chaque message.

Pour arrêter complètement de dépenser des crédits, ajoutez votre propre clé API ou utilisez un modèle local.

Une fonctionnalité est grisée ou manquante

Plusieurs fonctionnalités nécessitent Pro : plusieurs onglets, la fenêtre flottante, le mini chat, l'assistant rapide, les outils agents, la recherche Web en direct, le terrain de jeu d'images, l'entrée microphone et le système de mémoire. Credits, Pro et usage répertorie la répartition complète.

Si vous payez déjà, confirmez que cet appareil est connecté avec l'UID qui détient l'abonnement et que vous n'avez pas dépassé la limite d'appareils : un appareil gratuit, trois sur Pro. Suivez UID sur trois appareils pour connecter, changer ou supprimer un appareil.

Il manque quelque chose sur un autre appareil

Votre espace de travail est stocké localement sur chaque appareil, donc une deuxième machine connectée avec le même UID n'hérite pas de vos discussions, notes ou souvenirs. C’est une attente plutôt qu’une faute.

• Les mémoires sont par appareil. Une nouvelle installation démarre sans aucune.
• Handoff associe deux appareils pour une conversation ; ça ne copie pas le reste de votre espace de travail.
• Pour déplacer du matériel vous-même, utilisez Paramètres → Données et exportations.

Votre abonnement suit l'UID, donc un appareil qui vérifie avec celui-ci récupère Pro même si le contenu ne voyage pas.

Rien ici n'a aidé

Contactez support avec :

• votre système d'exploitation et la version 9xchat,
• le modèle et le fournisseur que vous utilisiez,
• que vous ayez des crédits, votre propre clé ou un modèle local,
• ce que vous avez fait et l'erreur visible exacte.