安装 text-to-cad 三步跑通Windows / macOS / Linux 跨平台部署清单【免费下载链接】text-to-cadGive your agent CAD superpowers.项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cadtext-to-cad 是一组给 AI Agent 用的 CAD 技能包你说一句画一个 40×20×6 的圆角支架Agent 就能生成可开可查的 STEP 零件顺带支持 STL / 3MF / GLB 导出、工程图、可制造性检查并全部在本地浏览器里预览。安装 text-to-cad 这件事本身不复杂——一条 Skills CLI 命令加一次 Agent 重启三大平台都能跑通剩下的只是各自系统上几个已知的小坑。本文先带你三步跑通再解释它到底装了什么最后按系统列出踩坑点和自检排错方法。三步跑通装好、重启、出一个模型确认 uv 在uv --version。uv 是 Python 包管理器负责给技能提供 Python 环境没有的话按 uv 官方安装方式装一个只需这一次。跑安装命令Skills CLI 会询问装给哪个 Agent、装到哪回车按提示选择即可npx skills add earthtojake/text-to-cad#latest想要全自动直接指定 Agent 并确认npx skills add earthtojake/text-to-cad#latest -g -a agent -y。 3.完全退出并重启你的 Agent然后发一句生成一个 40×20×6 的圆角支架存成 STEP然后打开给我看。本地 CAD Viewer 里转起来就算部署成功 ✅。text-to-cad 到底装了什么技能包skills每个技能 一份任务说明书 命令模板教 Agent 怎么调用 CAD 内核建模型、查几何、导文件。装完后放在各 Agent 的技能目录里例如~/.claude/skills、~/.codex/skills。装完没反应的头号原因就是 Agent 没重启、没重新扫描这些目录。Python 运行时cadgenCAD 内核 build123d OpenCascade以 Python 包形式运行。每个技能内部都用 uv 调用同一份已固定的cadgen见 skills/cad/SKILL.md 的 Setup 一节首次运行会联网下载 Python 3.13 环境和 CAD 运行时——所以装完后的第一次使用要联网之后就离线可用。CAD Viewer一个本地文件预览服务cadgen viewer在 localhost 起服务没有云端、没有数据库、不需要 GPU。为什么不需要服务器和 GPU所有计算建模、校验、导出都发生在你机器的 Python 进程里Viewer 只是把本地文件渲染给浏览器。三大平台差异对照项目WindowsmacOSLinux默认终端PowerShell / WSL2Terminalzshbash系统级拦截⚠️ Win11 Smart App Control见下无无首次运行下载Python 3.13 环境 CAD 运行时需联网同左同左分支要求一律latest生产发布分支同左同左额外依赖无可选切片器无可选切片器无MoveIt2 场景建议桌面版两点全局说明分支只用latest安装命令里带#latest/--ref latest/latest它只装已发布的版本。main是开发分支可能包含未发布的改动生产安装别用它。Node.js只有仓库开发工作流Viewer、文档站构建需要普通用户安装不用额外准备CONTRIBUTING.md 要求的是 Node.js 22供开发环境参考。Windows 11 的 Smart App Control 坑最大一个结论先说全新安装的 Windows 11 上默认 Smart App Control 会拦掉 CAD 内核。CAD 内核OCPOpenCascade 的 Python 绑定的 wheel 自带一个未签名的原生模块而 Smart App Control 会拦截未签名原生代码。表现是所有cadgen命令直接失败报ImportError: DLL load failed while importing OCP事件查看器里对应 CodeIntegrity 的 Event ID 3077cadgen doctor看到这种情况会直接点名它。处理方式二选一关掉 Smart App Control设置 → 隐私和安全性 → Windows 安全中心 → 应用和浏览器控制 → Smart App Control。注意它一旦关闭就无法再打开只能重装系统恢复改用 WSL 跑 CAD 技能该策略在 WSL 里不生效——想要完整体验WSL 也是 Windows 上的推荐方案。次要问题PowerShell 的执行策略可能拦npx。被拦就改用 cmd 执行或为当前用户放行脚本不必升管理员。macOS 与 Linux 各自的注意点macOS 快照浏览器预览、截图流程由 Playwright 驱动一个无头浏览器首次做快照时会自动下载跟着提示放行即可。macOS 隐私权限技能落在~/.claude/skills等用户目录若 Agent 读不到检查系统设置里的文件与文件夹授权Apple Silicon 上 CAD 内核的 arm64 依赖会自动匹配一般不用管。Linux 发行版技能安装路径本身用 uv 管理 Python你系统里的 Python 版本不影响它但仓库自身的开发工作流要求 Python 3.11packages/cadgen/pyproject.toml开发时建议按 PEP 668 的习惯建 venv 再用。MoveIt2 机器人场景SRDF 技能配套的 MoveIt2 服务器属于 ROS 生态主要在 Linux 桌面环境使用macOS / Windows 用户以 CAD 建模技能为主即可。装完没反应自检与排错最常见的装完没反应只有三种原因Agent 没重启、技能没装到你正在用的那个 Agent、同一个应用里装了插件 独立技能两份技能翻倍删一份即可。内核自检cadgen doctor 技能目录会报告当前使用的安装、Python 版本并验证 CAD 内核能否加载安装报错或内核加载失败先看它的输出uvx --no-config --managed-python --python 3.13 --from cadgen0.7.24 cadgen doctor skills/cad快速效果验证让 Agent 生成一个小零件并在本地 Viewer 打开能转起来即链路全通。更新 / 重装重跑原安装命令即可——Skills CLI 的add会重新拉取并覆盖连新增技能一起刷新插件类安装走各自市场页的更新按钮。Codex 用户注意插件市场已从text-to-cad改名为earthtojake旧市场要先移除codex plugin marketplace remove text-to-cad再装新的否则会静默装不上。下一步做什么出第一个正式零件把需求说具体尺寸、圆角、抽孔、倒角让 Agent 出 STEP 并让 CAD 技能做几何测量复核。要打印装 OrcaSlicer 后接 G-code 技能用你自己的打印机预设把模型切成 G-code只测能不能印则用 DfAM Check 技能查壁厚、悬垂和支撑。做机器人用 URDF / SRDF 技能写结构与规划组SRDF 可接 MoveIt2 做规划。要投产用 DFM 与 Engineering Drawing 技能分别过一遍可制造性检查和带标注的工程图 PDF。安装 text-to-cad 的全部核心流程就是装、重启、验证三步后面的能力都是按需加装随用随开。【免费下载链接】text-to-cadGive your agent CAD superpowers.项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cad创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考