text-to-cad 文字生成 CAD 插件

# text-to-cad：安装说明

这个工具包里只有安装说明，由 Mindket 编写。text-to-cad 插件和它的技能来自 earthtojake 的仓库，地址是 https://github.com/earthtojake/text-to-cad，它的服务器 cad-server 来自 PyPI

这些说明不是 earthtojake 或 Thompson Labs LLC 写的，也没有得到他们的认可。README 写的是：“The text-to-cad plugin gives your agent local workflows for generating 3D models as STEP, GLB, STL or 3MF files. It also does design for manufacturing checks, generates engineering drawings, and connects to popular 3D printing, sheet metal and CNC fabrication services.”，意思是：这个插件给你的智能体提供在本地生成 STEP、GLB、STL 或 3MF 格式 3D 模型的工作流，还做可制造性检查、生成工程图，并连接常见的 3D 打印、钣金和 CNC 加工服务。网站是 https://www.texttocad.dev

许可证：MIT。LICENSE 文件（https://github.com/earthtojake/text-to-cad/blob/main/LICENSE）写的是“Copyright (c) 2026 Thompson Labs LLC”。插件清单和 PyPI 上 `cad`、`cad-server`、`cad-mcp` 的条目写的是同一个许可证。

## 会安装什么

下面的安装命令是 texttocad.dev 提供的一段短脚本。它的页面 docs/install.md（https://github.com/earthtojake/text-to-cad/blob/main/docs/install.md）列出了它做的事：

- 它先找 uv，找不到就用 uv 自己的安装器装上，然后通过 uvx 运行最新版本里的 `cad setup`。第一次运行会下载这个版本，以及它要用的 Python 3.14。
- 它只做一次 CAD 内核环境：带 CAD 内核的库（OCP、build123d 和它们需要的东西），第一次约 220 MB，放在 text-to-cad 的缓存文件夹里。
- 它把插件写进 text-to-cad 状态文件夹里的一个文件夹，再用各应用自己的命令让每个智能体应用指向它。没有插件的智能体只拿到技能，通过 Skills CLI 复制过去。
- 它会移除 text-to-cad 的重复副本，其中包括来自 claude.ai 或 Codex 插件目录的那一份，并装上这个版本来取代。它还会把 CAD 的服务器加进 Claude Desktop 的配置，并在旁边留一份该文件的 `.bak`。
- 它注册 `cad` 命令（`~/.local/bin/cad`，在 Windows 上是 `%USERPROFILE%\.local\bin\cad.cmd`），并把它改动的一切写进一份回执。
- 它把你电脑上的 CAD 服务器切换到新版本，并列出需要重启的应用。

它中途什么也不问：直接执行它打印出来的计划。想在改动之前先看计划，就用下面的试运行。来源见 docs/install.md，“What the install command does”

## 事先需要准备

- 一个智能体应用。安装页面写了 Claude Code、Claude Desktop、Codex、Cursor、Grok Build、Gemini CLI，以及只装技能的 GitHub Copilot、Windsurf、Cline、Amp、Antigravity、OpenClaw、Droid、Goose、Kilo Code、Kiro CLI、Hermes Agent、OpenCode、Roo Code、Trae 和 Zed。
- uv。安装命令在它缺失时会帮你装。手动的话，用 `uv --version` 检查。
- Python 3.14 或更高。PyPI 上 `cad`、`cad-server` 和 `cad-mcp` 的条目写的是 `>=3.14`，启动命令用的是 uv 管理的 Python 3.14，所以 uv 会去取。
- 应用第一次启动时要有网络，它会下载 CAD 的运行环境。页面说这可能超过应用的服务器启动超时，重启后会接着下载。
- 在开着智能应用控制（Smart App Control）的 Windows 11 上，见 setup/windows.md。它会拦截 CAD 内核。
- Node.js 22.20 或更高（`npx`），只有只装技能的智能体需要。Skills CLI 的 npm 条目要求这个版本。见 setup/other-agents.md。

来源见 docs/install.md，“App by app”和“Windows 11: Smart App Control”；https://pypi.org/project/cad-server/

## 主安装命令

macOS 和 Linux：

```
curl -fsSL https://texttocad.dev/install.sh | sh
```

Windows，在 PowerShell 里：

```
irm https://www.texttocad.dev/install.ps1 | iex
```

再运行一次就能更新全部。来源见 README.md，“Quickstart”

选项写在 `sh -s --` 后面。安装页面给出：

```
curl -fsSL https://texttocad.dev/install.sh | sh -s -- --dry-run            # print the plan, change nothing
curl -fsSL https://texttocad.dev/install.sh | sh -s -- --only claude,codex  # only these apps
curl -fsSL https://texttocad.dev/install.sh | sh -s -- --no-telemetry       # also turn telemetry off
curl -fsSL https://texttocad.dev/install.sh | sh -s -- --uninstall          # undo what the receipt records
```

这四行依次是：只打印计划、不改动；只装这几个应用；同时关掉遥测；撤销回执里记录的内容。`--only` 可以填 `claude`、`claude-desktop`、`codex`、`cursor`、`grok` 和 `gemini`，也可以填 setup/other-agents.md 里那些智能体在 Skills CLI 里的 id。想在运行前先读脚本，页面说先下载下来：

