text-to-cad 是什么?

text-to-cad 是 MIT 许可的 CAD、CAE、CAM 与机器人 Agent Skills 集合。Agent 根据自然语言编辑 Python CAD 源码,用 build123d/OpenCascade 生成 STEP 等 B-rep 产物,并提供本地预览、工程图、DFM、URDF/SRDF/SDF 和现货零件流程。

⭐ 7,367 Stars 🍴 869 Forks JavaScript MIT 作者: earthtojake
来源:github.com/earthtojake/text-to-cad/blob/main/README.md;https://github… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

v0.6.6 于 2026-09-21 发布,增加统一 DFM 技能和由零件投影生成的 PDF 工程图。

来源:github.com/earthtojake/text-to-cad/releases/tag/v0.6.6

核心功能

代码式 B-rep CAD

CAD 技能用 build123d/OCP 创建可编辑实体,以 STEP 为主要输出,并可导出 STL、3MF 和 GLB;源代码与派生产物可一起版本管理。

来源:github.com/earthtojake/text-to-cad/blob/main/README.md;https://github…
本地查看与几何引用

CAD Viewer 为 STEP 和机器人文件提供本地浏览,@cad[...] 引用把后续修改绑定到具体几何,而不是只靠模糊位置描述。

来源:github.com/earthtojake/text-to-cad/blob/main/README.md
制造检查和工程图

v0.6.6 的 DFM 技能覆盖钣金、CNC 和注塑检查,Engineering Drawing 从零件生成带视图、尺寸、孔标注和标题栏的 PDF。

来源:github.com/earthtojake/text-to-cad/releases/tag/v0.6.6;https://github…
机器人描述工作流

独立技能处理 URDF、SRDF/MoveIt2 和 SDF,覆盖 link、joint、limit、碰撞几何、语义组和仿真描述。

来源:github.com/earthtojake/text-to-cad/blob/main/README.md

技术架构

