夜雨聆风学习资料网

ARTICLE · 1398011

跟CAD软件搏斗几天?1.9万星text-to-cad,让AI直接画可制造的3D模型

跟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)

●01项目速览●●
项目名称
text-to-cad
GitHub 仓库
earthtojake/text-to-cad
Star / Fork
19,101 / 1,887
协议 / 语言
MIT / Python
最新版本
v0.7.20(2026-10-10)
创建时间
2026-04-22(至今约 5.5 个月)
一句话定位
给 AI Agent 装上本地 CAD 超能力
●02它不只是“文生图”,而是“文生可制造零件”●●

很多 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。

●0312 个 Agent 技能,覆盖从建模到上机●●

text-to-cad 把能力拆成 12 个 skills,Agent 按需调用。下面是官方 README 中的能力总览:

Skill
作用
CAD
用自然语言或图片生成 STEP、STL、3MF、GLB
step.parts
查找螺丝、轴承、电机等现成 STEP 标准件
Engineering Drawing
生成带视图、尺寸、孔标注的 PDF 工程图
DXF
生成 2D DXF 轮廓、模板、垫片、切割布局
URDF
生成机器人结构文件:links、joints、limits、inertials
SRDF
为 URDF 添加 MoveIt 规划组、末端执行器、姿态
SDF
生成仿真器模型与世界:frames、physics、sensors、lights
SendCutSend
上传 SendCutSend 前检查 DXF / STEP
DfAM Check
测量壁厚、悬空、支撑体积、打印朝向
DFM
评估钣金 / CNC / 注塑可行性并给出量化证据
G-code
用 OrcaSlicer 切片生成打印机就绪 G-code
Bambu Labs
通过 Bambu Connect / Studio 直接发送打印任务
●04安装只要一条命令●●

对 Claude Code 用户,最简路径是走插件市场;其他 Agent 可用 Skills CLI。底层运行时都是通过 uv 管理的 cadgen,首次启动会自动下载 CAD 内核。

bash
# 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#latest
注意

README 强调:不要用 pip install cadgen 当作文本生成工具装——cadgen 只是底层运行时,真正带来 Agent 集成的是插件或 skills。

●05从文本到机床的链路●●

一个典型流程可以是:用自然语言描述零件 → CAD skill 生成 STEP → DfAM Check 测量壁厚与悬空 → DFM 评估加工工艺 → G-code skill 用 OrcaSlicer 切片 → Bambu Labs skill 发送打印任务。整个过程默认在本地完成:模型、代码、路径都在本机,只有遥测和版本检查需要联网(均可关闭)。

●06诚实边界:这些坑官方文档也写了●●

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,不托管你的模型或数据。
●07适合谁,不适合谁●●

适合:机械工程师、机器人开发者、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

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料