用途:这是一个失败模式技能(非工具目录),在即将创建、定尺、定向或合并几何体前阅读;只读场景检查时可跳过。它防止的故障形态通常是:代码能跑、不报异常、视图看似合理,但模型是错的,Blender 不给任何警告。全部数值在 Blender 4.5.13 LTS 的 blender --background --factory-startup 无头会话中实测。
陷阱一:尺寸参数含义不一致。primitive_cube_add(size=N) 的 N 是全边长(顶点在 ±N/2),而球、柱、锥的 radius 是半宽。scale= 会把意图再减半:scale=(0.4,0.4,0.4) 后 dimensions 仍读作 0.4,自检通过但零件只有一半大小。图元还会生成在 3D 光标处,始终显式传 location=。规则:用算子自带参数定尺,不用 scale=;非均匀盒体需跟 transform_apply(location=False, rotation=False, scale=True);尺寸来自规格时把单位写进变量名。
陷阱二:欧拉定向选错轴或静默丢弃。圆柱沿局部 +Z 构建,绕 Z 旋转对 Z 轴无效。实测 aim +X 用 (0, 90°, 0),aim +Y 用 (-90°, 0, 0),aim +Z 用 (0, 0, 0)。rotation_euler 与 rotation_quaternion 只有一个按 rotation_mode 生效,写另一个会被接受、存储并忽略,回读值也一致,使自检通过。规则:先设 obj.rotation_mode = "XYZ",再赋 rotation_euler;用 matrix_world 验证实际轴。
陷阱三:贴合不等于连接。零重叠在视口正确,但对布尔并集产生非流形或空结果、渲染 z-fighting、刚体漂移、3D 打印零壁厚。规则:先写下每个接头的目标重叠,默认取较薄件沿接头轴尺寸的 25%,不小于 1 mm,绝不为零。另外 dimensions 含修改器但不含旋转,export 受 scale_length 影响(设 0.01 会让 1 单位立方体导出后 100 倍过小)。
用法:先填连接图(接头、移动件、固定件、轴、固定接触面、移动贴合面、目标重叠),再按接头顺序以原点创建、定向、放置,每步重算并重读世界包围盒。最后运行校验清单:重叠、定向角、世界包围盒、法线符号体积、应用缩放、修改器数、导出单位;可保存为 verify_assembly.py 并用 blender --background --factory-startup --python verify_assembly.py 运行,逐项打印 PASS/FAIL。
限制:资料仅给出来源页面描述与技能正文,未提供价格、授权、安装步骤、支持范围等信息,暂未提供。