Risoluzione dei problemi

Risolvi i problemi in cui le persone si imbattono più spesso con Meshy DCC Core.

Problemi comuni

La tabella seguente elenca i problemi comuni e come risolverli.

Problema	Soluzione
`meshy-dcc: command not found`	Apri un nuovo terminale. Se continua a fallire, aggiungi `~/.local/bin` al tuo `PATH`.
La mia app non appare in Connected now	Controlla che il suo connettore sia installato. Per Unity, Godot, Unreal Engine e altre app per progetto, verifica che sia installato in questo progetto. Poi riavvia l'app. Appare entro pochi secondi dall'avvio.
L'installazione di Blender chiede dove si trova Blender	Blender non si trova nella posizione abituale, oppure ce n'è più di una copia. Inserisci il percorso completo dell'app Blender che usi.
L'installazione di Unity fallisce	Installa la versione di Unity Editor indicata nel file `ProjectSettings/ProjectVersion.txt` del progetto, chiudi il progetto e riprova.
L'installazione di Unreal Engine fallisce durante la compilazione	Installa Xcode su macOS, oppure Visual Studio 2022 con Game development with C++ su Windows. Su macOS, la versione di Xcode deve essere una di quelle accettate dal tuo engine.
Il mio agente non conosce Meshy DCC	Nella finestra, vai su Agents, attiva il tuo agente e avvia una nuova chat.
La finestra dice che non riesce a raggiungere il servizio	Esegui di nuovo `meshy-dcc ui`. Il servizio si ferma da solo quando nessuna app è stata aperta per un po' di tempo.
L'agente chiede quale app o progetto usare	Più di un'app aperta corrisponde alla richiesta. Indica il nome dell'app, della scena o del progetto.
Windows avvisa di un'app sconosciuta	I file di Windows non sono firmati. Scegli More info > Run anyway solo se hai effettuato l'installazione da `cdn.meshy.ai`.
Windows blocca l'app e non offre modo di eseguirla	Smart App Control blocca le app non firmate e non può fare un'eccezione per una di esse. Usa Meshy DCC Core su un PC dove Smart App Control è disattivato.

Controlla la tua configurazione

Per controllare la tua configurazione, esegui:

meshy-dcc doctor

Il comando controlla i file installati, il servizio locale e le app che si sono registrate. Non modifica nulla.

Segnala un problema

Per segnalare un problema, segui questi passaggi:

Nella finestra, vai su Settings > Report a problem.
Descrivi cosa hai chiesto al tuo agente di fare e cosa è successo, poi clicca su Preview. La finestra mostra il report esatto. Contiene la tua descrizione, le versioni e il tuo sistema operativo, un riepilogo diagnostico senza percorsi o ID, e i recenti report di errore del tuo agente.
Clicca su Send. Meshy DCC Core non invia nulla finché non clicchi su Send. Meshy trasforma il report in un issue pubblico nel repository meshy-dcc-core su GitHub, quindi non includere dettagli privati nella tua descrizione.

Da un terminale, esegui meshy-dcc report --summary "what happened" per vedere la stessa anteprima, e aggiungi --yes per inviarla. Il tuo agente può fare lo stesso. Ti chiede conferma prima di inviare qualsiasi cosa.

Per segnalare senza il modulo, apri un issue nel repository oppure invia un'email a support@meshy.ai. Incolla l'output di meshy-dcc doctor, rimuovendo eventuali dati privati, come i nomi delle cartelle. Per vedere i fallimenti recenti, le richieste lente e i log dei problemi sul tuo computer, clicca su Open the Debug Workbench in Report a problem.

Disinstalla Meshy DCC Core

Puoi chiedere al tuo agente di disinstallare Meshy DCC Core. Per farlo tu stesso, segui questi passaggi:

Rimuovi i connettori che hai installato. Vedi Disinstallare un connettore.

Rimuovi la skill dai tuoi agenti:

meshy-dcc agent-skill --remove --execute

Elimina meshy-dcc e meshy-dcc-server da ~/.local/bin. Se hai effettuato l'installazione con npm, esegui invece npm uninstall -g meshy-dcc.
Facoltativo: elimina la cartella ~/.meshy-dcc. Contiene le tue impostazioni e le tue skill personalizzate, quindi conserva una copia di qualsiasi skill tu voglia mantenere.