企业官网建设流程全解析

文字转CAD从0到1：5分钟搭好你的专属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

晚上十点，机械工程师老周还在为一个连接支架反复改图：开软件、建草图、拉伸、打孔、倒圆角，一套流程下来半小时起步，客户却已经在微信里催了三次。他忍不住想：如果能把这句话直接变成模型，该多好？

text-to-cad-ui 就是干这个的——一个免费开源、基于 SvelteKit 打造的轻量级文字转 CAD 前端界面，对接 Zoo Text-to-CAD API。你输入一句自然语言描述，它就把 3D 模型生成出来，还能在线旋转查看、一键导出多种格式。读完这篇文章，你不仅能知道它怎么用，还能亲手把整个界面跑起来，发出属于你的第一条"建模指令"。

它到底解决了什么问题？

一句话：把"写需求"变成"出模型"。传统 CAD 把心思花在工具栏和命令流上，而 text-to-cad-ui 把门槛砍到只剩一个输入框——描述你想要的东西，剩下的交给云端模型。

先看它的实际效果：

以前要 1 小时，现在只要 30 秒

对比一下同样做一个带孔的圆角连接板：

• 传统流程：新建文件 → 画草图 → 拉伸 → 打孔 → 倒角 → 导出，至少半小时；
• text-to-cad-ui 流程：在输入框敲一行字，按回车，几十秒后模型就出现在 3D 预览区。

而且它不止生成"看得见的模型"。项目内置的示例提示词覆盖了工程常见件：通风刹车盘、人股骨接骨板、翼梁截面、窗框、I 型钢、手术钻套……每个都是带具体尺寸和数量的真实工程描述。你复制一条试试，就知道"文字驱动设计"不是噱头。

5 步跑通你的第一个模型

跟着做，十分钟内你能亲眼看模型生成。所有命令都在终端执行。

第 1 步：拿到源码

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

第 2 步：配置 API 密钥

项目本身不负责"生成"，它通过 Zoo 的云端接口干活，所以需要你准备一个 API 令牌。先复制示例配置：

cp .env.development .env.development.local

然后编辑.env.development.local，填入你的接口地址和令牌（在项目根目录）：

PUBLIC_API_URL=你的API接口地址 PUBLIC_API_KEY=你的API令牌

第 3 步：安装依赖并启动

npm install npm run dev

浏览器打开http://localhost:5173，一个极简的文字转 CAD 界面就在眼前了。

第 4 步：写下第一句提示词

在输入框里试试这条（来自项目内置示例）：A 320mm vented brake rotor with 5 M12 holes on 114.3mm PCD——一个 320mm 带 5 个 M12 孔的通风刹车盘。按回车提交，等它几秒钟。

第 5 步：查看并导出

生成后进入详情页：src/components/ModelViewer.svelte用 Three.js 技术栈渲染模型，你可以旋转、缩放、平移，从各个角度检查细节；右侧src/components/DownloadButton.svelte提供格式下拉菜单，GLTF、GLB、OBJ、STL、STEP、PLY、FBX，连生成用的 KCL 脚本都能下载。

把工具嵌进你的工作流

• 方案比选：工程师快速生成多个候选模型，截图对比，不再靠脑补；
• 教学演示：老师让学生改一句描述里的数字，齿轮变凸轮、支架变法兰，参数与结果的因果关系一目了然；
• 3D 打印前哨：先文字建模验证思路，再导出 STL 切片，省去大量试错；
• 分享入口：源码里支持从 URL 参数?prompt=预填提示词，做好一个链接发给同事，对方打开就是你的描述。

新手最容易踩的 4 个坑

1. 提示词太模糊。"做个支架"远远不够，要写"带 4 个直径 8mm 孔的圆角支架，长 100mm"。尺寸、数量、形状越具体，结果越靠谱。
2. 忘配环境变量。启动后报 API 相关错误，九成是.env.development.local没创建或密钥没填对。
3. 导出其他格式要等待。默认生成 GLTF，切换成 STL/STEP 时接口要做格式转换，按钮会显示 Converting，别以为卡死了。
4. 复杂模型耐心等。项目每 6 秒轮询一次生成状态（见src/lib/consts.ts），大型件多等一会儿是正常的。

值不值得用？说点实在的

适合你，如果：你是 CAD 新手、想快速验证想法的工程师、做演示的教育者，或者想研究"前端如何对接 AI 建模 API"的开发者。

它的边界：界面本身是纯前端示例，真正的建模能力在 Zoo 云端，所以需要 API 密钥；它不追求替代专业 CAD 的精细编辑，定位是"快速产出"而非"精雕细琢"。

加分项：完全开源、SvelteKit 单页极简、接口层封装在src/lib/zooClient.ts，想二次开发或换 API 都很容易。

现在，轮到你了

出发前只需三样东西：一个终端、一份 API 密钥、一条能说清"你想要什么"的句子。然后按上面的 5 步走一遍，第一次看到自己的文字变成三维模型时，你会明白老周为什么感叹"早该用这个了"。

想深入了解实现细节？输入表单在src/components/PromptForm.svelte，3D 预览在src/components/ModelViewer.svelte，接口封装在src/lib/zooClient.ts。动手吧，你的第一句话，可能就是下一个零件的起点。

【免费下载链接】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