by 运行时依赖
安装命令
点击复制技能文档
Blender 无头渲染工作流 使用此技能时，用户需要从本地 3D 资产快速可靠地获取图像：STL/OBJ/PLY 打印模型、多部分模型文件夹或 BIM/Revit FBX 导出。对于实际 3D 打印分割、间隙、3MF 验证或装配适配调试，请使用专用的 3D 打印工作流；此技能仅生成预览/渲染。
当前操作假设 首选 Workbench + 正交相机用于技术预览。它快速、稳定且在无头模式下清晰显示几何/部件颜色。仅当用户明确需要更好的美观渲染时才使用 Cycles；它更慢，且对 GPU/渲染设置更敏感。不要假设固定 Blender 版本，如 5.0.1。使用安装在主机上的 Blender，理想情况下是当前稳定/LTS 版本。不要在没有用户明确许可的情况下安装或升级 Blender。渲染预览不是验证。漂亮的预览不能证明密闭性、可打印性或物理装配适配。
Blender 可执行文件 按以下顺序解析 Blender：${BLENDER_BIN:-$(command -v blender || echo /Applications/Blender.app/Contents/MacOS/Blender)} 如果该路径失败，请尝试 command -v blender。如果 Blender 缺失，请在安装之前询问用户。
工作流 1：多部分 STL/OBJ 预览用于打印交付 这是技术交付预览的首选工作流：确定性颜色、正交前/等轴测视图、可选的爆炸布局以及用于聊天/切片器审查的联系表。BLENDER_BIN="${BLENDER_BIN:-/Applications/Blender.app/Contents/MacOS/Blender}" "$BLENDER_BIN" --background \ --python scripts/render_stl_set_preview.py -- \ --input /path/to/final_parts_dir \ --output-dir /path/to/preview \ --prefix model-preview \ --explode 0.35 如果源格式携带有用的导入材料（例如 OBJ+MTL），则添加 --preserve-materials。对于纯 STL 交付预览，请将其关闭，以便脚本分配稳定的高对比度颜色。联系表需要 Pillow（python3 -m pip install pillow）如果它尚不可用。然后可以选择创建带标签的联系表：python3 scripts/make_contact_sheet.py \ --output /path/to/preview/model-preview-contact-sheet.png \ --image /path/to/preview/model-preview-front.png --label 正面预览 \ --image /path/to/preview/model-preview-iso.png --label 透视预览 质量检查：部件清晰可见或明确颜色编码。正交前视图未被裁剪。等轴测视图显示重要接口。文件名和标签使预览在此聊天外可理解。
工作流 2：标准单网格美观渲染 对于 STL/OBJ 模型，目标是更好的预览，具有程序材质和照明：BLENDER_BIN="${BLENDER_BIN:-/Applications/Blender.app/Contents/MacOS/Blender}" "$BLENDER_BIN" --background \ --python scripts/render_standard.py -- \ --input /path/to/model.stl \ --output /path/to/output_prefix \ --device auto \ --samples 64 \ --resolution 1400 这会发出 _front.png、_side.png 和 _top.png。使用 --device cpu 进行可移植的烟雾测试；仅当配置了 GPU 渲染时才使用 --device gpu。
工作流 3：BIM/Revit FBX 回退快照 BIM FBX 导入时通常会出现层次/材质问题，可能在 Cycles/Eevee 中显示为黑色。使用 Workbench 并强制可见性：BLENDER_BIN="${BLENDER_BIN:-/Applications/Blender.app/Contents/MacOS/Blender}" "$BLENDER_BIN" --background \ --python scripts/render_bim.py -- \ --input /path/to/structure.fbx \ --output /path/to/structure-preview.png 最近的经验法则是首先保留 Workbench。对于几何审查，Workbench/MATCAP 或 Workbench/STUDIO 比照片真实渲染更有用。正交相机优于透视相机，用于判断部件布局和尺寸。稳定的颜色很重要。为 STL 交付截图分配确定性材质颜色；仅当源格式实际携带有意义的材质数据时才保留导入的材质。爆炸副本仅用于预览。保持源对象隐藏或不变；渲染带偏移的复制预览对象。大的文件应保持本地。如果聊天上传对于大型 FBX/STL/3MF 文件不可靠，请要求提供从操作系统文件管理器复制的本地绝对路径。不要将渲染与验证混淆。对于打印/切片交付，请将预览与来自相关工作流的几何/3MF 验证报告配对。
脚本维护烟雾测试 编辑捆绑脚本后，请至少运行：python3 -m py_compile scripts/.py 真正的 Blender 渲染烟雾测试更好，但仅当 Blender 可用且用户允许访问所选的本地模型路径时才运行它。