Text-to-CAD：参数化源码、几何证据与负责任的交接
Text-to-CAD 上手：参数化示例块与诚实的验证计划
阅读一个小型 cadgen 模型，理解何时发生构建，并把导入、生成、检查和截图区分开。
Text-to-CAD 上手：参数化示例块与诚实的验证计划知识学习CN编辑简报更新 2026-09-14
你将学会
- 写出可以核对的设计说明
- 调用才构建，导入不会自动生成模型
- 审阅真正生成的文件
开始前需要
- 了解 Python 函数、模块与文件路径
- 理解单位以及设计和实物之间的区别
规划有边界的 CAD 练习，区分源码新鲜度、文档检查、视觉审阅和制造决策。
先看结论
- 模型体返回形状，而不是路径或字典。
- 调用装饰模型与导入模块不同。
- 测量和截图必须针对实际生成文件。
写出可以核对的设计说明
选一个无功能性示例块，宽 36 毫米、深 24 毫米、高 4 毫米。这些是教学尺寸，不是推荐制造公差。记录预期包围尺寸和正体积，把孔、装配和机器操作排除在第一次练习之外。
下方模型遵循已检查约定：无参数装饰函数返回 build123d 形状，并在主入口保护下调用。参数保留为具名常量。需要可复用变体时，可把几何放在普通工厂函数中，再由分别标识的模型调用。
调用才构建，导入不会自动生成模型
指南说明装饰器声明输出，调用模型才进行构建。运行 sample.py 应产生声明的 sample.step；仅导入模块不会调用构建。不要把 Python 源文件传给 STEP 检查或截图命令，并期待它替你生成几何。
把生成的 STEP 当作文档检查。先用 refs 获取事实和选择器，再用 validate 检查几何有效性，并针对设计尺寸测量。引用解析状态正常，不代表实体封闭、方向正确且具有正体积。
审阅真正生成的文件
构建成功后对 STEP 截图，检查方向、缺失材料和意外特征。保存准确路径及验证结果。截图缺失或失败应明确保留为限制，不要用以前好看的图片代替当前结果。
这是适用于正确安装环境的运行模式示例，不声称本次已经构建该块。实际测试只覆盖假依赖下的惰性导入代理。本文写作过程没有生成 STEP、网格或打印机文件。
如何选择
| 比较维度 | 方案 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
在匹配的安装环境中构建。
- 4
验证、测量并审阅准确输出。
可复制示例
python
from cadgen import build123d as bd
from cadgen import step
WIDTH, DEPTH, HEIGHT = 36.0, 24.0, 4.0
@step
def sample():
return bd.Box(WIDTH, DEPTH, HEIGHT)
if __name__ == "__main__":
sample()常见问题
为什么导入 sample.py 没有创建 STEP？
文档所述构建发生在装饰模型被调用时，通常由主入口执行。
这里实际运行了 CAD 示例吗？
没有，示例依据固定模型约定；只运行了独立代理测试。
资料来源
- Text-to-CAD / skills/cad/SKILL.md来源核查 2026-09-14