SolidCraft 参数化 3D CAD：画个矩形就能出零件，10 分钟跑通全流程

【免费下载链接】solidcraftSolidCraft: an open-source parametric 3D CAD application built in pure Rust. Desktop, web, and automation through MCP.项目地址: https://gitcode.com/gh_mirrors/so/solidcraft

SolidCraft 是一款纯 Rust 编写的开源参数化 3D CAD 软件：画草图、加约束和尺寸，再用特征时间线把轮廓变成实体零件，改一个参数整个模型自动重建。它提供桌面版、浏览器版和命令行solidcraft-cli，还内置 MCP 服务器，AI 代理也能帮你建模。本文带你从零开始，10 分钟做出第一个实体零件并导出。各平台安装包见 README.md 的 Download 部分。

先把它跑起来

💡 若系统首次打开时弹出来源验证提示（自构建版本常见），按向导选择"仍然打开/仍要运行"即可，详见 getting-started.md。

想从源码构建（需 Rust 1.95+），只需两步：

git clone https://gitcode.com/gh_mirrors/so/solidcraft && cd solidcraft cargo run --release -p solidcraft -- --sample # 带示例零件启动

界面速览——记住这几块就够

上图是一个典型的参数化零件：左侧设计树列着草图和实体，底部时间线记录每一步特征。

• 工具栏（顶部）：左边是工作区切换器，右边是 MODEL、SURFACE、ASSEMBLE、INSERT、MANAGE 等标签页；进入草图编辑时会自动出现 SKETCH 页。
• Browser（左侧）：设计树，列出文档设置、原点、实体（bodies）、草图和构造平面，眼睛图标控制显隐。
• Viewport（中央）：3D 视口。滚轮缩放、中键平移、右键拖拽旋转；左键点住 0.5 秒可以层层选中被遮挡的对象。
• Dialogs（右侧）：编辑特征时停靠的对话框，带实时预览，改参数立刻看到效果。
• Timeline（底部）：⭐ 参数化建模的核心——所有特征按顺序排列，双击编辑、拖拽标记回滚、拖动特征重排。

完整界面讲解见 ui-tour.md。

跟着做一个完整示例

下面跟着做一块带圆角的板，全程只用最基础的操作。

画个矩形，用尺寸把它钉死

现在你要在平面上画轮廓，并让它"不许乱动"。

• 在 MODEL 页点击New Sketch（命令sketch.create），点选 XY 平面进入草图模式。
• 选Rectangle（快捷键R），在视口点两下画出矩形。
• 按D（Sketch Dimension），点一条边输入40回车，再给另一条边标30。
• 未约束的几何是蓝色，标完两条边就变成完全约束——每条尺寸其实都是一个模型参数，以后随时可以改成表达式。

挤出来，它就成了实体

现在你要给二维轮廓一个厚度。

• 点Finish Sketch回到模型视图。
• 点Extrude（命令solid.extrude），选中矩形轮廓，距离填20 mm。
• 底部 Timeline 立刻多出一个挤出特征，板子成型了。空设计中挤出会问你放哪个 body，选 New Body 即可。

加个圆角，零件更精致

现在你要把锋利的棱边磨圆。

• 选中实体的竖直棱边，点Fillet（命令solid.fillet）。
• 半径填3，确认。支持直线棱、整圈平滑棱、折线棱链。

特征类命令全集见 features.md。

改一个数，看它自己重算

现在你要体验参数化 CAD 最爽的地方。

• 打开 Configure 面板的Parameters，把某个参数（比如板厚）从20改成32。
• 时间线从受影响的特征开始增量重建，挤出、圆角全部自动跟上。

这段官方演示走得更远：从空设计画草图、加参数尺寸、挤出、圆角、抽壳、阵列立柱、开孔，最后把高度 24 改成 32 mm，整个外壳自动重建。

保存与导出

• Save默认存为.sc容器（纯 JSON 也可），保存是原子操作，崩溃最多丢崩溃前的一次编辑。
• Export支持 STEP（AP242，带名称和颜色）、IGES、3MF、STL、OBJ。
• 别人的 STEP / IGES / 3MF / STL 文件也能直接打开继续建模。

格式对照表在 files.md。

回头看一眼，你刚才其实已经走完了完整链路：草图 → 约束尺寸 → 特征 → 参数化重建。这就是参数化 3D CAD 的全部骨架。

不只能点点点——脚本与自动化

SolidCraft 有一条设计原则：你在界面上能点的，都是带 JSON 参数的命令。界面、脚本、CLI、MCP 跑的是同一套命令，注册表在 crates/engine/src/cmd/。

solidcraft-cli run examples/bracket.json --out bracket.step # 运行脚本并导出 STEP solidcraft-cli eval examples/bracket.json # 输出体积、面积等测量 solidcraft-cli snapshot examples/bracket.json --out bracket.png # 渲染一张 PNG

示例脚本 bracket.json 就是一个 JSON 命令列表，和你点的按钮一一对应：

{"commands": [ {"command": "sketch.create", "params": {"plane": "XZ"}}, {"command": "sketch.line", "params": {"points": [[0,0],[40,0],[40,6],[6,6],[6,30],[0,30]], "closed": true}}, {"command": "sketch.finish", "params": {}}, {"command": "solid.extrude", "params": {"distance": "width"}} ]}

更进一步，solidcraft-cli mcp是内置的 MCP 服务器，AI 代理可以直接建模、测量、截图、导出，官方甚至用它建出了一台 3000 多特征的科学漫游车。接入方式见 mcp.md 和 crates/mcp/。

踩坑速查

Q：单位是什么？A：默认毫米和角度，Z 轴朝上；表达式里可以写"1 in"、"30 deg"。详见 parameters.md。

Q：特征失败了怎么办？A：Timeline 会标出失败的特征；用solidcraft-cli run跑脚本时以状态码 1 退出并列出失败项，不会写出错误文件。

Q：它现在能做什么、还不能做什么？A：草图约束、实体特征（挤出/旋转/扫描/放样/圆角/抽壳/拔模/孔/螺纹/阵列/镜像）、参数与配置、装配与关节、钣金、塑料外壳都已可用；曲面、工程图、CAM、仿真在路线图上暂缓。能力清单见 features.md，计划见 ROADMAP.md。

Q：想系统学习看哪里？A：官方文档书在 docs/book/，用户指南加开发者指南都有，SUMMARY.md 是完整目录。

下一步

• SUMMARY.md：官方文档书目录，用户指南和开发者指南都从这里进。
• commands.md：全部命令的参数参考，脚本化建模时随查随用。
• mcp.md：MCP 服务器详解，让 AI 代理替你建模。
• examples/：官方示例脚本合集，照着改就能跑。

打开它，你的第一个参数化零件只需要 10 分钟。🚀

【免费下载链接】solidcraftSolidCraft: an open-source parametric 3D CAD application built in pure Rust. Desktop, web, and automation through MCP.项目地址: https://gitcode.com/gh_mirrors/so/solidcraft