用 Blender 导出…

当需要把 Blender 场景导出为 Web/AR、游戏引擎、3D 打印或 VFX 管线所需的非 .blend 格式时，按目标平台选择格式并配置正确导出参数。

适用场景

解决思路

1. 按目标平台选格式：Web（Three.js、Babylon.js、model-viewer、AR Quick Look）→ glTF/GLB；游戏引擎（Unity、Unreal、Godot）动画/带骨骼 → FBX（现代引擎也可用 glTF），静态 → OBJ/FBX/glTF；Apple AR（USDZ）→ USDZ；3D 打印 → STL；VFX 管线（Maya、Houdini、Nuke）→ USD；DCC 往返 → FBX。目标未知时默认 glTF/GLB。
2. glTF/GLB 导出：调用 bpy.ops.export_scene.gltf(filepath='/tmp/output.glb', export_format='GLB', export_apply=True, export_materials='EXPORT', export_image_format='AUTO', export_yup=True, export_animations=True, export_morph=True, export_skins=True, export_normals=True, export_tangents=False)，静态模型把 export_animations 关掉，然后用 os.path.getsize 计算并打印 MB 大小。
3. glTF 限制：只有 Principled BSDF 材质能干净导出，程序化着色器会被丢弃或简化；硬上限 15 MB、软目标 8 MB；不使用 KTX2/Draco 压缩；贴图仅 PNG，通常最大 1024×1024。
4. 文件过大时先减面：对目标对象新建 DECIMATE 修改器，设置 mod.ratio=0.7（保留 70% 面）、mod.use_collapse_degenerate=True，执行 modifier_apply 后重新导出，并迭代调整 ratio 直到体积达标。
5. FBX 导出：调用 bpy.ops.export_scene.fbx(filepath='/tmp/output.fbx', use_selection=False, apply_unit_scale=True, apply_scale_options='FBX_SCALE_ALL', bake_space_transform=True, object_types={'MESH','ARMATURE','EMPTY'}, use_mesh_modifiers=True, mesh_smooth_type='FACE', use_armature_deform_only=True, bake_anim=True, bake_anim_use_all_bones=True, bake_anim_use_nla_strips=True, bake_anim_use_all_actions=True, bake_anim_force_startend_keying=True, embed_textures=True, path_mode='COPY', axis_forward='-Z', axis_up='Y')。
6. FBX 常见问题修复：目标引擎里模型旋转 90° → 检查 axis_up='Y'、axis_forward='-Z'；模型大 100 倍 → 导出前对对象 Apply Transform；贴图丢失 → embed_textures=True、path_mode='COPY'；动画只播放一个动作 → 用 NLA 并烘焙所有 action。
7. OBJ 导出：调用 bpy.ops.wm.obj_export(filepath='/tmp/output.obj', export_animation=False, apply_modifiers=True, export_eval_mode='DAG_EVAL_VIEWPORT', export_uv=True, export_normals=True, export_materials=True, export_triangulated_mesh=False, forward_axis='NEGATIVE_Z', up_axis='Y')；OBJ 无动画、无骨骼、材质支持基础，仅用于简单几何交换。
8. STL 导出：调用 bpy.ops.wm.stl_export(filepath='/tmp/output.stl', ascii_format=False, apply_modifiers=True)（二进制 STL 更小更快）。
9. STL 关键前提：网格必须 watertight（无孔洞、无法线翻转、无内部面），导出前在 Edit Mode 执行 Mesh → Clean Up → Make Manifold；STL 无单位，多数切片软件按 mm 处理，建模前先把 Blender 场景单位设为 mm；STL 无颜色/材质，只有单色灰。
10. USD 导出：调用 bpy.ops.wm.usd_export(filepath='/tmp/scene.usdc', export_animation=True, export_uvmaps=True, export_normals=True, export_materials=True, use_instancing=True, export_textures=True, overwrite_textures=True)。
11. 按用途选 USD 变体：.usd 文本（可调试、体积大）、.usdc 二进制（紧凑快速，默认首选）、.usda ASCII（可读、较大）、.usdz 打包全部资源的压缩 USD（Apple AR / iOS）。
12. 任何导出前跑检查清单：对目标对象执行 bpy.ops.object.transform_apply(location=False, rotation=True, scale=True) 烘焙旋转与缩放；进入 Edit Mode 全选后执行 mesh.normals_make_consistent(inside=False) 和 mesh.remove_doubles(threshold=0.0001) 再回 Object Mode；确保修改器已应用（导出参数 export_apply=True / use_mesh_modifiers=True）；打印顶点数与面数确认网格统计。
13. 导出后必须验证：用 os.path.exists 检查文件是否存在，用 os.path.getsize 计算并打印大小，或用 Bash 执行 ls -la /tmp/output.glb 复核。
14. 按平台控制面数：Web glTF ≤ 30000 三角面（移动端安全）；Web 主视觉资产 ≤ 60000；Unity/Unreal 主角 50000–100000；移动游戏每资产 ≤ 10000；AR USDZ ≤ 50000；3D 打印不限但要注意文件大小。
15. 按症状修复：FBX 无贴图 → embed_textures=True、path_mode='COPY'；glTF 丢程序化材质 → 先烘焙成图像贴图并只用 Principled BSDF；引擎里旋转 90° → FBX 用 axis_up='Y'、axis_forward='-Z'，glTF 用 export_yup=True；模型大 100 倍 → Apply Transform 并检查单位缩放；OBJ 别处导入失败 → 文件名只用 ASCII；STL 无法打印 → Make Manifold 并重算法线；GLB 超过 15 MB → 用 Decimate 减面并把贴图降到 1024×1024；骨骼数超限 → 每顶点权重限制为 4 并减少骨骼数；动画未导出 → glTF 设 export_animations=True，FBX 设 bake_anim=True。
16. 出现多格式批量导出、Asset Browser / library override 工作流、Apple AR 的 USDZ 细节、Unity/Unreal 往返排查、LOD 生成策略等需求时，加载 references/overview.md（覆盖各格式坑点、Asset Browser 工作流、生产环境 library override、USD 组合、各平台面数目标）。

适用边界 · 注意事项

• 需要的是 .blend 内部编辑或纯 Blender 内操作，而非导出成其他格式时，不必用本技能。
• 环境中没有 Blender 或对应的 blender 执行工具（bpy / mcp__blender__execute_blender_code）时无法执行。
• 目标平台依赖本技能默认配置未覆盖的能力（如 KTX2 / Draco 压缩、非 Principled BSDF 的程序化材质直出）时，需另行处理。