熟人识别分析

要解决的问题

在家庭监控、办公区域人员管理等场景中，上传一段视频或一张截图后，往往需要快速确认画面里出现的是不是已知人员，以及其出现位置。直接人工回看帧序列既慢，也容易漏掉多个目标。熟人识别分析把这类需求收敛为：先录入熟人底库，再对图片/视频做人脸检测、特征提取与底库比对，最终给出结构化结果。

技能如何工作

核心流程围绕 scripts/familiar_person_recognition_analysis.py 展开：

• 输入：支持本地图片或视频路径，也支持网络 URL，由服务端自动下载。
• 识别：对画面中的人脸进行检测、特征提取，并与已录入的人脸底库比对。
• 输出：返回识别对象的位置、身份标注、分析建议，以及可用于查看详情的报告链接。
• 历史查询：通过 --list 从云端接口读取历史报告清单，并按日期范围过滤，避免依赖本地记忆或手工汇总。

适用边界

该技能适合做熟人核验、区域人员识别的辅助分析，不替代法定身份核验。使用前需要先把目标人脸录入底库；支持 jpg、jpeg、png、mp4、avi、mov，单文件最大 10MB。历史报告应以云端返回数据为准，输出结果通常包含位置信息和报告链接，便于后续追溯。