Устранение неполадок

Решите проблемы, с которыми люди чаще всего сталкиваются при использовании Meshy DCC Core.

Частые проблемы

В следующей таблице перечислены частые проблемы и способы их устранения.

Проблема	Решение
`meshy-dcc: command not found`	Откройте новый терминал. Если ошибка сохраняется, добавьте `~/.local/bin` в `PATH`.
Моё приложение не появляется в разделе Connected now	Проверьте, что коннектор установлен. Для Unity, Godot, Unreal Engine и других приложений с привязкой к проекту проверьте, что он установлен в этом проекте. Затем перезапустите приложение. Оно появится в течение нескольких секунд после запуска.
При установке Blender запрашивается расположение Blender	Blender не находится в обычном месте, либо имеется больше одной копии. Введите полный путь к используемому приложению Blender.
Установка Unity завершается ошибкой	Установите версию Unity Editor, указанную в `ProjectSettings/ProjectVersion.txt` проекта, закройте проект и попробуйте снова.
Установка Unreal Engine завершается ошибкой при сборке	Установите Xcode на macOS или Visual Studio 2022 с компонентом Game development with C++ на Windows. На macOS версия Xcode должна поддерживаться вашим движком.
Мой агент не знает о Meshy DCC	В окне перейдите в Agents, включите своего агента и начните новый чат.
В окне сообщается, что служба недоступна	Запустите `meshy-dcc ui` ещё раз. Служба останавливается сама, если ни одно приложение не было открыто в течение некоторого времени.
Агент спрашивает, какое приложение или проект использовать	Запросу соответствует более одного открытого приложения. Укажите приложение, сцену или проект.
Windows предупреждает о неизвестном приложении	Файлы для Windows не подписаны. Выбирайте More info > Run anyway только если вы установили их с `cdn.meshy.ai`.
Windows блокирует приложение и не предлагает способа его запустить	Smart App Control блокирует неподписанные приложения и не может сделать для них исключение. Используйте Meshy DCC Core на ПК, где Smart App Control отключён.

Проверьте настройку

Чтобы проверить настройку, выполните:

meshy-dcc doctor

Команда проверяет установленные файлы, локальную службу и зарегистрированные приложения. Она ничего не изменяет.

Сообщить о проблеме

Чтобы сообщить о проблеме, выполните следующие шаги:

В окне перейдите в Settings > Report a problem.
Опишите, что вы просили сделать своего агента и что произошло, затем нажмите Preview. В окне отображается точный текст отчёта. Он включает ваше описание, версии и операционную систему, диагностическую сводку без путей и идентификаторов, а также последние отчёты об ошибках вашего агента.
Нажмите Send. Meshy DCC Core ничего не отправляет, пока вы не нажмёте Send. Meshy превращает отчёт в публичный issue в репозитории meshy-dcc-core на GitHub, поэтому не включайте в описание личные данные.

Из терминала выполните meshy-dcc report --summary "what happened", чтобы увидеть такой же предварительный просмотр, и добавьте --yes, чтобы отправить его. Ваш агент может сделать то же самое. Он спросит вас перед отправкой чего-либо.

Чтобы сообщить о проблеме без формы, создайте issue в репозитории или напишите на support@meshy.ai. Вставьте вывод команды meshy-dcc doctor, удалив всё личное, например названия папок. Чтобы увидеть недавние сбои, медленные запросы и журналы проблем на вашем компьютере, нажмите Open the Debug Workbench в разделе Report a problem.

Удаление Meshy DCC Core

Вы можете попросить своего агента удалить Meshy DCC Core. Чтобы сделать это самостоятельно, выполните следующие шаги:

Удалите установленные вами коннекторы. См. Удаление коннектора.
Удалите навык (skill) у своих агентов:
```
meshy-dcc agent-skill --remove --execute
```
Удалите meshy-dcc и meshy-dcc-server из ~/.local/bin. Если вы устанавливали через npm, вместо этого выполните npm uninstall -g meshy-dcc.
Необязательно: удалите папку ~/.meshy-dcc. В ней хранятся ваши настройки и пользовательские навыки, поэтому сохраните копию тех навыков, которые хотите оставить.