📌 项目地址：earthtojake/text-to-cad | ⭐ 8,962 颗星 | 🔧 JavaScript | 📜 未标注
项目简介：为AI代理赋予CAD与硬件设计能力
text-to-cad 是一个专为AI代理设计的技能库，覆盖CAD建模、机器人描述文件生成、零件筛选、2D绘图和本地预览等任务。它的核心思路是将传统需要图形界面或专业软件的操作，拆解成可供语言模型调用的模块化“技能”（Skills），让代理通过自然语言或图像输入，自动产出STEP、STL、URDF等工程文件。
目前项目在GitHub获得近9000星，主要语言为JavaScript，文档和演示网站均已上线。
核心Skill一览
仓库内置7个技能，每个技能对应一整套工作流：
| 技能 | 功能 | 对应文件 |
|---|---|---|
| CAD | 从文本或图像创建/编辑CAD模型，输出STEP（默认）、STL、3MF、GLB | skills/cad/SKILL.md |
| CAD Viewer | 在本地浏览器中预览CAD、G-code、机器人文件 | skills/cad-viewer/SKILL.md |
| step.parts | 搜索标准件STEP模型（螺丝、轴承、电机、连接器等） | skills/step-parts/SKILL.md |
| DXF | 基于Python或CAD几何生成2D DXF图纸（轮廓、模板、切割布局等） | skills/dxf/SKILL.md |
| URDF | 编写机器人结构文件，包含连杆、关节、限位、惯性参数和网格 | skills/urdf/SKILL.md |
| SRDF | 为URDF添加MoveIt规划组、末端执行器、姿态和碰撞规则 | skills/srdf/SKILL.md |
| SDF | 创建模拟器模型 | skills/sdf/SKILL.md |
这些技能不是独立工具，而是供AI代理调用的API/技能描述集。代理可以通过自然语言指令，按顺序调用多个技能完成完整任务链，例如：“用CAD生成一个电机支架，搜索合适型号的螺丝，导出DXF切割图，最后生成URDF装配体”。
实际用法（参考官方文档）
项目本身不提供一键运行的命令行工具，而是需要将库集成到AI代理系统中。具体调用方式取决于你使用的代理框架（如LangChain、AutoGPT等）。每个技能文件夹下都有 SKILL.md 文件，详细说明了输入参数、输出格式和调用示例。
例如，在 skills/cad/SKILL.md 中你会找到如何让代理描述几何体、指定尺寸和公差，并最终生成STEP文件的指南。同样，skills/urdf/SKILL.md 会说明代理如何定义关节类型和惯性矩阵。
重要提示： 所有命令、API细节均以官方文档（cadskills.xyz）和各 SKILL.md 为准，直接使用前务必阅读原文。
与同类工具的不同
- 对比OpenSCAD / CadQuery： 它们是面向人类的编程式CAD工具，用户需学习特定语法；
text-to-cad则是面向AI代理的接口，代理可以自主调用底层CAD引擎，无需人工编写代码。 - 对比传统CAD软件（Fusion 360 / SolidWorks）： 这些需要图形界面操作，无法被AI代理直接集成；
text-to-cad提供的是无头、可编程的CAD能力，适合自动化工作流和机器人领域的设计-仿真循环。 - 独特价值： 它将机器人描述文件（URDF、SRDF、SDF）也纳入了同一技能库，使得从零件设计到仿真部署的链路可以在一个代理对话中完成，此前很少有项目将CAD和机器人建模统一为AI技能。
注意事项
- 许可证： 仓库根目录有
LICENSE文件，采用何种开源协议请自行查看，商用需确认条款。 - 局限性： 当前技能主要适用于中等复杂度的机械件和标准件排列，高精度曲面、复杂装配体可能需要人工介入。代理对几何描述的准确性依赖其底层LLM的推理能力，生成结果需要人工校验。
- 依赖环境： 运行CAD技能可能依赖本地CAD内核（如FreeCAD），或调用云端API，具体看实现方式，README中未明确说明，需在部署前确认环境配置。
- 适合人群： 正在开发“硬件设计助手”类AI产品的开发者；希望将机械设计流程自动化的研究人员；机器人领域需要快速生成URDF/SDF模型的团队。
如果你正在搭建一个能理解物理世界的AI代理，或者想用自然语言快速生成机械零件和机器人模型，text-to-cad 是目前最直接的入口。