text-to-cad 今日发布

text-to-cad 是一个开源的 AI Agent 技能库，专注于 CAD/CAE/CAM 领域。它将建筑信息模型、STEP 文件、STL 网格、机器人描述文件等工程资产的生成、检验、采购和交接工作封装为一组可被 AI 编程助手直接调用的专项技能。

技能简介

text-to-cad 由 earthtojake 开发维护，当前收录 11 个专项技能，涵盖从自然语言描述生成 CAD 模型、导出工业标准格式，到机器人运动规划文件编写、3D 打印切片等完整工程流程。项目在 GitHub 拥有超过 14,900 颗星，定位为 AI 编程助手（如 Claude Code、OpenAI Codex、Grok Build）的 CAD 领域能力扩展插件。

核心能力

text-to-cad 提供以下核心技能模块：

CAD 技能：接收自然语言描述或参考图片，生成 build123d Python 脚本，输出 STEP/STP（主要格式）以及 STL、3MF、GLB 等网格格式；内置几何检验、尺寸标注和快照对比功能。

CAD Viewer 技能：在本地浏览器中预览生成的 CAD 模型和机器人描述文件，无需专业 CAD 软件即可查看设计结果。

step.parts 技能：从标准件库中检索现成的 STEP 零件，如螺丝、轴承、电机、连接器等，支持直接插入装配体。

DXF 技能：生成 2D 工程图纸（DXF 格式），包括零件轮廓、板金展开图、垫片和切割排版图，支持从 CAD 几何直接投影生成。

URDF 技能：编写机器人结构描述文件，包含连杆（links）、关节（joints）、运动限制、惯量信息和网格引用，输出标准 URDF 格式。

SRDF/MoveIt2 技能：在 URDF 基础上添加 MoveIt 规划组、末端执行器、姿态和碰撞规则，生成完整的机器人运动规划配置。

SDF 技能：创建仿真世界模型，包含坐标系、物理属性、传感器和光源配置，输出标准 SDF 格式用于 Gazebo 等仿真器。

DfAM Check 技能：基于打印工艺（FDM/SLA 等）检验网格可打印性，分析壁厚、悬伸角度和支撑体积，给出优化建议。

G-code 技能：将已验证的网格文件切片为打印机专用 G-code，结合真实切片软件 CLI 并做预检验。

Bambu Labs 技能：对接 Bambu Lab 打印机，验证后上传并谨慎启动本地打印任务。

SendCutSend 技能：检验 DXF 和 STEP 文件是否符合 SendCutSend 加工规范，避免文件退回。

安装配置

安装 text-to-cad 技能库需要以下三个步骤：

第一步，安装 Skills CLI。Skills CLI 是 text-to-cad 官方推荐的安装工具，执行命令：npx skills add earthtojake/text-to-cad。该命令会将所有技能模块直接安装到当前编程助手支持的技能目录中。

第二步，安装 Python 依赖。进入 skills/cad 目录，执行 python -m pip install -r requirements.txt，安装 cadgen 运行时环境和 build123d 建模库。

第三步，安装浏览器渲染依赖。执行 python -m playwright install chromium，为 CAD Viewer 技能提供本地浏览器预览能力（Playwright Chromium）。

此外，项目也支持主流编程助手插件市场直接安装。Claude Code 用户执行：claude plugin marketplace add earthtojake/text-to-cad && claude plugin install cad@text-to-cad。OpenAI Codex 用户执行：codex plugin marketplace add earthtojake/text-to-cad && codex plugin add cad@text-to-cad。Grok Build 用户执行：grok plugin install earthtojake/text-to-cad --trust && grok plugin enable cad。

使用步骤

以 CAD 技能为例，典型使用流程如下：

第一步，描述需求。向编程助手说明需要创建的零件或装配体，例如创建一个 M5 螺丝配合的铝合金外壳，壁厚 2.5mm，顶部留有 50x30mm 透明视窗。

第二步，生成模型。CAD 技能自动调用 build123d 生成对应的 Python 建模脚本，执行后输出 STEP 文件，同时生成 STL 和 3MF 网格文件供 3D 打印使用。

第三步，本地预览。调用 CAD Viewer 技能，在本地浏览器中查看生成的 CAD 模型，检查几何是否正确、配合关系是否合理。

第四步，导出交付。通过 cadgen step inspect 命令对 STEP 文件进行几何检验和尺寸测量，确认无误后交付设计文件。

如需创建机器人描述文件，则将需求替换为生成一个双足机器人的 URDF 文件，包含躯干和两条腿的连杆与关节。如需打印，则先调用 DfAM Check 技能评估可打印性，再通过 G-code 技能生成打印机指令。

适用场景

text-to-cad 适用于以下典型场景：

机械设计快速原型：工程师用自然语言描述零件需求，AI 直接生成 CAD 模型脚本和 STEP 文件，大幅缩短概念验证阶段的建模时间。

3D 打印准备：创客和工程师将 STEP 或 STL 文件导入切片流程，DfAM Check 技能在打印前评估壁厚和悬伸是否合理，减少打印失败。

机器人开发：机器人工程师通过 URDF/SRDF/SDF 技能生成标准机器人描述文件，直接对接 MoveIt 运动规划和 Gazebo 仿真环境。

制造业协作：step.parts 技能帮助工程师快速检索标准件（轴承、螺丝等），将其插入装配体，减少重复建模工作。

建筑和工程图生成：DXF 技能支持从 3D 模型投影生成 2D 工程图纸，用于钣金加工或 CNC 切割。

适用人群

机械工程师和 CAD 设计师：需要频繁创建或修改零件模型的从业者，可用自然语言快速生成标准格式文件。

机器人工程师：从事机器人本体的建模、URDF 编写和仿真工作的开发者，text-to-cad 覆盖了完整的机器人描述文件链。

AI 编程助手重度用户：在 Claude Code、OpenAI Codex 等 AI 编程环境中工作的开发者，通过插件扩展 AI 的工程制图能力。

3D 打印爱好者和创客：需要将创意快速转化为可打印模型的用户，特别是需要检验可打印性的非专业设计师。

工作原理

text-to-cad 的核心是 cadgen 运行时库，它将自然语言指令转换为 build123d Python 建模脚本。build123d 是一个基于 OpenCASCADE 的构造实体几何（CSG）库，支持参数化建模和精确的几何运算。

当用户向 AI 助手描述 CAD 需求时，CAD 技能会解析自然语言中的几何关键词（孔、倒角、切除、扫描等），生成符合 build123d 规范的 Python 建模代码，执行脚本输出 STEP 文件，调用 CAD Viewer 在浏览器中渲染预览，最后通过 cadgen step inspect 做几何验证。

各专项技能（如 URDF、DXF、G-code 等）都遵循相同的架构：以 Python 脚本为中间态，通过标准 CLI 工具链完成格式转换和验证，最终输出符合行业标准的工程文件。

官方链接

官网文档：https://www.texttocad.dev

GitHub 仓库：https://github.com/earthtojake/text-to-cad