文字转CAD工具text-to-cad-ui快速上手指南：3步把一句描述变成可用的3D模型

文字转CAD工具text-to-cad-ui快速上手指南：3步把一句描述变成可用的3D模型

【免费下载链接】text-to-cad-uiA lightweight UI for interacting with the Zoo Text-to-CAD API.项目地址: https://gitcode.com/gh_mirrors/te/text-to-cad-ui

深夜十一点，你终于画完了那个连接件的草图，却发现还要花半小时在软件里重新建模；你想给新买的3D打印机做个齿轮，却卡在"从零画起"的第一步。这样的时刻，一款叫 text-to-cad-ui 的免费开源文字转CAD工具，可能就是你想找的答案——它用自然语言把设计想法直接变成3D模型文件，不用学任何复杂建模软件。

它到底解决了什么问题：把"画图"变成"打字"

传统CAD建模像学做菜：你得先记住各种"刀法"（拉伸、倒角、阵列），才能处理一个零件。而 text-to-cad-ui 的思路完全不同——它像一位听得懂人话的厨师，你说"来一份模数2、19齿的直齿轮"，它就真的给你端出一盘。

它本质上是 Zoo Text-to-CAD API 的轻量级前端界面，你负责用一句话描述需求，它负责把这句话翻译成精确的三维几何。前端采用 SvelteKit 构建，整个项目开源可随意改造。最直观的证明来自官方演示图：一句"A SPUR GEAR WITH 19 TEETH"，几秒后就生成对应的齿轮模型，旁边还有"15点星形""螺旋斜齿轮"等案例。

3分钟完成本地部署的完整步骤

上手比想象中简单，全程只需要三步，前提是你电脑上装好了 Node.js。

第一步：拿到代码

打开终端执行：

git clone https://gitcode.com/gh_mirrors/te/text-to-cad-ui cd text-to-cad-ui

第二步：配置API连接

复制环境配置示例文件，并填入你的 API 令牌（去 Zoo 平台申请即可）：

cp .env.development .env.development.local

编辑.env.development.local，补上密钥：

PUBLIC_API_URL=https://api.zoo.com/v1 PUBLIC_API_KEY=你的API令牌

第三步：启动本地服务

npm install npm run dev

浏览器打开http://localhost:5173，看到一个简洁的输入框，你的文字转CAD之旅就正式开始了。整个流程大概3分钟，相当于泡一杯咖啡的时间。

三个值得反复把玩的核心功能

3D模型预览：像把玩实物一样检查设计

src/components/ModelViewer.svelte 负责模型展示。生成结果会以绿色线框风格呈现，你可以自由旋转、缩放、平移，还能开启自动旋转——相当于隔着屏幕把零件拿在手里转一圈。它基于 Three.js 技术栈，即使没有专业显卡，浏览器里也能流畅查看。

一键导出：一套模型，多种格式随便选

src/components/DownloadButton.svelte 是我最喜欢的部分。生成的结果默认是 GLTF 格式（Web 端3D模型标准），但你想导入 SolidWorks、AutoCAD 或者切片软件时，直接在下拉菜单里切换格式即可，支持 STL、STEP、OBJ、GLB、FBX、PLY 等，连 KCL 源码都能下载。这个过程就像同一道菜换不同的打包盒，内容不变，适配各种"餐桌"。

生成历史：你的模型档案馆

src/lib/stores.ts 把每次生成结果保存在浏览器本地存储里。关掉页面再打开，历史记录还在，还能按时间分组查看。批量生成时，这个功能能帮你省下大量"重新生成"的重复劳动。

两个真实场景：谁在用，怎么用

场景一：3D打印爱好者赶工

周末想打印一个带孔位的安装板，传统流程要先量尺寸、画草图、拉伸、打孔，至少一小时。用 text-to-cad-ui，输入"Create a plate with 4 holes and rounded corners"，等十几秒，导出 STL 格式直接送进切片软件。从想法到打印，半小时内搞定。

场景二：机械课老师做教具

讲解齿轮传动时，实时输入不同齿数和模数，学生立刻能看到参数变化对齿形的影响。抽象概念变成可旋转的立体模型，比任何PPT截图都直观。

新手最容易踩的3个坑与高效排查方法

坑一：模型生成为空或报错。大概率是提示词太模糊。别写"做个齿轮"，要写"模数2、19齿的直齿轮，齿宽15mm"——描述越具体，输出越可靠，这和给真人工程师提需求是一个道理。

坑二：导出转换失败。某些格式转换依赖 API 服务端，偶尔会提示 Failed。先确认网络正常，再换个格式试试，一般 GLTF 转 STL 最稳定。

坑三：生成速度比预期慢。简单模型 5-10 秒，复杂模型 20-30 秒都属于正常范围。如果频繁调用，记得利用本地历史记录做缓存，别重复生成同样的内容。

写在最后：它适合谁，又有什么边界

如果你是非专业背景的3D爱好者、教育工作者，或者想快速验证设计概念的工程师，text-to-cad-ui 绝对值得一试——它是免费的、开源的，学习成本几乎为零。但也要说句实话：它擅长的是结构清晰、能用语言描述清楚的零件，对于需要精细曲面造型或复杂装配关系的设计，目前仍需配合专业CAD软件。把这套工具当作你设计流程的"快速起手式"，先出模型再精修，效率会提升一大截。

现在就去克隆项目、填上密钥，用一句话生成你的第一个3D模型吧。打字就能建模的时代，已经开始了。

【免费下载链接】text-to-cad-uiA lightweight UI for interacting with the Zoo Text-to-CAD API.项目地址: https://gitcode.com/gh_mirrors/te/text-to-cad-ui