⭐⭐⭐ Spring Boot 项目实战 ⭐⭐⭐ Spring Cloud 项目实战
《Dubbo 实现原理与源码解析 —— 精品合集》 《Netty 实现原理与源码解析 —— 精品合集》
《Spring 实现原理与源码解析 —— 精品合集》 《MyBatis 实现原理与源码解析 —— 精品合集》
《Spring MVC 实现原理与源码解析 —— 精品合集》 《数据库实体设计合集》
《Spring Boot 实现原理与源码解析 —— 精品合集》 《Java 面试题 + Java 学习指南》

摘要: 原创出处 http://www.iocoder.cn/Fight/text-to-cad-v2-agent-skill/ 「芋道源码」欢迎转载,保留摘要,谢谢!


🙂🙂🙂关注微信公众号:【芋道源码】有福利:

  1. RocketMQ / MyCAT / Sharding-JDBC 所有源码分析文章列表
  2. RocketMQ / MyCAT / Sharding-JDBC 中文注释源码 GitHub 地址
  3. 您对于源码的疑问每条留言都将得到认真回复。甚至不知道如何读源码也可以请教噢。
  4. 新的源码解析文章实时收到通知。每周更新一篇左右。
  5. 认真的源码交流微信群。

在 AI 里说一句「帮我画一个模数 2、19 齿的直齿轮」,它就在本地生成一个 STEP 文件。浏览器里能直接转着看,觉得哪里不对,补一句「齿宽加厚到 15mm」,它改完再生成一遍。

这是 text-to-cad 干的事。它让 Claude Code、Codex、Cursor、Gemini 这些助手长出画三维模型的手。MIT 协议,仓库现在两万一 Star。

它不是一个网站

很多人看到这名字,第一反应是个在线服务。

不是。它不用注册,也没有服务器替你算,装完就是一个 Skill。建模跑在你自己的机器上,模型文件也不出门。

官方品牌图,Give your agent CAD superpowers

它下面真正干活的是 build123d,一个 Python 写的参数化建模库,再往下是 OpenCASCADE 这个几何内核,工业上用了很多年的东西。text-to-cad 在中间搭了个架子,AI 看懂你说的话,写一段 build123d 代码,跑一遍,几何就出来了。

仓库首页实时截图,Star 与 Fork 计数同时可见

因为模型是代码跑出来的,产物能进 Git,改动都有记录。单人玩家感受不深,几个人一起改结构就不一样了。

画完之后,东西接不接得住

这是我看这个项目最想先说的一点。

现在能让 AI 画出个模型的东西不少,难点从来不在渲染图好不好看,在于画完之后那份东西,下一道工序接不接得住。

官方演示,从一句话到模型

text-to-cad 在这件事上的答案是主输出 STEP。STEP 是正经的工业交换格式,拿到手能直接丢进 SolidWorks 或 Fusion 360 继续改,不是那种只能看不能碰的网格文件。

需要打出来,它导 STL 或 3MF。需要在浏览器里看,导 GLB。

判断它行不行,别看渲染图,看那份 STEP 明天能不能直接上机床。

十二个技能和二十多个入口

装完,助手会多出十二个技能。这不是按功能堆的清单,是按工序排的。

用得最多的是 CAD 本身,一句话或者一张参考图描述零件,出 STEP。往下游走,还有这么几类。

  • 工程图,能出带视图、隐藏线、尺寸、孔标注、标题栏的 PDF,能直接给车间看
  • DXF,二维切割图,垫片、面板、激光切割排版用得上
  • 机器人三个,URDF 管结构,SRDF 管 MoveIt 的运动规划,SDF 管 Gazebo 仿真场景
  • step.parts,查现成标准件,螺丝、轴承、电机、连接器,直接拿别人的 STEP 用
  • 可制造性检查其实是两个,DfAM 查打印方向,DFM 查钣金、CNC、注塑
  • G-code,调 OrcaSlicer 切片,还能把打印任务发给拓竹的机器

官网首页,支持二十多个 AI 助手

我最看重的是可制造性检查这一环。画完一个件要发去打样,壁厚够不够、哪里要加拔模斜度,这些核查挺费时间。现在可以让 AI 先跑一遍,报告里每条结论都带测量数据和所引的规则,有问题的地方改起来快得多。

整条链上只有它在做判断,前面几步都在生成,花钱之前就告诉你行不行。

装之前,有两个坑

安装不复杂,但有两件事得先知道。

第一件,先备好 uv。整套东西靠它拉依赖,uv --version 能出版本号就行。

第二件,插件和技能二选一。都装的话每个技能会出现两遍。

Claude Code 走插件市场。

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

Codex 也是同一套。

codex plugin marketplace add earthtojake/text-to-cad --ref latest
codex plugin add text-to-cad@earthtojake

Codex 的市场名从 text-to-cad 改成过 earthtojake,加过旧的要先 codex plugin marketplace remove text-to-cad。

Cursor 和 Grok 直接复用 Claude Code 的插件,Gemini 走 extensions。都不在名单里也没关系,支持 skills 框架就行。

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

重启就能用。第一次启动要联网下运行时。

Windows 11 还有个系统级的坑。Smart App Control 默认拦截 OpenCASCADE 那个没签名的原生模块,一装就报 DLL 加载失败,而且没有按应用放行的选项,只能关掉它或者在 WSL 里跑。

关掉之前想清楚,关了就只剩重装系统这一条路。

安装说明页

Codex 读取技能过程

哪些活它接不住

用了一段时间,说几个真实的天花板。

AI 会画错,尺寸对不上、结构不合理都会有。重要的件还得工程师自己复核,README 里也强调了。它更适合出方案、验证想法、批量生成标准件。

复杂装配体还是弱项。单个零件、简单配合问题不大,零件一多约束关系复杂起来,还是要人上手调。

生成效果也看你用哪个模型。模型强,代码质量高,改两轮就能用;模型弱,同样的需求得多磨几轮。

还有一件事。官方默认开了使用统计,会发使用频次、失败原因、构建数和时耗,带一个随机安装 ID。文件名、路径、内容和提示词都不发。想关掉用 uvx cadgen telemetry off,关了还会把已发的内容删掉。

所以「本地」这两个字要拆开看,你的模型不出门,但使用统计默认出门。两件事,可以分开处理。

L 形支架查看器效果

值不值得装一个

AI 写代码不稀奇了,硬件设计还是手工活多。text-to-cad 把建模、工程图、切片打印串起来了,至少证明这条路能走通。

指望它替代 SolidWorks,现在肯定不行,差得还远。但搞硬件的、玩 3D 打印的、做机器人的,值得装一个放着。尤其对精度要求不高的东西,这个效率提升是实打实的。

项目地址是 https://github.com/earthtojake/text-to-cad,MIT 协议。

文章目录
  1. 1. 它不是一个网站
  2. 2. 画完之后,东西接不接得住
  3. 3. 十二个技能和二十多个入口
  4. 4. 装之前,有两个坑
  5. 5. 哪些活它接不住
  6. 6. 值不值得装一个