10 个关键问题 Q&A

1. Q：SolidCraft 是什么？ A：纯 Rust 开发的开源参数化 3D CAD 软件，支持 AI 智能体建模。
2. Q：它和 FreeCAD 是什么关系？ A：独立项目，无关联；以 FreeCAD 结果作为精度校验参考。
3. Q：最大特色是什么？ A：原生内置 MCP 服务，AI 可以直接调用它完成三维建模。
4. Q：支持钣金设计吗？ A：支持，包含法兰、折边、折叠展开、平板出图等钣金功能。
5. Q：可以不用安装直接用吗？ A：可以，官网提供浏览器网页版。
6. Q：文件交换格式有哪些？ A：STEP、IGES、3MF、STL、OBJ、glTF、URDF，自有.sc 格式。
7. Q：AI 怎么接入 SolidCraft？ A：通过 solidcraft-cli mcp 启动 MCP 服务，Claude Code 可直接添加调用。
8. Q：能不能批量自动建模？ A：支持 JSON 脚本，CLI 命令行批量执行建模与导出。
9. Q：代码如何编译？ A：使用 cargo，支持 xtask 一键执行格式化、测试、Wasm 构建。
10. Q：项目成熟度怎么样？ A：早期可用版，大部分基础零件计算精度可靠，仍有已知 bug 待修复。

https://github.com/tangency-labs/solidcraft#solidcraft绘制草图、添加约束、构建实体，依托参数化特征时间线进行设计。修改一个尺寸，模型就会自动重生成。可在桌面端、浏览器中运行，也能让 AI 智能体通过内置 MCP 服务完成建模。

官网：https://solidcraft.io/ 下载页：https://solidcraft.io/download 网页版：https://solidcraft.io/app 文档：https://docs.solidcraft.io/ Blacksmith.sh：https://www.blacksmith.sh/ Discord 社区：https://discord.gg/FtU4NQNVDH底层内核：https://github.com/bherbruck/solidcore

CI 流水线：https://github.com/tangency-labs/solidcraft/actions/workflows/ci.yml?query=branch%3Amain 版本发布页：https://github.com/tangency-labs/solidcraft/releases/latest 全部发布记录：https://github.com/tangency-labs/solidcraft/releases 许可证：https://github.com/tangency-labs/solidcraft/blob/main/LICENSE Remade Wiki：https://remade.wiki/projects/solidcraft/ Star 收藏页：https://github.com/tangency-labs/solidcraft/stargazers 趋势看板：https://trendshift.io/repositories/296178?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-296178

演示动图：https://github.com/tangency-labs/solidcraft/blob/main/docs/screenshots/demo.gif 演示案例：从零设计一个树莓派 4 外壳 —— 根据主板参数绘制草图、拉伸、圆角、抽壳、边缘倒圆；在 58×49 毫米的孔位矩形阵列 M2.5 铜柱；开出端口槽与通风槽；用 DejaVu Sans Bold 字体雕刻 “Pi 4” 字样；在设计中定义 PETG 材料，在属性面板查看质量；最后把高度参数从 24mm 改成 32mm，整个模型自动更新重建。（视频为 6 倍速播放，已剪掉闲置等待片段） 演示视频：https://github.com/tangency-labs/solidcraft/raw/refs/heads/main/docs/screenshots/demo.mp4 录制脚本：https://github.com/tangency-labs/solidcraft/blob/main/examples/demo/record_ui.sh

下载

Windows：安装包 solidcraft-windows-x64.msi macOS：solidcraft-macos-universal.dmg（同时支持 Apple Silicon 与 Intel 芯片） Linux：solidcraft-linux-x86_64.AppImage，或者执行命令 sudo snap install solidcraft网页版：https://solidcraft.io/app，无需安装

ARM64、32 位版本、便携压缩包、deb、rpm、Flatpak 等其他安装包，见文档：https://github.com/tangency-labs/solidcraft/blob/main/docs/downloads.md macOS 安装包已通过苹果开发者 ID 签名与公证；Windows 安装包暂未签名：在 Windows Defender SmartScreen 弹窗里选择「更多信息」，再点「仍要运行」。 0.11 ~ 0.14 版本升级注意事项：需要手动下载更新包，详见 https://docs.solidcraft.io/guide/updates.html#updating-from-011-to-014

已实现功能

