夜雨聆风
name: "trae-cad-skill"
description: "Build123D CAD建模技能，遵循标准化工业逆向建模流程。执行零件建模任务时调用，包含分段拆解、草图构建、特征成型、布尔合并等完整流程。"
Build123D 标准化工业逆向建模技能
你是标准化工业逆向建模智能体，严格遵循分段拆解-局部坐标系定义-带约束草图构建-特征成型-任务树调度-全局合并全流程范式，统一语义、统一拆分逻辑、统一建模顺序，可与其他同类型智能体任务互通、结果对齐，全程维护标准化任务进度表，强制完整记录每一条草图图元与几何约束关系。
核心文件引用
文件 路径 用途
modeling_state.py {项目根目录}/modeling_state.py 状态管理核心：LCS定义、草图图元、任务状态、进度跟踪
workspace_manager.py {项目根目录}/workspace_manager.py 产出物管理：文件存档、目录结构、STEP/STL导出
一、Build123D 正确语法速查表
1.1 导入方式
import build123d as bd
from build123d import (
Box, Cylinder, Circle, Rectangle, Polygon, Line,
SlotOverall, SlotCenterPoint, SlotCenterToCenter, SlotArc,
BuildPart, BuildSketch, BuildLine,
extrude, revolve, sweep, fillet, chamfer,
Axis, Plane, Location, Vector, Align, Locations,
Mode, Compound, Shell, Sphere, Cone, Torus
)
1.2 基本几何体
# 盒子 (width, depth, height) - 注意：第二个参数是depth，不是width
with bd.BuildPart() as part:
bd.Box(100, 80, 30)
# 圆柱体
with bd.BuildPart() as part:
bd.Cylinder(radius=30, height=40)
# 球体
with bd.BuildPart() as part:
bd.Sphere(radius=20)
# 圆锥
with bd.BuildPart() as part:
bd.Cone(radius1=30, radius2=10, height=50)
# 圆环
with bd.BuildPart() as part:
bd.Torus(major_radius=50, minor_radius=10)
1.3 草图与拉伸
# 在XY平面创建草图并拉伸
with bd.BuildPart() as part:
with bd.BuildSketch(bd.Plane.XY):
bd.Rectangle(60, 40)
bd.Circle(radius=10)
bd.extrude(amount=20)
# 减材拉伸（切削）
with bd.BuildPart() as part:
bd.Box(100, 80, 20)
top_face = part.faces().sort_by(bd.Axis.Z)[-1]
with bd.BuildSketch(top_face):
bd.Circle(radius=6)
bd.extrude(amount=-20, mode=bd.Mode.SUBTRACT)
1.4 草图旋转生成实体
with bd.BuildPart() as part:
with bd.BuildSketch(bd.Plane.XY):
bd.Rectangle(20, 30, align=(bd.Align.MIN, bd.Align.CENTER))
bd.revolve(axis=bd.Axis.Y)
1.5 圆角与倒角
with bd.BuildPart() as part:
bd.Box(80, 60, 25)
# 圆角 - X轴方向的边
x_edges = part.edges().filter_by(bd.Axis.X)
bd.fillet(x_edges, radius=3)
# 倒角 - Z轴方向的顶边
top_edges = part.edges().filter_by(bd.Axis.Z).sort_by(bd.Axis.Z)[-1]
bd.chamfer(top_edges, length=2)
1.6 孔特征
with bd.BuildPart() as part:
bd.Box(100, 80, 20)
top_face = part.faces().sort_by(bd.Axis.Z)[-1]
# 通孔
with bd.BuildSketch(top_face):
with bd.Locations((-30, 20)):
bd.Circle(radius=6)
bd.extrude(amount=-20, mode=bd.Mode.SUBTRACT)
# 盲孔
with bd.BuildSketch(top_face):
with bd.Locations((30, 20)):
bd.Circle(radius=5)
bd.extrude(amount=-10, mode=bd.Mode.SUBTRACT)
# 沉头孔
with bd.BuildSketch(top_face):
with bd.Locations((0, -20)):
bd.Circle(radius=10)
bd.extrude(amount=-3, mode=bd.Mode.SUBTRACT)
with bd.BuildSketch(top_face):
with bd.Locations((0, -20)):
bd.Circle(radius=5)
bd.extrude(amount=-20, mode=bd.Mode.SUBTRACT)
1.7 槽孔特征（Slot）
重要: build123d中没有Slot类，而是使用以下槽孔类型：
SlotOverall: 按总长度定义
SlotCenterPoint: 按中心点和半径定义
SlotCenterToCenter: 按中心距定义
SlotArc: 弧形槽孔
with bd.BuildPart() as part:
bd.Box(50, 50, 10)
top_face = part.faces().sort_by(bd.Axis.Z)[-1]
# SlotOverall - 按总长度和宽度定义槽孔
with bd.BuildSketch(top_face):
# 语法: SlotOverall(total_length, width)
bd.SlotOverall(20, 6)
bd.extrude(amount=-10, mode=bd.Mode.SUBTRACT)
# SlotCenterPoint - 按中心点和半径定义
with bd.BuildSketch(top_face):
with bd.Locations((15, 0)):
# 语法: SlotCenterPoint(radius, width)
bd.SlotCenterPoint(10, 5)
bd.extrude(amount=-10, mode=bd.Mode.SUBTRACT)
# 使用矩形+半圆手动创建槽孔（兼容所有版本）
with bd.BuildSketch(top_face):
slot_length = 15
slot_width = 5
with bd.Locations((-15, 0)):
bd.Rectangle(slot_length, slot_width)
with bd.Locations((-slot_length/2, 0)):
bd.Circle(radius=slot_width/2)
with bd.Locations((slot_length/2, 0)):
bd.Circle(radius=slot_width/2)
bd.extrude(amount=-10, mode=bd.Mode.SUBTRACT)
1.7 定位功能
# 使用 Locations 定位
with bd.BuildPart() as part:
with bd.Locations((10, 20, 30)):
bd.Box(50, 40, 20)
# 使用 located() 方法定位已创建的实体
solid_s02 = part_s02.part.located(bd.Location((10.5, 0, 0)) * bd.Rotation(bd.Axis.Z, -48))
# 移动实体
moved_part = part.move(bd.Location(bd.Vector(x, y, z)))
# 旋转实体
rotated_part = part.rotate(bd.Axis.Z, angle_degrees)
1.8 选择器
# 选择Z轴方向的面
top_faces = part.faces().filter_by(Axis.Z)
bottom_faces = part.faces().filter_by(Axis.Z, reverse=True)
# 按位置排序
sorted_faces = part.faces().sort_by(Axis.Z)
# 选择边
x_edges = part.edges().filter_by(Axis.X)
# 选择最后一个（顶部）或倒数第二个（底部）
top_edge = part.edges().filter_by(bd.Axis.Z).sort_by(bd.Axis.Z)[-1]
bottom_edge = part.edges().filter_by(bd.Axis.Z).sort_by(bd.Axis.Z)[-2]
1.9 壳体功能
with bd.BuildPart() as part:
bd.Box(100, 100, 50)
# 创建壳体（移除顶面）
top_faces = part.part.faces().filter_by(bd.Axis.Z, reverse=True)
shelled_part = bd.Shell(top_faces)
1.10 扫掠
with bd.BuildPart() as part:
with bd.BuildSketch():
bd.Circle(radius=5)
with bd.BuildLine():
bd.Line((0,0,0), (0,0,100))
bd.sweep()
1.11 装配与布尔合并
# 方法1: 使用 bd.add() 在 BuildPart 上下文中合并
with bd.BuildPart() as merged_part:
bd.add(solid_s01)
bd.add(solid_s02)
bd.add(solid_s03)
merged = merged_part.part
# 方法2: 使用 Compound 组合（但需要布尔运算才能合并）
assembly = bd.Compound([part1, part2])
1.12 旋转阵列
with bd.BuildPart() as part:
bd.Cylinder(radius=50, height=10)
with bd.BuildPart() as cutter:
bd.Cylinder(radius=5, height=15)
for i in range(6):
angle = i * 60
rotated = cutter.part.rotate(bd.Axis.Z, angle)
translated = rotated.move(bd.Location(bd.Vector(35, 0, 5)))
part.part = part.part - translated
1.13 方向阵列
with bd.BuildPart() as part:
bd.Box(120, 20, 8)
with bd.BuildPart() as element:
bd.Cylinder(radius=8, height=15)
for i in range(5):
translated = element.part.move(bd.Location(bd.Vector(-40 + i * 25, 0, 8)))
part.part = part.part + translated
1.14 导出
bd.export_step(part, "output.step")
bd.export_stl(part, "output.stl")
二、标准化执行固定流程
第一阶段：初始化与分段定义
from modeling_state import (
ModelingState, LCS, SketchProfile, SketchEntity,
EntityType, TaskType, TaskStatus
)
from workspace_manager import WorkspaceManager
state = ModelingState()
state.project_name = "零件名称"
ws = WorkspaceManager("{项目根目录路径}")
state.add_segment("S01", "主体段")
state.add_segment("S02", "加强筋")
第二阶段：逐段建模循环
for each segment:
T001: 定义局部坐标系 LCS
T002: 录入草图图元（直线/圆弧/样条）
T003: 建立几何约束关系
T004: 校验草图闭合与无自交
T005: 主体拉伸/旋转生成实体
T006: 减材切削（孔/槽/型腔）
T007: 圆角/倒角修饰
第三阶段：全局合并
with bd.BuildPart() as merged_part:
bd.add(solid_s01)
bd.add(solid_s02)
bd.add(solid_s03)
merged = merged_part.part
export_paths = ws.export_final(merged, "最终模型名")
三、任务状态枚举
枚举值 中文含义
TaskStatus.PENDING 未开始
TaskStatus.IN_PROGRESS 进行中
TaskStatus.COMPLETED 已完成
TaskStatus.BLOCKED 异常阻塞
TaskStatus.PAUSED 暂停
四、任务类型枚举
枚举值 中文含义
TaskType.COORD_DEF 坐标定义
TaskType.SKETCH_ENTITY 图元采集
TaskType.SKETCH_CONSTRAINT 约束定义
TaskType.SKETCH_VALIDATION 合规校验
TaskType.SOLID_EXTRUDE 增材拉伸
TaskType.SOLID_REVOLVE 增材旋转
TaskType.SOLID_SWEEP 增材扫掠
TaskType.CUT_HOLE 减材切削
TaskType.CUT_SLOT 减材开槽
TaskType.FILLET_CHAMFER 修饰任务
TaskType.MERGE 合并任务
五、草图图元枚举
枚举值 中文含义
EntityType.LINE 直线段
EntityType.ARC 圆弧
EntityType.SPLINE NURBS样条曲线
EntityType.CIRCLE 完整圆
EntityType.RECTANGLE 矩形
EntityType.POLYGON 多边形
六、产出物目录结构
{项目根目录}/
├── modeling_state.py
├── workspace_manager.py
├── workspace/
│ ├── coordinates/
│ │ └── lcs_{分段编号}.json
│ ├── sketches/
│ │ ├── sketch_{分段编号}.json
│ │ └── sketch_{分段编号}_constraints.json
│ ├── tasks/
│ │ └── task_progress.json
│ ├── solids/
│ │ └── solid_{分段编号}.step
│ └── final/
│ └── merged.step
├── {最终模型}.step
└── {最终模型}.stl
七、测试用例速查（按功能分类）
测试1: 基本几何体
def test_primitives():
with bd.BuildPart() as part:
bd.Box(100, 80, 30)
bd.Cylinder(radius=30, height=40)
return part.part
测试2: 草图与拉伸
def test_sketch_extrude():
with bd.BuildPart() as part:
with bd.BuildSketch(bd.Plane.XY):
bd.Rectangle(60, 40)
bd.Circle(radius=10)
bd.extrude(amount=20)
return part.part
测试3: 圆角与倒角
def test_fillet_chamfer():
with bd.BuildPart() as part:
bd.Box(80, 60, 25)
x_edges = part.edges().filter_by(bd.Axis.X)
bd.fillet(x_edges, radius=3)
top_edges = part.edges().filter_by(bd.Axis.Z).sort_by(bd.Axis.Z)[-1]
bd.chamfer(top_edges, length=2)
return part.part
测试4: 孔特征
def test_holes():
with bd.BuildPart() as part:
bd.Box(100, 80, 20)
top_face = part.faces().sort_by(bd.Axis.Z)[-1]
with bd.BuildSketch(top_face):
with bd.Locations((-30, 20)):
bd.Circle(radius=6)
bd.extrude(amount=-20, mode=bd.Mode.SUBTRACT)
return part.part
测试5: 定位功能
def test_positioning():
with bd.BuildPart() as part:
with bd.Locations((10, 20, 30)):
bd.Box(50, 40, 20)
return part.part
测试6: 选择器
def test_selectors():
with bd.BuildPart() as part:
bd.Box(100, 80, 30)
top_faces = part.faces().filter_by(Axis.Z)
bottom_faces = part.faces().filter_by(Axis.Z, reverse=True)
sorted_faces = part.faces().sort_by(Axis.Z)
x_edges = part.edges().filter_by(Axis.X)
return part.part
测试7: 壳体功能
def test_shell():
with bd.BuildPart() as part:
bd.Box(100, 100, 50)
top_faces = part.part.faces().filter_by(bd.Axis.Z, reverse=True)
shelled_part = bd.Shell(top_faces)
return shelled_part
测试8: 扫掠
def test_sweep_loft():
with bd.BuildPart() as part:
with bd.BuildSketch():
bd.Circle(radius=5)
with bd.BuildLine():
bd.Line((0,0,0), (0,0,100))
bd.sweep()
return part.part
测试9: 装配与 Joints
def test_assembly_joints():
with bd.BuildPart() as base:
bd.Box(100, 80, 10)
with bd.BuildPart() as upper:
with bd.Locations((30, 20, 10)):
bd.Box(60, 40, 20)
assembly = bd.Compound([base.part, upper.part])
return assembly
测试10: 旋转阵列
def test_rotate_array():
with bd.BuildPart() as part:
bd.Cylinder(radius=50, height=10)
with bd.BuildPart() as cutter:
bd.Cylinder(radius=5, height=15)
for i in range(6):
angle = i * 60
rotated = cutter.part.rotate(bd.Axis.Z, angle)
translated = rotated.move(bd.Location(bd.Vector(35, 0, 5)))
part.part = part.part - translated
return part.part
测试11: 方向阵列
def test_linear_array():
with bd.BuildPart() as part:
bd.Box(120, 20, 8)
with bd.BuildPart() as element:
bd.Cylinder(radius=8, height=15)
for i in range(5):
translated = element.part.move(bd.Location(bd.Vector(-40 + i * 25, 0, 8)))
part.part = part.part + translated
return part.part
八、禁忌约束
禁止跨分段共用坐标系、不跨分段混用草图
禁止颠倒建模顺序：先基体增材，后减材去除，最后倒角圆角修饰
禁止不指定Axis：选择器必须指定轴向，如 filter_by(Axis.Z)
禁止使用错误的API名称：
✅ bd.extrude（小写）
❌ bd.Extrude（首字母大写）
✅ bd.fillet, bd.chamfer（小写）
❌ bd.Fillet, bd.Chamfer（首字母大写）
禁止在BuildPart外单独使用bd.add()：必须在BuildPart上下文中使用
严禁省略草图图元记录、严禁省略几何约束描述
九、完整建模模板
from modeling_state import (
ModelingState, LCS, SketchProfile, SketchEntity,
EntityType, TaskType, TaskStatus
)
from workspace_manager import WorkspaceManager
import build123d as bd
import math
# 初始化
state = ModelingState()
state.project_name = "零件名称"
ws = WorkspaceManager("{项目根目录路径}")
# 分段定义
state.add_segment("S01", "主体段")
# 局部坐标系
lcs = LCS(
name="LCS-S01",
segment_id="S01",
origin=(0, 0, 0),
x_axis=(1, 0, 0),
y_axis=(0, 1, 0),
z_axis=(0, 0, 1),
description="主体段坐标系"
)
state.add_lcs(lcs)
ws.save_lcs(lcs, "S01")
# 草图图元
profile = SketchProfile("SKETCH-S01", "S01", "LCS-S01")
profile.add_entity(SketchEntity(
entity_id="LINE-001",
entity_type=EntityType.LINE,
points=[(0, 0), (100, 0)],
constraints=["起点在原点"]
))
profile.check_closure()
state.add_sketch(profile)
ws.save_sketch(profile, "S01")
# Build123D 建模
with bd.BuildPart() as part:
with bd.BuildSketch():
bd.Rectangle(100, 50)
bd.extrude(amount=20)
# 保存实体
ws.save_solid(part.part, "S01")
# 布尔合并
with bd.BuildPart() as merged_part:
bd.add(part.part)
merged = merged_part.part
# 导出
export_paths = ws.export_final(merged, "最终模型名")
print(f"STEP: {export_paths['step']}")
print(f"STL: {export_paths['stl']}")