massive-cloud/alg/00_算法交付与输出规范/算法工程师通知模板.md

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

各位算法同事：

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

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. 交付前请执行：

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；测量结果字段发生冲突时，以新规范为准。