故障排除

解决使用 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 文件夹。其中包含你的设置和自定义技能，请先备份需要保留的技能。