前言¶
在 DSH 裏做 3D，常見做法是自己在對話裏拼 API、寫腳本、管登錄和產物路徑。Meshy 已經提供 meshy-cli 和麪向智能體的技能包；若要把「文生 3D、貼圖、重拓撲、綁骨動畫、格式導出、打印切片交接」放進 Harness 工作流，還需要插件把 CLI、會話憑據和技能目錄接進 dsh 的沙箱 shell。
下面介紹社區插件 meshy-dsh（維護者 meshy-dev，分類：聯網工具）。它把 Meshy 的 3D 生成與 3D 打印技能掛到 DeepSeek Harness 上，由智能體通過 shell 驅動 CLI，並把結果寫入當前項目。
這是什麼¶
meshy-dsh 是 Meshy 爲 DeepSeek Harness（dsh）提供的插件：打包 meshy-cli 依賴，掛載與 meshy-3d-agent 同步的技能，並在 Web / Desktop 側提供 Meshy 設置頁與 GLB 預覽。當前 package 版本爲 0.3.2，許可證 MIT。
插件解決兩類問題：一是讓 agent 在統一技能下調用 Meshy（含費用確認後再扣積分）；二是解決 dsh 沙箱無法持久保存 CLI 登錄的問題——由插件維護登錄、刷新會話，並注入每次 shell 調用所需環境，同時不把 MESHY_API_KEY 暴露給 agent 的 shell。
核心功能¶
技能側（README 與 package.json 描述一致）覆蓋：
- 文本或圖像生成 3D 模型
- 貼圖、重網格（remeshing）、綁骨與動畫
- 格式轉換（如導出 FBX 等，以 CLI 能力爲準）
- 3D 打印：生成可打印文件，並支持與切片器（slicer）交接
在 dsh web 配置下，新會話輸入 / 可看到 meshy-3d-generation 與 meshy-3d-printing。智能體會檢查 CLI；若未登錄會引導登錄，展示費用並等待確認後再消耗 credits。
登錄與站點
- 一次登錄即可：在 Settings → Meshy 或對話中通過
meshy_sign_in工具（鏈接 + 驗證碼；Web 上帶二維碼）。 - 可選中國區 meshy.cn，與 meshy.ai 同賬號同積分；登錄憑據由 CLI 加密存儲（與系統密鑰相關），本機終端裏的
meshy可共享該登錄。 - 插件不向 agent shell 導出
MESHY_API_KEY。
Web / Desktop 界面
- 左側欄 Meshy 入口：賬戶信息與示例請求，點選後新開會話並預填提示詞。
- Settings → Meshy（Plugins 下同名頁）：CLI 版本、登錄方式（瀏覽器或 API key）、賬戶、站點（meshy.ai / meshy.cn）、積分；中國區暫不顯示賬戶名與郵箱。
- 右側欄點擊
.glb或 agent 交付的模型卡片：交互式 3D 預覽（拖拽旋轉、滾輪縮放、重置或自動旋轉），顯示文件大小與三角面數；單文件最大 256 MB（分塊讀取，突破 dsh 整文件 32 MB 預覽限制）。 - tui 與 headless 無上述 UI，技能行爲一致。
實現要點（供排查）
cordis.patch.yml將內置 filesystem skill provider 再掛載到本包skills/。lib/index.js維護登錄，爲 shell 提供DSH_MESHY_NODE、DSH_MESHY_CLI、會話相關變量及工作區.meshy狀態目錄；註冊meshy_sign_in；Web/Desktop 上另有四條受認證路由固定參數調用 CLI。- 項目內
.dsh/skills或.agents/skills中同名 skill 優先於插件自帶技能。
安裝與啓用¶
插件按 profile 安裝；你用到哪個 profile 就裝哪個（web、tui、desktop）。
官方安裝命令：
dsh plugin --profile web add meshy-dsh
# or from GitHub
dsh plugin --profile web add github:meshy-dev/meshy-dsh
安裝後可用下面命令確認配置裏是否出現 meshy-dsh 層：
dsh --profile web --dump-config
輸出中應包含 # == meshy-dsh 段。在 dsh web 新會話裏用 / 查看上述兩個 Meshy 技能是否列出。
典型用法¶
- 在對應 profile 安裝插件並完成 Meshy 登錄（Settings 或對話內
meshy_sign_in）。 - 新建 web 會話，用自然語言描述需求。README 示例：
make a low-poly treasure chest and export FBX
- 按 agent 提示確認費用後再繼續；生成文件會保存在當前項目工作區，Web/Desktop 下可直接預覽 GLB。
Sidebar 裏的示例請求可作爲起點，編輯後發送即可。
適用場景與注意¶
適合誰
- 已在 DSH 裏用 agent 寫代碼、管倉庫，希望把 Meshy 3D / 打印流水線放進同一工作區的人。
- 需要 Web/Desktop 內預覽 GLB、在設置頁統一管理 CLI 與積分的人。
注意
- 插件與 dsh 進程同權限運行；安裝前請閱讀 GitHub 倉庫 源碼與 MIT 許可證，自行評估信任邊界。
- Meshy 爲付費 credits 服務；agent 會在扣費前展示成本並等待確認。
- 社區目錄 skillhub.cn 插件頁 與 DeepSeek / 幻方無官方從屬關係；DSH 生態是「一切皆插件」，本文事實以倉庫 README 與發佈包爲準。
結尾¶
meshy-dsh 把 Meshy CLI 與 3D/打印技能接進 DeepSeek Harness，並處理沙箱下的登錄與會話注入；Web/Desktop 還提供設置頁與 GLB 預覽。若你要在 dsh 裏從提示詞或圖片走到可導出模型乃至打印文件，可按 profile 安裝插件、登錄 Meshy 後直接在會話裏描述任務。
- 目錄頁：https://www.skillhub.cn/plugins/meshy-dev/meshy-dsh
- GitHub：https://github.com/meshy-dev/meshy-dsh
