text-to-cad

text-to-cad 是由开发者 Jake（earthtojake）发起并持续维护的开源 CAD 智能体技能库，核心定位是“为 AI 编码代理赋予实体硬件设计能力——从一句自然语言描述到可制造的 STEP 文件、到经过校验的机器人描述文件，再到 CNC/钣金/3D 打印的制造就绪交付物”——它不满足于做一份简单的文本转 3D 模型脚本或零散的 CAD 代码示例，而是将 12 个文件级技能、覆盖 CAD 建模、工程图纸、DXF 切割、URDF/SRDF/SDF 机器人描述、制造预检、切片打印的全链路整合于一套完整的开源工具链中，全部配有 claude plugin install 或 npx skills add 一键安装、本地运行的 CAD Explorer 可视化浏览器、@cad[...] 几何引用系统，以及 MIT 开源协议。截至 2026 年 10 月，项目已获得 1,205+ GitHub Stars，最新版本 v0.7.15。

一、text-to-cad 是什么

text-to-cad 采用“文件级技能 + 本地 CAD 运行时 + 多 Agent 插件”三位一体的架构，通过 GitHub 完全开源发布，采用 MIT 许可证。项目由开发者 Jake（earthtojake）发起并持续维护，于 2026 年 4 月 22 日开源。其核心理念是“Give your agent CAD superpowers”——赋予 AI 编码代理设计实体硬件的能力，将自然语言指令与参数化 CAD 内核及机器人模型格式打通。

text-to-cad 的运作机制与市面常见的“文本转 3D 模型工具”有本质区别。它不满足于做一份“输入文字输出一个 3D 文件”的简单封装，而是一套以文件为目标的技能系统。每个技能都针对特定类型的 CAD 交付物——STEP 零件、工程图纸、DXF 切割文件、URDF 机器人描述、G-code 打印文件——提供专注的工作流。CAD 运行时通过 uv 管理，编译为本地运行的 Python 包（cadgen），底层基于 build123d 和 OpenCascade（OCP） 的 CAD 内核。插件为 Agent 应用带来技能和 CAD 的查看器——一个本地 MCP 服务器（cadgen mcp）。所有建模、校验、导出全部在本地完成，无后端依赖。

二、text-to-cad 能做什么

text-to-cad 的核心能力可以精炼地概括为：建、出、检、引、造，围绕这五大维度提供了从自然语言描述到制造就绪交付物的完整路径，覆盖 CAD 设计与制造预检的全方位需求，具体包括：

自然语言驱动的 CAD 建模（建） ——不是“手工拖拽特征树”，而是“用一句话描述你想要的零件”。CAD 技能从纯语言或图像请求创建和编辑 CAD 模型，以 STEP 为主要输出格式，同时支持导出 STL、3MF 和 GLB。step.parts 技能查找现成的 STEP 零件——螺钉、轴承、电机和连接器，让 Agent 无需从零建模即可复用标准件。

工程图纸与 DXF 切割文件生成（出） ——不是“只能生成 3D 模型”，而是“从 3D 到 2D 工程图和切割布局的全链路输出”。Engineering Drawing 技能从零件生成带尺寸的工程图纸 PDF——包含视图、隐藏线、尺寸标注、孔位标注和标题栏。DXF 技能从 Python 源码或 CAD 几何创建 2D DXF 图纸，适用于型材、模板、垫片和切割布局。

机器人描述文件与运动规划（检） ——不是“只能做静态零件”，而是“从机器人结构定义到运动规划的全栈支持”。URDF 技能编写包含连杆、关节、限位、惯量和网格引用的机器人结构文件。SRDF 技能为 URDF 添加 MoveIt 规划组、末端执行器、位姿和碰撞规则。SDF 技能创建包含坐标系、物理属性、传感器和光源的仿真器模型与世界。

几何引用与精确后续编辑（引） ——不是“每次编辑都要重新描述整个模型”，而是“用 @cad[...] 引用精确指向模型的特定几何特征”。工作流中的 Reference 步骤让用户复制稳定的 @cad[...] 引用，使 Agent 能够进行精确的后续编辑。这种“几何感知编辑”的设计，让 CAD 修改从“从头重来”升级为“精准手术”。

制造预检与切片打印（造） ——不是“生成模型就结束”，而是“从设计到制造的全链路预检”。DfAM Check 技能按工艺测量网格的可打印性——壁厚、悬垂、支撑体积和构建方向。DFM 技能审查零件的钣金、CNC 加工或注塑成型适用性，提供可测量的证据和每个发现背后的引用规则。G-code 技能用 OrcaSlicer 将模型切片为打印机就绪的 G-code，使用用户自己的打印机预设。Bambu Labs 技能通过 Bambu Connect 或 Bambu Studio 将打印任务发送到 Bambu Lab 打印机。SendCutSend 技能在上传前检查 DXF 和 STEP 文件是否符合 SendCutSend 的制造要求。

三、text-to-cad 适合谁用

text-to-cad 的内容设计使其适配各类希望通过 AI 编码代理进行实体硬件设计的开发者与工程师，核心聚焦那些“想让 AI 帮我设计零件但不想学 CAD 软件”的人群，主要涵盖以下几类：

硬件工程师与机械设计师——日常工作中需要设计支架、夹具、外壳、连接件等实体零件。text-to-cad 让工程师可以用自然语言描述需求，Agent 自动生成可制造的 STEP 文件，大幅缩短从想法到模型的迭代周期。

