企业官网建设流程全解析

SolidCraft 是一款纯 Rust 编写的开源参数化 3D CAD 软件，核心流程是：在平面上画草图、加约束和尺寸标注，再用特征时间线把轮廓变成实体零件，修改一个参数就能看到整个模型自动重建。它提供桌面版、浏览器版、命令行solidcraft-cli，甚至内置 MCP 服务器让 AI 代理帮你建模。本教程带你 10 分钟内完成第一个实体零件。

第一步：安装 SolidCraft（3 种方式任选）

根据你的平台选择最方便的方式，新手推荐先试Web 版，零安装、打开即用。

💡 提示：早期发布的安装包未签名。Windows 上若出现 SmartScreen 警告，选择"更多信息 → 仍要运行"；macOS 首次启动请右键选"打开"。

如果你愿意从源码构建（需 Rust 1.95+），只需两步：

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

更多安装细节（Flatpak、Snap、Web 构建）见官方文档 getting-started.md。

快速熟悉 SolidCraft 界面布局

打开后你会看到五大区域，花 1 分钟认一下，后面全程用得到：

• 工具栏（顶部）：左侧的工作区切换器旁边是 SOLID、SHEET METAL、PLASTIC、UTILITIES 等标签页，草图编辑时会出现 SKETCH 页；
• Browser（左侧）：设计树，显示文档设置、坐标原点、实体（bodies）、草图、构造平面和组件，眼睛图标可显隐；
• Viewport（中央）：3D 视口。滚轮缩放、中键平移、右键拖拽旋转；右键点住不动 0.5 秒或右键菜单"Select Other…"可层层选中被遮挡的对象；
• 对话框（右侧）：特征编辑时停靠在此，带实时预览；
• Timeline（底部）：⭐ 参数化建模的核心——所有特征按顺序排列，可双击编辑、拖拽回滚和重排。

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

10分钟建模流程：从草图到实体零件

1️⃣ 创建草图并绘制矩形

1. 在 SOLID 工具栏点击Create Sketch（对应命令sketch.create），点击 XY 平面进入草图模式；
2. 选择Rectangle（快捷键R），在视口中点两下，画出一个矩形；
3. 关闭草图：点击Finish Sketch回到模型视图。

2️⃣ 用尺寸标注驱动草图

SolidCraft 的草图完全由约束和尺寸驱动：未约束的几何是蓝色，完全约束后会变黑。

• 按D（Sketch Dimension），点击矩形的一条边，直接输入40回车 —— 边长变成参数d1；
• 再标注另一条边为30。

每个尺寸其实都是一个模型参数，以后随时可以改成表达式（如width / 2）。约束支持重合、水平/垂直、平行、垂直、相切、相等、同心、对称等，完整列表见 sketching.md。

3️⃣ 挤出（Extrude）生成第一个实体

点击Extrude（命令solid.extrude），选择矩形轮廓，输入距离20 mm，确认。底部 Timeline 立刻多出一个"挤出"特征——你的第一个实体零件诞生了！

💡 提示：挤出会自动选择Join合并到已有实体；空组件中则选New Body。

4️⃣ 加个圆角，零件立刻更精致

选中实体的竖直棱边，点击Fillet（命令solid.fillet），半径填3。支持直线棱、整圈平滑棱、折线棱链，甚至闭合曲线棱。

5️⃣ 参数化重建：改一个数，整个模型跟着变

这就是参数化 CAD 的魅力。打开 SOLID 工具栏 CONFIGURE 面板里的Parameters，把某个参数（比如高度）从24改成32，时间线从受影响的特征开始增量重建——尺寸标注、挤出、圆角全部自动更新。

上图是官方完整演示：从空设计出发，画草图、加参数尺寸、挤出、圆角、抽壳、阵列立柱、开孔、刻字"Pi 4"，最后在 Parameters 里把高度 24 → 32 mm，整个外壳自动重建。

6️⃣ 保存与导出

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

格式细节见 files.md。

命令行与 AI 自动化：同一套命令

SolidCraft 有一个设计原则：你在界面上能点的，都是带 JSON 参数的命令。这意味着脚本、CLI、MCP 和界面跑的是同一套命令（命令注册表在 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 命令列表：sketch.create→sketch.rectangle.two_point→solid.extrude→solid.fillet，和你在界面里点的按钮一一对应。

更进一步，solidcraft-cli mcp是内置的 Model Context Protocol 服务器，可以让 Claude 等 AI 代理直接建模、测量、截图、导出；官方甚至用它完整建出了一台 3323 步特征的科学漫游车。MCP 用法详见 mcp.md。

新手常见疑问 FAQ

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

Q：特征失败了怎么办？时间线会标出失败的特征；参数改动导致重建失败时，solidcraft-cli run会以状态码 1 退出并列出失败特征，不会写出错误文件。

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

Q：想系统学习看哪里？官方文档书（源码在 docs/book/）包含用户指南与开发者指南，SUMMARY.md 是完整目录。

总结

• SolidCraft = 参数化 3D CAD：草图 + 约束尺寸 + 特征时间线 + 参数驱动重建；
• 5 步出第一个零件：Create Sketch → Rectangle → 尺寸标注 → Extrude → Fillet；
• 改参数即重建，.solidcraft文件原子保存，可导出 STEP/STL/3MF；
• 界面、CLI、MCP 共用同一套命令，可脚本化、可被 AI 代理驱动。

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