SolidCraft 钣金模块实战指南:规则、法兰、角部处理与展开导出全解析
SolidCraft 钣金模块实战指南:规则、法兰、角部处理与展开导出全解析
导读:SolidCraft 的 SHEET METAL(钣金)模块基于"恒定厚度板材 + 钣金规则"的建模范式,用一套命令即可完成基板法兰、边缘法兰、轮廓法兰、卷边、折弯、展开/折叠、转换为钣金、平板模式与 DXF/折弯表导出,并支持在钣金面上绘制随重建自动重定位的草图。本文以官方指南 docs/book/src/guide/sheet-metal.md 为骨架,结合引擎命令实现 crates/engine/src/cmd/sheet.rs、文档模型 crates/doc/src/sheet.rs 与大量回归测试 crates/engine/src/cmd/sheet_tests.rs,逐条讲解每个命令的参数、默认值、底层几何原理与自动化脚本写法,读完即可在 SolidCraft 桌面端或 MCP 自动化场景下独立完成从规则定义到平板展开导出的完整钣金工作流。
一、一切从"钣金规则"开始:sheet.manage_rules
钣金件由恒定厚度的板材在一条钣金规则(thickness 厚度、bend_radius 折弯半径、k_factor K 因子,以及角部避让、缝隙等)的约束下构建而成。规则通过 Sheet Metal Rules(钣金规则) 对话框或 sheet.manage_rules 命令管理,命令实现见 crates/engine/src/cmd/sheet.rs#L38-L43。
1.1 规则的全部参数
sheet.manage_rules 可新建规则(同名则更新已有规则),其参数如下(对应 crates/doc/src/sheet.rs#L151-L175 中 SheetRule 结构体的字段):
| 参数 | 含义 | 默认值表达式 |
|---|---|---|
name |
规则名,新建或选择已有规则(必填) | 无 |
thickness |
板材厚度 | 2.5 mm |
k_factor |
K 因子(0…1,用于折弯余量计算) | 0.44 |
bend_radius |
折弯内半径 | Thickness |
relief_width |
折弯避让宽度 | Thickness |
relief_depth |
折弯避让深度 | Thickness * 0.5 |
corner_relief |
角部避让尺寸(跨越折弯角),见第三节 | Thickness * 4.0 |
corner_relief_shape |
角部避让形状:notch / round / rectangular |
notch |
hem_gap |
平卷边(hem)内半径 | 0.01 mm |
gap |
交汇于基板角部的两个法兰端面之间的缝隙 | Thickness |
active |
设为 true 使其成为当前激活规则 |
— |
delete |
设为 true 删除该规则 |
— |
官方文档给出的典型创建命令:
{"command":"sheet.manage_rules","params":{"name":"Sheet 2 mm","thickness":"2 mm","k_factor":0.5,
"bend_radius":"1 mm","corner_relief_shape":"round","corner_relief":"8 mm","active":true}}
1.2 规则值本质上是表达式
从源码 crates/doc/src/sheet.rs#L289-L315 可以看出,规则的每个数值字段都是表达式字符串,可以引用用户参数,其中 Thickness 直接指向该规则自身的厚度。例如 bend_radius: "Thickness" 表示"折弯半径等于板厚";k_factor: 0.5、thickness: "Thick"(引用名为 Thick 的用户参数)都是合法写法。求值时会校验:
- 厚度必须为正且小于 10000 mm;
- K 因子必须在 0…1 之间、折弯半径必须非负,否则命令直接报错(测试 sheet_tests.rs#L435 验证了
k_factor: 3会被拒绝)。
由于规则值引用参数,参数一变,使用该规则的所有零件都会随之重建——测试 rules_are_parameters 验证了把 Thick 从 1.5 mm 改为 2 mm 后,平板尺寸、体积全部按新的折弯余量重算。
1.3 默认规则与规则列表
新文档没有自定义规则时,系统默认提供 Steel (mm) 规则(见 crates/doc/src/sheet.rs#L197-L213):厚度 2.5 mm、K 因子 0.44、折弯半径 = Thickness,与常见 CAD 软件的默认钢规则一致。可用 sheet.rules("List Sheet Metal Rules")列出全部规则、其表达式求值结果与当前激活规则(sheet.rs#L44、sheet.rs#L334-L343)。
二、三大法兰命令:sheet.flange
法兰由 sheet.flange 一个命令承载三种形态,命令签名见 crates/engine/src/cmd/sheet.rs#L16-L22:
- Base flange(基板法兰):由闭合草图轮廓生成整块基板;
- Contour flange(轮廓法兰):由开放草图的连续线段链生成沿边法兰;
- Edge flange(边缘法兰):由零件边缘拾取点生成翻边。
命令会根据传入参数自动判断类型:传 sketch 为基板,传 sketch + curves 为轮廓,传 edges 为边缘法兰;也可显式指定 type。
重要约束:厚度、K 因子、折弯半径、避让尺寸、角部避让等属于规则管辖的参数不能直接传给 sheet.flange——源码 sheet.rs#L111-L127 明确拒绝这些参数并提示用 sheet.manage_rules 建规则后以 rule 传入。这样做的目的是保证脚本永远拿不到与所请求厚度不符的零件。
2.1 边缘法兰的完整参数
sheet.flange params:
edges: [[x,y,z] 位于边缘上的点,或 {point, angle?, height?}]
height: 法兰高度(到外表面)
angle?: 折弯角,默认 90 deg
radius?: 折弯内半径,默认取规则值
position?: inside | outside | middle(默认 inside)
flip? body? name? body_name?
2.2 逐边独立的角度与高度
一个边缘法兰特征中的每一条边都可以有自己的角度和高度。edges 的每一项可以是:
- 一个点
[x, y, z]——使用特征级的height与angle; - 一个对象
{"point": [x, y, z], "angle": "105 deg", "height": "30 mm"}——angle、height任一或两者都可覆盖特征级默认值。
它们与特征级参数一样是表达式(支持用户参数),并且每条边都会成为独立的特征输入 Edge angle、Edge height,排在特征自身的 Height、Angle 之后,可被参数驱动。在 Flange 对话框中,选中多条边时每一行显示一个角度框和一个高度框,留空则取上方特征级的值(实现见 crates/ui-egui/src/dialogs_sheet.rs)。
官方文档示例——四边各带独立角度/高度的法兰:
{"command":"sheet.flange","params":{"edges":[[60,0,2],{"point":[120,45,2],"angle":"90 deg"},
{"point":[60,90,2],"angle":"105 deg","height":"30 mm"},{"point":[0,45,2],"angle":"120 deg","height":"25 mm"}],
"height":38.6,"angle":"75 deg"}}
即:底边用特征默认的 75°、高 38.6;右边 90°;顶边 105°、高 30;左边 120°、高 25。测试 edge_flanges_take_their_own_angle_and_height_per_edge 用手算折弯余量与展开坐标逐一校验了四种角度下的平板轮廓、折弯长度与体积。
不同角度的边在角部同样会互相闭合(规则缝隙 gap 隔开),这正是关闭不同角度法兰角部的唯一途径——因为不同特征的法兰彼此不会闭合。
2.3 折弯余量:K 因子与压弯一致性
平板长度之所以能与实际折弯机(press brake)产出吻合,关键在于折弯余量公式。源码 crates/doc/src/sheet.rs#L605-L608 中:
BA = |angle| · (bend_radius + K_factor · thickness)
折弯余量随角度线性增长,随半径与 K·T 组合增长;展开时每个折弯区宽度即 BA,折叠时该区域被弯成 θ·(R + T/2) 的环形扇区。测试对平板长度做了大量手算对照,例如 base_and_edge_flange_follow_the_k_factor 中(T=2.5、R=2.5、K=0.44)展开宽度期望值 60 − 5 + (π/2)(2.5 + 0.44·2.5) + 15 与引擎输出精确一致(误差 < 1e-6)。
三、角部避让与角部闭合:corner_relief_shape 与 gap
3.1 角部避让(Corner Relief)
当一个边缘法兰特征的两条折弯在基板角部相遇时,规则中的 角部避让形状(corner_relief_shape;对话框内即 Corner Relief Shape)决定该处切掉什么(crates/doc/src/sheet.rs#L230-L243):
notch(默认):不再多切,两条折弯在角部齐平截止;round:以两条折弯线交点为中心、corner_relief为直径(半径取其一半)切一个圆,两条折弯在避让起始处垂直截断;rectangular:以corner_relief为边长切一个方角,两条折弯同样垂直截断。基板角不是直角时,圆角沿基板角度跟随、方角退化为风筝形(两条切口仍垂直于各自边缘)。
避让会同时体现在折叠实体、平板模式、折弯表(折弯因此变短)和 DXF(圆形避让以 ARC 呈现)中。修改规则即可整体改变使用该规则的零件。测试 corner_reliefs_of_the_rule_reach_the_part_the_flat_pattern_and_the_dxf 验证了:72° 托盘在 8 mm 圆形避让下,每个角部体积减少 4·(r²·π/4 + r·2·BA)·T,DXF 中出现 4 条半径 4 的 ARC,折弯长度每条缩短 8 mm。
避让放不下的情况:corner_relief 跨越尺寸小于 0.01 mm、会完全切掉某条折弯、或延伸距离超过基板其他边缘时,该避让被跳过,法兰特征会在对应位置报告警告(crates/doc/src/sheet.rs#L533-L537 的 MIN_CORNER_RELIEF = 0.01;测试 the_corner_relief_shape_is_a_rule_setting_checked_and_undone 验证了 200 mm 过大的方形避让产生 4 条 "no corner relief at …" 警告且零件退回 notch 形态)。
3.2 角部闭合(Closed Corners)与 gap
同一特征中交汇于基板角部的边缘法兰,其面板在任意折弯角下都会彼此靠拢闭合:每个端面垂直于板材裁切,展开图中端线位置由"内表面最近的两条边平行、相隔规则 gap、分居两法兰平分面两侧"确定。72° 折弯的法兰在展开图中端线是斜的;非直角基板角同样闭合;90° 时就是规则历来给出的直角角部。无法闭合的情况(gap 小于 0.01 mm、两法兰反向弯折、展开图中端面会重叠)则保持开放并报告警告(MIN_CORNER_GAP = 0.01,crates/doc/src/sheet.rs#L533-L534)。后续特征追加的法兰不改变已闭合的角部:先前的法兰保持自身长度,新法兰在其折弯处截止。测试 closed_corners_reach_the_flat_pattern_and_the_dxf 对 60°/72°/90°/105° 四种角度逐一验证了展开轮廓、DXF 线段数量、体积守恒与折叠后打孔行为。
四、返回边(Return):法兰之上的法兰
法兰也可以站在另一条法兰的远端边缘上,形成"返回边"(return)——例如托盘四壁顶部向内翻出的卷唇。返回边沿所在边缘从头到尾延伸,因此会跟随所依附法兰的闭合端(无论是否倾斜)。
- 同一特征中、其法兰在基板角部相交的两条返回边也互相闭合,同样保持规则
gap,并沿两条面板法线均值所在平面斜接:该平面平分两条折弯线,且通过两面板起始线的交点。共面的返回边(托盘壁上水平返回边,无论壁倾斜角度如何)会在角部平分线上相接,形如画框四边; - 每条面板的端线在展开图中是斜线;每条折弯在与该平面保持
gap/2的位置垂直截止(最迟截止于所依附法兰末端,可能留下一小段裸露的边缘); - 反向翻折的返回边彼此错开通过;孤立的返回边以所依附法兰的末端收尾;若相邻法兰向内倾斜压到它,返回边会被切短直到与所依附法兰的端部保持同样的净空;
- 无法闭合的返回边保持开放并告警;不同特征的返回边同样不互相闭合,所以围角返回边必须放进同一个特征里。
官方文档示例——120×90 托盘、2 mm 板、90° 壁高 20 的四条返回边(每个点是壁远端边缘内表面中点,返回边向内翻向基板):
{"command":"sheet.flange","params":{"edges":[[60,2,20],[118,45,20],[60,88,20],[2,45,20]],
"height":12,"angle":"90 deg"}}
源码 crates/doc/src/sheet.rs#L594-L602 的 ReturnCorner 结构及 crates/engine/src/cmd/sheet_tests.rs 中的 tray_with_returns 系列测试(returns_on_a_tray_close_at_its_corners、returns_on_leaning_walls_stay_inside_the_walls、returns_follow_the_rules_gap_and_stay_open_with_a_warning_when_it_is_zero)覆盖了直角壁、110° 倾斜壁、gap 为 0 时的开放告警等场景。
五、折弯与卷边:sheet.fold、sheet.hem
sheet.fold:沿草图中的一条直线(或直接给定两点points: <a href="https://link.gitcode.com/i/e511b56db887a3e279ed4202222bf11f" target="_blank">[x,y,z],[x,y,z]])在基板面上折出 90°(默认)折弯。支持angle、radius(默认取规则)、position(centerline中心线 /start起点 /end终点 /mould模具线,默认 centerline)、fixed(指定留在原侧的点,默认取较大的一侧)、flip(反向折叠)。草图折弯线在草图变化时会被跟随;fixed点必须落在板材上,否则新特征直接拒绝(见 [sheet.rs#L234-L256 及常量FOLD_FIXED_OFF_SHEET)。测试 fold_takes_the_bend_out_of_the_flat_sheet 验证折弯后展开尺寸不变、折弯余量 = (π/2)(R+K·T),折叠实体体积 = 平板体积 − 折弯区 + 环形扇区;sheet.hem:沿板材边缘卷边,length(到外表面)、gap(内半径,默认取规则hem_gap)、flip。测试 contour_flange_hem_and_tray 验证了"法兰 + 平卷边 8"的组合,其折弯表中出现 180° 折弯。
六、展开 / 折叠 / 转换为钣金:sheet.unfold、sheet.refold、sheet.convert
sheet.unfold(MODIFY):把钣金体展开为平板,默认作用于最后一个钣金体,支持body指定;sheet.refold:把展开后的钣金重新折叠;sheet.convert("Convert to Sheet Metal"):把一个恒定厚度的实体转换为钣金。必须传body与face(大平面上的一个点),rule可选。测试 unfold_cut_refold_and_convert 演示了"两法兰 → unfold → 跨折弯开槽 → refold"的完整流程(体积精确回算到 15800.304),并验证圆柱体无法转换(拒绝非等厚实体)。
展开/折叠贯穿整个生命周期:参数变化、文件重开、组件重命名之后,钣金体都会按规则重建,平板与折叠状态保持一致(测试 closed_corners_reach_the_flat_pattern_and_the_dxf 与 corner_reliefs_of_the_rule… 均覆盖 unfold/refold 往返)。
七、平板模式、折弯表与 DXF 导出
7.1 平板模式 JSON:sheet.flat_pattern
sheet.flat_pattern(CREATE,无撤销、不进时间线)返回平板的完整结构化数据,字段见 crates/engine/src/cmd/sheet.rs#L386-L427:
{
"body": "钣金体名", "rule": "规则名", "thickness": 2.0, "k_factor": 0.5,
"flat_size_mm": [宽, 高, 厚],
"outline": [外轮廓点列表(多个闭环 = 分离的材料片)],
"cutouts": [每个切口的点列表],
"cutout_shapes": [每个切口的精确形状,与 cutouts 同序],
"pockets": [加工口袋:outline / cutouts / cutout_shapes / side / depth_mm / z0_mm / z1_mm],
"bends": [{bend, angle_deg, radius, direction: "up"|"down", allowance, length, start, end}],
"unfolded": [折弯线/展开几何]
}
每个切口在 JSON 中列出两次且顺序一致:cutouts 为点列,cutout_shapes 为精确形状——圆孔为 {"circle": {"center", "radius"}},其余按 line、arc(含 center、radius、start_deg、sweep_deg)与 polyline 分段描述。圆与圆弧保持精确,其他轮廓曲线以 0.001 mm 弦公差采样。
基板法兰轮廓保留内部孔;贯穿板材的切口若跨越板材边缘则成为平板外轮廓的缺口;重叠与重复的切口只扣除一次合并面积。平板预览、DXF 与展开实体使用相同的材料边界。切口可能留下分离的材料块(包括环形切口的中心块),这些块在 Unfold/Refold 中仍是一个逻辑板材组,并导出为独立的平板轮廓。超出几何处理预算(MAX_FLAT_POINTS/MAX_FLAT_SAMPLES/MAX_FLAT_PIECES/MAX_FLAT_WORK,见 crates/doc/src/sheet.rs#L23-L28)的复杂轮廓直接报错,而不是导出残缺轮廓。
7.2 折弯表导出:sheet.export_bend_table
用于车间图纸或电子表格:
{"command":"sheet.export_bend_table","params":{"format":"csv","path":"bracket-bends.csv"}}
{"command":"sheet.export_dxf","params":{"path":"bracket-flat.dxf"}}
- 默认
format: "csv",选format: "json"得到与sheet.flat_pattern相同的结构化数据; - CSV 表头固定为
body,rule,thickness_mm,k_factor,bend,angle_deg,direction,radius_mm,allowance_mm,length_mm,start_x_mm,start_y_mm,end_x_mm,end_y_mm(文本字段始终加引号,见 sheet.rs#L566-L591); - 长度单位毫米、角度单位度;包含规则、厚度、折弯角、半径、折弯余量(allowance)与平板中心线坐标;
- 折弯只在其中线有材料时列出:被切口缩短的折弯给出剩余长度与端点;被切口分割的折弯为每一段各占一行,且都使用同一折弯编号(平板模式与 DXF 画出的是同一组折弯线段);
path提供则写入文件(经 crates/io/src/vfs.rs 的虚拟文件系统),省略则通过命令响应直接返回内容;body默认取最后一个钣金体;导出不产生时间线条目、不消耗撤销步。
测试 bend_table_exports_shop_dimensions_and_tracks_parameter_changes 验证了 K 因子从 0.4 改成 0.5 后折弯余量随 (π/2)·3.8 → (π/2)·4.0 更新,并拒绝 format: "xml" 与不存在的 body。
7.3 DXF 导出:sheet.export_dxf
导出 R12 格式 DXF(毫米单位),图层(layer)设计如下(sheet.rs#L434-L542):
OUTLINE:板材轮廓与全部切口(切割几何);BEND_UP/BEND_DOWN:折弯中心线(按折弯方向分图层,与折弯表 direction 对应);POCKET_BOTTOM_Z…_TO_…_MM/POCKET_TOP_Z…_TO_…_MM/POCKET_INTERNAL_Z…_TO_…_MM:加工口袋边界,图层名直接编码深度坐标(见下文)。
DXF 切口几何中直线、圆与圆弧保持精确;其他曲线自适应采样(弦公差 0.001 mm);整圆在可能时输出为单个 CIRCLE 实体而非弦近似。
八、切割与加工操作:切口、口袋与 Intersect
8.1 规则内的切割
Box 切割,或轴线平行于板材法线的 Cylinder 切割,像按足迹拉伸一样加工板材:贯穿板材即为切口(圆柱为圆孔),部分深度即为口袋(pocket)。以任意其他角度切割或横跨已折叠折弯的原始体切割会被拒绝。
8.2 浅口袋与对穿
平行、无拔模的拉伸切割还可保留浅口袋贯穿 Unfold/Refold:口袋底面与侧壁保持实体几何;从两侧重叠的切割只要移除整个厚度就形成通孔。平板 JSON 以 pockets 列出,含 side(bottom / top / internal)、depth_mm、z0_mm、z1_mm(以平板底面为原点、毫米为单位)。DXF 中口袋边界使用前述 POCKET_*_Z… 图层——这些是加工操作,把 DXF 导入 CAM 时不要把每个口袋图层都当作贯穿切口轮廓处理。
8.3 Extrude Intersect 的钣金语义
在直基板或展开平板上做 Extrude Intersect,保留同时位于工具足迹与深度区间内的材料(含内部孔、分离岛与既有口袋);浅相交会把被移除层的上下两面记录为顶部/底部口袋。规则保持原始板材规格(stock gauge),剩余实体可能更薄;完全空的相交会连同钣金元数据一起移除板材。每条正值的保留或移除深度层都必须满足内核 0.000001 mm 的拉伸分辨率,更小的层直接报错而不是被舍入抹掉。To Object 可以保留一个修剪到直棱柱的工具(使用其实际修剪后的足迹);变深度的曲面工具在改动板材几何前被拒绝。口袋轮廓可随平面面板成形移动,但横跨折弯区的口袋尚不能重新折叠;加工已折叠的折弯材料、锥形切割等不支持的 3D 钣金 Cut/Intersect 会在改动设计前报错,绝不会在后续重建中静默恢复已移除的材料。相关回归测试集中在 crates/engine/src/cmd/sheet_tests.rs 开头的口袋与相交系列(浅口袋保留深度、双侧口袋对穿成孔、空相交移除几何与元数据、环状板材逻辑组保留、平行面板口袋随展开保留等)。
九、在钣金面上画草图:面锚定与自动重建
草图可以直接画在板材的平面面板上——基板或法兰的任意一侧。在界面中拾取该面,或通过 sketch.create 传 plane: {face: [x, y, z]} 指定一个面锚点,草图便附着在该面板上(而不是某个认证源面上)。
- 命名与找回:草图保留该面的名字
sheet:<body>:<panel>:<top|bottom>(panel为base或法兰的特征 tag),每当板材重建时重新寻找该面——包括参数变化(如厚度、法兰角度)、Unfold/Refold 往返、文件重开以及钣金体重命名之后(见 a_sketch_on_a_flange_face_attaches_to_its_panel 中的名字断言); - 坐标系:草图坐标即平板模式坐标——画在法兰上的点,与平板模式及其 DXF 中的位置一致;底面(bottom face)从下方看 y 方向相反;
- 丢失面:当所依附面消失(法兰被抑制或删除)时,草图报告"丢失附着"而不会跳到其他面;可用 Redefine Sketch Plane(重定义草图平面) 将其改附到另一面;
fixed: true仍然会把拾取时的平面冻结在空间中(测试中的 "Frozen" 草图验证了固定平面在厚度变化后不跟随、反而切出盲孔的行为)。
十、测试矩阵与自动化建议
钣金模块的正确性由多层级测试保障,可作为脚本复现与学习的样例:
- 引擎级命令测试 crates/engine/src/cmd/sheet_tests.rs:覆盖 K 因子手算、规则参数化、托盘四角闭合、角部避让、逐边角度高度、返回边闭合、折弯表/DXF 一致性、口袋与相交、钣金面草图等;
- 官方 Oracle 序列 tests/oracle:
67-sm-base-flange基板法兰、68-sm-edge-flange边缘法兰、69-sm-tray托盘、70-sm-flange-4545° 法兰、71-sm-custom-rule自定义规则、72-sm-contour-flange轮廓法兰、73-sm-hem卷边、74-sm-unfold-refold展开折叠、75-sm-bracket-holes支架孔、76-sm-thickness-variant厚度变体; - 桌面端 UI 场景脚本 crates/ui-egui/tests/scenarios:
s08_sheet_metal_flat_dxf.json(平板 DXF)、s22_sheet_metal_fold.json(折弯)、s49_sheet_metal_flange_per_edge.json(逐边法兰)、s51_sheet_metal_corner_relief.json(角部避让)。
自动化脚本建议:把规则定义放在流程最前(sheet.manage_rules + active: true);一个角部的多条法兰与返回边尽量放进同一 sheet.flange 特征以获得闭合;通过 sheet.flat_pattern 的 bends/outline/cutout_shapes 校验展开结果,再以 sheet.export_dxf + sheet.export_bend_table 输出车间交付物;需要参数驱动的展开长度,可直接在规则与逐边 angle/height 中引用用户参数(如 Thickness、Edge angle),修改参数后整个钣金体与平板模式会同步重建。