先理解任务结构
一个算法任务包含四部分：在哪些摄像头上运行、使用哪些分析能力、每项能力按什么条件成立、成立后怎样生成和发送事件。同一摄像头可以选择多项能力；共享同一底层识别的能力会复用推理结果。
新建任务
- 进入“算法任务”，点击新建。
- 填写能体现位置和目的的任务名称，例如“仓库东门人员闯入”。
- 选择一台或多台摄像头。
- 设置任务默认置信度和默认告警间隔。
- 按业务分类展开能力目录并勾选需要的能力。
- 逐项打开“能力配置”，确认该能力的独立参数和区域。
- 保存任务，等待页面返回保存结果和运行状态。
编辑已有任务
- 在任务列表找到目标摄像头，点击编辑。
- 核对左侧摄像头、任务名称和默认策略。
- 在右侧展开能力分类，查看已选能力及各自状态。
- 只修改当前要验证的项目，保存后等待任务重新加载。
- 返回任务列表确认运行状态，再做一次真实触发测试。
运行响应模式
- 及时提醒：约每秒分析 2 次，适合跌倒、闯入、逆行和即时险情，资源占用较高。
- 均衡运行：约每秒分析 1 次，适合安全穿戴、人脸、车牌、排队和计数。
- 节省资源：约每 10 秒分析 1 次，适合长期占用、滞留和物品状态。
- 定时巡检：约每 60 秒分析 1 次，适合库存、利用率和固定状态巡检。
同一摄像头上共享底层识别结果的能力会按其中响应最快的一档运行。修改响应模式后需要重新观察资源占用和事件响应时间。
置信度和告警间隔
- 置信度决定模型结果是否进入后续规则。先使用页面显示的模型推荐值。
- 可调下限来自模型候选保留阈值；低于该值的结果不会进入业务规则。
- 提高置信度通常能减少低质量结果，也可能漏掉远处、小目标或遮挡目标。
- 告警间隔只控制同一摄像头同一能力多久重复提醒一次，不影响识别是否成立。
- 单项能力选择“独立配置”后才覆盖任务默认值；否则继承任务默认值。
时序条件
- 持续确认时间：条件连续成立达到该时间后才产生正式事件，用于过滤瞬时误检。
- 短时丢检容忍：目标短暂遮挡或一两帧未检出时保留跟踪状态。
- 消失或离场确认：物品移除、车辆离场等能力必须持续看不到目标后才成立。
- 恢复等待时间：风险消失持续达到该时间后生成恢复事件。
- 关联窗口：多区域、路线、流量和重复到访在规定时间内关联同一目标。
响应频率较低时，持续确认需要结合实际采样间隔设置。不要把要求连续多帧的规则配置成比分析间隔更短的时间。
空间和区域条件
- 在能力配置中点击绘制区域。
- 沿真实业务边界依次点击，避免把无关道路、反光区域或屏幕边缘包含进去。
- 保存区域后确认目标脚点会进入区域，而不是只让检测框边缘碰到区域。
- 临边能力使用目标脚点到区域边界的画面百分比，不代表现场真实米数。
- 人车靠近使用画面二维距离，只表达摄像头画面中的风险关系。
- 越线和逆行需要选择允许方向；选择双向时不会判断逆行。
数量条件
- 最少人数、车辆或物品数达到后，结合持续时间触发。
- 最大数量填 0 时通常表示不限制上限；页面另有说明时以当前字段提示为准。
- 区域利用率中的设计容量用于计算占用率，不等于检测上限。
- 库存、动物、排队和人员数量使用同一数量控件，但业务含义随能力变化。
多区域条件
- 递进闯入：先进入警戒区，再在窗口内进入核心区。
- 路线到达：进入起点区后必须在时限内到达终点区。
- 排队外溢：主区域是正常队列区，第二个区域是外溢区。
- 有限空间监护：主区域是作业区，第二个区域是监护区。
- 多区域活动可以增加第三区域，目标必须按顺序经过。
每个区域都要单独绘制，不允许用一个大区域代替不同业务区域。
生效时段
- 全天运行时保持“全天”开启。
- 分时运行时选择星期、开始时间和结束时间。
- 结束时间早于开始时间表示跨夜，例如 22:00 到 06:00。
- 确认盒子系统时间和时区正确，否则任务会在错误时段生效。
人员身份和车牌策略
- 身份相似度用于底库匹配，不是人脸检测置信度。数值越高越不容易串人，也可能增加未识别。
- 人员身份能力使用前必须先在人员底库添加清晰照片并完成特征提取。
- 车牌名单能力使用前必须建立车辆底库，并保证车牌在画面中足够清晰。
- 黑白名单、分区权限、重复到访、禁入时段、巡检、考勤、交接和跨摄像头路线分别有独立条件。
- 跨摄像头流程只使用稳定身份或稳定车牌关联，不能用不同目标拼接路线。
事件策略
- 持续升级：事件长时间未恢复时提高事件级别。
- 重复风险升级：同一窗口内重复达到次数后升级。
- 恢复事件：风险持续消失后记录恢复，适合形成完整处置闭环。
- 组合风险：在指定窗口内同时满足两项条件才升级，例如危险区人员与 PPE 违规。
外部设备条件
任务可以要求指定 GPIO 输入处于有效或无效状态时才生成正式告警。使用前先在“硬件联动”配置并启用输入端点。输入状态未知时系统保留识别预览，但不会生成依赖该条件的正式告警。
保存后验证
- 确认任务和所选能力均显示已启用或运行中。
- 在监控大屏确认检测结果来自正确摄像头。
- 使用明确动作触发一次，核对事件时间、类型、区域和图片。
- 等待告警间隔后重复触发，确认限频符合预期。
- 做至少一种相似但不应告警的动作，检查误报。
常见错误
- 只保存任务但没有启用能力。
- 区域没有覆盖目标脚点，画面看得到但规则永远不成立。
- 生效时段与盒子时间不一致。
- 置信度一次调得过高，导致真实目标被过滤。
- 持续时间大于测试动作实际持续时间。
- 身份或车牌能力没有准备底库。
- 依赖 GPIO 的任务没有可用输入状态。
