Hermes Agent 版 Meshy 技能

Meshy 官方 Hermes Agent 技能，让你的智能体在对话中生成 3D 模型、纹理和动画，并准备 3D 打印文件。

概述

Meshy 现已支持 Hermes Agent，包含两个技能：

  • meshy-3d-generation：文生 3D、图生 3D 和多视图生 3D，AI 纹理生成与重新贴图，按面数预算重拓扑，UV 展开，人形角色自动绑定骨骼与动画，并导出 GLB、FBX、OBJ、STL 或 USDZ。
  • meshy-3d-printing：可打印性分析与修复，单色和多色 3MF，按真实尺寸缩放，Creative Lab 产品（手办、灯具、钥匙扣、冰箱贴），以及在已安装的切片软件中打开。

两个技能可以分别安装，如果只需要打印功能，只装打印技能即可。它们都通过 Meshy CLI 运行。只需在浏览器中登录一次，无需 API 密钥。

使用要求

  • Hermes Agent。
  • 运行 Hermes 的机器上需要 Node.js 22.12 或更高版本，并带有 npm。
  • Meshy 付费套餐：生成功能需要付费套餐，每个生成任务都会按 API 价格 消耗 Meshy 积分。可打印性分析免费，本地打印步骤（例如缩放模型或在切片软件中打开）无需登录。

安装

最快的方式是让 Hermes 自己完成安装。把下面这段话粘贴到对话中：

帮我安装 Meshy CLI 和 meshy-3d-agent 技能：
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md

智能体会检查 Node.js，安装 Meshy CLI 和两个技能，并引导你完成登录。

如果想手动安装，可以用 Hermes 从 GitHub 添加技能：

hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation
hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-printing

也可以用 skills 安装器一次装好两个：

npx -y skills add meshy-dev/meshy-3d-agent --skill meshy-3d-generation --skill meshy-3d-printing -g -y -a hermes-agent

npm install -g meshy-cli 全局安装是可选的；不安装的话，技能会通过 npm exec 运行 CLI。安装完成后请开启一个新的 Hermes 会话，以便加载技能。

登录

第一次请求生成模型时，智能体会运行 Meshy CLI 的设备登录流程，并发给你一个链接和一次性验证码：

  1. 在任意设备上打开链接并登录 Meshy。
  2. 按显示内容准确输入验证码，然后点击 Connect。
  3. 智能体会继续执行你之前的请求。

Connect Meshy CLI 页面

验证码 10 分钟后失效，过期了让智能体重新生成即可。设备登录可以在任意浏览器中完成，所以 Hermes 运行在服务器上或通过 SSH 使用时也能登录。Meshy CLI 将登录状态保存在 ~/.config/meshy/credentials.json，同一系统用户下的所有智能体共用。如果设置了 MESHY_API_KEY，它会优先于浏览器登录。

示例提示词

  • 做一个哈士奇幼犬的 3D 模型，以 GLB 格式保存到 ./assets。
  • 把这张照片转成带纹理的 3D 模型，保持原有比例。（附上图片）
  • 为我的游戏做三个低多边形药水瓶，每个不超过 1,500 个三角面。
  • 给这个人形角色绑定骨骼，添加行走动画，并导出为 FBX。
  • 帮我 3D 打印一个 80 mm 高的小龙手办，做成多色 3MF。

后续请求会沿用上一次的结果：做一个 1,500 面的 LOD、换成 FBX、缩放到 150 mm。在请求中加上 花积分前先问我，即可逐个确认付费步骤。

问题排查

现象解决方法
Hermes 没有使用 Meshy 技能安装后开启一个新会话，或在请求中提到 Meshy。
找不到 node 或 npm从 nodejs.org 安装 Node.js 22.12 或更高版本，然后重启 Hermes。
智能体要求提供 API 密钥拒绝，并让它改用浏览器登录。不要在任何对话中粘贴 API 密钥。
登录验证码已过期让智能体重新发起登录。验证码有效期为 10 分钟。
因套餐或积分不足无法生成生成需要付费套餐和足够的积分。请在 meshy.ai 查看你的套餐和余额。
登录了错误的 Meshy 账户让智能体运行 meshy auth logout，然后重新登录。

常见问题

如何把 Meshy 添加到 Hermes Agent？
让 Hermes 按照 https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md 操作，或者运行 hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation，再用同样的方式安装 meshy-3d-printing。你还需要带 npm 的 Node.js 22.12 或更高版本。
需要 Meshy API 密钥吗？
不需要。技能通过浏览器和一次性验证码登录，Meshy CLI 会保存登录状态。如果环境中已经设置了 MESHY_API_KEY，会优先使用它。
可以只安装 3D 打印技能吗？
可以。meshy-3d-printing 可以单独安装和使用，包括打印所需的生成步骤。
Hermes 运行在远程服务器上时也能用吗？
可以。设备登录会给出一个链接和验证码，你可以在任意浏览器中完成确认。
这些技能和 Codex 插件是同一套吗？
是的。Codex 插件、Claude Code、Cursor 和 Hermes Agent 使用的都是开源仓库 meshy-3d-agent 中的 meshy-3d-generation 和 meshy-3d-printing。
免费吗？
技能免费且开源。生成 3D 模型需要 Meshy 付费套餐，并按 API 价格消耗 Meshy 积分。可打印性分析免费。

相关链接