```
curl -fsSL https://texttocad.dev/install.sh -o install.sh
sh install.sh --dry-run
```

每个版本都带着这个脚本和它的 SHA-256 校验和，放在 https://github.com/earthtojake/text-to-cad/releases 。来源见 docs/install.md

## 各智能体的说明

- setup/claude-code.md：插件和查看器
- setup/claude-desktop.md：Code 标签页、Chat 标签页的配置条目，以及 Cowork
- setup/codex.md：插件和 CAD 标签页
- setup/cursor.md：插件和它的本地文件夹
- setup/gemini-cli.md：扩展
- setup/grok-build.md：插件
- setup/other-agents.md：只装技能，通过 Skills CLI
- setup/windows.md：PowerShell，以及智能应用控制
- setup/fabrication-tools.md：切片、打印、零件和切割这几个技能在 text-to-cad 之外要用到什么

## 技能

README 的技能表列出了它们（我们读到时是十二个）。括号里的路径是每个技能在仓库里的文件夹。

- CAD（skills/cad）：根据文字或图片需求，把 CAD 模型写成 Python 脚本来创建和修改，并导出 STEP、STL、3MF 和 GLB
- step.parts（skills/step-parts）：查找现成的 STEP 零件，比如螺丝、轴承、电机和连接器
- Engineering Drawing（skills/engineering-drawing）：给零件出带尺寸标注的 PDF 图纸
- DXF（skills/dxf）：2D 图纸，比如轮廓、模板、垫片和切割排版
- URDF（skills/urdf）：机器人结构文件，包含连杆、关节、限位、惯量和网格
- SRDF（skills/srdf）：在 URDF 上加 MoveIt 的规划组、末端执行器、姿态和碰撞规则
- SDF（skills/sdf）：仿真器用的模型和场景，包含坐标系、物理、传感器和灯光
- SendCutSend（skills/sendcutsend）：在上传到 SendCutSend 之前检查 DXF 和 STEP 文件
- DfAM Check（skills/dfam-check）：按工艺测量网格的可打印性
- DFM（skills/dfm）：审查零件能不能做钣金、CNC 加工或注塑
- G-code（skills/gcode）：用 OrcaSlicer 把模型切成能直接打印的 G-code
- Bambu Labs（skills/bambu-labs）：通过 Bambu Connect 或 Bambu Studio 把打印任务发给 Bambu Lab 打印机

## 更新或卸载

更新的话，再运行一次安装命令，或者在终端里运行 `cad update`，或者在有新版本时点 CAD 查看器里显示的更新按钮。你不要求，什么都不会更新。各智能体自己的更新命令在它们各自的文件里。来源见 docs/install.md，“Updates”

要移除安装命令装好的全部内容，页面给出：

```
curl -fsSL https://texttocad.dev/install.sh | sh -s -- --uninstall
```

它会撤销回执里记录的内容，移除 `cad` 命令并停止服务器。后面再加 `--purge`，还会删掉 text-to-cad 的状态文件夹和缓存文件夹。安装命令替换掉的插件目录副本不会被放回去。来源见 docs/install.md

## 使用数据

README 说，text-to-cad 会发送使用统计和崩溃报告，带一个随机 ID，从不包含你的文件、路径或提示词。隐私政策（https://www.texttocad.dev/privacy-policy ，我们读到时更新日期是 2026 年 10 月 31 日）写明了发送的内容，还说你的提示词、模型、图纸和文件从不离开你的电脑。它的第 5 节给出这些关闭遥测的办法：

```
uvx --no-config --managed-python --python 3.14 --from cad-server==0.10.0 cad telemetry off
```

这一行写的是政策对应的那个版本。其他办法：

- 在 CAD 应用或 CAD 查看器的菜单里点 Telemetry（左上角的 logo，在任何打开的模型上方）。
- 让你的智能体关掉 CAD 遥测。
- 在 text-to-cad 运行的环境里设置 `DO_NOT_TRACK=1` 或 `CAD_TELEMETRY=0`。政策说这只对那个进程和它要求的构建有效，不改变你的设置。后台启动的查看器和发送程序仍按你的设置走。
- 安装时加 `--no-telemetry`，出自 docs/install.md。

政策还说，版本检查最多每小时向 api.texttocad.dev 查询一次最新版本，不带 ID。`CAD_UPDATE_CHECK=0` 可以关掉它。用 step.parts 技能搜索时，你的搜索词会发到 step.parts。

## 来源

- README：https://github.com/earthtojake/text-to-cad/blob/main/README.md
- 安装页面：https://github.com/earthtojake/text-to-cad/blob/main/docs/install.md
- 安全政策：https://github.com/earthtojake/text-to-cad/blob/main/SECURITY.md
- 隐私政策：https://www.texttocad.dev/privacy-policy
- CAD 技能：https://github.com/earthtojake/text-to-cad/blob/main/skills/cad/SKILL.md
- PyPI：https://pypi.org/project/cad-server/

README.md  9 KB
setup/claude-code.md  3 KB
setup/claude-desktop.md  2 KB
setup/codex.md  2 KB
setup/cursor.md  2 KB
setup/fabrication-tools.md  4 KB
setup/gemini-cli.md  1 KB
setup/grok-build.md  1 KB
setup/other-agents.md  3 KB
setup/windows.md  3 KB