避开常见坑
配检测规则前先判断能不能做、能不能靠物理手段解决，再看类别、区域、各类型的坑、参数调整、组合条件和发布要求，最后是目前做不到的事。
先判断能不能做
- 视觉只能判看得见的状态。
- 螺丝装上了能判，拧紧了没有判不了；
- 插头插上了能判，插得紧不紧只能借「长度比例」这类间接办法；
- 力、扭矩、内部线序都看不见。
- 不能要求工人为了让 AI 看清楚多做动作（比如拧完举起来给摄像头看）。
- 做不了的当场说清楚，给替代方案：改判动作、加标志物、加传感器，或这一步靠治具防呆、AI 管前后步骤。
物理优先
- 摄像头、料盒、治具能固定就固定。固定后备料区只画检测区域、用「手在区域内」判取料，不用标注成堆的零件。
- 实在固定不了，把整个料盒标成一个类别，里面的零件不单独标，取料用「手靠近物体」指向料盒。
- 机位或料盒位置变了，先改检测区域，别急着重训。
类别
- 够用就行，规则用不到的零件不要定类别。
- 人眼都分不清的两种零件不要拆成两个类别。
- 状态类类型（互斥状态判定、物体状态变化）需要训练时把状态分成不同类别。
区域
- 推理区域要完整包住会放零件的地方，比工作区再大一圈。零件或手跨在边线上会被切掉。
- 检测区域改了不用重训，保存发布即可。
- 只有看区域的类型填区域才有用，见哪些类型看区域。计数、装配嵌入等填了也不生效，平台保存时会自动去掉。
改了推理区域必须重新训练
已经训好的工序后来才画推理区域，不能直接发布，要找研发迁移标注再训。
各类型最容易踩的坑
| 类型 | 坑 |
|---|---|
| 装配嵌入 | 多目标默认要全部进同一个容器；细长零件改用接触 |
| 物体分开 | 拿走一个不算分开；不要求之前接上过；同类多个时每一对都要分开 |
| 物体离开区域 | 必须先在区域里见过；常被手挡就勾 必须在区域外看到该物体，但零件会被拿出画面时不能勾 |
| 物体存在（选区域）/ 物体离开区域 | 上一轮留在区域里的也算；流水线、成品不马上拿走时勾 仅认新目标 |
| 物体不存在 | 一开始就没有也算满足；要判「拿走了」用「物体离开区域」 |
| 物体计数 | 全画面计数，别处的同类零件也会被数进去 |
| 物体存在 · 排除其他类别 | 只能一个目标、不能选区域；收尾步骤要勾 完成时会遮挡前置零件 |
| 物体朝向约束 | 需要旋转框模型 |
| 长度比例 | 必须有尺寸固定的参照物；比例用一体机标定，别估 |
| 手部类型 | 结果看得见的步骤别用；距离是手掌倍数不是像素 |
| 动作计数 | 只支持手动螺丝刀 |
| 物体存在（不选区域）/ 手持物体 | 别当兜底 |
| 姿态动作 / 时序动作 | 不可用，别配，也别对外承诺 |
参数调整
- 认不出细小零件：先画推理区域，再把置信度降到 0.3，最后才考虑加大推理尺寸。
- 误判通过：加长「持续命中」。
- 误报异常：加长异常持续时间，或检查类别是否容易混淆。
- 像素类阈值（距离、方位容差、接触容差）：在现场对着一体机画面调，不要凭空估。
组合条件
- 组合越复杂越难排查。能用一条单条件说清的就别组合。
- 看到「矛盾提示」先确认，别直接保存了事。
- 「都不满足」里放的条件越宽，越容易永远不满足。比如「都不满足〔手出现〕」，工人一动手就不成立。
- 逐件模式下，不属于某个工件的条件（手、异物）要勾 按整个画面判；「父容器 / 参照物」选锚点类别 = 这一件本身。
发布与设备版本
- 平台改了规则要提交审核并发布，一体机同步后才生效。
- 改工序参数要改草稿，再走审核。
- 多层组合、逐件模式（按规则判、子区域超出容器框）这些新写法，需要一体机正式版。老版本一体机拿到新写法的规则会报配置错误或判不准。
- 上线前一定在一体机上用真实操作或录像过一遍：每一步都看到通过、每种错误都能报出来。
目前做不到的事
| 事项 | 状态 |
|---|---|
| 判断拧紧、插紧的力度 | 视觉做不了 |
| 区分「拧紧」和「松开」这类相似动作 | 做不了 |
| 姿态动作、时序动作 | 不可用 |
| 第 1 步直接跳到最后一步的首尾跳步 | 报不出来；中间的跳步能报 |
| 逐件模式步骤卡片「n / N 件完成」 | 待开发（先看画面左上角） |