ARTICLE · 1184101

1.8万星神级插件,一句话让 Agent 造出可 3D 打印的模型!

发布时间：2026-10-15 07:19:00 最近访问：2026-10-15 07:19:01

大家好呀，我是开源食谱～

今天这篇教程手把手教你怎么给自己的 Agent 装上 CAD 本领，不是让 AI 给你一段 Python 伪代码，而是真能吐出 STEP、STL、能拿去 3D 打印、能出带尺寸的工程图。项目叫 text-to-cad，1.8 万星，MIT，把 OpenCascade 这套工业级几何内核交给了 Agent 去调。

1 这东西到底解决什么痛点

你大概也遇到过：跟 AI 说「帮我做个能 3D 打印的支架」，对方要么给你一段看不懂的 CADquery 代码，要么直接编。原因很简单，大模型本身不会画三维实体，缺的是一套能落地的几何内核。

text-to-cad 干的事，就是把这个内核（OpenCascade 加 build123d）包成一组技能，挂到你的 Agent 上。之后你用大白话下指令，Agent 调内核真把零件造出来。工程师和创客要的从来不是代码，是可生产的实体，这件死角被它补上了。

2 它到底怎么干活的

CAD 技能是主心骨。你用自然语言或丢一张图，text-to-cad 就把模型造出来、改出来，主输出 STEP，也能导出 STL、3MF、GLB。

配套一整套。step.parts 找现成标准件，螺丝、轴承、电机、连接器都能捞；Engineering Drawing 出带尺寸的工程图 PDF；DXF 画二维轮廓；URDF、SRDF、SDF 写机器人结构和仿真世界。

制造链路也接上了。DfAM Check 查可打印性，壁厚、悬垂、支撑体积一项项量；DFM 按钣金、CNC、注塑逐条评审并甩出实测证据；G-code 用 OrcaSlicer 切片；Bambu Labs 直接把活儿发到打印机。

3 详细搭建步骤

第一步，先装 uv

text-to-cad 的所有运行都走 uv。先确认装了（uv --version），没有就一行装好：

curl -LsSf https://astral.sh/uv/install.sh | sh

第二步，给 Claude Code 装上（最省事）

用插件市场一条命令加进来，重启 Claude Code，第一次启动会下载 CAD 运行时，所以要联网：

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

装好后，让 Agent「展示一个模型」，对话里就会冒出可旋转的查看卡片；在终端里则给一个浏览器链接。Cursor 只要你装了上一步的 Claude Code 插件就自动带上，不用重复装。

第三步，其他 Agent 与关遥测

Grok Build、Gemini 各一行插件或扩展命令，Codex 在插件目录点一下就行。没有插件支持的 Agent，用 Skills CLI 单独装技能：

npx skills add earthtojake/text-to-cad#latest

装完记得重启对应 App。默认开启的遥测（用法统计和崩溃上报）想关掉，一句 uvx cadgen telemetry off，它会把已发的数据也删掉。

4 装好能干啥

装完跟 Agent 聊就行，不用记任何命令。举个例子，跟 Agent 说「做个 M3 螺丝固定、壁厚 3mm 的 L 形支架」，Agent 出一张 STEP。接着说「检查能不能 FDM 打印」，DfAM 把壁厚、悬垂、支撑体积量出来告诉你。再说「出一张带尺寸的工程图」，Engineering Drawing 丢给你一份 PDF。最后说「直接发到 Bambu 打印」，Bambu Labs 技能把活儿递给打印机。

从一句话到实物，中间不用你开任何 CAD 软件。要改尺寸就接着聊，Agent 就地改模型重新出 STEP，迭代成本几乎为零。

5友情提示

泼点冷水：第一，Windows 11 默认开的 Smart App Control 会拦它底层的 OCP 原生模块，报 ImportError，要么关掉 SAC 要么走 WSL，cadgen doctor 会把这个情况点名。第二，它本质是 Agent 插件不是独立软件，第一次启动要联网拉运行时，之后离线也能干活。

第三，模型质量取决于你用的 LLM 和描述清不清楚，复杂装配、高精度公差还是得人审。第四，Bambu、G-code、SendCutSend 这几个技能要接外部服务账号，不是开箱即用。第五，遥测默认开，但文件、路径、提示词从不发送，一句命令就能关掉并删除已发数据。

最后总结一下

01 给 Agent 装上 CAD 本领：自然语言造 STEP、STL、3MF、GLB，不是伪代码。

02 12 个技能覆盖造模、找标准件、工程图、机器人文件、可打印性与 DFM 评审、切片与直发打印。

03 装法极简：uv 走起，Claude Code 一条插件命令，其他 Agent 一行或 npx skills add。

04 MIT、1.8 万星、2026 年开源、持续更新；支持 Claude Code、Codex、Cursor、Gemini、Grok 等主流 Agent。

05 边界：Windows SAC 拦原生模块、首启需联网、质量看 LLM、外部技能需账号、遥测可关。

开源地址

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

1.8 万星 / Python / MIT，2026 年开源，2026 年 10 月 8 日仍在更新