Text-to-CAD：参数化源码、几何证据与负责任的交接
Text-to-CAD 性能评估：分开测冷启动、未改模型、编辑和导出
区分构建复用、父装配更新、浏览器启动和网格密度的成本，不把跳过工作误当成几何加速。
Text-to-CAD 性能评估：分开测冷启动、未改模型、编辑和导出知识学习CN编辑简报更新 2026-09-14
你将学会
- 未改模型和已改模型是不同负载
- 把几何、渲染和网格化分开
- 清理派生状态前先诊断
开始前需要
- 了解 Python 函数、模块与文件路径
- 理解单位以及设计和实物之间的区别
规划有边界的 CAD 练习，区分源码新鲜度、文档检查、视觉审阅和制造决策。
先看结论
- 未改重跑不能直接与几何编辑比较。
- 源码生成、渲染和网格导出有不同成本。
- 相对网格容差不是毫米制造公差。
未改模型和已改模型是不同负载
指南描述新鲜度跳过与预热工作进程。首次构建、未改重跑、几何编辑和父装配重建应该分别比较，否则一次很快的未改运行可能被误解为昂贵几何运算变快了。
记录源码版本、输出、工作进程模式和文件大小。等待子几何的父模型与独立零件具有不同依赖工作。文档中的调度设计不能证明读者机器上的最优进程数量。
把几何、渲染和网格化分开
截图启动、文档编译、曲面网格化和源码生成有不同成本。代理设计能推迟依赖导入，但假模块测试不测真实延迟，不能把架构动机直接转换为端到端提速结论。
导出指南把线性网格容差定义为相对于各组件包围盒对角线，而不是绝对毫米偏差。收紧网格参数会影响密度和文件大小，却不会改善原始 CAD 设计。比较时固定零件和参数，同时考察导出保真度与成本。
清理派生状态前先诊断
使用 store why 理解具体新鲜度条款，用 daemon status 查看工作状态。有理由时优先重建准确模型。大范围清缓存可能丢失有用诊断并引起昂贵重算，本教程不推荐把删除整个缓存当作第一步。
建议记录表在真实测试前保留未知的耗时、内存和文件大小。本系列没有测吞吐、能耗、费用、冷启动节省或真实网格化性能。失败构建和验证失败同样应记入评估。
如何选择
| 比较维度 | 方案 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,
"冷构建秒数": null,
"未改运行秒数": null,
"编辑构建秒数": null,
"截图秒数": null,
"网格字节数": null,
"已执行基准": false
}常见问题
current 很快就证明几何构建更快吗？
不是，它可能只是因为模型未变而跳过几何工作。
mesh_tolerance 是毫米制造公差吗？
导出指南按组件尺度定义它，不能作为制造保证。
资料来源
- Text-to-CAD / skills/cad/SKILL.md来源核查 2026-09-14
- Text-to-CAD / skills/cad/references/supported-exports.md来源核查 2026-09-14
- Text-to-CAD / packages/cadgen/src/cadgen/build123d.py来源核查 2026-09-14