疑難排解

解決使用 Meshy DCC Core 時最常遇到的問題。

常見問題

下表列出了常見問題及解決方法。

問題解決方法
meshy-dcc: command not found開啟一個新的終端機視窗。如果仍然報錯，把 ~/.local/bin 加入你的 PATH。
我的軟體沒有出現在 目前已連接 下檢查它的連接器是否已安裝。對於 Unity、Godot、Unreal Engine 等按專案安裝的軟體，檢查連接器是否裝在目前的專案中。然後重新啟動軟體，它會在啟動後幾秒內出現。
安裝 Blender 連接器時詢問 Blender 在哪裡Blender 不在常見位置，或者你裝了多個版本。輸入你要使用的那個 Blender 的完整路徑。
Unity 連接器安裝失敗安裝專案的 ProjectSettings/ProjectVersion.txt 中指定的 Unity Editor 版本，關閉專案後重試。
Unreal Engine 連接器在編譯時安裝失敗在 macOS 上安裝 Xcode，或在 Windows 上安裝帶 使用 C++ 的遊戲開發（Game development with C++）工作負載的 Visual Studio 2022。在 macOS 上，Xcode 版本必須是你的引擎支援的版本。
智能體不知道 Meshy DCC在視窗中進入 Agent 頁面，啟用你的智能體，然後新建一個對話。
視窗提示無法連接到服務再次執行 meshy-dcc ui。如果一段時間內沒有開啟任何軟體，本機服務會自動停止。
智能體問你要用哪個軟體或專案有多個已開啟的軟體都符合請求。請說明是哪個軟體、場景或專案。
Windows 提示這是未知應用程式Meshy DCC Core 的 Windows 檔案沒有簽署。只有在你是從 cdn.meshy.ai 安裝的情況下，才選擇 更多資訊 > 仍要執行（More info > Run anyway）。
Windows 封鎖了應用程式，且沒有提供執行的選項智慧應用程式控制（Smart App Control）會封鎖未簽署的應用程式，並且無法為單一應用程式設定例外。請在關閉了智慧應用程式控制的電腦上使用 Meshy DCC Core。

檢查你的環境

執行以下指令檢查你的環境：

meshy-dcc doctor

這個指令會檢查已安裝的檔案、本機服務和已註冊的軟體，不會做任何修改。

報告問題

按以下步驟報告問題：

  1. 在視窗中進入 設定 > 報告問題。
  2. 描述你讓智能體做了什麼、發生了什麼，然後點擊 預覽。視窗會顯示將要傳送的完整報告，內容包括你的描述、版本和作業系統、一份不含路徑和 ID 的診斷摘要，以及智能體最近的錯誤報告。
  3. 點擊 傳送。在你點擊 傳送 之前，Meshy DCC Core 不會傳送任何內容。Meshy 會把這份報告轉為 GitHub 上 meshy-dcc-core 儲存庫中的公開 issue，所以請不要在描述中寫入私人資訊。

也可以在終端機中執行 meshy-dcc report --summary "發生了什麼" 查看同樣的預覽，加上 --yes 即可傳送。智能體也可以這樣做，並會在傳送前先徵得你的同意。

如果不想使用表單，也可以在儲存庫中新建 issue，或寄電子郵件到 support@meshy.ai。請附上 meshy-dcc doctor 的輸出，並去掉其中的私人資訊，例如資料夾名稱。要查看你電腦上最近的失敗、緩慢請求和問題日誌，可以在 報告問題 中點擊 開啟除錯工作台。

解除安裝 Meshy DCC Core

你可以讓智能體幫你解除安裝 Meshy DCC Core。如果想自己解除安裝，請按以下步驟操作：

  1. 移除你安裝的連接器，詳見解除安裝連接器。

  2. 從你的智能體中移除技能：

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

  3. 刪除 ~/.local/bin 中的 meshy-dcc 和 meshy-dcc-server。如果你是用 npm 安裝的，請改為執行 npm uninstall -g meshy-dcc。

  4. 可選：刪除 ~/.meshy-dcc 資料夾。其中包含你的設定和自訂技能，請先備份需要保留的技能。