Meshy 3D — 生成 + 列印
使用 Meshy CLI 0.8（0.8.5 或更新版本）將使用者的請求轉化為已交付的資產：請求的檔案位於請求的位置，存在的預覽圖像，以及對於列印作業，提供預期的尺寸、分析/修復結果，並在使用者要求時進行切片器交接。僅登入或提交任務不算完成。選擇最簡潔的合適管線，並在後續操作中重複使用現有資產。
安全聲明
可執行檔： Meshy CLI — meshy，或固定的暫存套件 npm exec --yes [email protected] -- meshy — 加上用於安裝的 npm，以及用於檢查執行環境的 node --version。不使用 Python、curl 或任何捆綁腳本。
憑證： CLI 自身的瀏覽器登入（OAuth 裝置流程）會將會話儲存並刷新在 ~/.config/meshy/credentials.v2.json（權限 0600）中，並使用作業系統維護的金鑰進行加密。現有的 MESHY_API_KEY 或明確的 --api-key-file 將被優先採用。此技能絕不會讀取、列印或複製令牌、裝置代碼或金鑰，也不會在對話中要求提供這些資訊。MESHY_API_KEY 為選用。
網路： Meshy API（api.meshy.ai）及其登入頁面（www.meshy.ai），或中國站點的 api.meshy.cn 和 meshy.cn；正在下載的資產或正在檢查的輸入 URL 的媒體主機（不帶憑證）；安裝 CLI 或作為暫存套件執行時的 npm 註冊表。
檔案： 僅寫入每個工作的一個工作區目錄 — 使用者命名的目錄，或 ./meshy_output — 並且 CLI 拒絕任何試圖逸出該目錄的路徑，包括透過符號連結。除非使用者要求，否則不會覆蓋現有檔案。讀取使用者指派的輸入檔案以及其本身在工作區中的輸出（預覽、附檔）。切片器交接會啟動已安裝的切片器應用程式。
離開此機器的資料： 發送到 Meshy 的提示詞、輸入圖像/模型和工作請求。
閱讀此請求所需內容
| 需求 | 參考文件 |
|---|---|
| CLI 執行器、登入或輸出位置 | 設定 |
| 數位資產：生成以及專案配對的模型、紋理化、重新網格化、轉換、圖像 | 管線 |
| 綁定、動畫或生成的動作 | 動畫 |
| 實體列印：本地準備、列印生成、分析/修復、切片器 | 列印配方 |
| Creative Lab 產品（人偶、燈具、鑰匙圈、磁鐵、鍵帽、指尖玩具） | Creative Lab |
| 費用、等待、預覽、交付或尋找先前模型 | 交付 |
| 失敗或不確定的操作 | 疑難排解 |
在需要時閱讀相關章節；配方是可調整的範例，而非需要完整執行的步驟。無紋理的模型跳過紋理化；現有的 GLB 無需轉換。參數不確定時使用命令 --help。
數位資產或實體列印
任何打算用於列印的物品 — 列印、切片器、3MF、STL、Bambu/Orca/Prusa/Cura、多色、桌上玩具或實體人偶 — 都應從第一個命令開始遵循列印配方，以使生成參數符合列印需求。其他所有內容則遵循管線。
| 列印請求 | 路徑 |
|---|---|
| 縮放、定向或放置現有 OBJ 於地面 | 本地 mesh prepare-print；無需登入或餘額 |
| 開啟現有 STL 或 3MF | 本地 slicer detect 和 slicer open；無需登入或餘額 |
| 從照片、草圖或文字生成白色模型 | 照片：image-to-3d。否則建議先製作參考圖像（當深度或側面重要時使用多視角），搭配 text-to-3d 作為更快的替代方案；使用無紋理的幾何體；按需分析/修復；準備檔案 |
| 多色模型 | 生成/重複使用幾何體；按需分析/修復；紋理化；多色列印 |
| 分件列印（平台、每部件顏色、較少支撐） | 生成/重複使用幾何體；自動拆分；切片各部件 |
| 檢查或修復現有模型（孔洞、薄壁），任何格式 | 透過任務 ID 或 --model-url 免費分析可列印性；僅在需要時修復 |
| 調整現有 STL、3MF 或 GLB 的大小 | 在切片器中縮放；僅 OBJ 在本地調整大小 |
| Creative Lab 人偶（從照片生成的風格化收藏品）、搪膠人偶、積木人偶、燈具、鑰匙圈、冰箱磁鐵、鍵帽或像素指尖玩具板 | 原型 → 審閱 → 建構 → 選擇產品工藝品 |
| Creative Lab 可折疊指尖玩具 | 從照片進行一次 create → STL |
顏色路徑不同：多色是為多材料印表機繪製一個物體的表面；拆分是將其切割成部件，每個部件使用一種線材，並移除紋理（拆分在任何修復之前進行；兩者不可連鎖）；像素指尖玩具板是其自身的產品。
單獨的人偶不表示就是 Creative Lab。僅在缺少的選擇會顯著改變結果時詢問尺寸、顏色或樣式。
OpenClaw 上的首次使用和登入
在第一次命令執行前執行 meshy --version；無需詢問。當 meshy 缺失或版本低於 0.8.5 時，使用 npm install -g [email protected] 安裝最新的 0.8.x 版本，並用一行文字告知。設定部分涵蓋了拒絕安裝和 0.9 或更新版本的 CLI。僅限本地的列印工作在此停止。其他所有情況都會重複使用已驗證的 auth status 會話；僅在沒有會話時，才進行登入：
- 使用
exec和較短的yieldMs（約 3000）及timeoutSeconds: 900啟動meshy auth login --device --format json --no-update-check（為中國大陸使用者新增--region cn：使用與全球站點相同的帳號和點數），使其在背景持續執行並返回sessionId。 - CLI 會在數秒內在 stderr 列印
Enter code … at https://www.meshy.ai/device。如果首次輸出僅包含 npm 通知，則對同一sessionId進行process poll。將該 URL 作為連結以及逐字的代碼發送給使用者，並告知操作步驟：打開連結、在提示時登入 Meshy、輸入代碼、批准。對話中無需回傳任何內容。 - 不要啟動第二次登入、終止會話或自行進行 HTTP 輪詢；CLI 會等待批准。當它退出時，OpenClaw 會喚醒此會話；使用
process poll收集結果（子代理在產生結果前進行輪詢，不會被喚醒）。然後驗證auth status，並使用已給予的輸入、路徑和預算繼續原始請求。
背景會話不得使用 & 或 nohup 分離。過期或被拒絕的代碼意味著重新執行相同的登入；這永遠不足以成為重新執行付費任務的理由。長時間 wait 命令的行為相同：讓 exec 將它們放到背景，並從完成喚醒中恢復，而不是重新提交或循環執行 sleep。
只有 CLI 會接觸其配置目錄；被沙盒阻止的登入請遵循設定文件的第 3 節。
執行邊界
- 透過 CLI 執行 API、上傳、下載和網格操作。本地輸入限制為 50 MiB，且本地模型必須為 GLB 或 glTF（綁定、UV 展開和多色：必須為 GLB）；對於其他情況，使用支援的 URL 輸入路徑。
- 每個命令都使用
--format json --no-update-check，並列印一個meshy.cli/v1封包（包含授權資訊）。從使用者的輸出路徑解析WORKSPACE，並將其傳遞給每次寫入操作。 - 在第一次付費 Create 之前，要知道模型的用途：遊戲資產、要綁定的角色、渲染用途還是 3D 列印。如果使用者尚未說明，則詢問一次；答案將決定路徑和模型（管線）。遊戲資產或面數預算意味著使用智慧拓撲，而不是將標準模型重新網格化至低面數。
- 使用
create --async提交一次，保留擁有資源和任務 ID，然後對該任務執行wait。超時和未知的提交遵循疑難排解；它們絕不授權另一次付費 Create。 - 如果沒有可用的照片，建議先製作參考圖像，然後從中建構模型；text-to-3d 是更快的替代方案（管線，從圖像開始；列印：列印配方，第 1 節）。
- 在批准的範圍和預算內工作；在花費前提出額外的付費階段或重新執行。本地準備和可列印性分析是免費的；交付部分涵蓋估價。
- 修復會改變幾何體並移除紋理：在下游使用修復後的幾何體，並在多色輸出前重新紋理化。將 Y 軸向上的 OBJ 準備為一個新檔案；切勿將該轉換應用於 STL、3MF 或浮雕產品的輸出。
交付
僅下載所需的資產。將可用的渲染預覽作為圖像發送給使用者；如果沒有預覽則應說明，而非暗示，且渲染的 PNG 並非 3D 檢視器。回報檔案路徑、用於後續操作的任務 ID 以及實際費用。對於列印，也需回報尺寸和分析/修復狀態；僅在請求時啟動已偵測到的切片器，並請注意 launch_requested 並不保證模型已成功導入。提及相關的剩餘檢查項目，例如支撐和壁厚，但不要將未經測試的模型稱為絕對可列印。