文本生成CAD模型

项目概述

text-to-cad 为智能代理提供本地化三维 CAD 工作流：根据自然语言或图片生成、编辑模型，并导出 STEP、GLB、STL、3MF 等格式；同时支持可制造性检查、工程图生成，以及 3D 打印、钣金和 CNC 加工服务连接。项目兼容支持插件或 Skills 框架的 Claude Code、Codex、Cursor、Gemini、Grok 等代理。

底层主要使用 Python 3.11+、build123d 0.11 与 OpenCASCADE 7.9；CAD 能力通过 cadgen 运行，并依赖 uv 管理运行环境。

安装与更新

CAD 依赖 uv，可先运行 uv --version 检查。插件会同时安装代理技能、本地 cadgen mcp 服务和模型查看器。代理插件与独立 Skills 不应重复安装，否则同一技能会出现两份。

推荐直接让代理执行：

Install text-to-cad from https://github.com/earthtojake/text-to-cad

Claude Code 的安装命令如下：

# 添加市场并安装插件
claude plugin marketplace add earthtojake/text-to-cad#latest
claude plugin install text-to-cad@earthtojake

更新后需重启 Claude Code：

claude plugin marketplace update earthtojake
claude plugin update text-to-cad@earthtojake

Claude Desktop 需在开发者配置中加入 MCP 服务：

{
  "mcpServers": {
    "cad": {
      "command": "uvx",
      "args": [
        "--no-config",
        "--managed-python",
        "--python",
        "3.13",
        "--from",
        "cadgen==0.7.26",
        "cadgen",
        "mcp"
      ],
      "env": {
        "CADGEN_INSTALL_CHANNEL": "claude-desktop"
      }
    }
  }
}

此配置固定 cadgen 版本；更新时修改版本号并重启应用。若找不到 uvx，可使用 which uvx 获取完整路径。

Codex、Cursor、Grok Build 和 Gemini 可分别通过插件市场、Git 仓库或扩展机制安装。其他不支持插件的代理可使用 Skills CLI：

# 交互式安装
npx skills add earthtojake/text-to-cad#latest

# 为指定用户和代理自动安装
npx skills add earthtojake/text-to-cad#latest -g -a <agent> -y

再次运行同一安装命令即可更新并补充新增技能；删除旧技能可使用：

npx skills remove cad-viewer cad-mcp-setup

核心技能

• CAD：依据文字或图片创建、编辑模型，主要输出 STEP，也支持 STL、3MF、GLB。
• step.parts：查找螺钉、轴承、电机和连接器等标准 STEP 零件。
• 工程图：生成带视图、隐藏线、尺寸、孔标注和标题栏的 PDF 图纸。
• DXF：从 Python 或 CAD 几何生成轮廓、模板、垫片及切割排版图。
• URDF、SRDF、SDF：创建机器人结构、MoveIt 规划配置及包含物理、传感器和灯光的仿真模型。
• DfAM Check：检查壁厚、悬垂、支撑体积和打印方向。
• DFM：依据实测结果审查钣金、CNC 和注塑设计，并标注规则依据。
• G-code：使用 OrcaSlicer 和自定义打印机配置生成可打印 G-code。
• SendCutSend、Bambu Labs：检查加工文件，或连接官方工具提交至 3D 打印机。

隐私、更新检查与 Windows 兼容性

遥测默认发送随机安装 ID、版本、操作系统、代理应用及功能调用统计，不包含文件名、路径、文件内容或提示词。可永久关闭并删除已发送数据：

uvx cadgen telemetry off

单次进程可通过环境变量控制：

DO_NOT_TRACK=1
# 或
CADGEN_TELEMETRY=0

CADGEN_UPDATE_CHECK=0 可关闭版本检查；关闭遥测不会影响离线使用。

Windows 11 的“智能应用控制”可能阻止未签名的 OCP 原生模块，导致 ImportError: DLL load failed while importing OCP。可运行 cadgen doctor 诊断；由于该机制没有单应用例外，需要关闭“智能应用控制”，或在 WSL 中运行 CAD 技能。