Dépannage

Corrigez les problèmes les plus courants rencontrés avec Meshy DCC Core.

Problèmes courants

Le tableau suivant répertorie les problèmes courants et la façon de les résoudre.

Problème	Solution
`meshy-dcc: command not found`	Ouvrez un nouveau terminal. Si le problème persiste, ajoutez `~/.local/bin` à votre `PATH`.
Mon application n'apparaît pas sous Connected now	Vérifiez que son connecteur est installé. Pour Unity, Godot, Unreal Engine et les autres applications par projet, vérifiez qu'il est installé dans ce projet. Redémarrez ensuite l'application. Elle apparaît quelques secondes après son démarrage.
L'installation de Blender demande où se trouve Blender	Blender ne se trouve pas à son emplacement habituel, ou il en existe plusieurs copies. Entrez le chemin complet de l'application Blender que vous utilisez.
L'installation de Unity échoue	Installez la version de l'éditeur Unity indiquée dans le fichier `ProjectSettings/ProjectVersion.txt` du projet, fermez le projet, puis réessayez.
L'installation de Unreal Engine échoue pendant la compilation	Installez Xcode sur macOS, ou Visual Studio 2022 avec Game development with C++ sur Windows. Sur macOS, la version de Xcode doit être une version acceptée par votre moteur.
Mon agent ne connaît pas Meshy DCC	Dans la fenêtre, allez dans Agents, activez votre agent, puis démarrez une nouvelle conversation.
La fenêtre indique qu'elle ne peut pas joindre le service	Exécutez à nouveau `meshy-dcc ui`. Le service s'arrête automatiquement lorsqu'aucune application n'a été ouverte pendant un certain temps.
L'agent demande quelle application ou quel projet utiliser	Plusieurs applications ouvertes correspondent à la demande. Précisez le nom de l'application, de la scène ou du projet.
Windows avertit à propos d'une application inconnue	Les fichiers Windows ne sont pas signés. Choisissez More info > Run anyway uniquement si vous avez effectué l'installation depuis `cdn.meshy.ai`.
Windows bloque l'application et ne propose aucun moyen de l'exécuter	Smart App Control bloque les applications non signées et ne peut pas faire d'exception pour l'une d'entre elles. Utilisez Meshy DCC Core sur un PC où Smart App Control est désactivé.

Vérifier votre configuration

Pour vérifier votre configuration, exécutez :

meshy-dcc doctor

La commande vérifie les fichiers installés, le service local et les applications enregistrées. Elle ne modifie rien.

Signaler un problème

Pour signaler un problème, suivez ces étapes :

Dans la fenêtre, allez dans Settings > Report a problem.
Décrivez ce que vous avez demandé à votre agent de faire et ce qui s'est passé, puis cliquez sur Preview. La fenêtre affiche le rapport exact. Il contient votre description, les versions ainsi que votre système d'exploitation, un résumé de diagnostic sans chemins ni identifiants, et les rapports d'erreur récents de votre agent.
Cliquez sur Send. Meshy DCC Core n'envoie rien tant que vous n'avez pas cliqué sur Send. Meshy transforme le rapport en un ticket public dans le dépôt meshy-dcc-core sur GitHub, donc n'incluez aucune information privée dans votre description.

Depuis un terminal, exécutez meshy-dcc report --summary "what happened" pour voir le même aperçu, et ajoutez --yes pour l'envoyer. Votre agent peut faire de même. Il vous demande confirmation avant d'envoyer quoi que ce soit.

Pour signaler un problème sans passer par le formulaire, ouvrez un ticket dans le dépôt ou envoyez un e-mail à support@meshy.ai. Collez la sortie de meshy-dcc doctor, après avoir supprimé toute information privée, telle que les noms de dossiers. Pour voir les échecs récents, les requêtes lentes et les journaux de problèmes sur votre ordinateur, cliquez sur Open the Debug Workbench dans Report a problem.

Désinstaller Meshy DCC Core

Vous pouvez demander à votre agent de désinstaller Meshy DCC Core. Pour le faire vous-même, suivez ces étapes :

Supprimez les connecteurs que vous avez installés. Consultez Désinstaller un connecteur.
Supprimez la compétence (skill) de vos agents :
```
meshy-dcc agent-skill --remove --execute
```
Supprimez meshy-dcc et meshy-dcc-server de ~/.local/bin. Si vous avez effectué l'installation avec npm, exécutez plutôt npm uninstall -g meshy-dcc.
Facultatif : supprimez le dossier ~/.meshy-dcc. Il contient vos paramètres et vos compétences personnalisées, donc conservez une copie des compétences que vous souhaitez garder.