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\

後續步驟