项目速览earthtojake/text-to-cad是一个开源的 AI Agent 技能集合专注于将自然语言转化为工程级 CAD 模型与机器人设计文件而非仅生成视觉 3D 预览。GitHub 数据截至 2026-05-28约5k Star、584 ForkMIT 协议JavaScript 主语言。定位为 Codex、Claude Code、Gemini CLI、OpenClaw 等编码 Agent 提供硬件工程技能包。官网 / 演示文档 cadskills.xyz在线演示 demo.cadskills.xyz。Skills CLI 工具详情见 skills.sh。核心能力1. 文本生成工程化 CAD输入自然语言如 100×60×20mm 矩形块四角 M6 通孔顶部倒角 2mmAI 生成可执行的 build123d Python 代码而非网格模型。代码驱动设计可回溯、可编辑、可参数化调整符合工业设计流程。2. 多格式工业导出支持 STEP / STL / 3MF / DXF / GLB / URDF / SRDF / SDF 等直接用于 3D 打印、仿真、机器人开发。3. CAD Explorer可视化浏览器预览模型、检查几何 / 拓扑、测量尺寸、查看装配关系。支持cad[...]几何引用便于 Agent 精准迭代修改。4. 标准件库集成可从 step.parts catalog 直接调用现成标准件螺栓、轴承、电子元件等避免重复建模。5. 本地化运行无后端依赖本地执行、数据安全支持离线工作流。技术原理核心架构LLM → build123d 代码 → OpenCASCADE 内核 → 工程文件。层级组件说明LLM 层Claude / Gemini / Codex理解文本并生成参数化 CAD 代码建模层build123dPython基于 OpenCASCADE 构建参数化、可编辑的 B-Rep 模型导出层统一输出保留完整设计意图与参数输出 STEP 等工业格式核心优势生成的是设计程序而非图像支持版本控制、参数迭代、工程验证。安装text-to-cad(Codex/OpenCode等)执行npx agent-skills-cli add earthtojake/text-to-cad上下箭头再按空格选择目前暂时不直接支持Hermes但可以通过软链接映射给Hermes接下来会自动克隆项目然后选择skills安装同样上下箭头配合空格键进行选择默认直接回车选全部安装FreeCAD打开https://www.freecad.org/downloads.php根据系统选择对应版本下载下载后进行安装并打开language可以设置为中文Opencode画CAD用opencode测试画cad图可以看到ai在读cad的skill文件ai自动创建虚拟环境和安装cad的python框架build123dAI编写六轴机械臂的代码生成cad文件并验证生成图像等轴测视图来看并没有画出机器人至少需要连接机械臂在freeCAD点击左上角第二个图标选择cad文件点击open打开默认方式导入点击ok查看默认是看上视图点击组件会显示名称和坐标信息点击上视图四个箭头可以看其他视图整体来看离预期有较大差别更换为具有视觉能力的多模态模型修改比如Kimi-K2.6和MiMo-V2.5等MiMO-V2.5修改了一会的结果看起来与预期仍有较大差距调整提示词继续要求修改中间改了好几次还得提醒检查坐标计算而不是盲目大幅度修改这是修改过程中比较接近的机械臂下面是改了几个小时最终结果看起来终于令人满意但仍有不足比如转其他方向看可以发现仍有本应该连接的地方存在缝隙安装text-to-cad(Hermes)如果要给Hermes可以复制到刚才安装cad相关的skills复制到Hermes的skills文件夹。但为了方便管理skills节省空间采用软链接的方法把/.opencode/skills的移动到/.agents/skills再把/.codex/skills和/.opencode/skills关于关于cad的skills删除执行以下命令进行软链接映射Mac和linux适用skills(cad render sdf sendcutsend srdf step-parts urdf) for skill in ${skills[]}; do ln -s ~/.agents/skills/$skill ~/.hermes/skills/$skill ln -s ~/.agents/skills/$skill ~/.codex/skills/$skill donewindows参考用命令for %i in (cad render sdf sendcutsend srdf step-parts urdf) do ( mklink /D %USERPROFILE%\.hermes\skills\%i %USERPROFILE%\.agents\skills\%i mklink /D %USERPROFILE%\.codex\skills\%i %USERPROFILE%\.agents\skills\%i )Hermes画CAD启动Hermes提问ai能不能看到cad相关的skillai找到了要求ai画工业机器人的cadai参考openclaw的cad代码生成成功AI采用resend的skill通过CAD Explorer启动网页cd /Users/Zhuanz/.hermes/skills/render npm --prefix scripts/viewer run dev:ensure -- --workspace-root /Users/Zhuanz --file industrial_robot.step打开http://127.0.0.1:4178/?fileindustrial_robot.step看起来效果还可以总结与建议维度评价易用性安装简单Agent 直接调用门槛低于传统 CAD 软件精度最终可达工程级但复杂模型需反复迭代迭代效率代码驱动 cad[...]引用修改比传统 GUI 更快当前局限复杂装配体仍需人工检查坐标、连接缝隙等细节给新手的建议提示词要具体不要说“画个机械臂”要说明关节数量如6轴、各臂长度如L1120mmL2100mm、连接方式如绕Y轴旋转、安装孔位置等。越接近工程图纸的描述AI生成的代码越靠谱。善用多模态模型纯文本模型容易在空间关系上出错有视觉能力的模型如 Kimi-K2.6、MiMo-V2.5能直接“看到”生成的STEP预览更快发现几何错位、比例失调等问题。CAD专业软件是必备验证工具 人工编辑实操AI生成的STEP务必导入FreeCAD等专业软件检查等轴测图看不出的缝隙换个视角就暴露了。发现问题后不必从头重跑AI可以人工修复1移动/旋转零件用FreeCAD的“Transform”工具手动对齐错位的关节2修补缝隙使用“Part → Create shape from mesh”或“Defeaturing”填补细小间隙3调整尺寸双击AI生成的build123d代码中的参数如length120改为125重新导出即可4装配约束用“A2plus”工作台添加真实约束替代AI不准确的坐标堆叠人工编辑AI迭代混合使用效率远高于纯靠AI反复抽卡。善用软链接管理 skills多个Agent共用同一套skills省空间、易更新Mac/Linux用ln -sWindows用mklink /D。text-to-cad 不是一键出图的魔法但它确实把 CAD 的设计门槛从精通软件操作降到了会写提示词 懂基础几何。对于机械工程师、机器人开发者、产品设计师来说这无疑是 AI 时代最值得尝试的工具之一。创作不易禁止抄袭转载请附上原文链接及标题
OpenCode/Hermes画工业机器人CAD（含安装和演示）：用 text-to-cad 把自然语言变成工程图纸
项目速览earthtojake/text-to-cad是一个开源的 AI Agent 技能集合专注于将自然语言转化为工程级 CAD 模型与机器人设计文件而非仅生成视觉 3D 预览。GitHub 数据截至 2026-05-28约5k Star、584 ForkMIT 协议JavaScript 主语言。定位为 Codex、Claude Code、Gemini CLI、OpenClaw 等编码 Agent 提供硬件工程技能包。官网 / 演示文档 cadskills.xyz在线演示 demo.cadskills.xyz。Skills CLI 工具详情见 skills.sh。核心能力1. 文本生成工程化 CAD输入自然语言如 100×60×20mm 矩形块四角 M6 通孔顶部倒角 2mmAI 生成可执行的 build123d Python 代码而非网格模型。代码驱动设计可回溯、可编辑、可参数化调整符合工业设计流程。2. 多格式工业导出支持 STEP / STL / 3MF / DXF / GLB / URDF / SRDF / SDF 等直接用于 3D 打印、仿真、机器人开发。3. CAD Explorer可视化浏览器预览模型、检查几何 / 拓扑、测量尺寸、查看装配关系。支持cad[...]几何引用便于 Agent 精准迭代修改。4. 标准件库集成可从 step.parts catalog 直接调用现成标准件螺栓、轴承、电子元件等避免重复建模。5. 本地化运行无后端依赖本地执行、数据安全支持离线工作流。技术原理核心架构LLM → build123d 代码 → OpenCASCADE 内核 → 工程文件。层级组件说明LLM 层Claude / Gemini / Codex理解文本并生成参数化 CAD 代码建模层build123dPython基于 OpenCASCADE 构建参数化、可编辑的 B-Rep 模型导出层统一输出保留完整设计意图与参数输出 STEP 等工业格式核心优势生成的是设计程序而非图像支持版本控制、参数迭代、工程验证。安装text-to-cad(Codex/OpenCode等)执行npx agent-skills-cli add earthtojake/text-to-cad上下箭头再按空格选择目前暂时不直接支持Hermes但可以通过软链接映射给Hermes接下来会自动克隆项目然后选择skills安装同样上下箭头配合空格键进行选择默认直接回车选全部安装FreeCAD打开https://www.freecad.org/downloads.php根据系统选择对应版本下载下载后进行安装并打开language可以设置为中文Opencode画CAD用opencode测试画cad图可以看到ai在读cad的skill文件ai自动创建虚拟环境和安装cad的python框架build123dAI编写六轴机械臂的代码生成cad文件并验证生成图像等轴测视图来看并没有画出机器人至少需要连接机械臂在freeCAD点击左上角第二个图标选择cad文件点击open打开默认方式导入点击ok查看默认是看上视图点击组件会显示名称和坐标信息点击上视图四个箭头可以看其他视图整体来看离预期有较大差别更换为具有视觉能力的多模态模型修改比如Kimi-K2.6和MiMo-V2.5等MiMO-V2.5修改了一会的结果看起来与预期仍有较大差距调整提示词继续要求修改中间改了好几次还得提醒检查坐标计算而不是盲目大幅度修改这是修改过程中比较接近的机械臂下面是改了几个小时最终结果看起来终于令人满意但仍有不足比如转其他方向看可以发现仍有本应该连接的地方存在缝隙安装text-to-cad(Hermes)如果要给Hermes可以复制到刚才安装cad相关的skills复制到Hermes的skills文件夹。但为了方便管理skills节省空间采用软链接的方法把/.opencode/skills的移动到/.agents/skills再把/.codex/skills和/.opencode/skills关于关于cad的skills删除执行以下命令进行软链接映射Mac和linux适用skills(cad render sdf sendcutsend srdf step-parts urdf) for skill in ${skills[]}; do ln -s ~/.agents/skills/$skill ~/.hermes/skills/$skill ln -s ~/.agents/skills/$skill ~/.codex/skills/$skill donewindows参考用命令for %i in (cad render sdf sendcutsend srdf step-parts urdf) do ( mklink /D %USERPROFILE%\.hermes\skills\%i %USERPROFILE%\.agents\skills\%i mklink /D %USERPROFILE%\.codex\skills\%i %USERPROFILE%\.agents\skills\%i )Hermes画CAD启动Hermes提问ai能不能看到cad相关的skillai找到了要求ai画工业机器人的cadai参考openclaw的cad代码生成成功AI采用resend的skill通过CAD Explorer启动网页cd /Users/Zhuanz/.hermes/skills/render npm --prefix scripts/viewer run dev:ensure -- --workspace-root /Users/Zhuanz --file industrial_robot.step打开http://127.0.0.1:4178/?fileindustrial_robot.step看起来效果还可以总结与建议维度评价易用性安装简单Agent 直接调用门槛低于传统 CAD 软件精度最终可达工程级但复杂模型需反复迭代迭代效率代码驱动 cad[...]引用修改比传统 GUI 更快当前局限复杂装配体仍需人工检查坐标、连接缝隙等细节给新手的建议提示词要具体不要说“画个机械臂”要说明关节数量如6轴、各臂长度如L1120mmL2100mm、连接方式如绕Y轴旋转、安装孔位置等。越接近工程图纸的描述AI生成的代码越靠谱。善用多模态模型纯文本模型容易在空间关系上出错有视觉能力的模型如 Kimi-K2.6、MiMo-V2.5能直接“看到”生成的STEP预览更快发现几何错位、比例失调等问题。CAD专业软件是必备验证工具 人工编辑实操AI生成的STEP务必导入FreeCAD等专业软件检查等轴测图看不出的缝隙换个视角就暴露了。发现问题后不必从头重跑AI可以人工修复1移动/旋转零件用FreeCAD的“Transform”工具手动对齐错位的关节2修补缝隙使用“Part → Create shape from mesh”或“Defeaturing”填补细小间隙3调整尺寸双击AI生成的build123d代码中的参数如length120改为125重新导出即可4装配约束用“A2plus”工作台添加真实约束替代AI不准确的坐标堆叠人工编辑AI迭代混合使用效率远高于纯靠AI反复抽卡。善用软链接管理 skills多个Agent共用同一套skills省空间、易更新Mac/Linux用ln -sWindows用mklink /D。text-to-cad 不是一键出图的魔法但它确实把 CAD 的设计门槛从精通软件操作降到了会写提示词 懂基础几何。对于机械工程师、机器人开发者、产品设计师来说这无疑是 AI 时代最值得尝试的工具之一。创作不易禁止抄袭转载请附上原文链接及标题
