Meshy 3D — 生成与打印是做什么的？

使用 Meshy CLI 0.8（0.8.5 或更新版本）将用户的请求转化为交付的资产：请求的文件在请求的位置，当存在预览时提供检查过的预览，对于打印件——提供目标尺寸、分析/修复结果以及切片器交接（当被要求时）。仅登录或提交任务不算完成。选择最短的合适流程，并为后续操作重用现有资产。

安全清单

可执行文件： Meshy CLI — meshy，或固定的临时包 npm exec --yes [email protected] -- meshy — 以及用于安装它的 npm，node --version 用于检查运行时。没有 Python，没有 curl，没有捆绑脚本。

凭据： CLI 自有的浏览器登录（OAuth 设备流）在 ~/.config/meshy/credentials.v2.json（模式 0600）中存储并刷新会话，该文件在操作系统保留的密钥下加密。现有的 MESHY_API_KEY 或显式的 --api-key-file 会被尊重并优先使用。该技能从不读取、打印或复制令牌、设备代码或密钥，也从不要求通过聊天提供。MESHY_API_KEY 是可选的。

网络： Meshy API（api.meshy.ai）及其登录页面（www.meshy.ai），或中国站点的 api.meshy.cn 和 meshy.cn；正在下载的资产或正在检查的输入 URL 的媒体主机，但不包含凭据；当安装 CLI 或作为临时包运行时注册表。

文件： 仅写入每个作业的一个工作空间内——用户命名的目录，或 ./meshy_output——并且 CLI 拒绝逃逸出该目录的路径，包括通过符号链接。除非用户要求，否则不会覆盖现有文件。读取用户指向的输入文件以及工作空间中的自身输出（预览、侧车文件）。切片器交接会启动一个已安装的切片器应用程序。

离开此机器的数据： 发送给 Meshy 的提示、输入图像/模型和任务请求。

读取此请求需要什么

需求	参考
CLI 运行器、登录或输出位置	设置
数字资产：生成和为项目配对的模型、纹理化、重网格化、转换、图像	流程
骨骼绑定、动画或生成的动作	动画
物理打印：本地准备、打印生成、分析/修复、切片器	打印配方
Creative Lab 产品（人偶、灯、钥匙扣、冰箱贴、键帽、指尖陀螺）	Creative Lab
成本、等待、预览、交付或查找之前的模型	交付
失败或不确定的操作	故障排除

在需要时阅读相关部分；配方案例是供适应的例子，不是需要完整运行的阶段。无纹理的模型跳过纹理化；现有的 GLB 不需要转换。当参数不确定时使用命令的 --help。

数字资产还是物理打印

任何用于打印的东西——打印件、切片器、3MF、STL、Bambu/Orca/Prusa/Cura、多色、桌面玩具或实体人偶——从第一个命令开始遵循打印配方，以便生成参数适合打印。其他所有内容遵循流程。

打印请求	路径
缩放、定向或接地现有 OBJ	本地 `mesh prepare-print`；无需登录或余额
打开现有 STL 或 3MF	本地 `slicer detect` 和 `slicer open`；无需登录或余额
从照片、草图或文本生成白色模型	照片：image-to-3d。否则建议先制作参考图像（当深度或侧面重要时使用多视图），text-to-3d 作为更快的替代方案；几何图形不带纹理；根据需要分析/修复；准备文件
多色模型	生成/重用几何图形；根据需要分析/修复；纹理化；多色打印
按独立部分打印（构建板、每部分颜色、更少的支撑）	生成/重用几何图形；自动分割；切片各部分
检查或修复现有模型（孔洞、薄壁），任意格式	通过任务 ID 或 `--model-url` 免费分析可打印性；仅在需要时修复
调整现有 STL、3MF 或 GLB 的尺寸	在切片器中缩放；只有 OBJ 会在本地调整尺寸
Creative Lab 人偶（从照片生成的可收藏风格化物品）、乙烯基人偶、砖块人偶、灯、钥匙扣、冰箱贴、键帽或像素指尖陀螺板	原型 → 审查 → 构建 → 选择产品工件
Creative Lab 可折叠指尖陀螺	从照片一次创建 → STL

