宠物赛跑犯规识别（抢跑/窜道）

要解决什么问题

宠物竞速（灵缇、赛马、障碍赛等）里，抢跑和窜道往往发生在毫秒级：人眼很难同时盯住发令、各道起跑和跨线顺序。裁判需要基于视频的客观依据——谁在发令前动了、是否偏离本道进入邻道——而不是主观回忆。

本技能面向赛道起点或终点区域的清晰视频（本地文件或 URL），在「赛事裁判辅助」场景下做犯规检测；它不提供赛程编排、训练建议或最终判罚结论，只输出可复核的结构化判定与证据定位。

技能如何工作

扮演专业赛事裁判 AI，围绕发令与赛道几何做时序分析，典型能力包括：

• 发令信号识别与起跑时间提取，用于判断是否存在抢跑（起跑早于发令）
• 道次识别与跟踪、窜道行为检测（偏离自身赛道进入邻道）
• 终点通过顺序判定，以及犯规证据片段在视频中的定位
• 输出结构化裁判结果；需要时可走云端查询历史检测报告（清单须来自 API，不得用本地记忆拼凑）

标准流程可以概括为：准备符合要求的赛道视频 → 系统在内部完成身份关联（不向用户索要身份参数）→ 在技能根目录调用 scripts/smyx_race_foul_detection_analysis（--input / --url，可选 --pet-type 等）→ 阅读分析报告与报告链接。历史列表用 --list，表格字段含报告名称、宠物类型、分析时间与查看链接。

适用边界与注意点

• 视频建议 mp4/avi/mov，单文件上限约 10MB；起跑时序精度依赖画质与帧率，文档建议 ≥ 60fps。
• 抢跑反应时下限、窜道容差等阈值由 API 端按赛事规则配置，客户端只做调用与呈现。
• 分析结果仅供裁判参考，现场主裁判决为准；勿把技能输出当作唯一法律依据。
• 附件会自动落盘处理；网络 URL 由 API 服务下载，无需用户本地下载后再传。