# 三维查错工具

这个目录放和三维模型查错、B-rep 证据提取、结构诊断、规则验证有关的工具。它们主要面向 `.SLDPRT` / `.SLDASM` 模型本身，不处理二维 DWG 图纸。

四类查错流程的边界见：`../DIAGNOSTIC_FLOW_BOUNDARIES.md`。本目录只负责三维零件查错和三维装配体查错；二维零件图、二维装配图、公差标注表达等问题在 `tools/drawing-diagnostics` 下处理。

## SectionBrepExtractor

从 SolidWorks 零件或装配体中提取 B-rep、剖面、草图图元、面、边、区域、图像等模型证据。

它是三维查错证据包的主要生成器，适合给后续规则判断或视觉模型分析提供结构化输入。

## BrepFaultProbe

三维查错实验和调试入口。

它会调用 `SectionBrepExtractor` 等工具生成证据，并组织桥接文件、诊断提示词、阶段性实验输出。适合开发阶段快速验证某类机械设计错误是否能被证据链覆盖。

## StructuralFaultProbe

抽取装配结构相关证据，例如组件、接触、轴向关系、固定方式、支承限制等。

它偏向装配功能和结构关系，不只看单个零件的几何特征。

## ModelDiagnosticVerifier

规则验证器。

它读取模型证据和规则模板，判断模型是否满足或违反某条机械设计规则。正式查错流程中，它比 `BrepFaultProbe` 更接近“可集成的判定器”。

## RuleTemplateGenerator

规则模板生成和校验工具。

它用于把教材、图片、说明文字中的机械设计禁忌整理成可验证的规则模板。它不直接判断模型是否有错，只生成或校验规则定义。

## 说明文档

- `MECHANICAL_DIAGNOSTIC_CONTRACT.md`：三维查错证据、规则、诊断流程之间的约定。
- `MECHANICAL_DIAGNOSTIC_USAGE.md`：三维查错工具的使用示例和阶段性流程说明。