Hermes Agent 版 Meshy 技能

Meshy 官方 Hermes Agent 技能，讓你的智能體在對話中生成 3D 模型、材質與動畫，並準備 3D 列印檔案。

概述

Meshy 現已支援 Hermes Agent，包含兩個技能：

  • meshy-3d-generation：文字生成 3D、圖片生成 3D 和多視圖生成 3D，AI 材質生成與重新貼圖，依面數預算重新拓樸，UV 展開，人形角色自動綁定骨骼與動畫，並匯出 GLB、FBX、OBJ、STL 或 USDZ。
  • meshy-3d-printing：可列印性分析與修復，單色和多色 3MF，依實際尺寸縮放，Creative Lab 產品（公仔、燈具、鑰匙圈、冰箱貼），以及在已安裝的切片軟體中開啟。

兩個技能可以分別安裝，如果只需要列印功能，只裝列印技能即可。它們都透過 Meshy CLI 運行。只需在瀏覽器中登入一次，無需 API 金鑰。

使用要求

  • Hermes Agent。
  • 運行 Hermes 的機器上需要 Node.js 22.12 或更高版本，並帶有 npm。
  • Meshy 付費方案：生成功能需要付費方案，每個生成任務都會依 API 價格 消耗 Meshy 點數。可列印性分析免費，本機列印步驟（例如縮放模型或在切片軟體中開啟）無需登入。

安裝

最快的方式是讓 Hermes 自己完成安裝。把下面這段話貼到對話中：

帮我安装 Meshy CLI 和 meshy-3d-agent 技能：
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md

智能體會檢查 Node.js，安裝 Meshy CLI 和兩個技能，並引導你完成登入。

如果想手動安裝，可以用 Hermes 從 GitHub 添加技能：

hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation
hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-printing

也可以用 skills 安裝器一次裝好兩個：

npx -y skills add meshy-dev/meshy-3d-agent --skill meshy-3d-generation --skill meshy-3d-printing -g -y -a hermes-agent

npm install -g meshy-cli 全域安裝是可選的；不安裝的話，技能會透過 npm exec 運行 CLI。安裝完成後請開啟一個新的 Hermes 會話，以便載入技能。

登入

第一次請求生成模型時，智能體會運行 Meshy CLI 的裝置登入流程，並傳給你一個連結和一次性驗證碼：

  1. 在任意裝置上開啟連結並登入 Meshy。
  2. 按顯示內容準確輸入驗證碼，然後點擊 Connect。
  3. 智能體會繼續執行你之前的請求。

Connect Meshy CLI 頁面

驗證碼 10 分鐘後失效，過期了讓智能體重新產生即可。裝置登入可以在任意瀏覽器中完成，所以 Hermes 運行在伺服器上或透過 SSH 使用時也能登入。Meshy CLI 會將登入狀態儲存在 ~/.config/meshy/credentials.json，同一系統使用者下的所有智能體共用。如果設定了 MESHY_API_KEY，它會優先於瀏覽器登入。

範例提示詞

  • 做一個哈士奇幼犬的 3D 模型，以 GLB 格式儲存到 ./assets。
  • 把這張照片轉成帶材質的 3D 模型，保持原有比例。（附上圖片）
  • 為我的遊戲做三個低多邊形藥水瓶，每個不超過 1,500 個三角面。
  • 給這個人形角色綁定骨骼，添加行走動畫，並匯出為 FBX。
  • 幫我 3D 列印一個 80 mm 高的小龍公仔，做成多色 3MF。

後續請求會沿用上一次的結果：做一個 1,500 面的 LOD、換成 FBX、縮放到 150 mm。在請求中加上 花點數前先問我，即可逐個確認付費步驟。

故障排查

現象解決方法
Hermes 沒有使用 Meshy 技能安裝後開啟一個新會話，或在請求中提到 Meshy。
找不到 node 或 npm從 nodejs.org 安裝 Node.js 22.12 或更高版本，然後重啟 Hermes。
智能體要求提供 API 金鑰拒絕，並讓它改用瀏覽器登入。不要在任何對話中貼上 API 金鑰。
登入驗證碼已過期讓智能體重新發起登入。驗證碼有效期為 10 分鐘。
因方案或點數不足無法生成生成需要付費方案和足夠的點數。請在 meshy.ai 查看你的方案和餘額。
登入了錯誤的 Meshy 帳戶讓智能體運行 meshy auth logout，然後重新登入。

常見問題

如何把 Meshy 添加到 Hermes Agent？
讓 Hermes 按照 https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md 操作，或者運行 hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation，再用同樣的方式安裝 meshy-3d-printing。你還需要帶 npm 的 Node.js 22.12 或更高版本。
需要 Meshy API 金鑰嗎？
不需要。技能透過瀏覽器和一次性驗證碼登入，Meshy CLI 會儲存登入狀態。如果環境中已經設定了 MESHY_API_KEY，會優先使用它。
可以只安裝 3D 列印技能嗎？
可以。meshy-3d-printing 可以單獨安裝和使用，包括列印所需的生成步驟。
Hermes 運行在遠端伺服器上時也能用嗎？
可以。裝置登入會給出一個連結和驗證碼，你可以在任意瀏覽器中完成確認。
這些技能和 Codex 外掛是同一套嗎？
是的。Codex 外掛、Claude Code、Cursor 和 Hermes Agent 使用的都是開源儲存庫 meshy-3d-agent 中的 meshy-3d-generation 和 meshy-3d-printing。
免費嗎？
技能免費且開源。生成 3D 模型需要 Meshy 付費方案，並依 API 價格消耗 Meshy 點數。可列印性分析免費。

相關連結