earthtojake/text-to-cad · 上手攻略

  • 仓库：earthtojake/text-to-cad
  • 链接：https://github.com/earthtojake/text-to-cad
  • 分类：CAD / 工程设计 / Agent Skills
  • 作者：Jay
  • 更新：2026-08-06

是什么

text-to-cad 是一个面向 AI 编程 Agent（Claude Code、Codex 等）的 CAD/CAE/CAM 技能库——给 AI Agent 安装这些 Skills 后，你可以用自然语言让 Agent 直接生成 STEP、STL、DXF、URDF 等工程文件，甚至驱动 3D 打印和数控加工。

项目包含 11 个独立 Skills，覆盖从"文本/图片生成 CAD 模型"到"G-code 切片验证"到"SendCutSend 钣金加工文件检查"的全链路。底层 CAD 内核基于 build123d（OpenCascade Python 封装），生成的模型为参数化 Python 脚本而非手写 CAD 数据，可直接在 Agent 编辑器中修改和版本控制。

当前版本：main 分支为生产可用分支，develop 分支用于社区贡献。

解决什么问题

AI Agent 擅长写代码，但在工程设计领域缺乏"CAD 能力"——无法理解 STEP 文件格式、无法生成机器人 URDF、无法验证 G-code 安全性。text-to-cad 通过将工程知识封装为 Agent 可调用的 Skills，让 AI 在代码生成的同时输出可直接用于加工的 CAD 数据，解决"AI 生成设计 → 人工重画 CAD"的重复劳动。

快速安装

方式一：Skills CLI（推荐，适用于所有兼容 Agent）

npx skills install earthtojake/text-to-cad

安装后重启 Agent，新安装的 Skills 应自动出现。

方式二：Codex 插件安装（OpenAI Codex ≥ 0.142.0）

codex plugin marketplace add earthtojake/text-to-cad
codex plugin add cad@text-to-cad
# 需升级到最新版 Codex：npm install -g @openai/codex@latest

方式三：Claude Code 插件安装

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

⚠️ Codex < 0.142.0 会静默跳过插件，无错误提示，需先升级。Git LFS 大文件（benchmark GIF、CAD 资产）默认不下载，如需本地 benchmark 可运行 git lfs pull --include="benchmarks/**"。

核心 Skills 详解

CAD Skill（最核心）

用自然语言描述，生成可编辑的 build123d Python 脚本，输出 STEP/STL/3MF/GLB：

Prompt: Create a centered 100 x 60 x 20 mm block with four 8 mm vertical through-holes.
Add only a 2 mm chamfer on the top outer perimeter.

输出文件：models/rectangular_calibration_block.py（脚本）+ models/step/rectangular_calibration_block.step

Agent 可直接修改 Python 脚本调整尺寸，模型重建自动化。

CAD Viewer Skill

本地浏览器预览 CAD、G-code、机器人描述文件，无需安装 CAD 软件：

/cad-viewer open models/step/my_part.step

DXF Skill

从 Python 源或 CAD 几何创建 2D DXF 工程图（型材、模板、垫片、切割排版）：

Prompt: Create a DXF profile for a 200x100mm rectangular plate with a 50mm diameter central bore
and four 10mm bolt holes on a 150mm PCD.

URDF / SRDF Skill

生成机器人描述文件：

Prompt: Write a URDF for a 2-DOF planar robot arm with 300mm links and servo motors at each joint.

SRDF Skill 在 URDF 基础上添加 MoveIt 规划组、末端执行器、抓取姿态和碰撞规则。

G-code Skill

将 STL/3MF 切片为经过 slicer CLI 验证的 FDM G-code：

# 在 Claude Code / Codex 中
npx cad skills run gcode \
  --input models/stl/my_part.stl \
  --printer "Bambu Lab X1C" \
  --profile "0.20mm Optimal"

SendCutSend Skill

上传前自动检查 DXF/STEP 文件规范（壁厚、孔径、文件单位），避免因格式错误被 SendCutSend 退回：

/sendcutsend check models/dxf/my_enclosure.dxf

