meshy-3d-generation

Meshy 3D 生成

使用 Meshy CLI 0.4.3 将用户的请求转化为交付的资产。完成意味着将所需文件保存到指定位置、检查可用的预览，并完成用户要求的任何项目集成。仅登录或提交任务不算完成。选择最简便的合适流程，并在后续请求中复用现有资产。

了解此请求的需求

需求	参考
CLI 运行程序、凭据或输出位置	设置
生成、贴图、绑定、动画或转换	流程
费用、等待、预览、交付或查找先前的模型	交付
操作失败或情况不确定	故障排查

需要时阅读相关章节；示例流程可根据所需结果调整，不要求执行每个阶段。未贴图的模型跳过贴图生成；现有 GLB 无需额外转换格式。参数不确定时，使用命令帮助。

首次使用与授权

自动确定运行程序：优先使用兼容的 meshy，否则使用 npm exec --yes [email protected] -- meshy …。复用已验证的会话。如果需要登录，按设置说明操作，并在持久工具会话中运行 auth login --device。在评论/进度消息中，而非最终答复中显示验证 URL 和用户代码。在本轮中等待同一会话退出，验证 auth status，然后继续处理原始请求。后台进程无法在已结束的轮次中恢复；不要要求用户发送“完成”消息。 浏览器授权由用户完成；不得在聊天中索要凭据。

执行边界

• API、上传、下载和网格操作均须通过 CLI 执行。本地输入大小上限为 50 MiB，本地模型必须为 GLB 或 glTF（绑定和多色模型必须为 GLB）；其他格式使用受支持的 URL 输入方式。
• 业务命令使用 --output-schema v1 --format json --no-update-check；身份验证命令有其专用的 JSON 格式。根据用户的输出路径确定 WORKSPACE，并在写入时传入。
• 使用 create --async 提交一次，保留所属资源和 ID，然后对该任务运行 wait。等待正在运行的命令时，保持 Agent 轮次处于活动状态。超时或提交状态未知时，遵循故障排查说明；这些情况不代表可以再次创建付费任务。
• 在用户批准的范围和预算内继续操作。额外的付费阶段或重新运行前，先提出方案；费用估算和余额检查见交付说明。

交付

只下载所需资产。有预览时，检查并展示预览；没有预览不应妨碍交付，也不得声称已检查。交付说明涵盖前期阶段预览的查找、实际费用，以及与现有项目的集成。报告结果和任何具体限制；渲染图像无法证明拓扑质量，也不能提供 3D 查看器。