Resolução de problemas

Corrija os problemas mais frequentes com o Meshy DCC Core.

Problemas comuns

A tabela seguinte apresenta os problemas comuns e como resolvê-los.

Problema	Correção
`meshy-dcc: command not found`	Abra um novo terminal. Se continuar a falhar, adicione `~/.local/bin` ao seu `PATH`.
A minha aplicação não aparece em Connected now	Verifique se o conector está instalado. Para Unity, Godot, Unreal Engine e outras aplicações por projeto, verifique se está instalado neste projeto. Depois reinicie a aplicação. Aparece poucos segundos depois de iniciar.
A instalação do Blender pergunta onde está o Blender	O Blender não está no local habitual, ou existe mais do que uma cópia. Introduza o caminho completo da aplicação Blender que utiliza.
A instalação do Unity falha	Instale a versão do Unity Editor indicada no ficheiro `ProjectSettings/ProjectVersion.txt` do projeto, feche o projeto e tente novamente.
A instalação do Unreal Engine falha durante a compilação	Instale o Xcode no macOS, ou o Visual Studio 2022 com Game development with C++ no Windows. No macOS, a versão do Xcode tem de ser aceite pelo seu motor.
O meu agente não conhece o Meshy DCC	Na janela, aceda a Agents, ative o seu agente e inicie uma nova conversa.
A janela indica que não consegue aceder ao serviço	Execute novamente `meshy-dcc ui`. O serviço para automaticamente quando nenhuma aplicação esteve aberta durante algum tempo.
O agente pergunta qual a aplicação ou projeto a utilizar	Mais do que uma aplicação aberta corresponde ao pedido. Indique o nome da aplicação, cena ou projeto.
O Windows avisa sobre uma aplicação desconhecida	Os ficheiros do Windows não estão assinados. Escolha More info > Run anyway apenas se instalou a partir de `cdn.meshy.ai`.
O Windows bloqueia a aplicação e não oferece forma de a executar	O Smart App Control bloqueia aplicações não assinadas e não pode criar uma exceção para uma delas. Utilize o Meshy DCC Core num PC onde o Smart App Control esteja desativado.

Verifique a sua configuração

Para verificar a sua configuração, execute:

meshy-dcc doctor

O comando verifica os ficheiros instalados, o serviço local e as aplicações registadas. Não altera nada.

Reportar um problema

Para reportar um problema, siga estes passos:

Na janela, aceda a Settings > Report a problem.
Descreva o que pediu ao seu agente para fazer e o que aconteceu e, em seguida, clique em Preview. A janela mostra o relatório exato. Contém a sua descrição, as versões e o seu sistema operativo, um resumo de diagnóstico sem caminhos ou IDs, e os relatórios de erro recentes do seu agente.
Clique em Send. O Meshy DCC Core não envia nada até clicar em Send. O Meshy transforma o relatório num issue público no repositório meshy-dcc-core no GitHub, por isso não inclua dados privados na sua descrição.

A partir de um terminal, execute meshy-dcc report --summary "o que aconteceu" para ver a mesma pré-visualização, e adicione --yes para o enviar. O seu agente pode fazer o mesmo. Pergunta-lhe antes de enviar seja o que for.

Para reportar sem o formulário, abra um issue no repositório ou envie um email para support@meshy.ai. Cole o resultado de meshy-dcc doctor, removendo quaisquer dados privados, como nomes de pastas. Para ver falhas recentes, pedidos lentos e registos de problemas no seu computador, clique em Open the Debug Workbench em Report a problem.

Desinstalar o Meshy DCC Core

Pode pedir ao seu agente para desinstalar o Meshy DCC Core. Para o fazer você mesmo, siga estes passos:

Remova os conectores que instalou. Consulte Desinstalar um conector.

Remova a skill dos seus agentes:

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

Elimine meshy-dcc e meshy-dcc-server de ~/.local/bin. Se instalou com npm, execute antes npm uninstall -g meshy-dcc.
Opcional: elimine a pasta ~/.meshy-dcc. Contém as suas definições e as suas skills personalizadas, por isso mantenha uma cópia de quaisquer skills que deseje preservar.