1.7 KiB
1.7 KiB
doc_id, kind, schema_version, knowledge_version, status, name_zh, sources, family_id, params, expected_derived
| doc_id | kind | schema_version | knowledge_version | status | name_zh | sources | family_id | params | expected_derived | |||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| example-stepped-shaft | example | 1.0 | 0.1.0 | reviewed | 台阶轴:完整示例 |
|
stepped-shaft |
|
|
台阶轴:完整示例
完整需求
制作一根实心台阶轴,从 Z=0 起先 D20 长 40,再 D12 长 20,不要圆角和孔。
结构化输入
唯一输入真源是本文件 YAML 的 params;数值只用于此示例,不是该族默认值。使用以下命令校验并查看派生值:
python3 -m cad_knowledge validate stepped-shaft --example
引擎无关计划
- 累积计算分界 Z 为 0、40、60。
- 使用半径 10 和 6 的半剖面旋转,或构造两个同轴圆柱并合并。
- 保留单一零件,核对 Z=40 的台肩。
设计预期与检查
总长 60 mm、最大直径 20 mm,预期体积约 14828.317325 mm³。把第二段长度改为 30 时,总长变为 70,第一段起止位置仍为 0~40。
YAML 的 expected_derived 是固定解析预期,用于检测离线工具回归。预期与真实 CAD 测量分别记录,当前没有实际几何验证。
缺失与冲突处理
尺寸缺失时列出待补信息;尺寸关系冲突时保留原输入并说明冲突。修改需求先转换为完整的新参数对象,重新校验;工具不自动补入示例尺寸。
关联知识
读取零件族主文档及其中登记的共享特征。示例不扩展该族的适用范围。