DeepSeek Harness 版 Meshy 外掛程式
Meshy 官方 DeepSeek Harness 外掛程式,讓你在對話中生成 3D 模型、材質和動畫,並準備 3D 列印檔案。
概述
Meshy 外掛程式為 DeepSeek Harness(dsh)帶來兩項技能:
- meshy-3d-generation:文字生成 3D、圖片生成 3D 和多視圖生成 3D,AI 材質生成與重新貼圖,依面數預算重新拓撲,UV 展開,人形角色自動綁定骨架與動畫,並匯出 GLB、FBX、OBJ、STL 或 USDZ。
- meshy-3d-printing:可列印性分析與修復,單色和多色 3MF,依實際尺寸縮放,Creative Lab 產品(公仔、燈具、鑰匙圈、冰箱磁鐵),以及在已安裝的切片軟體中開啟。
外掛程式內建 Meshy CLI,技能會透過它執行,產生的檔案會直接儲存到你的專案裡。只需在瀏覽器中登入一次,不需要 API 金鑰。
在 dsh Web 和 Desktop 中,外掛程式還會在側邊欄加入一個 Meshy 頁面、一個 Meshy 設定頁,以及 GLB 檔案的 3D 預覽。
外掛程式在 npm 上的套件名稱是 meshy-dsh,在 dsh 的 Plugins 中顯示為 Meshy。外掛程式原始碼位於 GitHub 的 meshy-dsh 儲存庫,技能則來自 meshy-3d-agent 儲存庫。
使用要求
- DeepSeek Harness。
- Meshy 付費方案:生成功能需要付費方案,每個生成任務都會依 API 價格 消耗 Meshy 積分。可列印性分析免費,本地列印步驟(例如縮放模型或在切片軟體中開啟)不需要登入。
安裝
以下三種方式任選其一:
-
讓智能體安裝:在 dsh 會話中說「幫我安裝 Meshy 外掛程式」,智能體會自動完成安裝。
-
在外掛程式頁面安裝:在 dsh 中開啟 Plugins,選擇 Add plugin,填入
meshy-dsh。在中國大陸請選擇 Mainland China mirror 來源。 -
用命令列安裝:執行下面的指令。想從 GitHub 安裝,把套件名稱換成
github:meshy-dev/meshy-dsh。dsh plugin --profile web add meshy-dshdsh 的外掛程式是依 profile 安裝的。要安裝到其他 profile(例如
desktop、tui)時,把web換成對應的 profile 名稱即可。
確認是否安裝完成:在 dsh 中開啟 Plugins,應該能看到 Meshy 外掛程式且處於執行狀態。接著新開一個會話,輸入 /,應該能看到 meshy-3d-generation 和 meshy-3d-printing。dsh 只會在安裝完成之後新開的會話中載入技能。
外掛程式內建 Meshy CLI,不需要再安裝其他東西。
登入
只需登入一次,之後不論新舊會話都會使用這個登入狀態。在 dsh Web 和 Desktop 中,可以從 Meshy 頁面或 Settings > Meshy 登入;在對話中第一次要求生成模型時,智能體也會提供登入連結和驗證碼。
從 Meshy 頁面登入:
-
在 dsh 側邊欄選擇 Meshy。
-
在 Site 中選擇 Global · meshy.ai;在中國大陸請選擇 China · meshy.cn。這兩個站點使用同一個 Meshy 帳號和同一份積分。
-
點擊 Sign in to Meshy,頁面會顯示 QR Code、登入連結和驗證碼。

-
用手機掃描 QR Code,或點擊 Open in browser。
-
如果 Meshy 要求登入,請登入你的 Meshy 帳戶。
-
在 Connect Meshy CLI 頁面,確認驗證碼與 dsh 中顯示的一致,然後點擊 Connect。

-
回到 dsh,頁面會自動完成登入並顯示 Signed in。
驗證碼 10 分鐘後失效,過期的話重新發起登入即可。
登入狀態由 Meshy CLI 自行儲存,並用作業系統保管的金鑰加密,所以你在終端機中使用 meshy 時也會是同一個登入狀態。dsh 不會把 export 的 MESHY_API_KEY 傳給智能體的 shell,外掛程式也不會轉交,請使用瀏覽器登入。
Meshy 頁面與 3D 預覽
以下頁面只會在 dsh Web 和 Desktop 中顯示。dsh tui 和無介面模式沒有這些頁面,但技能的用法完全相同。
-
Meshy 頁面:在左側邊欄選擇 Meshy。頁面會顯示你的 Meshy 帳戶,以及 Start creating 下方的四個範例請求。

選擇一個範例,會新開一個已經填好請求內容的會話,你可以修改後再送出。

