blender-workflow

Blender 工作流

以 Blender Python 作为主要接口。将重要工作保留在可重复运行的脚本中；保留现有场景内容和用户选定的风格。

研究主题

在创建新模型或场景，或对其形状、材质、灯光或构图进行重大修改前，请从至少两个相关且独立的来源查找并目视检查参考资料。研究实际图像、渲染图或视频帧，而非搜索摘要或页面描述。选择能解答任务疑问的参考资料：轮廓与结构、材质表现、比例、构图或运动。如果一个视角无法清晰呈现形态，请使用多个角度。

建模前简要记录来源和观察结果。借鉴有用的原则，但不要照搬独特设计，也不要偏离任务要求。用户提供的参考资料也可计入；重用已为此任务检查过的证据。小幅修正或机械式导出只需使用相关的现有参考资料并进行检查，无需重新制作情绪板。如果无法查看视觉内容，请尝试其他方式，然后说明仍存在的缺口。

如果不确定某个 API 或工作流，请查阅适用于已安装 Blender 版本的官方 Blender 手册或 Python API 文档。不要猜测上下文要求，也不要假定其他版本的示例仍然适用。

使用 Python 构建

使用项目实际的 Blender 可执行文件，通常以后台模式运行：

blender scene.blend --background --python-exit-code 1 --python scripts/change_scene.py

对于新场景，明确设置干净的起始状态。对于现有项目，先检查并保留无关对象。将重要的自动化工作保留在代码库中，记录输出和失败信息，并明确保存目标 .blend 文件。在对有价值的源内容进行破坏性修改前创建检查点。

优先使用 bpy 数据 API、bmesh 和 mathutils，而非依赖上下文的运算符。使用 bpy.ops 时，明确设置所需的活动对象、选中状态、模式和其他上下文；不要依赖后台模式下存在交互式视口。Blender API 操作应在主线程上执行。

使用稳定的对象名称、明确的单位和参数，以及可重复执行且能避免意外创建重复项的操作。考虑变换和世界空间尺寸。适当使用非破坏性修改器。实时 Blender 工具或 GUI 控制可用于检查或处理难以操作的环节；重要更改仍应能通过脚本重复执行。

如果无法使用 Blender，请查看项目记录的安装说明。不要将未执行的代码描述为已验证的场景。

检查并交付

在 Blender 中运行自动化脚本，并检查场景数据和渲染图像。脚本成功运行本身并不能证明视觉效果或结构正确。

检查关键事实：尺寸和变换、对象和集合状态、材质、修改器、缺失的依赖项或间隙。从能暴露潜在问题的视角渲染低成本预览。实际打开并检查这些图像，查看轮廓、比例、相交、悬空部件、着色、灯光和取景。修正可见缺陷，并检查新渲染的图像，然后再进行最终渲染。小幅编辑只需针对性检查；复杂对象可能需要透视、正交和细节视图。

用于制造时，请检查单位、壁厚、配合间隙、未连接的几何体、非流形边或开放边，以及法线。验证导出比例；渲染效果逼真并不能证明物理结构正确。

对于绑定和动画，请检查帧范围、父级关系、骨骼、约束、变形和相交情况。检查具有代表性的姿势和过渡，或在运动效果重要时检查短序列。条件允许时，请在目标运行时验证导出的动画。

确认已保存 .blend 文件，且所需导出文件均存在。条件允许时，重新导入或独立检查导出文件，并视情况检查比例、材质、几何体和动画。交付可编辑源文件和脚本，以及所需输出，并简要说明已验证的内容和仍存在的局限。