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,也就是 npm 上的 meshy-cli 包。你只需在浏览器中登录一次,无需 API 密钥。

这些技能在 GitHub 上的 meshy-3d-agent 仓库中开源。


开始之前

  • 你需要 Hermes Agent。如需下载 macOS 或 Windows 桌面应用,或获取在终端中安装它的命令,请前往 Hermes Agent 官网。

  • 运行 Hermes 的电脑上需要 Node.js 22.12 或更高版本,并带有 npm。

  • 生成模型需要 Meshy 付费套餐。每个生成任务都会按 API 价格消耗 Meshy 积分。各任务的费用请参阅价格。可打印性分析免费,本地打印步骤(例如缩放模型或在切片软件中打开模型)无需登录。


安装技能

如果想让 Hermes 完成安装,把下面这段文字粘贴到对话中:

Help me install Meshy CLI and the meshy-3d-agent skills:
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md

Hermes 会检查 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 没有使用这些技能,请开启一个新会话。


登录

第一次请求生成模型时,Hermes 会启动 Meshy CLI 登录,并发给你一个链接和一次性验证码。

按以下步骤登录:

  1. 在任意设备上打开链接。

  2. 如果页面要求输入验证码,在 设备代码 中按 Hermes 显示的内容准确输入,然后点击 继续。

  3. 如果 Meshy 要求登录,登录你的 Meshy 账户。

  4. 在 连接 Meshy CLI 页面上,点击 连接。页面会显示 已授权 Meshy CLI。

    连接 Meshy CLI 页面,显示已登录的账户、CLI 获得的权限,以及取消和连接按钮

  5. 回到对话。Hermes 会继续执行你之前的请求。

验证码 10 分钟后失效。如果过期,让 Hermes 重新生成一个。你可以在任意浏览器中确认登录,所以 Hermes 运行在服务器上或通过 SSH 使用时也能登录。

Meshy CLI 将登录状态保存在 ~/.config/meshy/credentials.json 中。在这台电脑上以同一用户运行的所有智能体共用该登录状态。如果设置了 MESHY_API_KEY,CLI 会改用该 API 密钥,而不是浏览器登录状态。


示例提示词

用你自己的话描述任务。例如:

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

后续请求会沿用上一次的结果,例如 做一个 1,500 面的 LOD、换成 FBX 或 缩放到 150 mm。如果想自己确认每个付费步骤,在请求中加上 花积分前先问我。


问题排查

下表列出了常见问题、原因及解决方法。

问题原因解决方法
Hermes 没有使用 Meshy 技能Hermes 没有在已打开的对话中加载技能,或没有把你的请求匹配到这些技能。开启一个新会话,或在请求中提到 Meshy。
找不到 node 或 npm没有安装 Node.js,或 Hermes 找不到它。从 Node.js 官网安装 Node.js 22.12 或更高版本,然后重启 Hermes。
Hermes 要求提供 API 密钥技能不需要 API 密钥,它们通过浏览器登录。拒绝,并让 Hermes 改用浏览器登录。不要在对话中粘贴 API 密钥。
登录验证码已过期验证码有效期为 10 分钟。让 Hermes 重新发起登录。
因套餐或积分原因,Hermes 无法生成生成需要付费套餐和足够的积分。在 Meshy 网页端的订阅页面查看你的套餐和余额。
登录了错误的 Meshy 账户Meshy CLI 会复用保存在你电脑上的登录状态。让 Hermes 运行 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,Meshy CLI 会改用它。
可以只安装 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 积分。可打印性分析免费。