颜色路径不同：多色在单个物体表面涂绘以供多材料打印机使用；拆分将其切割成多个部分，每个部分一种耗材，并丢弃纹理（在修复前拆分；两者不能链接）；像素指尖陀螺板是它自己的产品。

仅仅是人偶并不意味着 Creative Lab。仅在缺失的选择会显著改变结果时才询问尺寸、颜色或样式。

在 OpenClaw 上的首次使用和登录

在第一个命令之前运行 meshy --version；无需询问。当 meshy 缺失或版本低于 0.8.5 时，使用 npm install -g [email protected] 安装最新的 0.8.x 版本，并用一行说明；Setup 涵盖了拒绝安装和版本为 0.9 或更新的 CLI。仅本地的打印工作在此停止。其他所有内容重用已验证的 auth status 会话；仅当没有任何会话时，登录：

启动 meshy auth login --device --format json --no-update-check（对于中国大陆的用户添加 --region cn：同一账户和积分，如同全球站点）配合 exec 和一个较短的 yieldMs（约 3000）以及 timeoutSeconds: 900，以便它在后台持续运行并返回一个 sessionId。
CLI 会在几秒内将 Enter code … at https://www.meshy.ai/device 打印到 stderr。如果第一次输出仅包含 npm 通知，则 process poll 同一 sessionId。将 URL 作为链接和代码原样发送给用户，并说明操作步骤：打开它，如果需要则登录到 Meshy，输入代码，批准。无需在聊天中回复任何内容。
不要启动第二次登录、终止会话或自己发送 HTTP 轮询；CLI 会等待批准。当它退出时，OpenClaw 唤醒此会话；通过 process poll 收集结果（子代理，得不到唤醒，在让步前轮询）。然后验证 auth status 并继续原始请求，使用已经给出的输入、路径和预算。

后台会话不能使用 & 或 nohup 分离。过期的或被拒绝的代码意味着重新运行相同的登录；它绝不证明需要重新运行一个已付费的任务。长 wait 命令行为相同：让 exec 在后台运行它们，并从完成唤醒点恢复，而不是重新提交或在 sleep 上循环。

只有 CLI 访问其配置目录；被沙箱阻止的登录遵循 Setup 的第三节。

执行边界

通过 CLI 运行 API、上传、下载和网格操作。本地输入有 50 MiB 的限制，本地模型必须为 GLB 或 glTF（骨骼绑定、UV 展开和多色：GLB）；对于其他情况，使用支持的 URL 输入路径。
每条命令使用 --format json --no-update-check 并打印一个 meshy.cli/v1 信封，包括认证。从用户的输出路径解析 WORKSPACE 并将其传递给每次写入操作。
在第一次付费创建之前知道模型的用途：游戏资产、需要绑定的角色、渲染、3D 打印。如果用户没有说明，询问一次；答案选择路径和模型（流程）。游戏资产或面数预算意味着智能拓扑，而不是标准模型降采样。
使用 create --async 提交一次，保留拥有资源和任务 ID，然后在该任务上执行 wait。超时和未知提交遵循故障排除；它们绝不允许另一个付费创建。
如果没有可用的照片，建议先制作参考图像并从中构建模型；text-to-3d 是更快的替代方案（流程，从图像开始；打印件：打印配方，第 1 节）。
在批准的范围内和预算内工作；在花费之前提议附加的付费阶段或重跑。本地准备和可打印性分析是免费的；交付涵盖估算。
修复会改变几何图形并丢弃纹理：在下游使用修复后的几何图形，并在多色输出之前重新纹理化。准备一个 Y-up OBJ 一次，作为一个新文件；永远不要将该变换应用于 STL、3MF 或浮雕产品输出。

交付

只下载需要的资产。将可用的渲染预览作为图像发送给用户；缺失的预览要声明，不能暗示，渲染的 PNG 不是 3D 查看器。报告文件路径、用于后续的任务 ID 以及实际收费。对于打印件还要报告尺寸和分析/修复状态；仅在请求时启动检测到的切片器，并注意 launch_requested 并不证明模型已被导入。提及其他相关检查，如支撑和壁厚，但不要称未经测试的模型保证可打印。

Meshy 3D — 生成与打印