入门
本页内容
本指南帮助设施从"CCTV 录像"阶段进入"在 People 时间线上识别会员"阶段。本指南假定您的 CCTV / VSaaS 模块已经正常运行：Edge Processor 在线、摄像头已添加、视频正在录制。
第 1 步：启用该功能
AI Insights & People 是构建在 CCTV 模块之上的一项设施功能，由您的 Performance Hub 客户经理按设施启用：
- People：核心功能，包括人员时间线、档案、会员匹配、报告、访问区域以及
insights_*MCP 工具。 - AI Insights：增强分析层，供 Self Learning 关联和热图预生成等后台处理使用。
启用后，AI Insights & People 会出现在您的 Performance Hub 侧边栏中，Access Zones、People、Face Recognition 和 Insights 分组会出现在共享的 Settings 侧边栏中。如果针对未启用该功能的设施调用 People API，将返回 "People feature is not enabled for this facility"，请参阅故障排除。
第 2 步：按摄像头开启人员追踪
人员检测需要按摄像头选择启用。在 CCTV 模块中，打开每个摄像头的设置并启用人员追踪（请参阅摄像头与设备）。
请审慎选择：
- 在入口、前台和重点区域启用：即任何需要统计到访、识别人员或覆盖访问区域的位置。
- 在人员智能没有价值的位置不启用（停车场、设备机房）：每一路经过 AI 分析的画面都会占用设备的推理容量。一般而言，启用 AI 推理时，一台设备可处理的摄像头画面数量约为仅录像时的一半；各型号的具体数值请参阅硬件。
- 隐私敏感区域（卫生间、更衣室）绝不应安装摄像头，请参阅安全与隐私。
第 3 步：开启 Enhanced AI Analysis
在 Settings → General（属于 CCTV 的设置）中，启用 Enhanced AI Analysis：
“生成更丰富的元数据，包括热力图、路径追踪和自主学习。禁用此功能还将关闭自动档案匹配。会增加存储用量。”
它用于解锁 Self Learning：关闭时，Self Learning 设置部分会被隐藏，关联流程也不会运行。没有它，基本的人脸匹配仍可使用，但对于采用本模块的设施，几乎总是应当开启它。
第 4 步：连接会员同步
会员匹配需要有可供匹配的会员。Performance Hub 的 Partner 集成会从您的会员管理系统同步以下内容：
- 会员记录：姓名、会员状态、计划、标签和档案照片。
- 签到记录：刷卡/入场事件，为到访辅助匹配和 Self Learning 提供支持。
同步的照片在用于识别之前会自动进行质量检查（清晰度、光照、姿态、遮挡，另有内容检查，会拒绝宠物或卡通等非人物图像）。未通过检查的照片会在 People 列表中显示 "Invalid Photo" 标记，您可以按 Photo Status（"Valid Photo"、"Invalid Photo"、"Not Processed"）筛选来查找它们。照片无效的会员无法进行人脸匹配，但 Self Learning 仍可以通过到访关联来识别他们。
您可以在 Settings → People → Profile Info 中控制同步哪些可选的联系信息字段（电子邮件、手机号码、地址）。
没有会员管理系统？您仍然可以手动添加人员（"Add people"），或通过文件批量 "Import Members"，请参阅人员与档案。
第 5 步：查看首批识别结果
运行一天之内，您应该会看到：
- Timeline 开始填充：打开 AI Insights & People → Timeline。已识别的会员按姓名显示；新访客显示为 "Unsure - "。请参阅人员时间线。
图 1：第一天的 People 时间线：已识别会员与 "Unsure" 访客混合显示
-
人员档案逐步完善：点击任意人员，即可查看其活动日志、到访规律和 AI 洞察。请参阅人员与档案。
-
报告从第二天开始出现：报告快照会在夜间针对前一天生成，因此 Reports 视图会在第一个完整日之后开始显示数据。
第 6 步：第一周调整
真实数据开始流入后，有几件事值得去做：
| 任务 | 位置 | 原因 |
|---|---|---|
| 将误检加入黑名单 | Timeline → 人员菜单 → "Add to Blacklist" | 海报、人体模特和屏幕每天都可能被检测为人脸，加入黑名单后会被永久丢弃。请参阅黑名单 |
| 合并重复的 unsure 档案 | Timeline → 选择图块 → "Merge" | 初期，同一位访客可能会有两个影子档案；合并可以让系统知道他们是同一个人 |
| 手动识别常客 | 人员菜单 → "Identify This Person" | 为缺少会员照片或照片质量较差的人员加快识别 |
| 审核 Self Learning 队列 | Self Learning 选项卡 → "Pending Review" | 批准或拒绝自动的会员关联 |
| 设置访问区域 | Settings → Access Zones | 将摄像头映射到区域，使报告和访问违规检测具有结构。请参阅访问区域 |
| 检查保留期限 | Settings → 云存储 | AI 元数据默认保留 24 个月，请确认这与您的隐私政策相符。请参阅安全与隐私 |
在考虑更改之前，请将识别阈值保持在 Balanced 预设至少几周。有关何时以及如何调整，请参阅人脸识别调优。