字节笔记本
2026年10月3日 · 约 5 分钟读完
对 agent 说一句话，拿到能送厂的 CAD 图纸
让 AI 画个示意图很容易，让它产出真正能进车间加工的 CAD 模型，过去要靠工程师手工建模再反复改。earthtojake 的 text-to-cad 把这中间的整条链路做成了 agent 技能库：对 agent 说一句话，拿到 STEP 工程文件、工艺审查报告，甚至直接切好片送进 3D 打印机。仓库 16.6 千星，MIT 协议，作者把它做成 Codex 插件发布后在 X 上拿了 600 多个赞。
项目简介
text-to-cad 的本质是一套面向 CAD 制造场景的 agent skills 集合，共 12 个技能，全部本地运行。几何内核用的是 OpenCASCADE 的 Python 绑定 OCP，建模层跑 build123d，命令行工具 cadgen 发在 PyPI 上统一管理版本，Claude Desktop 走的就是 cadgen 的 MCP 服务器接入。它不是又一个文生 3D 的玩具模型生成器，产出的都是带精确尺寸、可以直接进 CAD 软件继续编辑的工程文件。技能之间是流水线关系：CAD 技能出几何，审查技能挑毛病，切片技能送生产，agent 会根据你的问题自己决定调用哪几个。
核心功能
生成与出图。 CAD 技能从自然语言或图片生成模型，主输出是 STEP，可选导出 STL、3MF 和 GLB；工程图技能从零件直接产出带尺寸标注、隐藏线、孔位标注和标题栏的 PDF 图纸；DXF 技能负责二维轮廓、垫片和下料排版。
审查与选型。 DFM 技能按钣金、CNC、注塑三种工艺审查零件，每条结论都带测量证据和引用的工艺规则原文，比如拔模角度不够、 undercut 位置、投影面积超限都会从网格上实际量出来再下结论；DfAM Check 逐项测壁厚、悬垂、支撑体积和打印朝向，给出支撑用量估计；step.parts 负责找螺丝、轴承、电机这类现货标准件的 STEP 文件，能买现成的就不开机床。审查报告最值钱的地方在于可追溯，agent 说你有问题，你得能看到它是量出来的还是编的。
机器人方向。 URDF、SRDF、SDF 三个技能覆盖机器人描述文件和仿真世界：连杆、关节限位、惯量、MoveIt 规划组、碰撞规则、传感器和灯光一次配齐。
落地制造。 G-code 技能调用 OrcaSlicer 用你自己的打印机预设切片；Bambu Labs 技能通过 Bambu Connect 把任务直接发到拓竹打印机；SendCutSend 技能在上传前预检 DXF 和 STEP 文件。
和文生 3D 的区别
市面上的文生 3D 工具输出的是网格，看着像那么回事，尺寸一量全是错的，只能拿去做摆件。text-to-cad 走的是参数化建模这条路：agent 写的是 build123d 的 Python 代码，几何由 OpenCASCADE 内核精确计算，产出的 STEP 文件尺寸是真的，能导入 SolidWorks、Fusion 360 继续编辑，工程图上的标注也是从真实几何量出来的。代价是没有网格方案那种天马行空的造型能力，它做的是工程件，不是手办。
数据与隐私
插件默认在首次启动时询问是否上报匿名使用统计，内容只有安装 ID、版本、操作系统、各技能调用次数这类计数信息，明确承诺不碰文件名、路径、内容和提示词，也可以用 DO_NOT_TRACK=1 直接关闭。这套交代写在仓库的隐私政策里，做企业内部评估时可以直接引用。
快速上手
推荐的安装方式是 Skills CLI 一条命令：
npx skills add earthtojake/text-to-cadCodex 用户装插件体验最完整，0.142.0 版本起支持，装完侧栏多出 CAD 查看器，可以转动查看 agent 刚生成的模型：
codex plugin marketplace add earthtojake/text-to-cad
codex plugin add text-to-cad@earthtojakeClaude Code 和 Grok Build 也有对应插件安装命令，Claude Desktop 里模型以可交互卡片形式出现在聊天中，可以转动观察、选中特征再追加进提示词，agent 能读到你的选择。运行时依赖 uv，首次启动自动下载固定版本的 cadgen。两个已知的坑：Windows 11 的 Smart App Control 会拦截未签名的 OCP 原生模块，要么关闭该功能要么走 WSL，环境异常时先跑 cadgen doctor 自检；更新技能要用 add 命令而不是 update，后者会漏装新增的技能。
适合谁用
动手派创客是第一用户：从一句话到打印件，中间的建模、审查、切片全链路都有 agent 兜着。接零活的机械工程师值得把它当生产力工具，DFM 审查的逐条证据引用能让改模沟通省掉不少来回。做机器人的开发者则可以直接复用 URDF 到 SDF 的三件套。唯一的前提是你得愿意让 agent 碰真实图纸，毕竟它现在真的能把东西做出来。
