Meshy for OrcaSlicer

在 OrcaSlicer 中安装 Meshy 插件，无需离开切片软件，就能生成 3D 模型、让模型达到可打印状态，并添加到打印板。

概述

Meshy for OrcaSlicer 是适用于 macOS 和 Windows 上 OrcaSlicer 2.5 及更高版本的测试版插件。它为切片软件增加两个视图：

  • Meshy 标签页：完整的工作台，位于顶部栏中。你在这里设计图片、生成和上传模型，并使用全部打印工具。
  • Meshy 面板：停靠在 Prepare 和 Preview 中打印板旁边的轻量面板，一次处理一个模型。

使用这个插件，你可以：

  • 根据描述和最多五张参考图设计图片。
  • 根据一张图片，或同一物体的最多四个视图，生成 3D 模型。
  • 上传你自己的 .glb、.stl、.obj 或 .3mf 文件，也可以选择打印板上的对象。
  • 检查模型的可打印性（检查不消耗积分），并一键修复。
  • 生成与打印机耗材数量一致的多色 3MF。
  • 把模型拆分成可分别打印、再组装的部件。
  • 为模型生成或重新生成纹理，用 Meshy N1 得到适合打印的干净配色，用 Meshy 7 得到更精细的细节。
  • 一键把结果添加到打印板。

Meshy 会把每个完成的结果保存在你的电脑上。插件会跟随 OrcaSlicer 的浅色或深色主题以及界面语言。

Meshy 标签页中选中了一个龙模型，左侧是创建表单，中间是带有 Model chain 和工具栏的 3D 预览，右侧是 My creations

开始之前

  • 你需要 OrcaSlicer 2.5.0 或更高版本。OrcaSlicer 从 2.5 版开始支持插件，更早的版本无法运行这个插件。要下载 OrcaSlicer，请访问 OrcaSlicer 发布页。

  • 你需要 macOS 或 Windows。

  • 你需要 Pro 或更高级别套餐的 Meshy 账号。插件通过 Meshy 执行的每个操作都需要该套餐，包括可打印性检查。免费账号可以登录，但任何操作都会显示升级提示。套餐详情请参阅价格与积分。

安装插件

要安装插件，请按以下步骤操作：

  1. 下载 meshy-orcaslicer.zip 并解压。文件夹中包含 meshy_orcaslicer.py 和一份安装指南。

  2. 在 OrcaSlicer 中，点击 File > Plugins。

  3. 在 Plugins 窗口中，点击 Install plugin 旁边的小箭头，然后点击 Install local plugin。

    Plugins 窗口，Install plugin 旁的箭头已展开，显示 Install plugin 和 Install local plugin

  4. 选择 meshy_orcaslicer.py。OrcaSlicer 只接受 .py 文件，不接受 zip。

  5. 当 OrcaSlicer 请求插件的权限时，全部批准。没有这些权限，插件无法工作。各项权限的用途请参阅权限与隐私。

  6. 确认顶部栏中出现了 Meshy 标签页。如果没有，请重启 OrcaSlicer。

    OrcaSlicer 顶部栏，依次是 Prepare、Preview、Device、Project 和 Meshy 标签页，其中 Meshy 处于选中状态

要更新插件，请下载你想要版本的 zip，并用同样的方式安装其中的 meshy_orcaslicer.py。更新会重置已授予的权限，所以 OrcaSlicer 会再次请求权限。你保存的结果和上传的文件都会保留。

登录

你在浏览器中用 Meshy 账号登录。无需输入验证码，也不需要 API 密钥。

要登录，请按以下步骤操作：

  1. 在 OrcaSlicer 中，点击 Meshy 标签页。

  2. 点击 Sign in with browser。浏览器会打开 meshy.ai。

    Meshy 标签页中的 Sign in to Meshy 卡片，带有 Sign in with browser 按钮

  3. 如果 Meshy 要求你登录，请登录你的 Meshy 账号。

  4. 在授权页面确认应用名称是 Meshy for OrcaSlicer，然后批准请求。

  5. 返回 OrcaSlicer。浏览器会显示你已登录，Meshy 标签页会自动完成登录。

登录链接 10 分钟后失效。如果标签页仍然显示 Finish signing in in your browser，请点击 Open sign-in page again。

要退出登录，请点击 Meshy 标签页左侧栏中的头像，然后点击 Sign out。同一个菜单会显示你的套餐，以及已保存结果占用的 Cache 和它的上限。

权限与隐私

插件加载时，OrcaSlicer 会请求以下权限。

权限用途
访问网络 api.meshy.ai 和 assets.meshy.ai调用 Meshy，并下载你生成的图片和模型。
本地端口 127.0.0.1:53247在你的电脑上运行插件自己的服务器。它接收浏览器的登录回调，把模型交给 OrcaSlicer 导入，并提供 3D 预览。只有你的电脑可以访问它。
运行程序在浏览器中打开登录页和价格页，并把模型导入当前项目。在 macOS 上，插件运行 /usr/bin/open。在 Windows 上，插件运行 rundll32.exe url.dll,FileProtocolHandler。它还会在「下载」文件夹中创建 meshy-for-orcaslicer 文件夹（macOS 上运行 /bin/mkdir，Windows 上运行 cmd.exe /d /c mkdir），并打开这个文件夹或已保存结果的文件夹（macOS 上运行 /usr/bin/open，Windows 上运行 explorer.exe）。
读写 Downloads/meshy-for-orcaslicer 中的文件保存你用 Save to Downloads 制作的副本。
线程在后台运行网络请求，让 OrcaSlicer 窗口保持响应。

上传的模型会保留在你的电脑上。只有当你对它执行检查、修复、纹理生成或多色操作时，插件才会把它发送给 Meshy。.glb 或 .3mf 文件最大 100 MB。.stl 或 .obj 文件最大 1 GB，只要插件转换后的模型不超过 100 MB。

问题排查

下表列出安装插件和登录时可能遇到的问题、原因和解决方法。

问题原因解决方法
Meshy 标签页没有出现。OrcaSlicer 还没有加载插件，或者你安装的是 zip 而不是 .py 文件。重启 OrcaSlicer。如果标签页仍然没有出现，请重新安装 meshy_orcaslicer.py。
登录时显示 Sign-in was denied or expired。你在授权页面拒绝了请求，或者链接在 10 分钟后失效。再次点击 Sign in with browser，并在授权页面批准请求。
标签页显示 Your session expired。保存的登录已失效。重新登录。
某个操作显示 Upgrade to keep creating。账号的套餐低于 Pro。点击 View plans，升级到 Pro 或更高级别。
OrcaSlicer 再次请求权限。更新会重置已授予的权限。再次全部批准。

如果问题仍然存在，请把截图和插件的 debug.log 文件发送到 support@meshy.ai。日志中不包含登录凭据。要找到日志，请打开以下文件夹：

  • macOS：~/Library/Application Support/OrcaSlicer/orca_plugins/plugin_data/meshy-orcaslicer/
  • Windows：%APPDATA%\OrcaSlicer\orca_plugins\plugin_data\meshy-orcaslicer\

后续步骤