SolidCraft：Rust 参数化 3D CAD

项目简介

SolidCraft 是一个用纯 Rust 编写的开源参数化 3D CAD 应用。它围绕「草图 — 约束 — 实体特征」的参数化时间线工作：改动一个尺寸，模型就会重新构建。同一套命令既能在桌面端运行，也能在浏览器中运行，还可以通过内置的 MCP server 交给 AI 代理建模。

主要功能

• 草图与约束：支持直线、圆弧、样条、文字等图元，使用自研约束求解器，尺寸可由参数驱动。
• 实体特征：拉伸、旋转、扫掠、放样、圆角、倒角、抽壳、拔模、孔、螺纹、阵列、镜像、分割、合并，全部挂在可编辑的参数化时间线上。
• 参数与配置：支持带单位的表达式。
• 装配：关节、运动仿真、接触集、干涉检查与质量属性。
• 钣金：法兰、折边、折叠/展开与展开图，以及塑料外壳相关特征。
• 文件格式：在支持范围内读写 STEP、IGES、3MF、STL、OBJ、glTF，支持 URDF 导出与 .sc 设计文件（旧版本的 .solidcraft 文件仍可打开）。
• 多种运行形态：桌面应用、浏览器应用、无界面 CLI 和 MCP server 运行的是同一套命令。

完整能力列表见仓库的 docs/capabilities.md 与 docs/features.md，状态与计划见 ROADMAP.md。

安装与使用

官方提供各平台安装包：

• Windows：solidcraft-windows-x64.msi 安装包
• macOS：通用 dmg（Apple silicon 与 Intel）
• Linux：AppImage，或使用 Snap：

sudo snap install solidcraft

• Web：无需安装，直接打开 https://solidcraft.io/app

ARM64、32 位、便携 zip、.deb、.rpm、Flatpak 等其他包在仓库的 docs/downloads.md 中列出。

从源码构建：

cargo run --release -p solidcraft -- --sample      # 带示例零件的桌面应用
cargo run --release -p solidcraft-cli -- commands  # 查看命令注册表

用脚本驱动建模：

cargo run --release -p solidcraft-cli -- run examples/bracket.json --out bracket.step

脚本是一份 JSON 命令列表，内容与 UI 执行的操作相同，格式见 docs/scripts.md。

用 AI 代理建模（MCP）

solidcraft-cli mcp 是一个 Model Context Protocol server。它可以无界面地自行运行设计会话，也可以用 --connect 驱动正在运行的应用，便于观察。以 Claude Code 为例：

claude mcp add solidcraft -- solidcraft-cli mcp

如果终端找不到 solidcraft-cli（较旧的 Windows 安装包不会把它加入 PATH），请给出完整路径。工具、访问规则与示例会话见 docs/mcp.md。

注意事项

• 项目处于早期阶段，但已可用于简单零件：76 个公开参考零件中有 75 个的体积、面积、质心与包围盒与解析值或 FreeCAD 计算结果一致，剩余一个为已记录的问题。
• Windows 下载尚未签名，SmartScreen 提示时选择「更多信息」，再选择「仍要运行」。
• macOS 应用已使用 Developer ID 签名并通过 Apple 公证。
• 许可为 MIT OR Apache-2.0，可任选其一。
• SolidCraft 为独立项目，与 Autodesk、Dassault Systèmes、PTC、Siemens 等 CAD 厂商无隶属或背书关系。

本作品整理自 GitHub 开源项目 tangency-labs/solidcraft，原作者 @tangency-labs，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。