Text-to-CAD：参数化源码、几何证据与负责任的交接
Text-to-CAD 架构：源码新鲜度与文档编译回答不同问题
追踪模型调用、派生输出和查看器状态，理解装配更新为何需要重建父模型，以及缓存看不到哪些输入。
Text-to-CAD 架构：源码新鲜度与文档编译回答不同问题知识学习CN编辑简报更新 2026-09-14
你将学会
- 先追踪源码构建路径
- 文档能渲染，源码可能已经变化
- 让影响几何的输入显式存在
开始前需要
- 了解 Python 函数、模块与文件路径
- 理解单位以及设计和实物之间的区别
规划有边界的 CAD 练习，区分源码新鲜度、文档检查、视觉审阅和制造决策。
先看结论
- 父装配重建时才消费子模型更新。
- 文档渲染不证明源码是最新的。
- 影响几何的输入应明确且可跟踪。
先追踪源码构建路径
CAD 指南通过文件与函数标识模型，由函数体返回几何并由装饰器声明输出。父模型调用子模型并放置其几何。子模型改变不会自动推送到全部父装配文件；父模型必须重建，才会消费变化后的子结果。
文档所述存储保存派生、内容寻址的几何和模型记录。新鲜度检查考虑源码、导入常量、子结果和声明输出。这是已记录的约定，不是本系列完整验证过的并发或缓存实现。
文档能渲染，源码可能已经变化
检查和查看从 STEP 或网格文件开始，而不是从 Python 生成器开始。存储中缺少文档表示时，可以根据已有字节编译。这回答“现在文件里有什么”，不回答“之后的源码修改是否应该产生新字节”。
查看器状态描述文档编译、渲染或失败。判断源码是否最新，应使用面向模型的 store why 并重建对应源码目标。在查看器中重新打开旧 STEP，不会自动应用 Python 里刚改过的尺寸。
让影响几何的输入显式存在
指南警告环境变量、当前时间、工作目录和随机值不是受跟踪的几何输入。配置应进入明确常量或工厂参数，不要藏在进程环境中，否则外部值变化时，新鲜度结果可能仍误导性地显示当前有效。
推荐一模型一源码文件，因为同文件多个模型共享源码闭包。围绕有意义的零件与依赖划分边界。本次没有测试守护进程竞态、跨运行时升级的失效处理或完整装配重建，不应从示意图推断这些保证。
如何选择
| 比较维度 | 方案 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
消除隐藏的时间、环境或随机几何输入。
可复制示例
json
{
"排查": true,
"源码已编辑": true,
"文档已渲染": true,
"已知源码新鲜度": false,
"下项检查": "cadgen store why sample.py",
"重建目标": "sample.py"
}常见问题
重建子零件会更新全部装配文件吗？
文档描述的是拉取式依赖，需要重建父模型来采用子结果。
Rendered 表示源码最新吗？
不是，它是文档侧的查看器状态。
资料来源
- Text-to-CAD / skills/cad/SKILL.md来源核查 2026-09-14
- Text-to-CAD / skills/cad-viewer/SKILL.md来源核查 2026-09-14