参考

本页内容

快速查阅页面：列出每个选项、默认值和限制，并链接到对其进行说明的页面。

功能要求

要求	值
前置模块	CCTV 模块（该模块需要设备管理）
设施功能	People（核心）· AI Insights（增强后台分析）
按摄像头的前提条件	已启用人员追踪
Self Learning 前提条件	已开启 Enhanced AI Analysis（CCTV Settings → General）
功能关闭时的 API 响应	"People feature is not enabled for this facility"
访客共享令牌	无法访问人员或人脸检测数据
AI 摄像头容量	每台设备约为仅使用 VSaaS 时容量的一半，请参阅硬件

会员匹配阈值

详情：人脸识别调优

设置	Lenient	Balanced（默认）	Strict
Identified Match Threshold	80	85	92
Drop Threshold	55	45	35
Identified Collection Search Floor	35	40	47

设置	默认值
Visiting Member Bonus	+5
Check-in Lookback Window	30 mins
Borderline Confidence Zone（姿态检查区间）	+7
Identified pose limits（yaw / pitch / roll）	55° / 30° / 30°
黑名单检查	95%：固定值，最先运行，不可配置

影子档案阈值

详情：人脸识别调优 · 工作原理

设置	默认值
Profile Link Threshold	80
Duplicate Prevention Threshold	90
Minimum Detection Confidence	90
Unidentified pose limits（yaw / pitch / roll）	30° / 35° / 60°
Quality preset	Lenient / Balanced / Strict
Tier 1 — Fast Quality Checks	Sharpness · Contrast · Lighting · Exposure · Dynamic Range · Eye Aspect Ratio（约 10–60 ms）
Tier 2 — ISO Quality Checks	Face Occlusion · Eyes · Mouth · Head Pose · Illumination · Exposure · Compression · Expression（约 5–10 s）

Self Learning 参数

详情：Self Learning · 人脸识别调优

参数	Balanced 默认值
最少关联到访次数	8
回溯期	约 2 个月
签到前后的时间窗口	±10 分钟
Gender check	开启
Age check	关闭（容差 10 岁）
候选规则	恰好一位候选会员，否则为 No match
自动影子照片	99% 以上相似度 · 每人最多 6 张 · 两次添加之间有冷却时间

**队列状态：**Pipeline · Pending Review · Automatically Linked · Unable to Link · No Match · Rejected · Manually Approved · Monitoring · Linking… · Link Failed。

时间线

详情：人员时间线 · Settings → People Timeline

设置/限制	值
Minimum Time to Merge Detections	45 mins（默认）
最少检测次数（阈值筛选器）	3（默认）；筛选器工具提示中写的是 "at least 5 detections and a duration of 5 minutes or more"
最短时长（阈值筛选器）	5 mins（默认）
Show No Check-In Badge	关闭（默认）
天数范围选项	1D / 2D / 3D
排序选项	Last Seen（默认）· Visit Time · Name · Visit Count
批量选择上限	100 人
合并上限	每次合并 2–20 个档案

**分类标签：**All · Facility Members · Current · EA Members · From Other Clubs · Unidentified · Unsure · Expired · On Hold · Card Sharing · Tailgating · Access Violators。（大多数标签在计数为零时隐藏。）

People 列表

详情：人员与档案

控件	选项
快速选项卡	All · Active · Expired · Staff
Photo Status 筛选器	Valid Photo · Invalid Photo · Not Processed
Sort By	Recently Added（默认）· Last Name (A-Z / Z-A) · First Name (A-Z / Z-A) · Membership Updated
视图	网格 · 紧凑网格 · 列表
新会员标记	"Active [NEW]"：5 天内加入
导入步骤	Upload File → Map Fields → Preview & Import

**同步字段：**始终同步：姓名、出生日期、性别、档案照片、会员状态、会员类型、计划、标签；可选：电子邮件、手机号码、地址、创建时间、更新时间（电子邮件和手机号码默认开启）。

报告

详情：报告

项目	值
快照生成	夜间生成，针对前一天（设施当地时间）
KPI	Total Tracks · Unique People · Avg Visit · Unsure % · Peak Hour · Access Violations
热图模式	Tracks · Detections · People · Unsures
热图显示选项	Peak Hour Heatmap · Cell Counts · Violations
人口统计年龄段	18-24 · 25-34 · 35-44 · 45-54 · 55+
情绪分数范围	0–100
情绪区间	Positive ≥ 70 · Neutral 40–69 · Negative < 40
情绪预设	Default · Gym/Fitness · Custom

定义：****轨迹是 "one continuous sighting of the same person"；总检测次数是 "every face detected across all cameras"；访问违规是指 "where a member's active membership plan was not permitted by the zone's access rules" 的进入记录。

访问区域

详情：访问区域

项目	值
区域标记	Anyone can access · Membership plan access · Restricted
规则输入	会员计划 · 会员类型 · 标签（包含或排除）
区域来源	本地创建 · 从会员系统同步（通过关联/合并进行组合）
结构	区域可以嵌套：子区域的摄像头汇总到父区域
子选项卡	Camera Assignment · Membership Plans · Access Hours

数据生命周期

详情：安全与隐私

项目	值
每个设施的人脸集合	已识别 · 未识别（影子档案）· 黑名单：按设施相互隔离
AI Metadata 保留期限	默认 24 个月，可配置，请参阅存储与保留
影子照片	在档案存在期间保留；不受基于时间的清理影响
删除途径	Delete this person（未识别人员）· Delete Member（档案的 Advanced 部分）· 保留期限清理

MCP 工具

详情：集成与 MCP

工具	用途
`insights_timeline_search`	搜索检测时间线
`insights_people_search`	搜索已登记人员
`insights_person_get`	某个人的完整档案
`insights_person_activity`	某个人的到访历史
`insights_checkins`	会员签到历史
`insights_match_unidentified`	将未识别检测与签到记录相关联
`insights_report_snapshots`	每日报告快照

这七个工具都需要 CCTV 模块访问权限，并且目标设施需启用 People 功能。