トラブルシューティング

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 では Game development with C++ を含む Visual Studio 2022 をインストールしてください。macOS では、Xcode のバージョンがお使いのエンジンが対応しているものである必要があります。
自分のエージェントが Meshy DCC を認識しない	ウィンドウでエージェントに移動し、エージェントを有効にして、新しいチャットを開始してください。
ウィンドウにサービスへ到達できないと表示される	`meshy-dcc ui` をもう一度実行してください。サービスは、しばらくどのアプリも開かれていない場合に自動的に停止します。
エージェントがどのアプリまたはプロジェクトを使うか尋ねてくる	開いているアプリが複数あり、リクエストに合致するものが複数あります。アプリ、シーン、またはプロジェクトの名前を指定してください。
Windows が不明なアプリについて警告する	Windows 用ファイルに署名がありません。`cdn.meshy.ai` からインストールした場合に限り、詳細情報 > 実行を選択してください。
Windows がアプリをブロックし、実行する方法を提供しない	スマートアプリ制御が未署名のアプリをブロックしており、個別に例外を設定できません。スマートアプリ制御がオフになっている PC で Meshy DCC Core を使用してください。

セットアップを確認する

セットアップを確認するには、次を実行します。

meshy-dcc doctor

このコマンドは、インストール済みファイル、ローカルサービス、登録済みのアプリを確認します。何も変更はしません。

問題を報告する

問題を報告するには、次の手順に従ってください。

ウィンドウで設定 > 問題を報告するに移動します。
エージェントに何を依頼し、何が起きたかを説明してから、プレビューをクリックします。ウィンドウには実際のレポートが表示されます。そこには、あなたの説明、バージョン情報とオペレーティングシステム、パスや ID を含まない診断サマリー、エージェントの直近のエラーレポートが含まれます。
送信をクリックします。Meshy DCC Core は、あなたが送信をクリックするまで何も送信しません。Meshy はこのレポートを GitHub の meshy-dcc-core リポジトリ内の公開 issue に変換するため、説明には個人情報を含めないでください。

ターミナルから meshy-dcc report --summary "what happened" を実行すると同じプレビューが表示され、--yes を付けると送信されます。エージェントも同じことができますが、何かを送信する前に必ず確認を求めます。

フォームを使わずに報告するには、リポジトリで issue を開くか、support@meshy.ai にメールしてください。フォルダ名など個人的な情報を取り除いたうえで、meshy-dcc doctor の出力を貼り付けてください。お使いのコンピューター上の直近の失敗、遅いリクエスト、問題のログを確認するには、問題を報告する内のデバッグワークベンチを開くをクリックしてください。

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 フォルダーを削除します。ここには設定とカスタムスキルが保存されているため、残しておきたいスキルがあればコピーを保管してください。