문제 해결
사람들이 Meshy DCC Core에서 가장 자주 겪는 문제를 해결합니다.
일반적인 문제
다음 표는 일반적인 문제와 그 해결 방법을 나열한 것입니다.
| 문제 | 해결 방법 |
|---|---|
meshy-dcc: command not found | 새 터미널을 엽니다. 그래도 실패하면 ~/.local/bin을 PATH에 추가하세요. |
| 내 앱이 Connected now 아래에 나타나지 않습니다 | 해당 앱의 커넥터가 설치되어 있는지 확인하세요. Unity, Godot, Unreal Engine 등 프로젝트별 앱의 경우, 해당 프로젝트에 설치되어 있는지 확인하세요. 그런 다음 앱을 다시 시작하세요. 시작 후 몇 초 안에 나타납니다. |
| Blender 설치 시 Blender가 어디에 있는지 묻습니다 | Blender가 일반적인 위치에 없거나, 복사본이 여러 개 있는 경우입니다. 사용 중인 Blender 앱의 전체 경로를 입력하세요. |
| Unity 설치가 실패합니다 | 프로젝트의 ProjectSettings/ProjectVersion.txt에 명시된 Unity Editor 버전을 설치하고, 프로젝트를 닫은 후 다시 시도하세요. |
| 빌드 중 Unreal Engine 설치가 실패합니다 | macOS에서는 Xcode를, Windows에서는 Game development with C++ 가 포함된 Visual Studio 2022를 설치하세요. macOS에서는 Xcode 버전이 사용 중인 엔진이 허용하는 버전이어야 합니다. |
| 내 에이전트가 Meshy DCC를 인식하지 못합니다 | 창에서 Agents로 이동하여 에이전트를 켜고 새 채팅을 시작하세요. |
| 창에 서비스에 연결할 수 없다는 메시지가 표시됩니다 | meshy-dcc ui를 다시 실행하세요. 일정 시간 동안 열려 있는 앱이 없으면 서비스가 자동으로 중지됩니다. |
| 에이전트가 어떤 앱이나 프로젝트를 사용할지 묻습니다 | 요청에 맞는 열려 있는 앱이 두 개 이상입니다. 앱, 씬, 또는 프로젝트의 이름을 지정하세요. |
| Windows가 알 수 없는 앱이라고 경고합니다 | Windows 파일이 서명되지 않았습니다. cdn.meshy.ai에서 설치한 경우에만 More info > Run anyway를 선택하세요. |
| Windows가 앱을 차단하고 실행할 방법을 제공하지 않습니다 | Smart App Control이 서명되지 않은 앱을 차단하며 예외를 둘 수 없습니다. Smart App Control이 꺼져 있는 PC에서 Meshy DCC Core를 사용하세요. |
설정 확인하기
설정을 확인하려면 다음을 실행하세요:
meshy-dcc doctor
이 명령은 설치된 파일, 로컬 서비스, 등록된 앱을 확인합니다. 아무것도 변경하지 않습니다.
문제 리포트하기
문제를 리포트하려면 다음 단계를 따르세요:
- 창에서 Settings > Report a problem으로 이동합니다.
- 에이전트에게 요청한 작업과 발생한 상황을 설명한 다음 Preview를 클릭합니다. 창에 정확한 리포트가 표시됩니다. 여기에는 사용자의 설명, 버전 및 운영 체제, 경로나 ID가 없는 진단 요약, 그리고 에이전트의 최근 오류 리포트가 포함됩니다.
- Send를 클릭합니다. Meshy DCC Core는 Send를 클릭하기 전까지는 아무것도 전송하지 않습니다. Meshy는 리포트를 GitHub의 meshy-dcc-core 저장소에 공개 이슈로 등록하므로, 설명에 비공개 정보를 포함하지 마세요.
터미널에서 meshy-dcc report --summary "what happened"을 실행하면 동일한 미리보기를 볼 수 있으며, --yes를 추가하면 전송됩니다. 에이전트도 동일한 작업을 수행할 수 있습니다. 전송하기 전에 항상 사용자에게 확인을 요청합니다.
양식 없이 리포트하려면 저장소에 이슈를 열거나 support@meshy.ai로 이메일을 보내세요. 폴더 이름 등 비공개 정보를 제거한 후 meshy-dcc doctor의 출력을 붙여넣으세요. 컴퓨터에서 최근 실패, 느린 요청, 문제 로그를 확인하려면 Report a problem에서 Open the Debug Workbench를 클릭하세요.
Meshy DCC Core 제거하기
에이전트에게 Meshy DCC Core 제거를 요청할 수 있습니다. 직접 제거하려면 다음 단계를 따르세요:
-
설치한 커넥터를 제거합니다. 커넥터 제거하기를 참고하세요.
-
에이전트에서 스킬을 제거합니다:
meshy-dcc agent-skill --remove --execute -
~/.local/bin에서meshy-dcc와meshy-dcc-server를 삭제합니다. npm으로 설치한 경우, 대신npm uninstall -g meshy-dcc를 실행하세요. -
선택 사항:
~/.meshy-dcc폴더를 삭제합니다. 여기에는 설정과 사용자 지정 스킬이 들어 있으므로, 보관하고 싶은 스킬은 사본을 남겨두세요.