项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- Rust 1.95 或更高版本(桌面与 Web UI 构建;核心 workspace 最低要求 Rust 1.90)
- 可用的 Cargo 构建环境(随 Rust 工具链安装)
- 如需 Web 版:安装 trunk(trunkrs.dev)
- 支持 macOS、Windows、Linux、FreeBSD,或浏览器 WebAssembly
安装与启动步骤
-
1克隆仓库
把 cadcraft 源码拉取到本地,需要能访问 GitHub。
git clone https://github.com/storytold/cadcraft -
2进入项目目录
后续所有 cargo 命令都在仓库根目录执行。
cd cadcraft -
3编译并打开示例图纸
用 release 模式编译 cadcraft 桌面程序并加载示例图纸,首次编译较慢。
cargo run --release -p cadcraft -- --sample -
4在命令行试绘图
程序启动后在命令行逐条输入,按提示拾取对象完成操作。
line 0,0 @10,0 @0,5 c circle 5,2 1 offset 0.25 zoom e -
5构建 Web 版(可选)
需要先安装 trunk,然后在 web 应用目录启动开发服务器。
cd apps/cadcraft-web && trunk serve -
6headless 转换与导出(可选)
用 cadcraft-cli 一次性执行脚本、导出 DXF/PNG,或转换格式。
cadcraft-cli run --sample --script 'CIRCLE 22,3 1 ' --save out.dxf --export out.png -
7桥接运行中的实例(可选)
先用 --control 7979 启动应用,再用 CLI 的 mcp 子命令连接。
cadcraft-cli mcp --connect 127.0.0.1:7979
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--sample | 否 | 启动时直接打开内置示例图纸,便于快速体验 | --sample |
--control | 否 | 指定控制端口,供 cadcraft-cli 远程桥接 | 7979 |
--script | 否 | headless 模式下要执行的命令脚本 | 'CIRCLE 22,3 1
' |
--save | 否 | 把绘图结果保存为 DXF 文件 | out.dxf |
--export | 否 | 把绘图结果导出为图片 | out.png |
如何确认成功
cargo 编译无报错并弹出绘图窗口显示示例图纸;命令行输入 line、circle 等能看到图形变化。
常见问题
Q:编译报错提示 Rust 版本过低怎么办?
A:桌面与 Web UI 构建需要 Rust 1.95 及以上,核心 workspace 最低 1.90,请先升级 Rust 工具链再重新编译。
Q:trunk serve 提示命令找不到?
A:Web 构建依赖 trunk,先按 trunkrs.dev 的说明安装 trunk,再进入 apps/cadcraft-web 目录运行。
Q:CLI 如何连接已打开的程序?
A:启动桌面程序时加上 --control 7979,然后执行 cadcraft-cli mcp --connect 127.0.0.1:7979。
Q:能直接在浏览器里用吗?
A:可以,项目支持 WebAssembly 构建,通过 apps/cadcraft-web 的 trunk serve 在浏览器运行。
注意事项
- 首次 release 编译耗时较长,属于正常现象。
- README 未给出 trunk 的具体安装命令,请参考 trunkrs.dev 官方说明。
- 命令行绘图命令需在应用启动后逐条输入,不是 shell 命令。
- cadcraft-cli 的具体安装方式 README 未说明,若命令不可用需自行从仓库构建。
核心亮点
- 纯 Rust 实现,内存安全且无 GC,性能与跨平台潜力好
- 采用 AutoCAD 风格命令式交互,老 CAD 用户上手成本低
- 干净室开源实现,便于学习 CAD 内核架构与二次开发
不足之处
- 项目处于成长阶段,功能完整度和稳定性尚待验证
- 生态与插件、文件格式兼容性相比成熟 CAD 仍有差距
适用场景
- 工程师在 Linux/macOS 上进行轻量二维制图与草图绘制
- 学生和开发者学习 CAD 内核原理并参与开源贡献
- 需要自主可控、可定制 CAD 工具链的团队做内部工具基础
替代项目
LibreCAD、FreeCAD
上一篇:intent
下一篇:没有了!
同类项目推荐
open-design
开源
让 AI 代工做界面,本地跑完随手改
The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create···
Excalidraw
开源
开源虚拟白板协作工具
Virtual whiteboard for sketching hand-drawn like diagrams
morph
开源
用数据直接生成设计、动画和交互可视化
Morph is a free and open-source tool for creating designs, animations or interactive···
ChatGPT-MidJourney-prompt
开源
输入一句话,AI帮你生成Midjourney完整提示词
This is a ChatGPT based prompt generation model for MidJorney. The purpose of this m···
