Files
reducers/backend/skill/references/validation-checklist.md
T

71 lines
2.4 KiB
Markdown

# Validation Checklist
## Reducer 验收
读取:
```text
output/runs/<run>/formula/formula_instance.json
output/runs/<run>/placement/placement_plan.json
output/runs/<run>/cad/assembly_manifest.json
output/runs/<run>/validation/validation_report.json
```
必须满足:
- `validation_report.overall_passed == true`
- `formula_instance.run_id == placement_plan.run_id`
- `formula_instance.run_id == assembly_manifest.run_id`
- `formula_instance.derived.ratio` 满足 requirement 的 `target_ratio ± ratio_tolerance`
- `cad/reducer.step` 存在且非空
- `cad/reducer.model.json` 存在且非空
- `cad/reducer.session.json` 存在且非空
- `placement/placement_plan.json` 存在
- `assembly_manifest.components[*].center_xyz_mm` 与 `placement_plan.component_poses[*].center_xyz_mm` 一致
## 必须关注的验证项
validation report 中以下类别不能失败:
- 静态公式验证:齿数正整数、齿数大于 17、齿数闭合、行星均布、中心距、外径、行星间隙。
- 运动学验证:速比、方向、fixed member 速度为 0、rigid 两端速度相等、残差。
- 拓扑关系验证:`external_mesh`、`internal_mesh`、`revolute_joint`、`fixed`、`rigid`、`coaxial`。
- 齿轮啮合验证:中心距、齿顶齿根间隙、backlash、齿相位、运动采样残差。
- 工业物理关系验证:轴承、销轴、螺栓、配合、间隙、联轴和刚性连接。
- OCP 几何检测:不得有未允许的正体积干涉。
## Joint module 验收
读取:
```text
output/runs/<run>/joint_module_manifest.json
output/runs/<run>/joint_module_validation_report.json
output/runs/<run>/joint_interference_report.json
output/runs/<run>/reducer/validation/validation_report.json
```
必须满足:
- `joint_module_validation_report.overall_passed == true`
- `joint_module.step` 存在且非空
- 电机 STEP、外壳 STEP、减速器 STEP 来源真实存在
- 电机轴线、外壳轴线、减速器主轴同轴检查通过
- 电机输出到太阳轮输入的关系存在
- 齿圈固定到外壳关系存在
- 行星架输出关系存在
- reducer 内部 validation report 通过
## 失败处理
如果验证失败,不能说生成成功。必须报告:
- 失败文件链接
- 失败 check code
- message
- actual
- expected
- 如果是干涉:component pair、common volume、possible cause、suggested fix
如果 SimpleCADAPI 或 OCP 缺失,报告环境错误。不要跳过后声称成功。