5分钟用文字生成CAD模型：text-to-cad-ui免费开源工具完整上手指南

5分钟用文字生成CAD模型text-to-cad-ui免费开源工具完整上手指南【免费下载链接】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深夜十一点你在工位上对着一个19齿直齿轮的需求发呆。打开 SolidWorks新建草图、画齿廓、拉伸、倒角……光是回忆菜单在哪就花掉十分钟。如果这时候有人告诉你把这句话原封不动打进去几十秒后就能拿到一个可以旋转查看、直接导出的 3D 模型你会信吗text-to-cad-ui 就是这样一个把打字和建模之间那堵墙拆掉的免费开源工具。它本质是一个轻量级的 Web 界面专门用来对接 Zoo 的 Text-to-CAD API你输入自然语言描述它把文字翻译成精确的三维 CAD 模型。它凭什么值得你花五分钟试一次市面上的建模工具多如牛毛text-to-cad-ui 打动人的地方恰恰是反着来——不要求你先会建模而是让机器替你做建模。学习成本约等于零全程只需要一个输入框。你不是在学软件你只是在描述想法。会打字就会用。出图速度快到不像话简单模型往往几十秒内就能完成生成与预览复杂模型也不过几分钟比起从草图一步步堆出来的传统流程效率不是一个量级。免费且完全开源界面、交互、API 调用逻辑全部摊开给你看没有任何付费墙。想要改输入校验、换配色、加功能改完就能跑完全由你做主。一句话总结它把 CAD 设计从专业技能降维成了表达能力。亲手跑通一次从克隆仓库到看到齿轮纸上谈兵没意思我们直接把它跑起来。整个过程只需要四步每步都有它的道理。先把代码拉到本地。打开终端执行git clone https://gitcode.com/gh_mirrors/te/text-to-cad-ui cd text-to-cad-ui再给它一把钥匙。项目本身只是个空壳界面真正的魔法在云端 API 里。你需要去 Zoo 平台申请一个 API 令牌然后复制示例配置cp .env.development .env.development.local打开.env.development.local填入你的令牌PUBLIC_API_URLhttps://api.zoo.dev/v1 PUBLIC_API_KEY你的API令牌这一步对应着项目里的 src/lib/env.ts 和 src/lib/zooClient.ts前者负责读取环境变量后者负责把这些配置包装成一个轻量的 API 客户端。之所以拆成这样是为了让界面和通信互不干扰——将来你想换后端、加代理都只需要动这一层。装依赖、起服务npm install npm run dev浏览器自动打开http://localhost:5173一个极简的深色界面等着你。左侧是输入区下方摆着几个示例提示词右侧是 3D 预览区。现在输入你的第一句话。我推荐从内置示例开始比如A 320mm vented brake rotor with 5 M12 holes on 114.3mm PCD带 5 个 M12 孔的 320mm 通风刹车盘。回车之后你会在侧边栏看到一条新的生成记录右侧的 3D 视图里慢慢浮现出模型的轮廓——绿线勾勒的棱边、可以拖拽旋转的视角几乎像变魔术。界面上那句标语说得很好Turning thoughts into complex mechanical designs——把想法变成复杂的机械设计这正是这个工具存在的全部意义。三个值得深挖的亮点不止是输入→出图如果你以为它只是个文字换模型的玩具那就小看它了。这几个细节才是它真正耐用的地方。亮点一3D 预览不是摆设而是质检工具。项目用 ThrelteThree.js 的 Svelte 封装搭建了 src/components/ModelViewer.svelte。模型加载后会自动旋转方便你从各个角度审视你一旦伸手拖拽自动旋转会暂停 5 秒等你松手再继续——这个细节说明作者真的考虑过检查模型这个使用场景。它还会给每个网格自动上色、描出棱边线让齿轮齿形、孔位这些细节一目了然。生成的结果好不好不用等导出当场就能看出来。亮点二导出格式多得超出预期。点开 src/components/DownloadButton.svelte 的下拉菜单你会看到 gltf、stl、step、obj、fbx、ply 一长串格式甚至还能下载 KCL 源码——也就是生成这个模型的程序化代码。这意味着什么你可以拿 GLTF 到网页里继续编辑拿 STEP 直接丢进 SolidWorks、AutoCAD 做工程细化拿 STL 去切片 3D 打印或者直接研究那段 KCL 代码理解参数化建模的底层逻辑。格式转换的映射表就定义在 src/lib/endpoints.ts想看支持哪些格式翻这一个文件就够了。亮点三你的建模历史会自动存档。所有生成记录都存在浏览器本地localStorage通过 src/lib/stores.ts 统一管理并且按今天、过去 7 天、本月、今年自动分桶。关掉浏览器再打开之前的模型还在。配合侧边栏的无限滚动加载做设计迭代时往前翻一翻很容易找到灵感起点。对经常反复调参的人来说这个后悔药非常实用。新手最容易踩的四个坑实践里大家卡住的点其实高度集中提前知道能省不少时间。坑一提示词太含糊。设计一个齿轮这种描述AI 也能出图但结果大概率不是你要的。正确姿势是带参数模数 2、齿数 30 的直齿轮齿宽 15mm。越具体的数字越接近工程可用的结果。想找感觉可以先看 src/lib/consts.ts 里内置的示例提示词刹车盘、I 型梁、股骨骨板、手术钻导向器……每一条都是很好的模板。坑二API 密钥配错位置。常见问题是把密钥写进了.env.development而不是.env.development.local。前者是提交到仓库的公共示例后者才是你本地的私密配置。改完环境变量记得重启npm run dev不然不生效。坑三生成失败就懵了。别慌先看界面上的错误提示和右上角的 toast 通知。大部分失败来自网络超时、密钥失效或描述超出了模型能力范围。换个更简单的描述再试一次往往就通了。坑四模型显示空白。如果预览区一片漆黑可能是返回的模型场景为空。项目对这种空场景做了专门的错误卡片提示看到它说明本次生成确实没产出有效几何体重新提交一次即可不是你的环境坏了。谁适合用谁不适合说实话强烈推荐这三类人一是机械、产品、建筑方向的初学者用文字生成来理解参数如何影响造型比死记软件命令高效得多二是需要快速出概念方案的工程师客户要概念图十分钟给个能转的 3D 模型沟通效率完全不一样三是教育场景的老师讲齿轮、连杆、凸轮时现场生成一个学生改文字看变化比 PPT 生动一百倍。而这几类人可能用不上需要极精密公差控制、复杂装配关系的资深结构工程师——目前的文字生成还做不到那种级别的工程细节你的主战场仍在专业 CAD 软件以及想完全脱离 API、纯离线使用的人——它的核心能力依赖 Zoo 的云端服务离线只能看界面生成不了模型。下一步就现在回到开头那个场景那个19 齿直齿轮现在你只需要把它打进输入框旋转确认齿形再选 STEP 导出——全程用不了一根烟的时间。这就是 text-to-cad-ui 送给你的礼物把想和做之间的距离压缩到一次回车之间。想自己上手就按上面的步骤把仓库克隆下来跑一遍想深入原理优先读 src/lib/zooClient.tsAPI 通信、src/components/PromptForm.svelte输入交互和 src/components/ModelViewer.svelte3D 渲染这三个文件整个工具的骨架就全在你脑子里了。它或许还不能取代你所有的建模工作但至少下一次当你只想赶紧看一眼长什么样的时候不用再打开那个沉重的建模软件了——打几个字就行。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考