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-dsh
    

    dsh 的外掛程式是依 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 頁面登入:

  1. 在 dsh 側邊欄選擇 Meshy。

  2. 在 Site 中選擇 Global · meshy.ai;在中國大陸請選擇 China · meshy.cn。這兩個站點使用同一個 Meshy 帳號和同一份積分。

  3. 點擊 Sign in to Meshy,頁面會顯示 QR Code、登入連結和驗證碼。

    dsh 中的 Meshy 頁面,顯示 QR Code、驗證碼、Open in browser 按鈕和 Waiting for your approval 提示

  4. 用手機掃描 QR Code,或點擊 Open in browser。

  5. 如果 Meshy 要求登入,請登入你的 Meshy 帳戶。

  6. 在 Connect Meshy CLI 頁面,確認驗證碼與 dsh 中顯示的一致,然後點擊 Connect。

    Connect Meshy CLI 頁面,顯示目前登入的帳戶、需要確認的驗證碼,以及 Cancel 和 Connect 按鈕

  7. 回到 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 下方的四個範例請求。

    dsh 側邊欄中的 Meshy 頁面,顯示 Meshy 帳戶卡片、Global 與 China 站點選擇、Sign in to Meshy 按鈕和四個範例請求

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

    新開的 dsh 會話中已填好 Photo to 3D 範例請求

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

    已登入的 Meshy 頁面,顯示帳戶、積分、Signed in with Browser,以及 Sign out 和 Get credits 按鈕

  • 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。
側邊欄沒有 Meshydsh tui 和無介面模式沒有 Meshy 頁面,請使用 dsh Web 或 Desktop。技能在所有模式下都能使用。
Meshy 頁面顯示 Needs attention已儲存的登入狀態無法驗證。點擊重新整理圖示;如果提示仍在,請登出後重新登入。
Meshy CLI 沒有使用你設定的 MESHY_API_KEYdsh 不會把憑證變數傳給智能體的 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 積分。可列印性分析免費。