text-to-cad v0.6.6 教程：生成可测量 STEP 零件
text-to-cad 让编码 Agent 写 build123d Python 源码，再由本地 OpenCascade 内核生成 STEP。第一次不要挑战复杂装配。用一个尺寸明确的块体检查安装、几何、导出和测量链路，更容易发现模型是否漏了条件。
1. 从官方仓库安装技能
npx skills add earthtojake/text-to-cad
安装后重启 Agent，确认 CAD 技能可见。add 会覆盖已安装内容，也会带入新版本新增技能；团队环境先在测试账号审查来源、文件变化和锁文件。
2. 建立隔离的 CAD 项目
在空目录创建 Python 虚拟环境，让技能按自己的 requirements 安装固定 cadgen 版本。不要把第一次试运行放进重要工程仓库。Windows 11 若 Smart App Control 阻止 OCP 原生模块，优先考虑 WSL；关闭该系统功能后通常只能重装 Windows 才能恢复。
3. 用尺寸明确的提示开始
创建一个 100 × 60 × 20 mm 的长方体。
四个直径 8 mm 的贯穿孔，孔中心距最近两条边各 10 mm。
顶面外轮廓做 2 mm 倒角。
保留 build123d Python 源码，导出 STEP，并列出全部关键尺寸。
要求 Agent 先复述单位和约束。含糊的“差不多”“工业风”无法替代尺寸、公差和基准。若使用云 Agent，提示、源文件或参考图可能离开本机。
4. 检查实体和派生文件
运行技能提供的实体检查，确认 STEP 可打开、形体为预期数量、没有明显无效几何。再用本地 Viewer 检查六个方向和剖面。STL 只适合网格用途，后续参数修改应回到 Python 源码重新生成。
5. 独立测量每个要求
测量总长、宽、高、孔径、孔中心到边的距离和倒角。把提示值、实测值、单位和偏差写成表格。截图看起来像零件，不能证明隐藏孔、厚度或公差正确。
6. 制造前再做工程审核
实体闭合只是起点。3D 打印要检查壁厚、悬垂和切片参数；CNC 要检查刀具可达性、内角半径和装夹；注塑要检查拔模、缩水和分型。承载件还要按材料与工况计算，最终由有资质的人签核。
与 CADAM 对比
CADAM 是 GPLv3 的浏览器应用，用 Anthropic API 生成 OpenSCAD，浏览器用 WASM 和 Three.js 预览，可导出 STL、SCAD、DXF；text-to-cad 是安装到 Agent 的技能库，以 Python/build123d 和 STEP B-rep 为核心，还覆盖工程图、DFM 和机器人格式。快速网页式 OpenSCAD 试作可看 CADAM；需要源码化 STEP、测量检查和机器人交付链时评估 text-to-cad。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
适合谁用
适合可版本化的机械零件、夹具、简单装配、工程图、DXF、机器人描述和制造前检查。它不能替代工程签核：实体闭合只说明几何检查的一部分，尺寸、公差、材料、载荷、刀具可达性、壁厚、装配干涉和机器参数仍需专业人员确认。
原教程未展开的系统信息
核心功能
代码式 B-rep CAD
CAD 技能用 build123d/OCP 创建可编辑实体，以 STEP 为主要输出，并可导出 STL、3MF 和 GLB；源代码与派生产物可一起版本管理。
本地查看与几何引用
CAD Viewer 为 STEP 和机器人文件提供本地浏览，@cad[...] 引用把后续修改绑定到具体几何，而不是只靠模糊位置描述。
制造检查和工程图
v0.6.6 的 DFM 技能覆盖钣金、CNC 和注塑检查，Engineering Drawing 从零件生成带视图、尺寸、孔标注和标题栏的 PDF。
机器人描述工作流
独立技能处理 URDF、SRDF/MoveIt2 和 SDF，覆盖 link、joint、limit、碰撞几何、语义组和仿真描述。
架构与数据流
每个 skills/* 目录包含 SKILL.md、参考资料、脚本和固定的 cadgen 依赖。Agent 先写或改 Python/build123d 源文件，再调用本地 OCP 几何内核生成 STEP、网格、DXF、工程图或机器人描述，最后通过 Viewer 和检查脚本复核。技能可由 Skills CLI 安装，也可作为 Codex、Claude Code 或 Grok 插件安装。
技术栈和运行条件
语言
Python CAD 源码与 Markdown/YAML 技能
框架
build123d、OpenCascade/OCP、cadgen 与 Agent Skills
关键依赖
- text-to-cad v0.6.6
- Python 环境与 cadgen 固定版本
- Node.js/npx 用于 Skills CLI
- 可选本地 Viewer
- Codex 插件方式要求 Codex 0.142.0+
运行环境
CAD 内核和预览可在本机运行；所选 Agent 模型仍可能通过云端处理提示与源文件。Windows Smart App Control 可能阻止未签名 OCP 原生模块
常见问题
text-to-cad v0.6.6 只会生成 STL 网格吗？
不是。CAD 技能以 STEP B-rep 为主要输出，还能导出 STL、3MF、GLB 和拓扑数据；仓库另有 DXF、工程图和机器人描述技能。
text-to-cad 在本地运行就代表设计不会上传吗？
不一定。几何内核和 Viewer 可在本机运行，但 Agent 本身可能使用云模型并发送提示、源码或参考图。应按所选 Agent 和模型提供方核对数据边界。
Windows Smart App Control 阻止 OCP 时该怎么办？
官方建议考虑在 WSL 中运行。Smart App Control 没有单应用例外；关闭后通常只有重装 Windows 才能重新启用，因此不要把关闭系统保护当成轻率的第一步。
生成的 STEP 通过实体检查后能直接生产吗？
不能。还要人工核对尺寸、公差、材料、载荷、壁厚、刀具可达性、装配干涉和实际机器参数。闭合实体只是必要检查之一。
为什么更新时用 npx skills add 而不是只用 update？
README 说明 add 会重新获取并覆盖已安装技能，也会加入新版本新增的技能；update 只刷新锁文件中已有技能，可能漏掉新技能。更新前仍应审查来源和差异。