每个 skills/* 目录包含 SKILL.md、参考资料、脚本和固定的 cadgen 依赖。Agent 先写或改 Python/build123d 源文件,再调用本地 OCP 几何内核生成 STEP、网格、DXF、工程图或机器人描述,最后通过 Viewer 和检查脚本复核。技能可由 Skills CLI 安装,也可作为 Codex、Claude Code 或 Grok 插件安装。

来源:github.com/earthtojake/text-to-cad/blob/main/README.md;https://github…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) text-to-cad v0.6.6text-to-cad v0… Python 环境与 cadgen 固定版本Python 环境与 c… Node.js/npx 用于 Skills CLINode.js/npx 用… 可选本地 Viewer Codex 插件方式要求 Codex 0.142.0+Codex 插件方式… 代码式 B-rep CAD 本地查看与几何引用 制造检查和工程图 机器人描述工作流 text-to-cad 项目本体 核心功能 关键依赖

技术栈

语言Python CAD 源码与 Markdown/YAML 技能框架build123d、OpenCascade/OCP、cadgen 与 Agent Skills
text-to-cad v0.6.6Python 环境与 cadgen 固定版本Node.js/npx 用于 Skills CLI可选本地 ViewerCodex 插件方式要求 Codex 0.142.0+
CAD 内核和预览可在本机运行;所选 Agent 模型仍可能通过云端处理提示与源文件。Windows Smart App Control 可能阻止未签名 OCP 原生模块
来源:github.com/earthtojake/text-to-cad/blob/main/README.md;https://github…

快速上手

优先用 npx skills add earthtojake/text-to-cad 安装,重启 Agent 后在隔离项目创建 Python 环境。让 Agent 生成一个带明确毫米尺寸的简单块体、四个通孔和倒角,保留源码并导出 STEP;再运行实体检查、打开本地 Viewer,逐项测量外形、孔径、孔距和倒角。
来源:github.com/earthtojake/text-to-cad/blob/main/README.md;https://github…

使用场景

适合可版本化的机械零件、夹具、简单装配、工程图、DXF、机器人描述和制造前检查。它不能替代工程签核:实体闭合只说明几何检查的一部分,尺寸、公差、材料、载荷、刀具可达性、壁厚、装配干涉和机器参数仍需专业人员确认。

来源:github.com/earthtojake/text-to-cad/blob/main/skills/cad/SKILL.md;http…

优势与局限

优势

  • 输出 STEP 和可编辑 Python 源码,不只生成展示网格
  • 技能覆盖预览、工程图、DFM、DXF 和机器人描述
  • B-rep 结果可以用本地工具测量与检查

局限

  • Agent 生成的几何和工程图仍可能尺寸错误或漏掉设计意图
  • 代码式 CAD 对不熟悉 Python/build123d 的用户有门槛
  • 所选 Agent 可能把提示、源码或参考图发送到云端
  • Windows Smart App Control 可能阻止 OCP;关闭后只能重装 Windows 才能重新启用,优先考虑 WSL
  • Skills CLI 的 add 会覆盖已安装技能,更新前应审查差异
  • 3D 打印、CNC 或注塑前仍需材料、强度、公差和工艺审核
  • 本轮未安装依赖或生成模型
来源:github.com/earthtojake/text-to-cad/blob/main/README.md;https://github…

最新版本

v0.6.6 于 2026-09-21 发布,加入统一 DFM 技能,覆盖钣金、CNC 与注塑,并加入从零件投影生成 PDF 的 Engineering Drawing 技能。

来源:github.com/earthtojake/text-to-cad/releases/tag/v0.6.6

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对官方 README、CAD SKILL、requirements、LICENSE 与 v0.6.6 Release  |  limitations: 未安装技能、Python/OCP/cadgen 或 Viewer,未生成 STEP、工程图、DXF 或机器人文件,未测量实体,也未运行制造检查  |  observed_output: v0.6.6 是最新 release,发布日期为 2026-09-21;该版新增 DFM 和 Engineering Drawing;README 当前给出 Skills CLI 与三种插件安装路径

来源:github.com/earthtojake/text-to-cad/releases/tag/v0.6.6;https://github…

同类项目对比

与 CADAM 对比:CADAM 是 GPLv3 的浏览器应用,用 Anthropic API 生成 OpenSCAD,浏览器用 WASM 和 Three.js 预览,可导出 STL、SCAD、DXF;text-to-cad 是安装到 Agent 的技能库,以 Python/build123d 和 STEP B-rep 为核心,还覆盖工程图、DFM 和机器人格式。快速网页式 OpenSCAD 试作可看 CADAM;需要源码化 STEP、测量检查和机器人交付链时评估 text-to-cad。

来源:github.com/Adam-CAD/CADAM/blob/main/README.md;https://github.com/eart…

总结评价

保留并优先改造。文章以可测量的简单零件为主线,明确本地 CAD 与云 Agent 的区别,并把制造前人工审核放在导出之后。

来源:github.com/earthtojake/text-to-cad/blob/main/README.md

常见问题

text-to-cad v0.6.6 只会生成 STL 网格吗?

不是。CAD 技能以 STEP B-rep 为主要输出,还能导出 STL、3MF、GLB 和拓扑数据;仓库另有 DXF、工程图和机器人描述技能。

text-to-cad 在本地运行就代表设计不会上传吗?

不一定。几何内核和 Viewer 可在本机运行,但 Agent 本身可能使用云模型并发送提示、源码或参考图。应按所选 Agent 和模型提供方核对数据边界。

Windows Smart App Control 阻止 OCP 时该怎么办?

官方建议考虑在 WSL 中运行。Smart App Control 没有单应用例外;关闭后通常只有重装 Windows 才能重新启用,因此不要把关闭系统保护当成轻率的第一步。

生成的 STEP 通过实体检查后能直接生产吗?

不能。还要人工核对尺寸、公差、材料、载荷、壁厚、刀具可达性、装配干涉和实际机器参数。闭合实体只是必要检查之一。

为什么更新时用 npx skills add 而不是只用 update?

README 说明 add 会重新获取并覆盖已安装技能,也会加入新版本新增的技能;update 只刷新锁文件中已有技能,可能漏掉新技能。更新前仍应审查来源和差异。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件