# 算法输出规范执行通知（转发模板）

各位算法同事：

为统一平台“算法结果”中的任务号、测量位置、单位、公差和中间数据，从现在起请新交付算法以及存量算法的后续版本遵循：

`alg/00_算法交付与输出规范/README.md`

目录内同时提供：

- `result.schema.json`：完整 JSON Schema；
- `validate_result.py`：零第三方依赖校验器；
- `examples/head-car-coupler-and-deflection.result.json`：正确示例；
- `examples/invalid-legacy-result.json`：禁止的旧写法反例。

本次最关键的变化：

1. 正式测量结果必须单独返回 `taskNo`，不再把任务号写在 `name` 中；
2. `name` 只保留纯项目名称；同一任务的左/右等多个结果使用 `position` 区分；
3. 每个指标必须提供稳定的 `metricCode`；
4. 头车/中车必须依据输入的检测对象选择任务号，不得默认猜测；
5. `dx_y`、`dx_z`、拟合残差、法向量等中间量不得进入正式 `measurements`，统一放入 `extra.intermediateMetrics`；
6. 正式结果只允许 `pass`、`warning`、`fail`，不再用 `info` 表示可交付项；
7. 交付前请执行：

```bash
python3 alg/00_算法交付与输出规范/validate_result.py /path/to/result.json
```

请各算法负责人先检查自己的输出，并回复以下信息：

- 指标与正式业务任务号的映射是否完整；
- 哪些输出是正式测量值，哪些只是计算中间量；
- 同一指标是否会因头车/中车等检测对象对应不同任务号；
- 单位、公差、理论值和换算口径是否与正式任务清单一致；
- 预计从哪个算法版本开始按新规范交付。

车钩与挠度算法请重点确认：

- 任务 5 的左梁、右梁作为同一任务的两个 `position` 输出；
- 头车车钩对应任务 8、10，中车对应任务 9、12；
- `dx_y`、`dx_z` 仅保留为中间量；
- “右偏转角”最终交付口径是角度 `°`，还是偏差值/基准长度（例如 `0.073/700 mm`）。

平台插件的运行、输入、进度和产物接入仍参考 `docs/algorithm-integration-spec.md`；测量结果字段发生冲突时，以新规范为准。