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,页面会显示二维码、登录链接和验证码。

-
用手机扫描二维码,或点击 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 和 headless 模式没有这些页面,但技能的用法完全一样。
-
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 和 headless 模式没有 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:插件源码