# 机器人线束装配试验表：字段与计算

版本：2026-09-23。配套文件为 robot-trial-template.csv 与 robot-trial-demo.csv。
CSV 使用 UTF-8 BOM，可从 Excel“从文本/CSV”或 LibreOffice 打开；分隔符为逗号。
字段名保留英文，便于跨语言团队合并记录。下表给出中文释义。

一行是一件线束从约定起点开始的一次完整流程尝试。试验开始前写明 unit_definition；
示例的边界是送料开始至判定合格/失败且工位恢复可接收下一件。重试留在原行，不另算新件。
工件、夹具、程序、条件或计时边界变化时另建 batch_id。同一件只做插入阶段的试验另建批次，
不能混入整件流程分母。这个建议表需要按本项目的产品要求补充实际验收方法。

| 字段 | 含义与填写方式 |
| --- | --- |
| data_kind | 实测填 measured；演示文件为 synthetic_example，不能混入实测汇总 |
| batch_id / trial_id | 条件一致的试验批次 / 批次内唯一尝试编号 |
| unit_definition | 工件单位、起点、终点；是否包含送料、检验、恢复 |
| drawing_revision / component_lot | 线束图纸版本 / 端子、塑壳、线缆批次引用 |
| fixture_program_revision / condition_id | 夹具与程序版本 / 试验条件记录引用 |
| first_pass_ok | 无重试且完成本批次规定验收：1；已确认未首遍通过：0；未知留空 |
| final_ok | 允许的重试完成后的验收结果：1 或 0；未判定留空 |
| retry_count | 本次尝试内追加的自动重试次数；无重试明确写 0；未知留空 |
| human_recovery | 有人工恢复填 1，无人工恢复填 0，未知留空；不是参与人数 |
| occupancy_seconds | 包括本次失败与恢复的占用秒数；缺失留空，不用 0 补齐 |
| first_failed_stage | 首个失败阶段，如 feed、alignment、insertion、locking、inspection；无失败填 none |
| lock_check / electrical_check | 按本项目方法的检查状态：pass、fail、not_measured 或 not_applicable；方法和限值置于 evidence_ref |
| evidence_ref | 同编号原始日志、检查方法与判据、图像/视频位置；演示数据没有实测证据 |
| notes | 损伤、退针、线序、异常恢复或额外检查的记录 |

## 使用演示记录复算

robot-trial-demo.csv 中 6 行全部为虚构数据，展示记录方法，未进行实物测试。它们有相同
unit_definition、条件与版本，首遍、最终判定和占用时间均完整：

- 启动尝试 N = 6。
- first_pass_ok 为 1 的行有 4 条，首遍通过率 = 4 / 6 = 66.7%。
- final_ok 为 1 的行有 5 条，最终合格比例 = 5 / 6 = 83.3%。
- occupancy_seconds 合计 = 30 + 30 + 50 + 70 + 30 + 30 = 240 秒；平均每次占用 40 秒。
- human_recovery 为 1 的行有 1 条；retry_count 合计为 2 次。
- T004 在插入阶段失败，所以后续锁止和电气检查记 not_measured；这不妨碍其整件最终失败判定。

实际汇总前先检查批次条件一致、trial_id 不重复，以及各指标的记录完整性。若 6 次启动中
有 1 次最终结果缺失，应报“已知成功数、已知失败数、缺失 1 条、启动 6 次”，暂不声称
全部尝试的最终合格比例。时间字段不完整时同样报告缺失，不把已记录部分除以全部次数。
未做电气检查不能填 pass；是否需要电气检查由本产品的试验目的与验收要求决定。

该表不包含自动计算宏，也不提供通用接触力、重试上限、样本数或设备安全参数。填写实际
限制后再执行；表中比例是描述性样本结果，不证明量产能力。