Text-to-CAD：参数化源码、几何证据与负责任的交接
Text-to-CAD 是什么：从源码模型到可检查几何，再到独立制造决策
理解助手技能库与 cadgen 运行时，分清渲染成功、尺寸正确和具备制造条件之间的区别。
你将学会
- 交付的是几何文件，不只是图片
- 分开看源码、几何和呈现
- 生成前先定义需要的证据
开始前需要
- 了解 Python 函数、模块与文件路径
- 理解单位以及设计和实物之间的区别
规划有边界的 CAD 练习，区分源码新鲜度、文档检查、视觉审阅和制造决策。
先看结论
- CAD 意图需要尺寸与关系，而不只是外观。
- 源码、文件、预览和制造条件是不同状态。
- 选择器解析成功不是完整几何验证。
交付的是几何文件，不只是图片
在固定提交 3e4dfde 中，earthtojake/text-to-cad 提供 CAD、本地查看、图纸、机器人描述和制造交接等助手技能。CAD 流程编写参数化 Python 模型，用 cadgen 生成并检查文件。助手解释设计说明，运行时负责几何运算。
概念图可以表达外观而不指定精确尺寸，但 CAD 任务需要明确单位、参数、关系和输出。本系列用无功能性的桌面示例块解释区别，不设计承重零件、机器人执行机构或需要认证的部件。
分开看源码、几何和呈现
存在生成脚本时，模型脚本是可编辑来源。技能默认使用 STEP 作为 CAD 输出，也可声明 STL、3MF 和 GLB 等网格输出，并允许纯网格模型。导入的 STEP 可以直接检查，不必假装它一定有可恢复的生成源码。
查看器显示已经存在的文件及其编译表示，不会运行 Python 模型，也不判断文件是否落后于源码。因此，美观预览无法独立证明源码最新、尺寸正确，或适合某种制造工艺。
生成前先定义需要的证据
CAD 指南区分引用解析、几何有效性、针对性测量和视觉审阅。refs 命令即使成功解析选择器，也不代表已经完成独立几何验证。有效交接应说明检查的是哪个文件，以及需求中的哪些指标真正测过。
本系列阅读七份固定来源，使用假的几何模块对上游惰性导入代理执行八个隔离案例。没有运行 CAD 内核、构建模型、启动查看器、切片、操作打印机或测量性能；正文持续保留这些边界。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
确定文件类型和预期用途。
- 2
记录单位、尺寸及验收检查。
- 3
区分生成文件和可编辑源码。
可复制示例
{
"示例": true,
"零件": "桌面示例块",
"单位": "毫米",
"已构建几何": false,
"已测量尺寸": false,
"已批准制造": false
}常见问题
Text-to-CAD 是图片生成器吗？
其 CAD 流程生成并检查几何文件，纯概念图是另一类任务。
预览好看就能制造吗？
不能，几何、工艺、材料和配合要求需要各自的证据。
资料来源
- Text-to-CAD / README.md来源核查 2026-09-14
- Text-to-CAD / skills/cad/SKILL.md来源核查 2026-09-14
- Text-to-CAD / skills/cad-viewer/SKILL.md来源核查 2026-09-14