text-to-cad：让智能体用文字生成可导出的 CAD 模型

想让编码智能体直接产出一个能送去 3D 打印或加工的零件，光有模型还不够：要能导出常见格式，要能先检查能不能做出来，最好还附上一张给加工方看的图纸。text-to-cad 是一个 MIT 许可的开源项目，把这些能力做成 Claude Code、Codex、Cursor、Gemini、Grok 等智能体可以安装的插件，其他智能体则可以只装 skills。装好后，智能体在本机生成 STEP、GLB、STL 或 3MF 文件。CAD 内核是 OpenCascade 的 Python 绑定 OCP，README 的徽章标出 build123d 0.11 和 Open CASCADE 7.9。

核心功能

text-to-cad 的功能按 README 里的 skill 划分，下面几项是读者最可能先用到的。

• 以 STEP 为主，同时导出 GLB、STL 和 3MF：CAD skill 的主要输出是 STEP，README 写明同一个模型还能导出 STL、3MF 和 GLB。
• DFM 检查附带依据：DFM skill 针对钣金、CNC 加工和注塑审查零件，README 说每条结论都附有测量证据和引用的规则。
• 打印前检查可打性：DfAM Check 按工艺测量网格的壁厚、悬垂、支撑体积和摆放方向。
• PDF 工程图：Engineering Drawing skill 从零件生成带尺寸、孔标注和标题栏的 PDF 图纸。
• 对接加工和打印服务：SendCutSend skill 在上传前检查 DXF 与 STEP 文件；G-code skill 用 OrcaSlicer 按你自己的打印机预设切片；Bambu Labs skill 通过 Bambu Connect、Bambu Lab 官方应用或 Bambu Studio 发送打印任务。
• 机器人与仿真文件：URDF、SRDF 和 SDF 三个 skill 分别编写机器人结构、MoveIt 规划组和仿真模型。

典型使用场景

text-to-cad 适合下面几类工作，每一类都对应 README 里的一组 skill。

• 要把零件交给钣金或 CNC 加工厂的工程师：先用 DFM skill 审查，再用 Engineering Drawing skill 出 PDF 图纸，最后用 SendCutSend skill 检查 DXF 或 STEP 文件，然后再上传下单。
• 自己 3D 打印零件的人：用 DfAM Check 看壁厚、悬垂和摆放方向，再用 G-code skill 切片，或者用 Bambu Labs skill 发送到 Bambu Lab 打印机。
• 需要 2D 切割图的人：DXF skill 从 Python 源或 CAD 几何生成轮廓、模板和垫片图。
• 做机器人或仿真的开发者：用 URDF 写连杆、关节和限位，用 SRDF 加上 MoveIt 规划组和碰撞规则，再用 SDF 搭建仿真世界。

同属 3D 建模类的条目还有 floorplan-3d，两者的输入和用途不同，可以对照着看。

快速上手

text-to-cad 在不同智能体应用里的安装命令不一样。下面是 README 给出的 Claude Code 版本：

claude plugin marketplace add earthtojake/text-to-cad#latest
claude plugin install text-to-cad@earthtojake

装之前先确认本机有 uv，运行 uv --version 能输出版本号即可。重启 Claude Code 后，第一次启动会下载 CAD 运行时，需要联网。然后让智能体显示一个模型：在能显示视图卡片的应用里，模型会直接出现在对话中；在终端这类环境里，你会拿到一个链接，在浏览器中打开 CAD Viewer。

小结

text-to-cad 适合已经在用上述智能体、想让它直接产出 STEP 文件和工程图的人，尤其是要在打印或下单前先过一遍可制造性检查的小批量零件。它不适合只想要传统 CAD 界面的人，检查结果也不能当作加工厂的最终审核。GitHub 把主语言标为 Python，许可证为 MIT。仓库创建于 2026-04-22，最近一次推送是 2026-10-20，未归档；截至 2026-10-21，有 22,043 颗星。

有几件事要先知道。第一，遥测默认开启：README 写明 CAD 应用、浏览器查看器和构建守护进程会发送使用统计和崩溃报告，附带随机安装 ID，不含文件名、路径、内容或提示词，可用 uvx cadgen telemetry off 关闭。第二，Windows 11 的 Smart App Control 会拦截未签名的 OCP 原生模块，报错为 ImportError: DLL load failed while importing OCP；README 给出的办法是关闭它（关闭后只能重装 Windows 才能再开），或在 WSL 里运行 CAD skill。第三，Claude Desktop 的配置把 cadgen 版本写死在 args 里（README 示例为 0.7.26），升级要手动改。第四，README 对 DFM 和 DfAM Check 的描述都是几何测量，没有提到公差或材料。我们只核对了 README、LICENSE 和仓库元数据，没有安装运行，因此没有检验生成模型的质量。