Bambu Labs Skill

将验证后的 G-code 干运行、本地上传、谨慎启动 Bambu Lab 打印机任务（带人工确认步骤）。

最小可跑命令

# 1. 安装 Skills CLI（Node.js 环境）
npm install -g @skills/cli   # 或用 npx 免装

# 2. 安装 CAD Skills
npx skills install earthtojake/text-to-cad

# 3. 在 Claude Code / Codex 中验证安装
npx skills list

# 4. 生成第一个 CAD 模型（在 Agent 对话中）
# Prompt: "Create a 50mm cube with a 10mm cylindrical hole through the center on Z axis"

# 5. 本地预览（需启动 CAD Viewer）
npx cad skills run cad-viewer --file models/step/output.step
# 依赖：Chrome/Chromium 浏览器（用于本地 WebGL 渲染）

硬件/环境要求： - Node.js ≥ 18（Skills CLI） - Python ≥ 3.9（build123d 依赖） - OpenCascade（build123d 底层，Linux/macOS 安装较简单，Windows 建议 WSL2） - CAD Viewer 需本地浏览器

典型适用场景

  1. 机械工程师 + AI 协作：用自然语言描述零件需求，Agent 生成 build123d 脚本 → 参数化修改 → 导出 STEP 交付加工。
  2. 机器人开发者：用 URDF/SRDF/SDF Skills 快速构建机器人描述文件，配合 MoveIt 或 Ignition Gazebo 仿真。
  3. 3D 打印爱好者：G-code Skill + Bambu Labs Skill 实现"描述零件 → 自动切片 → 打印"全流程。
  4. 硬件创业团队：SendCutSend Skill 直接检查钣金 DXF，减少与工厂的来回沟通成本。
  5. AI 编程 Agent 评测：使用仓库提供的 10 个 benchmark 评测用例（从校准块到行星齿轮），评估 Agent 的工程设计能力。

坑与注意

坑点 说明
Windows OpenCascade 安装复杂 build123d 依赖 OpenCascade，Windows 推荐 WSL2 或 Docker，避免在原生 Windows 调试
CAD Viewer 需本地浏览器 无头服务器（headless）无法使用 CAD Viewer Skill
Codex 版本门槛 0.142.0 旧版 Codex 静默跳过插件，不会报错
参数化脚本依赖 Python 生成的是 build123d Python 脚本而非直接 CAD 文件，需 Python 环境才能渲染
Implicit CAD Skill 为实验性 基于 GLSL signed-distance fields，渲染质量与标准 CAD 有差距
benchmark GIF 需 LFS fetch git lfs pull --include="benchmarks/**" 后才可本地查看

与同类对比

方案 定位 CAD 内核 多 Agent 支持 加工链
earthtojake/text-to-cad AI Agent CAD Skills build123d (OCCT) ✅ Claude Code / Codex ✅ SendCutSend / Bambu Labs
cad困厄/harness AI Agent CAD build123d ✅ Cursor / Claude Code 部分（需自拼）
OpenSCAD 脚本化 CAD 自研 ❌ ❌
Onshape 云端 CAD 自研 API 层有限 ❌

text-to-cad 的独特价值在于全链路工程化——不只是生成 CAD 文件，还覆盖了制造端（SendCutSend 钣金、G-code 切片、Bambu 打印）和机器人描述（URDF/SRDF/SDF），是当前 AI + 硬件领域覆盖最完整的开源 Agent Skills 库。

一句话推荐结论

AI Agent 的工程技能基座——如果你在用 Claude Code 或 Codex 做硬件相关开发，text-to-cad 是目前最完整的 CAD/CAE/CAM Skills 包，让 AI 直接输出可用于加工的工程文件而非图片或 JSON；上手需要 Python + OpenCascade 环境，但一旦跑通就真正实现了"说需求 → 得成品"的全流程。

来源：GitHub README（含 Skills 表格、benchmark 用例、Installation 说明）· cadskills.xyz · CONTRIBUTING.md 原始 commit/PR 链接：https://github.com/earthtojake/text-to-cad