text-to-cad 跨平台安装避坑一条命令从零到跑通【免费下载链接】text-to-cadGive your agent CAD superpowers.项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cadtext-to-cad 把 CAD 能力装进你的 AI Agent你用自然语言描述零件它生成 STEP 模型、导出 STL/3MF/GLB、写 URDF/SRDF 机器人描述文件并在本地浏览器里直接预览。这份清单覆盖 Windows、macOS、Linux 三大平台的 text-to-cad 安装环境检查、安装命令、平台差异、装完验证和排错。照做一遍你能独立完成部署并让 Agent 画出一个能在本地 Viewer 里转的 STEP 零件。最快跑通路径⚡ 赶时间的话记住这两行uv --version # 预期显示 uv 版本号 npx skills add earthtojake/text-to-cad#latest # 预期提示选择要安装的 Agent第一条确认uv在场CAD 运行时全靠它跑第二条用 Skills CLI 把技能装进 Agent 的技能目录。命令会问装给哪个 Agent想跳过交互就写成npx skills add earthtojake/text-to-cad#latest -g -a agent -y。装完重启 Agent技能列表不热加载。如果你更习惯原生插件Claude Code 跑claude plugin marketplace add earthtojake/text-to-cad#latest加claude plugin install text-to-cadearthtojakeCodex 跑codex plugin marketplace add earthtojake/text-to-cad --ref latest加codex plugin add text-to-cadearthtojakeCursor 直接克隆到~/.cursor/plugins/local/text-to-cad。它到底怎么跑起来的text-to-cad 本质是一组技能包加一个本地运行时。插件安装 技能 一个本地 CAD 服务器cadgen mcpCAD Viewer 的后台没有插件支持的 Agent 只装技能模型照样能在浏览器 localhost 页面里预览。整个运行链是 Python 脚本 → cadgenbuild123d 建模栈 OpenCASCADE 内核→ 浏览器本地预览不经过任何云端渲染。组件干什么你需要准备什么12 个技能skills/生成/检查 STEP、STL、DXF、URDF/SRDF、DfM、G-code无随安装命令落地cadgenpackages/cadgen/CAD 内核运行时经 uv 管理 Python装好 uv首次运行需联网CAD Viewer本地浏览器预览模型localhost 服务器无插件自带切片器可选把网格切成 G-codeOrcaSlicer仅打印场景需要划重点没有服务器要部署、没有数据库、不需要 GPU一台能跑 Node.js 和 Python 的电脑就够。唯一要留意的默认行为是遥测——使用统计默认上报随机 ID不含文件、路径和提示词不放心就uvx cadgen telemetry off。动手前确认这几点uvuv --version有版本号即可。CAD 运行时统一走 uv技能固定用它托管的 Python 3.13所以系统里 Python 多旧都无所谓。Node.jsLTSnode --version。Skills CLI 通过npx调用。Gitgit --version仅手动克隆路径需要。网络首次运行会下载 cadgen 运行时和快照用的无头浏览器第一次生成模型必须在线。切片器可选只有要切 G-code 才装 OrcaSlicer其余场景跳过。完整安装步骤Step 1装好 uv 并确认CAD 的 Python 环境全部由 uv 托管缺它后面全卡住。uv --version # 预期输出 0.x 版本号缺失则按 uv 官方文档装一遍Step 2按你的 Agent 装 text-to-cad推荐路径是 Skills CLI跨平台行为最一致npx skills add earthtojake/text-to-cad#latest # 预期安装成功提示技能文件落入对应 Agent 的技能目录没有 Skills CLI 环境的 Agent 走各自插件命令见上一节Cursor 则克隆仓库到~/.cursor/plugins/local/text-to-cad。注意各应用对分支的写法不同#latest/--ref latest/latest别省略——稳定安装取latest分支省略则装main里面可能带着未发布的改动。Step 3重启 Agent必须整进程重启不是重开聊天窗口。技能列表只在启动时扫描热加载不存在这是装完没反应的头号原因。Step 4首跑自检首次调用 cadgen 会下载运行时顺手用 doctor 确认内核能加载技能文档里把这个 uvx 长命令简写为cadgenuvx --no-config --managed-python --python 3.13 --from cadgen0.7.24 cadgen doctor skill-dir # 预期报告当前安装与版本CAD 内核加载成功如果之后要切 G-code再单独装 OrcaSlicer 并把可执行目录加进PATH要推 Bambu 打印机则装 Bambu Studio见 skills/gcode/。不同环境的坑安全策略、执行权限与下载⚠️Windows 11 Smart App Control 拦内核安全策略。现象每条 cadgen 命令都报ImportError: DLL load failed while importing OCP。原因OCPOpenCASCADE 的 Python 绑定的 wheel 带未签名原生模块Smart App Control 默认开启时直接拦截事件查看器记为 Event ID 3077。解法cadgen doctor会点名这个原因关掉 Smart App Control一次性操作关了回不去或改用 WSL2 跑WSL 里不受影响。PowerShell 执行策略拦 npx权限。现象npx报无法加载因为在此系统上禁止运行脚本。原因PowerShell 默认执行策略。解法Set-ExecutionPolicy -Scope CurrentUser RemoteSigned或干脆换命令提示符执行。Python 版本冲突版本。现象自己手动跑脚本时 build123d 报错。原因你用了系统里的旧 Python 而不是 uv 托管的 3.13。解法所有建模命令都走uvx --from cadgen... python别用裸python。首次运行卡住依赖下载。现象第一条 cadgen 命令迟迟没输出。原因首次运行要下载运行时首次快照还要下载无头浏览器。解法确认网络可达后等它下完失败就检查代理再重试一次。macOS 隐私策略权限。现象Agent 读不到技能文件。原因技能写在~/.claude/skills等用户目录受文件与文件夹授权管理。解法系统设置里给对应 Agent 放行文件夹访问。遥测默认开启隐私策略。现象担心数据外发。原因使用统计默认上报但只有计数和随机 ID无文件名、路径、内容。解法uvx cadgen telemetry off同时删除已发送的数据。跑起来之后第一个 STEP 验证✅ 最小验证就一句话——把你的 Agent 打开说画一个 40×20×6 mm 的 bracket生成 STEP在 CAD Viewer 里给我看。预期结果对话里出现 viewer 卡片或给你一个 localhost 链接浏览器打开后模型能旋转、能缩放就像这样没看到模型按顺序查三点Agent 重启了没有技能扫描只在启动时发生。cadgen doctor是否报告内核加载成功——失败多半是上面 Windows 安全策略那条。首跑下载是否完成断网环境第一次一定失败连上网重跑即可。想跑现成样例仓库里 models/examples/l_bracket.py 这类脚本让 Agent 执行一遍输出落在声明的 STEP 目录里。装不上 / 不生效高频问题装完 Agent 里看不到技能重启 Agent技能列表不热加载。仍看不到就确认文件真的落到了目标目录ls ~/.claude/skills各 Agent 目录不同。报 ImportError: DLL load failed while importing OCPWindows 11 Smart App Control 拦截了未签名的 OCP 内核模块。cadgen doctor确认原因后关掉 Smart App Control 或改用 WSL2。技能行为和文档对不上多半是省略了#latest装到了main。重跑同一条安装命令即可更新然后重启 Agent。G-code 技能提示找不到切片器OrcaSlicer 不随 text-to-cad 附带需另装并加进PATHmacOS 一条brew install --cask orcaslicer搞定。遥测数据发的是什么能关吗只有工具调用计数、版本等统计绑随机安装 ID不含你的文件和提示词。uvx cadgen telemetry off关闭并删除已发数据。一条命令npx skills add earthtojake/text-to-cad#latest覆盖三大平台的主体安装插件式 Agent 换各自的 marketplace 命令。装完重启技能列表只在 Agent 启动时扫描不重启等于没装。认准分支稳定安装带#latest省略装到main会混进未发布改动。全程本地无服务器、无数据库、无 GPU预览渲染都在你自己的机器上完成。现在就可以打开你的 Agent说一句画一个 40×20×6 mm 的 bracket 并生成 STEP几分钟后在浏览器里转起来的就是你的第一个零件。【免费下载链接】text-to-cadGive your agent CAD superpowers.项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cad创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考