技能介绍

要解决的问题

规模化养殖中，个体身份记录是健康追踪、精准饲喂、生产记录和种畜管理的基础。但猪、牛、羊等畜群通常密度高、外观相似，仅靠肉眼区分个体容易出错，也难以将某头牲畜的历史健康记录、生产数据稳定地关联到同一个身份上。耳标或号牌虽能辅助，但存在脱落、污损或编号与实际个体不对应的情况。本技能要解决的是：从一张照片或短视频出发，给出一个稳定的个体 ID 与置信度，让后续的追踪流程有据可依。

技能如何工作

核心能力

个体检测与定位：先在画面中定位畜禽的面部或体表区域。
畜种识别：区分猪、牛、羊等常见畜种。
面部特征比对：提取口鼻、眼睛、耳形和面部轮廓等区域进行比对。
体纹与花斑比对：利用花斑、条纹、色块等体表模式，适用于奶牛花斑或猪身斑纹等场景。
辅助特征提取：兼容耳标、号牌等可见标识。
个体 ID 匹配与置信度输出：在特征库中检索，返回匹配到的个体 ID 与置信度。
多个体同框识别：支持同一场镜像中多个个体的批量身份关联。

关键步骤

提供本地文件路径或网络 URL，输入为图片或短视频。
在技能根目录下执行 python -m scripts.smyx_livestock_individual_analysis，通过 --input 或 --url 传入目标。
脚本返回结构化结果：个体 ID、置信度、匹配到的特征区域，以及可访问的报告链接。
使用 --list 查询历史报告清单，数据统一从云端接口读取，并以 Markdown 表格形式输出。
常用可选参数：--pet-type 保持 other、--detail 控制输出详细程度（basic / standard / json）、--output 指定结果文件。

适用边界与注意点

拍摄要求：优先正面或近正面拍摄，距离建议 30cm～150cm，面部或目标体表区域占画面比例不低于 1/4。
光照与运动：光照要均匀，避免强逆光和大面积阴影；目标尽量保持静止或缓慢移动，减少运动模糊。
文件限制：图片支持 jpg / png / jpeg，视频支持 mp4 / avi / mov，单文件不超过 10MB；短视频建议 5～15 秒。
体纹识别：使用体纹特征时尽量正侧面拍摄，减少遮挡。
结果性质：本技能只输出个体身份识别结果，不提供管理建议或生产建议。正式的生产档案和种畜谱系登记仍需结合养殖场台账和人工复核。