-
設定頁:開啟 Settings,選擇 Meshy;也可以從 Plugins 下的 Meshy 外掛程式進入。登入後,頁面會顯示你的帳戶、積分、登入方式(瀏覽器或 API 金鑰)、所用站點和 Meshy CLI 版本。你可以在這裡登出或取得積分。中國站暫不顯示帳戶名稱。

-
3D 預覽:在右側邊欄選擇一個
.glb檔案,或選擇智能體交付的模型卡片,即可查看 3D 模型以及檔案大小和三角面數。拖曳旋轉,滾輪縮放,也可以用按鈕重設視角或讓模型自動旋轉。預覽支援最大 256 MB 的模型。
範例提示詞
- 做一個低多邊形的卡通寶箱,用在我的遊戲裡,匯出 GLB。
- 把我附上的這張照片做成帶材質的 3D 模型。(附上圖片)
- 生成一個卡通騎士,綁定骨架並加上走路動畫,匯出 FBX。
- 做一個 10 公分高的柴犬公仔,並準備好可以直接列印的 3MF。
- 為我的遊戲做三個低多邊形藥水瓶,每個不超過 1,500 個三角面。
後續請求會沿用上一次的結果:做一個 1,500 面的 LOD、換成 FBX、縮放到 150 mm。花費積分之前,智能體會先告訴你需要消耗多少,等你確認後才會開始。
故障排查
| 現象 | 解決方法 |
|---|---|
輸入 / 看不到 Meshy 技能 | 新開一個會話。如果還是沒有,表示外掛程式裝到了別的 profile,請安裝到你正在使用的 profile,例如 dsh plugin --profile desktop add meshy-dsh。 |
| 側邊欄沒有 Meshy | dsh tui 和無介面模式沒有 Meshy 頁面,請使用 dsh Web 或 Desktop。技能在所有模式下都能使用。 |
| Meshy 頁面顯示 Needs attention | 已儲存的登入狀態無法驗證。點擊重新整理圖示;如果提示仍在,請登出後重新登入。 |
Meshy CLI 沒有使用你設定的 MESHY_API_KEY | dsh 不會把憑證變數傳給智能體的 shell,請改用瀏覽器登入。請勿在任何對話中貼上 API 金鑰。 |
| 登入驗證碼已過期 | 重新發起登入,或請智能體重新提供驗證碼。驗證碼有效期為 10 分鐘。 |
| 因方案或積分不足無法生成 | 生成需要付費方案和足夠的積分。請前往 meshy.ai 查看你的方案和餘額。 |
| 3D 預覽提示模型過大 | 預覽支援最大 256 MB 的模型。請智能體把模型重新拓撲到更少的面數,再重新開啟。 |
| 登入了錯誤的 Meshy 帳戶 | 在 Meshy 頁面點擊 Sign out,然後重新登入。 |
常見問題
- 如何把 Meshy 加入 DeepSeek Harness?
- 讓智能體幫你安裝 Meshy 外掛程式,或在 Plugins > Add plugin 中填入 meshy-dsh,或執行 dsh plugin --profile web add meshy-dsh,然後新開一個會話。
- 需要 Meshy API 金鑰嗎?
- 不需要。只要在瀏覽器中登入一次,所有 dsh 會話都會使用這個登入狀態。dsh 不會把 export 的 MESHY_API_KEY 傳給智能體。
- 需要安裝 Node.js 或 Meshy CLI 嗎?
- 不需要。外掛程式內建 Meshy CLI,並替技能執行它。
- dsh tui 裡能用嗎?
- 可以。技能在 dsh 的所有模式下都能使用。Meshy 頁面、設定頁和 3D 預覽只會在 dsh Web 和 Desktop 中提供。
- 在中國大陸能用嗎?
- 可以。登入時選擇 China · meshy.cn,使用同一個 Meshy 帳號和同一份積分,之後的請求都會走中國站。
- 這些技能和 Codex 外掛程式是同一套嗎?
- 是的。Codex、Claude Code、Cursor、OpenClaw、Hermes Agent 和 DeepSeek Harness 使用的都是開源儲存庫 meshy-3d-agent 中的 meshy-3d-generation 和 meshy-3d-printing。
- 免費嗎?
- 外掛程式免費且開源。生成 3D 模型需要 Meshy 付費方案,並依 API 價格消耗 Meshy 積分。可列印性分析免費。
相關連結
- Codex 版 Meshy 外掛程式
- Hermes Agent 版 Meshy 技能
- AI 工具:MCP server 與 llms.txt:使用你自己的 API 金鑰,在 AI 智能體中呼叫 Meshy API
- GitHub 上的 meshy-dsh:外掛程式原始碼