meshy-3d-printing

Meshy 3D 打印

使用 Meshy CLI 0.4.3，按预期尺寸交付所需的打印文件，并在适用时附上分析／修复结果，以及按需交接给切片软件。此技能独立完整。普通数字资产请使用 meshy-3d-generation。

需求	参考
CLI 运行器、凭据或输出位置	设置
本地准备、云端生成或产品工作流	打印方案
费用、等待、预览、交付或查找以前的模型	交付
操作失败或结果不确定	故障排查

根据需要阅读相关章节。方案展示有效命令；只选择满足用户输出需求的步骤。

选择本地或云端操作

请求	路径
缩放、定向或放置现有 OBJ	本地运行 mesh prepare-print；无需身份验证或余额
打开现有 STL 或 3MF	本地运行 slicer detect 和 slicer open；无需身份验证或余额
根据文本或照片制作白色模型	生成几何体，不带纹理；按需分析／修复；准备文件
多色模型	生成／复用几何体；按需分析／修复；添加纹理；进行多色打印
分件打印（构建平台、每个零件的颜色、减少支撑）	生成／复用几何体；自动拆分；对零件进行切片
Creative Lab 手办、乙烯基手办、积木手办、灯具、钥匙扣、冰箱贴、键帽或像素解压板	原型 → 审核 → 制作 → 选择产品文件
Creative Lab 可折叠解压玩具	根据照片创建一次 → STL

手办本身并不意味着必须使用 Creative Lab。根据预期产品判断路径；只有在缺失的选择会实质影响结果时，才询问尺寸、颜色或风格。 对于现有模型，请区分本地准备与云端可打印性分析；本地尺寸检查无法确认模型是否完全适合打印。

云端授权

按照设置中的说明自动解析运行器（兼容 meshy 或 npm exec --yes [email protected] -- meshy …）。仅限本地的操作在运行器设置后结束。 云端操作会复用已验证的会话。如需登录，保持 auth login --device 运行， 在评论／进度中，而不是最终答复中显示其 URL 和用户代码，并在本轮中等待同一个工具会话。命令退出后，验证 auth status，然后继续打印任务。 不要在聊天中索要“已完成”的消息或凭据；设置中提供了主机等待流程。

打印专属约束

• 修复会改变几何形状并丢失纹理。下游使用修复后的几何形状，并在输出多色模型前重新添加纹理。当功能部件、薄特征或其他要求使分析变得相关时，请进行分析；已知打印机类型和打印尺寸时也一并提供，以便同时检查壁厚；分析报告并不能证明材料适用性。
• 将 Y 向上的 OBJ 转换为新的 Z 向上文件，并按请求的高度设置尺寸、居中并放置于底面。不要重复变换，也不要将其应用于 STL、3MF 或浮雕产品输出。多色 3MF 无需转换 OBJ。产品 ZIP 包和可选灯座的处理方式各不相同，详见“打印配方”。
• API、下载和几何操作使用 CLI。本地输入上限为 50 MiB，本地模型必须为 GLB 或 glTF（多色模型：GLB）；STL、OBJ 或 FBX 只能以 http(s) URL 的形式提交给 Meshy。 业务命令使用 --output-schema v1 --format json --no-update-check；写入时附带解析后的 --workspace WORKSPACE。读取返回的路径和 ID，不要猜测。
• 使用 create --async 提交云端任务一次，保留其资源和谱系，并对同一任务调用 wait。等待期间保持当前轮次活跃。未知提交状态和中断的下载属于恢复处理情形，不代表可以重新生成。
• 在获批范围和预算内操作；产生额外付费阶段前先提出方案。交付内容应说明适用的估算。本地预处理和可打印性分析免费。

完成交接

展示可用的渲染预览，并提供文件路径、尺寸、分析／修复状态和报告的费用。仅在收到请求或已获授权时，才启动检测到的切片软件；launch_requested 并不能证明已成功导入，也不能证明已启动实体打印机。如果未安装合适的切片软件，仍须交付文件。说明相关的待检查事项，例如支撑和壁厚；未经测试的模型不得描述为保证可打印。