text-to-cad Skill:用自然语言让 AI Agent 生成真实可用的 3D 模型

text-to-cad Skill:用自然语言让 AI Agent 生成真实可用的 3D 模型

text-to-cad 是近期 GitHub Trending 上的新兴热门 Skill(2026-10-05 日榜 +83 stars),它为 AI 编程 Agent 赋予了 CAD 超能力——让 agent 用自然语言描述即可生成 STEP、GLB、STL、3MF 等格式的 3D 模型文件,同时支持设计可制造性(DFM)检查和工程图生成。一句话概括:把 AI agent 变成你的 3D 工程师,说一句话,它就输出可 3D 打印、可 CNC 加工的模型文件。目前已支持 Claude Code、Codex、Cursor、Gemini CLI 和 Grok Build,star 17,113,是 AI × CAD 垂直领域增长最快的开源项目。

功能与原则

text-to-cad 围绕四大核心能力构建:

  • 自然语言转 3D 模型:输入描述性文本,输出标准 CAD 格式文件(STEP/GLB/STL/3MF)
  • 设计可制造性检查(DFM):自动检测模型是否适合 3D 打印、钣金加工或 CNC 制造
  • 工程图生成:自动输出符合工业标准的 2D 工程图纸
  • 多格式导出与查看:内置 CAD 查看器,可在对话中直接以 3D 可交互卡片形式预览模型

设计原则强调本地优先:CAD 渲染核心通过 uv(astral 的 Python 包管理工具)本地运行,不依赖云端 API,数据完全私有。所有模型文件生成和查看都在用户本机完成。

认可度

  • GitHub Star:17,113 ⭐(截至 2026-10-05)
  • Forks:1,757
  • 今日增长:单日 +83 stars(2026-10-05 GitHub Trending 日榜)
  • GitHub Trending:2026-10-05 当日 AI/Developer Tools 分类 trending 常驻
  • 支持平台数:5 个主流 AI coding agent(Claude Code / Codex / Cursor / Gemini / Grok)

链接

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

原作者

earthtojake(Jake)— 独立开发者,专注于 AI × CAD 工具链。text-to-cad 是其核心项目,已在 GitHub 形成稳定的发布节奏和维护生态。

介绍

text-to-cad 解决的是一个实际痛点:传统 CAD 软件(SolidWorks、Fusion 360、FreeCAD)学习曲线陡峭,非工程师很难用自然语言直接生成想要的零件。而 text-to-cad 把这个门槛降到了零点——任何可以用自然语言描述形状的人,都可以让 AI agent 帮你生成 3D 模型。

它的技术架构分为两层:底层是 cadgen(通过 uvx 运行的 Python CAD 内核),上层是各个 AI agent 的插件接口(plugin 格式)。这意味着一次开发,多平台复用——安装一次,Claude Code、Codex、Cursor、Gemini 和 Grok Build 都能用。

CAD 查看器(CAD Viewer)是另一个亮点:Claude Code 对话里可以直接渲染 3D 模型卡片,用户能旋转、缩放,还能把选中的几何信息回传给 agent。这意味着 agent 不仅能”看见”模型,还能根据用户的反馈调整设计,形成真正的多轮对话式 3D 设计工作流。

支持的输出格式涵盖了工业界最常用的几种:STEP(国际标准交换格式,适合 CAD 间互导)、GLB/GLTF(Web 和游戏)、STL(3D 打印)、3MF(现代 3D 打印标准,带材料信息)。配合 DFM 检查,输出的模型直接就能拿去 3D 打印或 CNC 加工,不是”只能看不能用的 Demo”。

特点

  • 多 agent 平台支持:Claude Code、OpenAI Codex、Cursor、Gemini CLI、Grok Build 一个都不落
  • 本地推理:CAD 核心走 uvx 本地运行,不上云,数据完全私有
  • 原生 3D 查看器:对话内嵌可交互 3D 卡片,无需导出到外部软件预览
  • 多格式导出:STEP / GLB / STL / 3MF,覆盖 3D 打印、CNC、Web 全场景
  • DFM 自动化检查:自动验证模型是否符合 3D 打印/钣金/CNC 制造规范
  • 工程图生成:自动输出 2D 工程图纸,减少人工绘图工作量
  • 插件热更新:claude plugin update 一条命令即可升级到最新版本

使用方法

安装(以 Claude Code 为例)

# 添加 marketplace 并安装插件
claude plugin marketplace add earthtojake/text-to-cad
claude plugin install text-to-cad@earthtojake

# 重启 Claude Code,首次启动会自动下载 CAD 运行时

Claude Desktop(MCP 模式)

在 Settings > Developer > Edit Config 中添加:

{
  "mcpServers": {
    "cad": {
      "command": "uvx",
      "args": ["--no-config", "--managed-python", "--python", "3.13", "--from", "cadgen==0.7.14", "cadgen", "mcp"],
      "env": {"CADGEN_INSTALL_CHANNEL": "claude-desktop"}
    }
  }
}

Codex / Cursor / Grok Build

# Codex
codex plugin marketplace add earthtojake/text-to-cad
codex plugin add text-to-cad@earthtojake

# Grok Build
grok plugin install earthtojake/text-to-cad --trust
grok plugin enable text-to-cad

安装完成后,在 agent 对话中直接说”帮我设计一个 M8 六角螺母”或”生成一个 50x30x10mm 的盒子,底部带 3mm 圆角”,agent 就会调用 text-to-cad 生成 3D 模型文件。

使用场景与人群

适用场景:

  • 快速原型验证:工程师用自然语言描述想法,秒级生成可 3D 打印的模型
  • AI 编程工作流中的几何输出:agent 生成的代码附带可视化的 CAD 模型
  • 制造业设计沟通:非 CAD 专业人员的概念设计验证
  • 教育场景:学生用对话方式学习 3D 建模基础

目标用户:

  • 机械工程师、3D 打印爱好者
  • AI 编程 agent 用户(Claude Code / Codex / Cursor 等)
  • 独立创客和硬件创业者
  • 需要快速生成工程图纸的团队

输入与输出案例

案例 1:生成标准零件

  • Input:输入”a standard M8 hex nut, stainless steel, ISO 4032 dimensions”
  • Output:生成 M8_hex_nut.step 文件,可在任何 CAD 软件中打开,尺寸符合 ISO 4032 国际标准,同时自动附上 DFM 检查报告(通过/警告/失败)

案例 2:复杂装配体描述

  • Input:输入”design a simple phone stand: base 80x60x5mm, vertical arm 60mm tall at 75° angle, contact pad 30x10mm, all parts with 2mm fillets”
  • Output:生成包含底座、支架、接触垫三个零件的装配体 STEP 文件,可导出为 STL 直接 3D 打印。CAD Viewer 在对话中渲染可旋转的 3D 预览,用户可选择特定面让 agent 继续修改。

GitHub:https://github.com/earthtojake/text-to-cad | 17,113 ⭐截至 2026-10-05


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

评论区

0 条评论

登录后可评论。

Skill超级捕获手 18 阅读