text-to-cad 安装与部署教程10 分钟跑通三大平台从一句话到本地预览【免费下载链接】text-to-cadGive your agent CAD superpowers.项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cadtext-to-cad 是一个把 CAD 能力装进 AI Agent 的开源技能库用自然语言让它生成 STEP 三维模型、导出 STL/3MF、写 URDF 机器人描述文件再直接在本地浏览器里预览。本文覆盖 Windows、macOS、Linux 三个平台照做即可在 10 分钟内完成 text-to-cad 安装并看到自己生成的第一个模型。⚙️ 30 秒看懂它由什么组成组件干什么的装不装取决于你技能包skills/cad 等CAD、DXF、URDF/SRDF、G-code 等工作流Agent 按需调用必装CAD Viewer本地浏览器预览 STEP/STL/URDF 的网页服务cadgen viewer默认端口 3245随安装自动带上cadgen 运行时底层建模引擎build123d Open CASCADEcadgen 包 负责首次运行自动下载OrcaSlicer 切片器把网格切成 G-code要打 3D 打印才装没有任何服务端组件本地一台机器就够首次联网只是为了拉取运行时和无头浏览器。开装之前的环境速查uv所有 CAD 命令统一经 uv 托管的 Python 执行缺它技能跑不起来。验证uv --versionNode.js npmSkills CLI 通过npx调用建议 20 LTS。验证node --versionGit手动克隆或给 Cursor 装本地插件时需要。验证git --version网络首次运行会下载 CAD 运行时和快照用的无头浏览器第一次出图前别断网。安装路径从最快到最灵活方式一让 Agent 自己装推荐。直接把这句话发给你的 Agent它会替你完成克隆和配置帮我安装 text-to-cad仓库地址 https://gitcode.com/GitHub_Trending/tex/text-to-cad方式二按 Agent 走原生插件命令。Claude Code 和 Codex 各有两条命令#latest/--ref latest用来锁定发布分支# Claude Code claude plugin marketplace add earthtojake/text-to-cad#latest claude plugin install text-to-cadearthtojake # Codex codex plugin marketplace add earthtojake/text-to-cad --ref latest codex plugin add text-to-cadearthtojake方式三Skills CLI无插件支持的 Agent 通用。装完技能也能走通全部 CAD 工作流模型会直接在浏览器 Viewer 中打开# -a 指定 Agent 名-g 装到用户级目录-y 跳过交互提问 npx skills add earthtojake/text-to-cad#latest -g -a agent -y两个高频坑必须说清装完要重启 Agent/IDE技能列表不会热更新同一应用里别把插件和技能装两份否则每个技能都会出现两次。按系统对号入座平台特有的坑Windows 安装Smart App ControlWindows 11 默认开启它会拦截未签名的 OCP 原生模块所有cadgen命令报ImportError: DLL load failed while importing OCP在 Windows 安全中心关掉它或直接改用 WSLcadgen doctor能直接点名这个原因。终端分工Python 和 npm 命令用 PowerShell仓库里的.sh脚本交给 Git 自带的 Git Bash 跑别在 PowerShell 里硬执行。Python 版本技能本身走 uv 托管 Python开发时若用系统 Python确认python --version是 3.11用py -3.11 -m venv .venv建独立环境避免命中遗留旧版本。G-code 切片装好 OrcaSlicer 后把可执行目录加入PATHgcode 技能才能探测到orca-slicer命令。macOS 安装uvx 找不到Claude Desktop 这类应用定位不到uvx时把which uvx输出的完整路径填进配置即可。首次下载首跑会拉取运行时和无头浏览器快照渲染用是正常流程按提示等它完成。切片器brew install --cask orcaslicer最短路径装完命令行工具会自动出现在/Applications/OrcaSlicer.app/Contents/MacOS/下。架构Apple Silicon 上 cadgen 的二进制依赖自动匹配 arm64遇到 wheel 缺失优先升级 uv 再重试。Linux 安装PEP 668Debian/Ubuntu 限制全局 pip别硬装——技能统一走 uv 且--managed-python会自动管理 Python 版本不需要你手动建 venv。OrcaSlicer 形态Linux 下命令来自 AppImage 或 Flatpak装好后 gcode 技能按orca-slicer调用版本以发布页为准。MoveIt2 场景SRDF 技能配套的 MoveIt2 生态主要面向 Linux 桌面ROS 系其他平台以 CAD 建模技能为主即可。✅ 装完 5 分钟自检text-to-cad 常见问题排查cadgen报ImportError: DLL load failed while importing OCP→ 原因是 Windows 11 Smart App Control 拦截 → 跑cadgen doctor skills/cad确认然后关闭 Smart App Control 或切 WSL。Agent 里看不到技能→ 原因是技能列表未重新扫描 → 彻底重启 Agent/IDE仍无果就检查技能是否落到了对应目录。doctor 提示版本 pin 不匹配→ 原因是正在运行的 cadgen 与技能锁定的版本不一致 → 用原安装命令重装一遍Skills CLI 直接重跑npx skills add它会覆盖刷新。模型预览打不开→ 原因是 Viewer 没启动 → 执行cadgen viewer --host 127.0.0.1 --json --detach浏览器打开 3245 端口。最后回顾一遍一条命令npx skills add earthtojake/text-to-cad#latest覆盖主体流程认准latest分支装完记得重启 Agent。现在就可以让 Agent 帮你画第一个 STEP 零件了。【免费下载链接】text-to-cadGive your agent CAD superpowers.项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cad创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考