Khắc phục sự cố

Khắc phục những sự cố mà người dùng thường gặp phải nhất với Meshy DCC Core.

Vấn đề thường gặp

Bảng dưới đây liệt kê các vấn đề thường gặp và cách khắc phục.

Vấn đề	Cách khắc phục
`meshy-dcc: command not found`	Mở một terminal mới. Nếu vẫn thất bại, thêm `~/.local/bin` vào `PATH` của bạn.
Ứng dụng của tôi không xuất hiện trong mục Connected now	Kiểm tra xem connector của nó đã được cài đặt chưa. Đối với Unity, Godot, Unreal Engine, và các ứng dụng theo từng dự án khác, kiểm tra xem nó đã được cài đặt trong dự án này chưa. Sau đó khởi động lại ứng dụng. Nó sẽ xuất hiện trong vài giây sau khi khởi động.
Khi cài đặt Blender, hệ thống hỏi Blender ở đâu	Blender không ở vị trí thông thường của nó, hoặc có nhiều hơn một bản sao. Nhập đường dẫn đầy đủ của ứng dụng Blender bạn đang dùng.
Cài đặt Unity thất bại	Cài đặt phiên bản Unity Editor mà tệp `ProjectSettings/ProjectVersion.txt` của dự án chỉ định, đóng dự án, và thử lại.
Cài đặt Unreal Engine thất bại trong khi build	Cài đặt Xcode trên macOS, hoặc Visual Studio 2022 với Game development with C++ trên Windows. Trên macOS, phiên bản Xcode phải là phiên bản mà engine của bạn chấp nhận.
Agent của tôi không biết đến Meshy DCC	Trong cửa sổ, vào Agents, bật agent của bạn, và bắt đầu một cuộc trò chuyện mới.
Cửa sổ báo rằng không thể kết nối tới dịch vụ	Chạy lại `meshy-dcc ui`. Dịch vụ sẽ tự dừng khi không có ứng dụng nào được mở trong một khoảng thời gian.
Agent hỏi nên dùng ứng dụng hoặc dự án nào	Có nhiều hơn một ứng dụng đang mở phù hợp với yêu cầu. Hãy nêu tên ứng dụng, cảnh, hoặc dự án.
Windows cảnh báo về một ứng dụng không xác định	Các tệp Windows không được ký số. Chỉ chọn More info > Run anyway nếu bạn đã cài đặt từ `cdn.meshy.ai`.
Windows chặn ứng dụng và không cho cách nào để chạy	Smart App Control chặn các ứng dụng không được ký số và không thể tạo ngoại lệ cho một ứng dụng cụ thể. Hãy sử dụng Meshy DCC Core trên một PC đã tắt Smart App Control.

Kiểm tra thiết lập của bạn

Để kiểm tra thiết lập của bạn, chạy:

meshy-dcc doctor

Lệnh này kiểm tra các tệp đã cài đặt, dịch vụ cục bộ, và các ứng dụng đã đăng ký. Nó không thay đổi bất cứ điều gì.

Báo cáo sự cố

Để báo cáo sự cố, hãy làm theo các bước sau:

Trong cửa sổ, vào Settings > Report a problem.
Mô tả những gì bạn đã yêu cầu agent của bạn làm và điều gì đã xảy ra, sau đó nhấp Preview. Cửa sổ sẽ hiển thị chính xác báo cáo. Nó chứa mô tả của bạn, các phiên bản và hệ điều hành của bạn, một bản tóm tắt chẩn đoán không có đường dẫn hay ID, và các báo cáo lỗi gần đây của agent của bạn.
Nhấp Send. Meshy DCC Core sẽ không gửi bất cứ điều gì cho đến khi bạn nhấp Send. Meshy sẽ biến báo cáo thành một issue công khai trong kho lưu trữ meshy-dcc-core trên GitHub, vì vậy hãy để các chi tiết riêng tư ngoài mô tả của bạn.

Từ terminal, chạy meshy-dcc report --summary "what happened" để xem cùng một bản xem trước, và thêm --yes để gửi nó. Agent của bạn cũng có thể làm điều tương tự. Nó sẽ hỏi bạn trước khi gửi bất cứ điều gì.

Để báo cáo mà không dùng biểu mẫu, hãy mở một issue trong kho lưu trữ hoặc gửi email tới support@meshy.ai. Dán kết quả đầu ra của meshy-dcc doctor, sau khi đã loại bỏ mọi thông tin riêng tư, chẳng hạn như tên thư mục. Để xem các lỗi gần đây, các yêu cầu chậm, và nhật ký sự cố trên máy tính của bạn, nhấp Open the Debug Workbench trong Report a problem.

Gỡ cài đặt Meshy DCC Core

Bạn có thể yêu cầu agent của bạn gỡ cài đặt Meshy DCC Core. Để tự làm điều đó, hãy làm theo các bước sau:

Gỡ bỏ các connector bạn đã cài đặt. Xem Gỡ cài đặt một connector.
Gỡ bỏ skill khỏi các agent của bạn:
```
meshy-dcc agent-skill --remove --execute
```
Xóa meshy-dcc và meshy-dcc-server khỏi ~/.local/bin. Nếu bạn đã cài đặt bằng npm, hãy chạy npm uninstall -g meshy-dcc thay vào đó.
Tùy chọn: xóa thư mục ~/.meshy-dcc. Thư mục này chứa các thiết lập và các skill tùy chỉnh của bạn, vì vậy hãy giữ lại một bản sao của bất kỳ skill nào bạn muốn giữ.