文字转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深夜加班画图的工程师都懂那种滋味客户发来一句帮我看看这个零件行不行你打开CAD软件从零开始建草图、拉特征、倒圆角半小时后对方又说尺寸改一下。而text-to-cad-ui这款免费开源的文字转CAD工具把这段痛苦的流程压缩成了一句话的时间——你输入设计一个带5个M12孔的320mm通风刹车盘它就在几秒内给你生成一个可以直接旋转查看、下载导出的3D模型。这不是科幻演示而是一个真正能跑起来的开源项目。它本质上是一个轻量级的Web界面封装了Zoo Text-to-CAD API用自然语言替代传统建模操作。本文就带你从零开始认识它、安装它、用它产出第一个模型再挖一挖那些藏在代码里的实用细节。传统建模为什么让人望而却步先讲一个真实的对比。用传统CAD画一个工字梁标准流程大致是新建零件选择基准面绘制截面草图两片翼缘加一条腹板标注尺寸长度、翼缘宽度、腹板厚度、圆角半径拉伸成实体再处理细节这套流程本身不难难的是你要先学会这套软件语法——菜单在哪、命令叫什么、坐标系怎么摆。很多非机械专业的人比如做采购、做教育、做产品经理的被挡在了这第一道门槛前。而text-to-cad-ui的解法完全不同把建模动作换成描述需求。你不需要知道任何命令只需要把零件长什么样说清楚。它背后的模型会理解你的描述生成符合工程语义的模型文件。同样是工字梁一句12英寸长、4英寸高、翼缘2.66×0.29英寸、腹板0.19英寸、根部半径0.46英寸就够了。text-to-cad-ui是什么一句话定位text-to-cad-ui是Zoo官方开源的示例级项目用SvelteKit构建专门用来演示如何快速对接Zoo Text-to-CAD API。它给你的不是一个笨重的客户端而是一个清爽的Web页面左边输入文字中间实时预览3D模型右边管理你的生成历史。它的核心卖点可以浓缩成三条卖点说明零学习成本会打字就会用无需任何CAD软件基础秒级出图简单模型几秒生成复杂模型20-30秒格式自由一键导出GLTF、STL、STEP、OBJ等工业格式还能拿到KCL源码三步上手从克隆到看到界面整个过程只需要三条命令跟着做就能跑起来。第一步获取源代码在终端执行git clone https://gitcode.com/gh_mirrors/te/text-to-cad-ui cd text-to-cad-ui第二步准备环境变量项目通过环境变量管理API连接。仓库里提供了一个示例配置复制一份出来cp .env.development .env.development.local然后编辑.env.development.local填入你自己的API令牌。配置项非常简单核心就是两个PUBLIC_API_URL你的API服务地址 PUBLIC_API_KEY你的API令牌第三步安装依赖并启动npm install npm run dev浏览器访问http://localhost:5173一个极简的文字转CAD界面就出现了。页面正中央是输入区下方有随机刷新的示例提示词按钮点击就能把示例填入输入框非常适合第一次体验。第一次实战用一句提示词生成刹车盘环境跑通之后我们来走一遍完整流程。这次用一个贯穿始终的案例通风刹车盘。1. 输入你的需求在输入框里输入A 320mm vented brake rotor with 5 M12 holes on 114.3mm PCD翻译过来就是直径320毫米的通风刹车盘带5个M12安装孔分布在114.3毫米的分度圆上。注意这里包含了三个关键信息整体尺寸320mm、孔的规格与数量5个M12、孔的分布方式114.3mm PCD。描述得越具体模型就越接近你要的东西。2. 观察模型生成提交后界面会显示生成状态。完成后模型会出现在3D预览区默认带有缓慢的自动旋转方便你从各个角度检查。这个预览功能值得多说一句它用的是Three.js技术栈支持鼠标拖拽旋转、滚轮缩放而且有一个很贴心的细节——当你开始拖动模型时自动旋转会暂停5秒等你操作完再恢复不会和你抢控制权。这个小交互藏在src/components/ModelViewer.svelte里改天想给项目加功能这里是很好的切入点。3. 导出你想要的格式模型满意之后点击Download按钮右侧的格式下拉框你会看到一串选项gltf、glb、obj、ply、stl、step如果模型带了源码还会多出一个kcl选项。这里有个值得注意的机制默认下载的是gltf格式但其他格式并不是一开始就存在的。当你选择stl或step时工具会自动调用文件转换接口把gltf实时转换成目标格式转换期间按钮会显示Converting状态完成后自动触发下载。也就是说无论你要什么格式界面上都是一键的事转换过程被完全隐藏了。那些示例文章不会告诉你的隐藏细节这个项目体积不大但藏了不少值得把玩的细节我挑三个最有价值的分享给你。细节一生成历史按时间自动归档项目把每次生成的记录存在浏览器的localStorage里不会丢。更妙的是历史列表会按今天、过去7天、本月、今年自动分桶显示打开侧边栏就能看到自己最近的工作流。这个分桶逻辑定义在src/lib/consts.ts的时间桶配置里是一个很典型的时间管理设计值得借鉴。细节二提示词会自动变成文件名你下载的文件名不是乱码而是由提示词自动转换的。比如输入Sash window, 500mm wide下载的gltf文件就会叫sash-window-500mm-wide.gltf——提示词被转成了kebab-case风格。这个转换逻辑在src/lib/toKebabCase.ts里保证你导出的文件放到项目文件夹里一眼就能认出是哪个零件的模型。细节三代码即模型KCL源码随手可得大多数文字转CAD工具只给你结果文件text-to-cad-ui却额外暴露了KCL源码。KCL是Zoo的编程建模语言等于你除了拿到模型还拿到了一份模型的配方。这意味着你可以把生成结果交给懂代码的人继续微调或者作为参数化设计的起点。在DownloadButton组件里KCL被特殊处理成纯文本下载和二进制模型文件走的是完全不同的通道。提示词避坑指南从能出图到出对图用过几次之后你会发现同样的工具提示词写得好不好结果天差地别。这里分享几条实测有效的经验。先说尺寸单位中文描述习惯不带单位但模型生成非常依赖单位。320mm和320是两个概念务必带上单位。角度、直径、壁厚这些参数也一样写45度不写45写2mm壁厚不写2壁厚。再说结构描述只写一个齿轮你会得到一个不知道什么参数的齿轮。写成模数2、齿数30的直齿轮才可能拿到符合工程语义的结果。项目自带的示例提示词是最好的教材比如A bone plate for a human femur, 8 holes, 4.5 mm screws股骨骨板8孔4.5毫米螺钉17-floor twisted tower, 30 m wide, 5 m floor height17层扭曲塔Surgical drill guide, 150 mm handle, Ø2 Ø3.2 mm bits手术钻导板注意这些示例的共性每个都包含数量、尺寸、结构三类信息。照着这个模板写成功率会高很多。复杂模型分步来一次描述太复杂的模型容易生成失败或结果不理想。建议先描述基本形状等模型出来后再补充细节分两次生成。这也是对API负载更友好的做法。常见问题快问快答问需要会编程才能用吗完全不需要。项目是给终端用户用的Web界面你的身份只是描述需求的人。唯一和代码沾边的步骤是启动项目时的三条命令复制粘贴就能完成。当然如果你恰好会一点Svelte改改组件、加加功能会非常顺手。问生成的模型能导入SolidWorks、AutoCAD这类软件吗能。通过格式下拉框导出STEP或STL格式即可这两种是主流工程软件通用的交换格式。导出后直接拖进目标软件就能使用。问生成一个模型要多久简单模型大约5-10秒复杂模型20-30秒。生成时间主要取决于模型复杂度和API的当前负载。界面有加载指示等待时不会干着急。问免费吗项目本身完全免费开源你可以任意查看源码、修改、二次开发。使用时的实际开销只有Zoo API的调用费用具体以Zoo平台的计费规则为准。问生成历史存在哪会不会丢存在你浏览器的localStorage里换浏览器或清缓存会清空。代码里还留了一个很细心的设计如果存储空间超限会自动从最旧的记录开始清理避免整个历史被清掉。这个逻辑在src/lib/stores.ts里感兴趣可以翻一翻。从今天开始让文字替你建模text-to-cad-ui的意义不在于取代专业CAD软件——复杂装配、工程图、仿真这些工作它做不了。它的价值在于把想法→模型这段最耗时的路径压缩到极致概念验证、方案对比、教学演示、给客户看效果这些场景里它比任何传统工具都快。现在就动手吧克隆项目、填上API密钥、启动服务然后输入你脑子里那个构思已久的零件描述看看它是不是比想象中更接近你想要的样子。如果跑通了下一步还可以去读读src/lib/zooClient.ts和src/components/PromptForm.svelte你会发现自己已经站在了二次开发的门口。【免费下载链接】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），仅供参考