机器人开发者与研究者——需要创建和编辑 URDF/SRDF/SDF 机器人描述文件，进行运动规划和仿真。text-to-cad 的机器人描述技能覆盖了从连杆关节定义到 MoveIt 规划组配置的完整链路。

3D 打印爱好者与创客——需要将想法快速转化为可打印的 STL/3MF 文件，并完成切片和打印。text-to-cad 的 G-code 技能和 Bambu Labs 技能让从建模到打印的流程完全在 Agent 中完成。

AI 编码代理的重度使用者——已经在用 Claude Code、Codex、Cursor、Gemini 或 Grok 进行日常开发。text-to-cad 支持所有支持插件或 skills 框架的流行 Agent，安装后即可用自然语言驱动 CAD 工作流。

制造业从业者与 CNC 操作员——需要生成钣金切割布局、CNC 加工图纸，或上传前检查文件是否符合制造服务商的要求。DXF、DFM 和 SendCutSend 技能覆盖了制造预检的核心需求。

四、text-to-cad 的应用场景是什么

基于其内容设计与定位，text-to-cad 的应用场景主要围绕实体零件设计与制造、机器人描述文件生成、3D 打印全流程自动化、CNC/钣金切割预检，覆盖从个人创客到工程团队的多个场景，具体包括：

实体零件从描述到制造场景——工程师需要一个特定尺寸的安装支架，但不想打开 CAD 软件。用户向 Agent 描述需求（“一个 100mm × 60mm 的 L 型支架，带四个 M4 安装孔”），Agent 用 CAD 技能生成 STEP 文件，用 Engineering Drawing 技能出工程图，用 DFM 技能检查钣金可制造性，最后导出 DXF 用于激光切割。整个流程在对话中完成。

机器人描述与运动规划场景——机器人开发者需要为一个新设计的机械臂创建 URDF 文件。用户描述连杆长度、关节类型和运动范围，Agent 用 URDF 技能生成结构文件，用 SRDF 技能添加 MoveIt 规划组和碰撞规则，用 Robot Motion 技能进行逆运动学和路径规划测试。

3D 打印从建模到打印全流程场景——创客有一个产品外壳的想法。用户描述外观和尺寸，Agent 生成 3MF 文件，用 DfAM Check 检查壁厚和悬垂，用 G-code 技能切片为打印文件，用 Bambu Labs 技能直接发送到打印机。从想法到开始打印，全程在对话中完成。

标准件复用与快速装配场景——工程师需要设计一个包含螺钉、轴承和电机的装配体。step.parts 技能让 Agent 查找并复用现成的标准 STEP 零件，无需从零建模每个组件。

制造服务上传前预检场景——用户准备将 DXF 文件上传到 SendCutSend 进行钣金切割，但不确定文件是否符合要求。SendCutSend 技能在上传前检查 DXF 和 STEP 文件，避免因文件格式问题被退回。

五、text-to-cad 为什么值得关注

text-to-cad 之所以值得关注，核心在于它将“CAD 设计从专业软件的手工操作升级为 AI 编码代理的自然语言驱动工作流”，并具备“文件级技能架构、本地运行、多 Agent 支持、制造全链路覆盖、MIT 开源”的独特价值，具体体现在以下几点：

从“学 CAD 软件”到“说一句话”的范式革命。传统 CAD 设计需要学习 SolidWorks、Fusion 360 或 FreeCAD 的复杂界面和特征树操作，门槛高、周期长。text-to-cad 将设计入口从“手工建模”简化为“自然语言描述”——用户只需告诉 Agent 想要什么零件，Agent 自动完成建模、校验和导出。这种“描述即设计”的范式，大幅降低了实体硬件设计的门槛。

从“单一模型”到“12 个文件级技能”的覆盖广度。大多数文本转 CAD 工具只做“文字 → 3D 模型”这一件事。text-to-cad 提供了 12 个专注不同交付物的技能——CAD 建模、标准件查找、工程图纸、DXF 切割、URDF/SRDF/SDF 机器人描述、制造预检（DfAM/DFM）、G-code 切片、Bambu 打印、SendCutSend 预检。从 3D 到 2D、从设计到制造、从零件到机器人，覆盖了实体硬件设计的完整生命周期。

从“云端依赖”到“本地运行”的数据主权。text-to-cad 的 CAD 运行时通过 uv 在本地运行，所有建模、校验、导出全部在本地完成，无后端依赖。CAD Explorer 是本地运行的 Web 应用，用户的零件设计数据不出设备。这种“本地优先”的设计，让涉及产品设计机密的工作也可以放心使用 AI 辅助。

从“单 Agent”到“多 Agent 插件生态”的集成自由度。text-to-cad 支持所有支持插件或 skills 框架的流行 Agent——Claude Code、Codex、Cursor、Gemini 和 Grok。安装方式灵活：Claude Code 用户通过 claude plugin marketplace add 安装，Codex/Cursor 用户通过 npx skills add 安装。一次安装，在任何支持的 Agent 中都能使用同一套 CAD 技能。

从“手工检查”到“自动化制造预检”的工程严谨性。大多数 CAD 工具不检查“这个零件能不能造出来”。text-to-cad 的 DfAM Check 按工艺测量网格的可打印性——壁厚、悬垂、支撑体积和构建方向；DFM 审查钣金、CNC 加工或注塑成型适用性，提供可测量的证据和引用规则；SendCutSend 在上传前检查 DXF 和 STEP 文件。这种“设计即预检”的设计，让制造问题在提交给工厂之前就被发现。