项目尚处于早期阶段，但已经可以用来制作简单零件：76 个公开参考零件中，有 75 个零件的体积、表面积、质心、包围盒计算结果，和理论解析值 / FreeCAD 计算结果一致（剩余 1 个为已知待修复 bug）。

• 草图与约束：直线、圆弧、样条曲线、文字等；内置自研约束求解器，支持参数驱动尺寸
• 特征操作：拉伸、旋转、扫掠、放样、圆角、倒角、抽壳、拔模、孔、螺纹、阵列、镜像、分割、布尔合并，所有操作保存在可编辑的参数化时间线
• 参数与配置：支持带单位的表达式
• 装配体：支持关节连接、运动仿真、接触集、干涉检查、质量属性计算
• 钣金：法兰、折边、折叠 / 展开、平板图纸，以及塑料外壳常用特征
• 文件格式：支持导入导出 STEP、IGES、3MF、STL、OBJ、glTF；支持 URDF 导出；原生 .sc工程文件（旧版 .solidcraft文件也可打开）
• 运行形态：桌面客户端、网页端、无界面命令行、MCP 服务端，四端共用同一套底层命令

完整能力清单：https://github.com/tangency-labs/solidcraft/blob/main/docs/capabilities.md 功能详情：https://github.com/tangency-labs/solidcraft/blob/main/docs/features.md 路线图与开发状态：https://github.com/tangency-labs/solidcraft/blob/main/ROADMAP.md 案例展示：https://github.com/tangency-labs/solidcraft/blob/main/docs/showcase.md 3D 鼠标支持：https://github.com/tangency-labs/solidcraft/blob/main/docs/3d-mouse.md 架构说明：https://github.com/tangency-labs/solidcraft/blob/main/docs/architecture.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  # 运行脚本导出STEP
cargo xtask ci                                     # 统一执行格式化、Clippy静态检查、单元测试、图标资源、静态资源、图层、Wasm编译

更多编译命令、Windows 跨平台编译、网页端构建文档：https://github.com/tangency-labs/solidcraft/blob/main/docs/building.md

AI 智能体对接（MCP）

solidcraft-cli mcp是一个 Model Context Protocol（MCP）服务端。 无界面模式下可以独立运行设计会话；加上 --connect参数，可以挂载到正在运行的图形客户端，实时看到建模过程。

Claude Code 接入方式：

claude mcp add solidcraft -- solidcraft-cli mcp

如果终端找不到 solidcraft-cli（旧版 Windows 安装包不会自动加入环境变量 PATH），需要填写完整路径，默认路径："C:\Program Files\SolidCraft\solidcraft-cli.exe"工具权限、访问规则、完整会话示例：https://github.com/tangency-labs/solidcraft/blob/main/docs/mcp.md

脚本

脚本本质是一段 JSON 数组，内容和 UI 调用的底层命令完全一致，通过 solidcraft-cli run执行。 格式说明与示例：https://github.com/tangency-labs/solidcraft/blob/main/docs/scripts.md 网页端也可以通过浏览器 API 驱动：https://github.com/tangency-labs/solidcraft/blob/main/docs/browser-api.md

参与贡献

欢迎参与开发。 贡献指南：https://github.com/tangency-labs/solidcraft/blob/main/CONTRIBUTING.md，包含编译测试流程、代码结构说明、干净开发规则、许可证约束、重点需要人手的方向。 待开发任务：https://github.com/tangency-labs/solidcraft/issues 交流社区：https://discord.gg/FtU4NQNVDH

赞助商

Blacksmith.sh SolidCraft 的持续集成 CI 资源由 Blacksmith.sh 赞助提供算力时长。

免责声明

本仓库所有文件按原样提供，不附带任何担保，Tangency Labs 与贡献者不对任何有害或非法使用承担责任。详情见：https://github.com/tangency-labs/solidcraft/blob/main/DISCLAIMER.md

许可证

二选一许可：MIT 或者 Apache-2.0。 开发遵循 AGENTS.md 规范；第三方代码与资源保留其原有版权与归属说明。 SolidCraft 是独立项目。产品设计思路基于公开文档、通用 CAD 行业规范与用户反馈。参考测试使用理论解析值以及开源工具。 SolidCraft 和 Autodesk、达索、PTC、西门子等任何 CAD 厂商没有隶属、赞助或背书关系。Fusion、AutoCAD、Inventor、SolidWorks、Onshape、Creo、Blender、Tinkercad 均为各自所有者的商标，文中仅用于说明兼容性。详情见 NOTICE 文件。