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

    dsh 中的 Meshy 页面,显示二维码、验证码、Open in browser 按钮和 Waiting for your approval 提示

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

  • 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 和 headless 模式没有 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 积分。可打印性分析免费。