ARTICLE · 1398011
跟CAD软件搏斗几天?1.9万星text-to-cad,让AI直接画可制造的3D模型
做机械设计的人早就习惯了“先学软件,再画图”:Fusion 360、SolidWorks、Onshape……每个都有陡峭的学习曲线。text-to-cad 想把这个顺序反过来——先描述你想要什么,再让 AI 去生成可编辑、可制造、可直接上机的 3D 模型。这个 MIT 协议的开源项目在 GitHub 上已经拿到 1.9 万星,最新 release v0.7.20(2026-10-10),创建至今不到 6 个月。

官方社交卡片:Give your agent CAD superpowers.(数据来源:texttocad.dev / GitHub)
很多 AI 3D 工具只输出一张好看但不可编辑的网格。text-to-cad 的核心差异在于“可制造”:它基于 build123d 和 Open CASCADE 7.9,生成的几何是带参数的实体模型,可导入常规 CAD 软件继续编辑。
输出格式覆盖 STEP、STL、3MF、GLB、DXF;流程也不止于建模。README 列出的链路包含设计可制造性检查(DfAM / DFM)、工程图输出,以及把 G-code 直接发给 Bambu Lab 打印机。也就是说,它试图把 CAD → CAE → CAM 的缝隙压到一个 Agent 会话里。

texttocad.dev 首页实时截图:版本 v0.7.20、GitHub 19,091 星、支持十余种 Agent。
text-to-cad 把能力拆成 12 个 skills,Agent 按需调用。下面是官方 README 中的能力总览:
对 Claude Code 用户,最简路径是走插件市场;其他 Agent 可用 Skills CLI。底层运行时都是通过 uv 管理的 cadgen,首次启动会自动下载 CAD 内核。
# Claude Code(推荐) claude plugin marketplace add earthtojake/text-to-cad#latest claude plugin install text-to-cad@earthtojake # 示例 prompt:给机器人底座设计一个 <M3 通孔>,输出 STEP # text-to-cad 会调用 CAD + DfAM Check,再决定能不能打印 # 通用 Skills CLI(支持 Claude Code / Codex / Cursor 等) npx skills add earthtojake/text-to-cad#latestREADME 强调:不要用 pip install cadgen 当作文本生成工具装——cadgen 只是底层运行时,真正带来 Agent 集成的是插件或 skills。
一个典型流程可以是:用自然语言描述零件 → CAD skill 生成 STEP → DfAM Check 测量壁厚与悬空 → DFM 评估加工工艺 → G-code skill 用 OrcaSlicer 切片 → Bambu Labs skill 发送打印任务。整个过程默认在本地完成:模型、代码、路径都在本机,只有遥测和版本检查需要联网(均可关闭)。
text-to-cad 解决了一个真实痛点,但它不是“零门槛神药”。官方 README 里明确划了几条边界:
- Windows 11 可能直接跑不起来。
底层 Open CASCADE 的 Python 绑定 OCP 带未签名原生模块,Windows 11 的 Smart App Control 会拦截,报错 ImportError: DLL load failed while importing OCP。解决方法是关闭 SAC(关闭后无法重新开启)或在 WSL 下运行。 - 遥测默认开启。
cadgen 会发送使用统计和崩溃报告,带随机 ID,不包含文件、路径或提示词。可用 uvx cadgen telemetry off或DO_NOT_TRACK=1关闭。 - 项目非常年轻。
2026-04-22 创建,到本文写作时已发布 81 个 release,迭代极快。接口、skill 命名和最佳实践都可能变,生产项目需要跟版本。 - 依赖前置条件。
需要 uv、Python 3.11+、Node.js 20+,首次运行还要下载 CAD 运行时。不是“装好即用”的纯前端工具。 - 它不是 SaaS。
官方定位是“be the protocol, not the platform”——分发靠 PyPI wheel + Skills CLI,不托管你的模型或数据。
适合:机械工程师、机器人开发者、maker,以及已经在用 Claude Code / Codex / Cursor 等 AI Agent 的用户。如果你经常要画标准件、改机器人 URDF、出工程图或切片打印,这个工具能把反复切软件的流程压进一段对话。
不太适合:希望“开箱即用”零配置、Windows 11 Smart App Control 无法关闭、或对本地遥测敏感且不愿手动关闭的用户。它目前仍更像“给折腾型开发者准备的 CAD 底座”。
相关链接
GitHub 仓库:github.com/earthtojake/text-to-cad
官方网站:www.texttocad.dev
PyPI 运行时:pypi.org/project/cadgen















































































