AI 3D建模工具： Tripo 3D | Meshy AI
一句话结论：一般"text-to-3D"给你的是一个 mesh；Text-to-CAD 给的是代码。这个 MIT 许可的开源插件让你正在用的 coding agent（Claude Code、Codex、Cursor、Gemini、Grok）写参数化 Python 模型（build123d），生成精确的 STEP 几何，再派生 STL / 3MF / GLB、标注图纸、DXF、G-code，甚至直接送到 Bambu Lab 打印机。它的关键设计不是"生成"，而是让 agent 自己证明零件是对的。
CAD 在线查看器3D 模型查看器
本文完整编译 dev.to 文章《Text-to-CAD: Open-Source AI CAD Generator for Claude Code》（2026-10-15），并做中文整理与边界核对。
一、CAD as Code：为什么它写 Python 而不是生成网格
Text-to-CAD 的核心选择是生成程序而不是网格：agent 写出参数化的 Python 模型（用 build123d），运行后得到 STEP 文件——精确的 B-rep 几何，FreeCAD、Fusion、SolidWorks 都能导入。想要打印件，就在同一个函数上叠加 @stl 或 @threemf 装饰器：网格是从精确模型派生出来的，而不是反过来。
参数化的直接好处：
- 想做宽一点？改
WIDTH重跑即可； - 模型是源码：进 git、改动是可读 diff、装配体由调用子模型构成；
- 技能里写死了可复现性要求：几何不得依赖未跟踪的时间、随机值、环境变量或工作目录——同一个脚本永远构建同一个零件。
二、Agent 必须证明零件是对的
"AI 说完成了"和"零件装得上"是两回事。这个技能把验证做成了工作流的显式步骤：
- 构建完成后，agent 要按需求里的尺寸、间隙、拓扑来选检查项，并且对保存下来的文件（而不是源）执行测量——用 build123d 原生几何测量；
- 至少渲染一张结果快照，并自己读图——技能原话是 "always render and read them yourself, never rely on the viewer for it"；
- 两句定调的话："计算失败不是通过"；"汇报单位、阈值、选中几何与未测试的需求"；
- 交接时必须列出输出文件、实际运行的检查、以及所有假设；对不熟悉的尺寸，记录它假设了什么；当缺失信息会实质改变结果时，问你而不是猜；失败要回源修复并重跑受影响的检查。
三、在查看器里点一个面，直接要求改它
插件自带 CAD Viewer（本地服务）：Claude Desktop 里以卡片形式出现在对话中，Codex 里是每个线程旁边的 CAD 标签页，终端 agent 里给你一个浏览器链接。
最巧的部分是选择会回流到对话里：你点一个面，查看器复制一个精确引用，例如 assembly.step#o1.2.f7——它钉死了那个已保存文件里的某一个面。agent 用 read_scene 打开文档、把引用解析成真实几何，于是知道"这个面"具体指哪。
Quick Edit 更进一步：你描述改动，查看器附上文件与引用；如果你在视图上手绘了标记，还会附上手绘 PNG——agent 被要求先看草图再动模型。相当于在图纸上圈一下、旁边写"这里加厚"。此外 agent 也有自己的"眼睛"：cad_screenshot 看你在看什么，cad_view 读你选了什么。
四、12 个技能：从螺栓到 Bambu Lab 打印机
| 技能 | 作用 |
|---|---|
| CAD | 从文字/图像创建与编辑模型；STEP 优先，另出 STL、3MF、GLB |
| step.parts | 查找现成 STEP 零件：螺丝、轴承、电机、连接器 |
| Engineering Drawing | 带视图、隐藏线、孔标注与标题栏的 PDF 标注图 |
| DXF | 2D 轮廓、模板、垫片与切割排版 |
| URDF | 机器人结构文件：link、joint、限位、惯性、mesh |
| SRDF | MoveIt 规划组、末端执行器、姿态与碰撞规则 |
| SDF | 仿真器模型与世界：物理、传感器、灯光 |
| SendCutSend | 上传前检查 DXF / STEP |
| DfAM Check | 3D 打印性：壁厚、悬垂、支撑体积、摆放方向 |
| DFM | 钣金、CNC、注塑评审，规则必须引用来源 |
| G-code | 用你自己的打印机预设调用 OrcaSlicer 切片 |
| Bambu Labs | 通过 Bambu Connect / Bambu Studio 发送打印任务 |
跨度是关键：一条机械臂项目会同时需要 CAD 零件、采购的舵机、给 ROS 的 URDF、以及打印出来的支架——Text-to-CAD 把整条链留在一个对话里。
五、真实零件与真实制造规则
两个技能把设计钉在物理世界里：
step.parts 是带 API 的可购买件目录。装配需要某个舵机、电机或紧固件时，agent 被要求先搜索目录，别急着发明占位件；先试别名与厂商名；目录公布 SHA-256 时校验下载的 STEP；如果最终退回简化的包络体，必须明说。
DFM 评审钣金 / CNC / 注塑，规则强调证据：
- 它是引导式评审技能，不是自动特征识别或制造认证引擎；无法执行的检查必须报告"不可用"；
- 供应商自己的规格优先于通用建议；冲突的规格要记录，而不是悄悄替你选一个；
- 每条采用的限制必须标注来源、版本、访问日期与单位；无法检查的规则要报缺，不得编造默认值；
- 绝不从渲染图的材质或颜色推断合金、树脂、强度或板材厚度；
- 注塑场景由脚本从网格测量拔模角、倒扣与投影面积。
3D 打印另有 DfAM Check 按工艺测打印性；G-code / Bambu Labs 技能则把检查过的模型一路送到打印。
六、机器人：URDF / SRDF / SDF
机器人描述文件冗长、严格、通常手工写。这里由 CAD 技能提供真实几何产出的 mesh，而不是目测的替代品：
- URDF：link/joint、限位、惯性、mesh，ROS 标准格式；
- SRDF：MoveIt 的语义层——规划组、末端执行器、命名姿态、忽略哪些碰撞；
- SDF：仿真器模型与世界——物理、传感器、灯光。
三者都是 XML，需要程序化检查时可以转成 JSON 再处理。
七、安装（以及三个容易踩的坑）
最简安装：把一句话发给你的 agent：
Install text-to-cad from https://github.com/earthtojake/text-to-cad
手动安装需要先有 uv（Astral 的 Python 包管理器），Claude Code 里：
claude plugin marketplace add earthtojake/text-to-cad#latest
claude plugin install text-to-cad@earthtojake
重启应用，首次启动会下载 CAD 运行时（需要网络）。Codex 从插件目录安装，Gemini 用 --auto-update 装扩展，Cursor 和 Grok Build 可直接复用 Claude Code 插件。任何支持 skills 框架的 agent 可以只装技能：
npx skills add earthtojake/text-to-cad#latest
README 里的三条提示：
- 插件和技能只装一个，否则每个技能加载两遍；
- 命令用
latest分支（只收已发布版本）；省略会装main，可能含未发布内容； - 更新技能要重跑
npx skills add，而不是npx skills update（后者会静默漏掉新增技能）。
Windows 11 已知问题：CAD 内核的 Python 绑定带一个未签名的原生模块，Windows 11 全新安装默认开启的 Smart App Control 会拦截它，所有命令报 ImportError: DLL load failed while importing OCP。它没有"按应用例外"：要么关闭 Smart App Control（只能靠重装 Windows 反转），要么在 WSL 下跑 CAD 技能。cadgen doctor 能检测这一情况。
八、遥测默认开启：发什么、不发什么
Text-to-CAD 默认发送使用统计与崩溃报告，README 写得很细，装之前值得知道：
- 会发：版本、安装来源、操作系统与 agent 应用、计数（各 CAD 工具调用次数、构建模型数、失败原因——从固定枚举里选，不发错误消息原文）；崩溃报告含错误类型与 cadgen 内部失败位置。全部带随机安装 ID，存 PostHog；服务器从 IP 推导国家但不保存 IP。
- 不会发：文件名、路径、文件内容、提示词。
- 关闭方式：
uvx cadgen telemetry off（同时删除已发送数据）、查看器菜单，或让 agent 执行；DO_NOT_TRACK=1可对单个进程关闭。CI 与开发安装不发；全功能可离线使用。另有每天最多一次的匿名版本检查，CADGEN_UPDATE_CHECK=0可关。
九、项目健康度与适合谁
截至原文写作时：仓库创建于 2026-04-22，18,586 星、1,848 fork、1,453 次提交、20 位贡献者；迭代很快——v0.7.17/18/19 都在 2026-10-08 ~ 09 发布，cadgen 包在 PyPI 上已有 57 个版本；有 CI 测试工作流、文档站与 Discord。
适合：做功能性零件的人——支架、外壳、安装座、夹具、机器人部件，以及任何尺寸重要的东西；有 3D 打印机的 maker；不想手写 URDF 的机器人开发者；想要一个能在常用 CAD 里继续编辑的参数化起点的工程师。
不适合：有机/雕刻形状（角色、手办）——那是 mesh 系 text-to-3D 生成器的战场；也不能代替制造商的签核——DFM 技能明确只是引导式评审，不是认证。另外就是上面 Windows 11 的坑。
最后，原文特别澄清：它与 Zoo 的商业 Text-to-CAD 是两回事，earthtojake/text-to-cad 是独立开源插件，在本地 agent 里运行。
十、给工程团队的提醒
- 这套东西的价值在约束而不是"生成速度"：STEP 优先、参数化源码、可复现性要求、验证后交接——每一条都在把 AI 输出拉回工程纪律；
- 但纪律要靠人检查：DFM 不是认证、失败计算不是通过、目录里找不到的零件必须明说——这三句话恰恰说明自动化边界在哪；
- 模型的"眼睛"（渲染快照 + 自己读图）和你的眼睛（查看器 + 手绘标记）是互补的；最终签核仍然是人。
来源
- dev.to, Text-to-CAD: Open-Source AI CAD Generator for Claude Code（2026-10-15）：https://dev.to/itxtayab/text-to-cad-open-source-ai-cad-generator-for-claude-code-4722
- 项目仓库：https://github.com/earthtojake/text-to-cad
同主题阅读
- BIM vs CAD：什么时候该把架构工作流往上抬一级
- 多色 3MF 为什么在别的软件里变成灰模型：解码 Bambu Studio 的 paint_color
- glTF / GLB 完全指南：格式、压缩与在线查看
- 专题：AI × 3D / 生成式 AI 完全指南
本文由 BimAnt 编译整理，转载请注明出处。
本文属于「AI × 3D」专题。查看专题全部文章 →
