freecad-occt-debug-kit

Root-Cause Investigation Agent

面向 OCCT / FreeCAD 圆角与倒角失败场景的根因诊断 Agent + 量化 Eval 工具链。

Agent OCCT FreeCAD Root-Cause 5 维 Eval macOS Apple Silicon

这个项目在做什么

把「为什么会失败」从一句猜测，变成一条可复现、可定位、可评分、可回归的调试闭环：从可复现构建、几何采集，到自动化的根因诊断 Agent 与量化 Eval。

pinned forks + Pixi 工具链 + 幂等 bootstrap：一条命令从裸 clone 到可调试的 OCCT / FreeCAD 环境。

BREP → mesh / geom / defect 转换，并加入 BOP 面面自交校验，堵住「假绿」盲区。

observe → 定位 → 机制 → 反事实 → 结论，把诊断过程变成可追踪的决策链。

13 个 case 基线、反事实真分、弃权四态，数字漂移即回归，CI 自动把关。

确定性规则与 LLM 决策可 A/B，方便评估「模型到底贡献了什么」。

捕获的 BREP 可转成可视化资产，交给 Print viewer 端做直观检查。

# 合成 case 根因诊断 python -m agent.loop.investigate box 5 # 用自己的模型文件诊断 python -m agent.loop.investigate “brep:/abs/m.brep” 5 –edges 3

# 五维 + 弃权四态分层打分 bash agent/eval/eval.sh

环境 / 构建层成熟：一条命令从裸 clone 到可调试

几何工具成熟：60+ 离线断言 + 夹具回归

Agent + Evalv0 投产，13 case 基线

CI + 护栏离线单测门 + 基线回归门已落地