人脸识别调优
本页内容
Settings → Face Recognition 提供了识别流程背后的各项调节参数：Member Matching、Shadow Profiles 和 Self Learning（另有 Blacklist Faces，在黑名单中说明）。每个部分都提供 Lenient / Balanced / Strict 预设，所有底层阈值均可单独调整，滑块旁会显示其默认值，例如 "(Default: 30 mins)"。
调整任何设置之前的基本原则：
- Balanced 是每个部分的推荐默认值：从它开始，并保持不变，直到您积累了数周的真实数据、能够证明存在具体问题为止。
- 预设体现的是单一的取舍：Lenient 能识别更多人，但错误匹配的风险更高；Strict 几乎不会误标，但会有更多人处于 "Unsure" 状态。
- 每次只更改一个部分，并在判断效果前等待几天：效果只有在汇总数据中才会显现（请关注报告中的 Unsure % KPI）。
- 设置页面包含一个实时的 Logic Visualisation 流程图，按您设施的当前值呈现。节点可以点击（"Tap to scroll to this setting"），因此这是核实某项更改实际作用的最佳方式。
成员匹配
控制流程第 3–5 步中的判定：什么情况下可以确信一张人脸是某位会员？
图 1：Member Matching：顶部为预设，下方为实时 Logic Visualisation 流程图
预设
| 阈值 | Lenient | Balanced（默认） | Strict |
|---|---|---|---|
| Identified Match Threshold | 80 | 85 | 92 |
| Drop Threshold | 55 | 45 | 35 |
| Identified Collection Search Floor | 35 | 40 | 47 |
单项阈值
图 2：Member Matching 的各个滑块，每个滑块都标有其默认值
| 设置 | 默认值 | 作用 |
|---|---|---|
| Identified Match Threshold | 85% | 将人脸确认为会员所需的最低相似度。这是影响最大的单个滑块 |
| Drop Threshold | 45% | 低于此值时，部分匹配会被丢弃，而不是保留为 "unsure" |
| Identified Collection Search Floor | 40% | 候选人能够被搜索返回所需的最低相似度 |
| Visiting Member Bonus | +5 | 候选人近期已签到时增加的相似度分值，即到访辅助匹配 |
| Check-in Lookback Window | "(Default: 30 mins)" | 签到需要在多近的时间内才能获得加分 |
| Borderline Confidence Zone | "(Default: +7)" | 分数落在匹配阈值以上此区间内时，会进行额外的姿态检查 |
| Identified pose limits | Yaw 55° / Pitch 30° / Roll 30° | 边界匹配所接受的最大头部角度 |
何时偏离 Balanced：
- Unsure % 较高，但会员在摄像头中清晰可辨 → 先改进会员照片（在 People 列表中按 "Invalid Photo" 筛选），之后再考虑 Lenient。
- 出现任何已确认的错误识别 → 立即改用 Strict（或提高匹配阈值）：检测结果被关联到错误的身份，代价远高于一位身份不明的访客。
- 前台摄像头且签到关联范围较宽 → 在会员经过摄像头前会停留一段时间的设施，适当延长 Check-in Lookback Window 可以提高识别率；加分应保持适度。
影子档案
控制流程第 6–7 步：未匹配的人脸何时关联到现有影子档案，以及系统在创建新档案时有多严格。
图 3：Shadow Profiles：质量预设、阈值和影子档案流程图
| 设置 | 默认值 | 作用 |
|---|---|---|
| Profile Link Threshold | 80% | 将检测结果关联到现有影子档案所需的最低相似度，即"与昨天是同一位访客"的判定 |
| Duplicate Prevention Threshold | 90% | 最后一次竞态条件复查时，将"新"人脸视为已创建档案的相似度 |
| Minimum Detection Confidence | 90% | 在尝试创建档案之前，AI 必须确信图像中包含真实人脸的置信度 |
| Unidentified pose limits | Yaw 30° / Pitch 35° / Roll 60° | 照片用于创建新档案时允许的最大头部角度。该限制特意比匹配更严格，因为这张照片将成为长期使用的参考照片 |
| Quality preset | Balanced | 决定下文所述的两级照片质量门槛 |
质量预设（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）设定标准。每个底层值都可以单独调整，包括最低分辨率、清晰度、对比度、光照对称性、曝光范围、动态范围、眼睛纵横比，以及完整的 ISO 检查项（含 IR/夜视过滤器和最低总体质量分数）。但在此处进行单项覆盖应在支持团队的指导下进行；预设几乎可以满足所有实际设施的需要。
症状对照表：
| 症状 | 可能的解决方法 |
|---|---|
| 同一位访客每天都会获得一个新的 "Unsure" 档案 | 质量预设对您的光照条件而言过于严格，或 Profile Link Threshold 过高。请先尝试 Lenient 质量预设 |
| 两个不同的人被合并到同一个影子档案中 | 提高 Profile Link Threshold / 改用 Strict |
| 垃圾档案激增（阴影、反光、屏幕） | 提高 Minimum Detection Confidence；将固定的误检来源加入黑名单 |
自主学习
控制到访关联流程。仅在启用 Enhanced AI Analysis 时可见。
图 4：Self Learning 设置：证据要求和验证检查
| 设置 | Balanced 默认值 | 作用 |
|---|---|---|
| Minimum visits | 8 | 做出关联决定前所需的关联到访次数，即证据标准 |
| Lookback period | 约 2 个月（60 天） | 关联分析所考虑的历史时长 |
| Timing window | ±10 分钟 | 检测与签到需要多接近才算作关联 |
| Gender check | 开启 | 检测到的属性必须与会员记录一致，否则 → Pending Review |
| Age check | 关闭（容差 10 岁） | 可选的第二项验证 |
预设的直观理解：Lenient 以较少的证据更快完成关联（适合员工本来就会审核队列的小型设施）；Strict 要求更多到访次数和更严格的验证（适合无法接受自动错误关联的场所）。请记住，有一项结构性保障不受任何预设影响：关联结果必须指向唯一一位会员，否则结果为 No match。
无法调整的内容
为完整起见，以下是流程中按设计固定的部分：
- 黑名单检查阈值（95%）：请参阅黑名单。
- 用于保持识别准确性的自动影子照片规则（99% 以上相似度、每人少量轮换上限、冷却时间）：请参阅 Self Learning。
相关页面
- 工作原理：这些设置所驱动的流程
- Self Learning：审核控制台
- 故障排除：识别问题及其常见原因