Meshy for OrcaSlicer 安装与使用
在 OrcaSlicer 里直接用 Meshy：设计图片、图生 3D 模型、贴图、可打印性检测与修复、多色、拆件，结果一键送进当前项目。也可以上传自己的模型（文件或打印板上的对象）做检测、修复、贴图和多色。
准备
- macOS 或 Windows。
- OrcaSlicer 2.5.0 或更高版本。插件功能是 2.5 才有的，2.4 不支持插件。可以在 OrcaSlicer 发布页下载。
- Meshy Pro 或更高等级的会员。插件里所有用到 Meshy 的操作（包括打印检查）都需要。免费账号可以登录，但任何操作都会弹出升级提示，并链接到 Meshy 会员方案页。
安装
下面两种方式任选一种。不要两种都装，两份插件会冲突。
方式一：插件市场（推荐）
-
打开 OrcaSlicer 2.5，顶部菜单选 File → Plugins（中文界面：文件 → 插件）。
-
在插件窗口里点 Install plugin（安装插件），搜索 Meshy 并安装。
-
Orca 会询问插件权限，全部选「允许」（各项用途）。
-
窗口顶部出现 Meshy 页签就装好了。没出现的话重启一次 Orca。
从插件市场安装的插件有新版本时，会在插件窗口里提示，点一下即可更新。
方式二：安装本地文件
-
从 Meshy 下载压缩包并解压，里面有
meshy_orcaslicer.py和这份说明。 -
在 OrcaSlicer 里选 File → Plugins。在插件窗口里点 Install plugin 旁边的小箭头，选 Install local plugin（安装本地插件），然后选中
meshy_orcaslicer.py。只接受
.py文件，不能直接选压缩包。 -
按提示允许 Orca 询问的权限（各项用途）。
-
窗口顶部出现 Meshy 页签就装好了。没出现的话重启一次 Orca。
本地安装的插件不会收到更新提示。要更新时，下载新的压缩包，用同样的方法安装新的 meshy_orcaslicer.py。
权限
插件加载时，Orca 会询问下面这些权限。请全部允许，否则插件无法工作。
| 权限 | 用途 |
|---|---|
访问 api.meshy.ai、assets.meshy.ai | 调用 Meshy，下载生成的模型和图片。 |
本机端口 127.0.0.1:53247 | 插件自己的本地服务：接收浏览器登录后的回调，把模型交给 Orca 导入，也给 3D 预览读取你上传的文件。只有这台电脑能访问。 |
| 运行程序 |
macOS：/usr/bin/open …，用来在浏览器里打开登录页和会员方案页，以及用 orcaslicer://… 把模型导入当前项目。Windows： rundll32.exe url.dll,FileProtocolHandler …，用来在浏览器里打开登录页和会员方案页，以及打开 orcaslicer://open?file=… 链接把模型导入 OrcaSlicer。两个系统都有： /bin/mkdir（Windows：cmd.exe /d /c mkdir）创建 下载/meshy-for-orcaslicer 文件夹，/usr/bin/open（Windows：explorer.exe）打开这个文件夹或缓存文件夹。
|
读写 下载/meshy-for-orcaslicer 中的文件 | 保存你用保存到「下载」存下的副本。 |
| 创建线程 | 网络请求在后台运行，不卡 Orca 界面。 |
登录
-
在 Meshy 页签点使用浏览器登录，浏览器会打开 meshy.ai。
-
授权页上的应用名是 Meshy for OrcaSlicer。需要的话先登录 Meshy，然后点同意。
-
浏览器会显示一个可以回到 OrcaSlicer 的页面，插件自动完成登录。不需要输入任何代码。
登录链接 10 分钟后失效。失效了再点一次使用浏览器登录即可。
能做什么
Meshy 页签
页签里有三种模式：
- 设计图片（Design）：用文字描述想要的东西，可以再加最多 5 张参考图，生成图片。图片模型可选 GPT Image 和 Nano Banana。
- 生成模型（Generate）：用一张图，或同一物体的最多 4 个视角，通过 Meshy 7.1 生成 3D 模型。贴图默认用 Meshy N1，颜色干净，适合打印；需要更多细节时可以选 Meshy 7。
- 上传模型（Upload）：使用自己的
.glb、.stl、.obj或.3mf文件，或者打印板上的对象。
每个结果会把各个版本串成模型链路，并带有可旋转的 3D 预览。对一个结果可以：
- 检测可打印性：检查水密、非流形边、孔洞和薄壁，检测不消耗积分。发现问题时会给出修复按钮。
- 贴图或重新贴图。
- 生成多色 3MF，颜色数默认与当前打印机的耗材数一致。
- 拆件：把模型拆成可以分别打印、再拼起来的部件。
- 点准备打印送进当前项目，同时会在「准备」页打开 Meshy 面板。
会扣积分的按钮都直接标出了消耗。我的作品里能看到之前的图片和模型。
Meshy 面板
在「准备」和「预览」页，打印板旁边有一个停靠的 Meshy 面板，所有内容都在同一页：创作（设计图片或生成模型）、我的作品，以及一次处理一个资产的工作台（打印板上的物体或你的作品）。直接在这里检测、修复、上色、拆件或贴图，最后点加到打印板。
面板关掉后，可以点页签左侧栏的面板按钮重新打开，也可以用快速启动（按空格键）→ Meshy Panel。
其他说明
- 导入的 STL 如果超出打印机的构建体积，会被等比缩小到刚好放得下（约为体积的 80%）。
- Meshy 会在结果完成 3 天后删除它。插件会把每个完成的结果保存在你的电脑上，之后仍然可以使用。更新插件时，保存的结果和上传的文件会保留。在「我的作品」里移除一个结果，也会删掉它的本机副本。
- 插件跟随 Orca 的浅色或深色主题和界面语言（共 19 种语言）。
已知限制
- Windows：除非只允许运行一个实例，否则 OrcaSlicer 会在新窗口里打开导入的模型。在偏好设置 → 同时仅运行一个 OrcaSlicer 实例里打开这个选项，模型就会导入到当前窗口。
- OrcaSlicer 会在下载目录里留下每次导入的模型副本（
meshy_model.stl、meshy_model(1).stl…），可以删除。 - 拆件只支持 Meshy 生成的模型，上传的模型暂不支持。拆件还需要 Meshy 上的原始结果，所以只能在模型生成后的 3 天内使用。
- 多色的打印机只能选品牌。导入多色或拆件的 3MF 时，Orca 可能会切换当前打印机，导入后请检查一下。
- 上传的模型只存在本机，只有在检测、修复、贴图或多色时才会发给 Meshy，GLB、3MF 文件上限 100 MB；STL、OBJ 文件上限 1 GB，只要转换后的模型不超过 100 MB。
- 打印板上对象的涂色要从对象当初打开的
.3mf文件读取，读不到时会提示。这时把项目另存为.3mf，再拖进 Meshy 页签即可保留颜色。
反馈问题
请附上截图，以及 debug.log。日志里不含登录凭据。无论是从插件市场还是从文件安装，它都在同一个位置：
- macOS：在 Finder 里按 ⇧⌘G，打开
~/Library/Application Support/OrcaSlicer/orca_plugins/plugin_data/meshy-orcaslicer/。 - Windows：在文件资源管理器里打开
%APPDATA%\OrcaSlicer\orca_plugins\plugin_data\meshy-orcaslicer\。