{
  "_meta": {
    "title": "CDSL 语义词表几何签名（初稿 v0.1）",
    "protocol": "cad.cdsl.llm.v1",
    "date": "2026-09-14",
    "role": "三层关联机制的字典层：label ↔ 几何期望的机器可读绑定。签名是期望（expectation），不是模板（template）。",
    "checking_semantics": "签名检查只产生警告与训练数据分级，永不阻塞建模与重建（与 AGENTS.md 一致：不把语义分歧当程序错误）。",
    "input_dependency": "metric_expectations 依赖重建管线输出的逐特征指标（derived_metrics per_feature delta）。缺失 delta 时，退化检查为：metric_expectations 中 *_delta 键跳过，其余照查。",
    "inheritance": "label 可带 parent，检查时先应用父签名再应用自身（并集）。composite=true 表示该语义典型地由特征组合实现（如打孔+阵列），检查时沿 depends_on 链聚合 delta。",
    "out_of_vocabulary": "词表外 label 无签名，程序侧零校验（开放词表的设计使然）；训练侧应引导收敛到词表内。",
    "known_limitation": "纯用途差异在几何上不可分：coolant_channel 与 lubrication_gallery、cosmetic_surface 与 stress_relief_fillet 的几何签名几乎相同，其区分依赖 intent.why 与上下文，不依赖本签名。",
    "cross_field_reference": "param_expectations 的值可以引用另一参数路径（如 {\">\": \"diameter_mm\"}），匹配器解析为跨字段比较。",
    "signature_version": "0.1",
    "vocabulary_count": 37
  },
  "signatures": {
    "bolt_circle": {
      "parent": "fastener_hole",
      "composite": true,
      "allowed_atomics": ["pattern_circular", "pattern_linear", "hole_wizard", "hole_blind"],
      "param_expectations": {
        "pattern_count": {">=": 3},
        "positions": {">=": 3}
      },
      "metric_expectations": {
        "hole_count_delta": {">=": 3},
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_inner_cylindrical_face": true
      },
      "relations": ["instances_same_diameter", "instances_on_common_circle"],
      "notes_zh": "一组等径紧固孔沿公共圆周分布。典型实现：hole_wizard(1孔)+pattern_circular 阵列，或一次多 positions。检查时沿 depends_on 聚合打孔与阵列两特征的 delta。"
    },
    "fastener_hole": {
      "allowed_atomics": ["hole_wizard", "hole_blind", "extrude_cut_through"],
      "param_expectations": {
        "end_condition.type": {"in": ["through_all", "through_all_both", "blind"]}
      },
      "metric_expectations": {
        "hole_count_delta": {">=": 1},
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_inner_cylindrical_face": true
      },
      "notes_zh": "紧固件过孔（光孔）。词表父节点：tap_hole / bolt_circle / 沉头类均为其子型或伴生型。"
    },
    "tap_hole": {
      "parent": "fastener_hole",
      "allowed_atomics": ["hole_wizard", "thread_cut"],
      "param_expectations": {
        "thread": {"required_if_atomic": "hole_wizard"}
      },
      "metric_expectations": {
        "hole_count_delta": {">=": 1},
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_inner_cylindrical_face": true,
        "creates_thread_helix": false
      },
      "notes_zh": "螺纹孔。注意：hole_wizard 的 thread 装饰当前被引擎降级为光孔（thread_decoration_ignored 诊断），creates_thread_helix 恒为 false，签名如实反映现状；thread_cut 才产生真实螺旋几何。"
    },
    "counterbore_seat": {
      "parent": "fastener_hole",
      "allowed_atomics": ["hole_counterbore", "hole_wizard"],
      "param_expectations": {
        "counterbore_diameter_mm": {">": "diameter_mm"},
        "counterbore_depth_mm": {">": 0}
      },
      "metric_expectations": {
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_inner_cylindrical_face": true,
        "creates_planar_shoulder": true
      },
      "notes_zh": "沉头柱坑：主孔 + 同轴大直径浅坑，坑底形成环形平面肩。"
    },
    "countersink_seat": {
      "parent": "fastener_hole",
      "allowed_atomics": ["hole_countersink", "hole_wizard"],
      "param_expectations": {
        "countersink_diameter_mm": {">": "diameter_mm"},
        "countersink_angle_rad": {">": 0, "<": 3.141592653589793}
      },
      "metric_expectations": {
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_inner_cone_face": true
      },
      "notes_zh": "沉头锥坑：主孔 + 锥形扩口，锥面是与柱面区分的强拓扑指纹。"
    },
    "locating_pin_hole": {
      "allowed_atomics": ["hole_wizard", "hole_blind"],
      "param_expectations": {},
      "metric_expectations": {
        "hole_count_delta": {">=": 1},
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_inner_cylindrical_face": true
      },
      "notes_zh": "定位销孔。配合公差与双孔位置度是设计要点，但公差不在 CDSL 当前表达能力内，机器只能查到 存在性/数量；配合语义写 why。"
    },
    "bearing_seat": {
      "allowed_atomics": ["extrude_add_blind", "cylinder_add", "revolve_add", "hole_wizard"],
      "param_expectations": {},
      "metric_expectations": {},
      "topology_expectations": {
        "creates_cylindrical_fit_surface": true
      },
      "notes_zh": "轴承位（轴颈或座孔）。功能型语义，几何签名天然宽：内核是圆柱配合面（外圆或内孔），方向（增/减材）与安装形式有关。尺寸配合关系写 why。"
    },
    "shaft_passage": {
      "allowed_atomics": ["hole_wizard", "hole_blind", "extrude_cut_through"],
      "param_expectations": {
        "end_condition.type": {"in": ["through_all", "through_all_both"]}
      },
      "metric_expectations": {
        "hole_count_delta": {">=": 1},
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_inner_cylindrical_face": true
      },
      "relations": ["axis_aligned_with_body_center_or_axis"],
      "notes_zh": "过轴通孔。贯穿是强约束（签名可查）；同心是典型但非必然（签名标注为关系提示）。"
    },
    "press_fit_boss": {
      "allowed_atomics": ["extrude_add_blind", "cylinder_add"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {">": 0}
      },
      "topology_expectations": {
        "creates_outer_cylindrical_face": true
      },
      "notes_zh": "压配合凸台：增材圆柱特征。过盈量等配合信息写在 why，几何只可查 增材+圆柱面。"
    },
    "alignment_datum": {
      "allowed_atomics": ["reference_plane", "reference_axis", "extrude_add_blind", "hole_blind"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {">=": 0}
      },
      "topology_expectations": {},
      "notes_zh": "对中/对位基准结构。可以是参考几何（零材料变化）也可以是小凸台/销孔；签名宽，依赖 why。"
    },
    "mounting_boss": {
      "allowed_atomics": ["extrude_add_blind", "cylinder_add"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {">": 0}
      },
      "topology_expectations": {
        "creates_outer_cylindrical_face": true
      },
      "notes_zh": "安装凸台：增材圆柱特征，常带后续紧固孔（组合语义）。"
    },
    "mounting_foot": {
      "allowed_atomics": ["extrude_add_blind"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {">": 0}
      },
      "topology_expectations": {
        "creates_planar_faces": true
      },
      "notes_zh": "安装底脚：增材板状特征，形成安装平面。"
    },
    "lifting_eye": {
      "allowed_atomics": ["extrude_add_blind", "revolve_add", "sweep_add"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {">": 0}
      },
      "topology_expectations": {
        "creates_inner_cylindrical_face": true
      },
      "notes_zh": "吊环/吊耳：增材结构带贯穿吊孔（吊索穿过）。孔的存在是较强指纹。"
    },
    "slot_adjustment": {
      "allowed_atomics": ["extrude_cut_blind", "extrude_cut_through", "hole_wizard", "hole_blind"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_inner_planar_walls": true
      },
      "notes_zh": "调整长孔/滑槽：允许位置调节的细长切口。典型实现：长圆 polygon 切除，或两孔+直切。"
    },
    "coolant_channel": {
      "allowed_atomics": ["hole_wizard", "hole_blind", "extrude_cut_through", "sweep_add"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_inner_cylindrical_face": true
      },
      "notes_zh": "冷却通道。与 lubrication_gallery 几何签名几乎相同（能力边界案例），区分靠 why 与介质上下文。"
    },
    "lubrication_gallery": {
      "allowed_atomics": ["hole_wizard", "hole_blind", "extrude_cut_through", "sweep_add"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_inner_cylindrical_face": true
      },
      "notes_zh": "润滑油路。同上，几何上与冷却通道不可分。"
    },
    "vent_hole": {
      "allowed_atomics": ["hole_wizard", "hole_blind", "extrude_cut_through"],
      "param_expectations": {},
      "metric_expectations": {
        "hole_count_delta": {">=": 1},
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_inner_cylindrical_face": true
      },
      "notes_zh": "排气孔：小直径贯穿孔，通常贯穿（呼吸/排气的功能要求）。"
    },
    "drain_port": {
      "allowed_atomics": ["hole_wizard", "hole_blind", "extrude_cut_through"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_inner_cylindrical_face": true
      },
      "notes_zh": "排液口。位置在最低点是设计要点但不在几何签名能力内，写 why。"
    },
    "fluid_inlet": {
      "allowed_atomics": ["hole_wizard", "hole_blind", "extrude_cut_through", "extrude_add_blind"],
      "param_expectations": {},
      "metric_expectations": {},
      "topology_expectations": {},
      "notes_zh": "进液口。可能是孔（减材）也可能是接管凸台+孔（增减组合），签名宽。"
    },
    "process_corner_relief": {
      "allowed_atomics": ["extrude_cut_blind", "extrude_cut_through", "chamfer", "fillet"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {},
      "notes_zh": "工艺让位（避让刀具/相邻件干涉）。材料切除量小是典型特征。"
    },
    "weld_prep": {
      "allowed_atomics": ["chamfer"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_cone_face": true
      },
      "notes_zh": "焊接坡口：倒角原子直接映射（坡口即倒角），锥面是强指纹。"
    },
    "machining_setup_tab": {
      "allowed_atomics": ["extrude_add_blind"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {">": 0}
      },
      "topology_expectations": {},
      "notes_zh": "装夹工艺台：临时增材，后续工序去除。生命周期语义写在 why（几何本身与普通小凸台不可分）。"
    },
    "inspection_access": {
      "allowed_atomics": ["hole_wizard", "hole_blind", "extrude_cut_through"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_inner_cylindrical_face": true
      },
      "notes_zh": "测量/探针可达孔。"
    },
    "stress_relief_fillet": {
      "allowed_atomics": ["fillet"],
      "param_expectations": {
        "radius_mm": {">": 0}
      },
      "metric_expectations": {
        "volume_delta": {"<": 0},
        "face_count_delta": {">": 0}
      },
      "topology_expectations": {
        "creates_torus_face": true
      },
      "notes_zh": "应力缓解圆角。torus 面（圆角面）+面数增加是修饰操作生效的强指纹；与 cosmetic_surface 的区别是用途而非几何。"
    },
    "stiffening_rib": {
      "allowed_atomics": ["extrude_add_blind"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {">": 0}
      },
      "topology_expectations": {
        "creates_planar_faces": true
      },
      "notes_zh": "加强筋：增材薄壁特征。薄（相对壁厚）是定义的一部分但属跨字段相对约束，初稿不做机器检查。"
    },
    "weight_relief": {
      "allowed_atomics": ["hole_wizard", "hole_blind", "extrude_cut_blind", "extrude_cut_through"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {},
      "notes_zh": "减重（孔/槽）。通常多孔或多腔（volume delta 显著为负）。"
    },
    "mass_saving_pocket": {
      "allowed_atomics": ["extrude_cut_blind"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_planar_faces": true
      },
      "notes_zh": "减重腔：盲切腔体，不留穿。与 weight_relief 的区别是形式（腔 vs 孔阵）。"
    },
    "load_path_flange": {
      "allowed_atomics": ["extrude_add_blind", "revolve_add"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {">": 0}
      },
      "topology_expectations": {},
      "notes_zh": "承载法兰/接盘。功能型语义，签名宽。"
    },
    "wall_thickness_transition": {
      "allowed_atomics": ["shell", "extrude_add_blind"],
      "param_expectations": {},
      "metric_expectations": {},
      "topology_expectations": {},
      "notes_zh": "壁厚过渡。实现多样（抽壳/变截面拉伸），签名宽。"
    },
    "gear_teeth": {
      "allowed_atomics": ["gear_add"],
      "param_expectations": {
        "module_mm": {">": 0},
        "teeth_count": {">=": 8}
      },
      "metric_expectations": {
        "volume_delta": {">": 0}
      },
      "topology_expectations": {
        "creates_involute_or_bspline_faces": true
      },
      "notes_zh": "轮齿：gear_add 原子专属。渐开线/自由曲面齿面是强指纹（亦可用于检测 gear_add 是否真的生成几何）。"
    },
    "rack_teeth": {
      "allowed_atomics": ["rack_add"],
      "param_expectations": {
        "module_mm": {">": 0}
      },
      "metric_expectations": {
        "volume_delta": {">": 0}
      },
      "topology_expectations": {
        "creates_involute_or_bspline_faces": true
      },
      "notes_zh": "齿条齿：rack_add 原子专属。"
    },
    "thread_drive": {
      "allowed_atomics": ["thread_add"],
      "param_expectations": {
        "pitch_mm": {">": 0}
      },
      "metric_expectations": {
        "volume_delta": {">": 0}
      },
      "topology_expectations": {
        "creates_thread_helix": true
      },
      "notes_zh": "传动螺纹（外螺纹实体段）：thread_add 专属，螺旋面是强指纹。"
    },
    "cam_track": {
      "allowed_atomics": ["sweep_add", "extrude_cut_through", "extrude_cut_blind"],
      "param_expectations": {},
      "metric_expectations": {},
      "topology_expectations": {
        "creates_bspline_curve_geometry": true
      },
      "notes_zh": "凸轮轨道：曲线扫掠或曲线槽，B 样条路径/曲线是其指纹。"
    },
    "bend_wing": {
      "allowed_atomics": ["bend_add"],
      "param_expectations": {
        "chain": {">=": 1}
      },
      "metric_expectations": {
        "volume_delta": {">": 0}
      },
      "topology_expectations": {
        "creates_cylindrical_bend_face": true
      },
      "notes_zh": "折弯翼：bend_add 原子专属，折弯内/外圆柱面是指纹。"
    },
    "cosmetic_surface": {
      "allowed_atomics": ["fillet", "chamfer"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {"<": 0}
      },
      "topology_expectations": {
        "creates_torus_face": true
      },
      "notes_zh": "外观修饰（倒圆/倒角）。与 stress_relief_fillet 几何签名几乎相同（能力边界案例），区别写 why。"
    },
    "datum_plane_feature": {
      "allowed_atomics": ["reference_plane"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {"==": 0},
        "face_count_delta": {"==": 0}
      },
      "topology_expectations": {},
      "notes_zh": "设计基准面：零材料变化 + 零拓扑变化 + 特定原子，是全部签名中最确定的一条（强指纹）。"
    },
    "datum_axis_feature": {
      "allowed_atomics": ["reference_axis"],
      "param_expectations": {},
      "metric_expectations": {
        "volume_delta": {"==": 0},
        "face_count_delta": {"==": 0}
      },
      "topology_expectations": {},
      "notes_zh": "设计基准轴：同上，强指纹。"
    }
  }
}