项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- Rust 工具链与 cargo(README 的构建命令全部基于 cargo,需自行安装)
- 本地磁盘空间与网络,用于编译依赖并拉取仓库
- 构建网页版需额外安装 Trunk(README 给出 trunk build 命令)
- 如需读取 STEP 文件,准备本地 .step 文件路径
安装与启动步骤
-
1获取源码
把仓库克隆到本地,后续所有命令都需在仓库根目录执行。
git clone https://github.com/tangency-labs/solidcraft.git cd solidcraft -
2准备Rust工具链
README 未给安装命令,但所有构建都通过 cargo 执行,需先装好 Rust 环境。
-
3运行桌面示例
启动桌面版并加载自带的示例零件,首次会编译较久,可看到参数化模型窗口。
cargo run --release -p solidcraft -- --sample -
4打开STEP文件
把已有 STEP 文件作为新建设计打开,用于查看或继续编辑外部模型。
cargo run --release -p solidcraft -- part.step -
5查看命令注册表
列出 CLI 支持的全部命令,方便了解可脚本化的建模操作。
cargo run --release -p solidcraft-cli -- commands -
6建模导出STEP
按 JSON 描述执行建模并导出 STEP 文件,适合嵌入自动化流水线。
cargo run --release -p solidcraft-cli -- run examples/bracket.json --out bracket.step -
7渲染效果图
用 render 示例配置输出产品级效果图 PNG,也可用 snapshot 生成快照。
cargo run --release -p solidcraft-cli -- render examples/render-studio.json --out product.png -
8构建网页版
进入 web 应用目录用 Trunk 构建,默认 WebGPU,可在 URL 加 ?webgl 或 ?sample。
cd apps/solidcraft-web && trunk build --release --public-url ./
如何确认成功
执行桌面命令后弹出 SolidCraft 窗口并显示示例零件;CLI 命令生成 bracket.step、product.png 等输出文件即成功。
常见问题
Q:没有 Rust 环境能直接用吗
A:README 的构建命令全部依赖 cargo,需自行安装 Rust 工具链;也可改用官网 solidcraft.io/download 的成品包或在线版。
Q:Linux 上 3D 鼠标没反应
A:可运行 spacenavd 守护进程(读取 /var/run/spnav.sock),或为 hidraw 设备加带 uaccess 标签的 udev 规则后重载并重插设备。
Q:浏览器版打不开或渲染异常
A:默认走 WebGPU,不支持时在地址后加 ?webgl 使用 WebGL2;加 ?sample 可直接打开示例零件。
Q:Flatpak 版本识别不到 3D 鼠标
A:Flatpak 沙箱不暴露 hidraw 设备,目前只有原生构建版本支持 3D 鼠标。
Q:Firefox 里 3D 鼠标不可用
A:需先按文档 Getting started › 3D mouse in the browser 设置 3DxWare,网页端才能读到设备。
注意事项
- 所有 cargo 命令必须在克隆后的仓库根目录执行
- 首次编译为 release 模式耗时较长,属正常现象
- Windows 交叉构建使用 cargo xwin build --release --target x86_64-pc-windows-msvc -p solidcraft
- 修改图标资源后可用 cargo xtask icons 检查,完整校验为 cargo xtask ci
核心亮点
- 纯 Rust 实现,无 C++ 依赖,编译部署和跨平台分发更简单
- 同一套代码同时覆盖桌面与 WASM 网页端,降低多端维护成本
- 内置 BRep 内核与 STEP 支持,具备真实实体建模和格式交换能力
不足之处
- 项目较新,功能完整度和稳定性相比成熟 CAD 仍有差距
- 文档与教程偏少,新用户上手参数化建模流程有门槛
适用场景
- 个人或小团队在浏览器里快速做参数化零件建模
- 开发者把 CAD 建模能力嵌入自有 Web 应用或工具链
- AI 代理通过 MCP 自动生成和修改 3D 模型
替代项目
FreeCAD、OpenSCAD、CadQuery
上一篇:BANDORI-PET-REV
下一篇:aigcpanel
同类项目推荐
aigcpanel
开源
本地模型一键装,文本音频直接变数字人视频
AIGCPanel 是一个简单易用的一站式AI数字人系统,支持视频合成、声音合成、声音克隆,简化···
solidcraft
开源
纯 Rust 参数化 CAD,桌面网页都能建模,还能被 AI 自动驱动
SolidCraft: an open-source parametric 3D CAD application built in pure Rust. Desktop···
BANDORI-PET-REV
开源
BanG Dream! 角色住进桌面,50+ 角色随切随陪
BandoriPet 是一个基于 Live2D 和 PySide6 的开源桌面宠物项目,支持 50+ 位 BanG Dream! ···
dsh-blender-plugin
开源
AI 直连 Blender,说话就能建模调渲染
DSH × Blender 直连实时插件:15 个模型工具让 AI 驱动 GUI Blender;v2.5 活动状态置顶并···
robot-heads
开源
给 AI Agent 装个电视头,状态一眼看懂
Animated 3D robot heads for React: TV-headed bots with LED faces that show what your···
ldraw-nova
开源
用 AI Agent 自动拼出合法可搭的乐高数字模型
Agent tooling for generative LEGO models building, built with Astra and Opus 5.5, po···
ComfyUI_Sonic
开源
一张人像照加一段音频,在 ComfyUI 里生成会说话的数字人视频
Sonic is a method about ' Shifting Focus to Global Audio Perception in Portrait Anim···
一键瘦身 VRChat 模型,性能等级飙升轻松上传
d4rkpl4y3r's VRChat Avatar 3.0 optimizer
一张照片生成可实时驱动的 3D 数字人头
[NeurIPS 2024] Generalizable and Animatable Gaussian Head Avatar