Performance Hub 徽标Performance Hub
网站版块： 文档

故障排除

本页内容

以症状为出发点诊断人员/AI 层的问题。如果是摄像头、录像、上传或设备问题，请先查看 CCTV 故障排除：本页的所有内容都假定视频本身运行正常。

People 时间线上没有任何内容

时间线显示 "No face detections — There are no face detection items in this current view range of the timeline."

  1. **人员追踪是否已开启？**该设置按摄像头配置，默认关闭。请在摄像头与设备中检查每个摄像头。
  2. **检测阈值筛选器是否隐藏了所有内容？**默认情况下，人员需要在足够长的时间内有足够多次检测才会显示。关闭阈值筛选器：如果人员出现了，说明他们只是略低于最低要求。
  3. 检查日期窗口：1D/2D/3D 范围和日期选择器很容易停留在错误的日期上。
  4. **摄像头是否真的拍到了人脸？**人员检测需要大小和角度合适的人脸。垂直向下拍摄的吸顶摄像头检测到的是头顶，而不是人脸。请在实时画面中检查摄像头的取景。
  5. 功能启用：如果整个 People 区域都不存在，或 API 返回 "People feature is not enabled for this facility"，说明该功能未启用；请联系您的客户经理。

某位会员始终未被识别（总是显示 "Unsure"）

这是最常见的问题，几乎总是与照片有关：

  1. 检查照片状态。在 People 列表中找到该会员。"Invalid Photo" 标记（工具提示会显示分数和失败原因）或 "Not Processed" 状态意味着人脸匹配没有可用的照片。请在您的会员系统中修正照片，或直接编辑照片（"Edit Profile" → "Change"）。
  2. 完全没有照片？Self Learning 仍然可以通过到访关联识别他们：检查他们是否在其队列中，并确认 Enhanced AI Analysis 已开启。
  3. **手动识别一次。**在其 unsure 档案上使用 "Identify This Person" 操作会立即完成关联，不断积累的影子照片也会改善今后的匹配。
  4. 持续出现差一点就匹配的情况（悬停弹出框显示相似度略低于 85%）→ 请参阅人脸识别调优，但在调整阈值之前，请先改进照片。

同一个人不断获得新的 "Unsure" 档案

识别功能没有将其多次到访关联起来：

  1. 合并重复档案：在时间线上选择这些档案并合并。每次合并都会整合人脸参考，使下一次到访更有可能被关联。
  2. 检查摄像头图像质量：球罩脏污、逆光（摄像头正对明亮的入口）和光线不足，都会导致参考照片质量太差而无法匹配。解决方法在于摄像头画面，而不是设置。
  3. 如果问题遍及整个设施，可能是影子档案的质量预设对您的光照条件而言过于严格，请参阅症状对照表。

识别出错误的人

这种情况很少见，但值得认真对待：

  1. **修正记录：**打开此人的档案并检查其影子照片：错误合并或不良的自动添加照片通常一眼就能看出。删除错误的图像，或合并/重新识别到正确的会员。
  2. **如果关联是由 Self Learning 建立的，**请在该记录上使用 "Unlink"（"the self-learn record will be reverted"），并填写原因 "Reject" 该匹配，以免再次被建议。
  3. **收紧匹配：**将 Member Matching 调向 Strict，请参阅人脸识别调优。

海报/人体模特/电视不断被识别为人员

这是按设计运行的结果，并且有专门的解决方法：将其加入黑名单。打开该误检人员的菜单 → "Add to Blacklist"，并填写原因（"e.g. Store Mannequin"）。今后的检测会在任何处理之前被丢弃。如果从第二个摄像头角度仍有检测出现，请从其中一次检测再添加一个黑名单条目。

报告为空或缺少区域

  1. 报告按设计存在延迟：快照在夜间针对前一天生成。全新的设施从第二天开始才能看到数据。
  2. "No zones configured — assign cameras to access zones in Settings"：区域分析需要已分配摄像头的访问区域。
  3. KPI 与签到次数相比偏低：检查哪些摄像头开启了人员追踪；报告数据仅来自经过分析的摄像头。

访问违规看起来不正确

  1. 设置后出现的误报违规几乎总是规则错误：某个合法计划不在区域的允许列表中。在怀疑会员行为之前，请先检查该区域的 Membership Plans 规则。
  2. **请记住定义：**违规是指与计划规则不符（"excluded, or not in the allowed plans"），包括 Access Hours 中的时间窗口。会员即使计划正确，在错误的时间出现仍属违规。
  3. 开放区域从不产生违规：如果您希望标记为 "Anyone can access" 的区域产生违规，需要先为其设置规则。
  1. 必须开启 Enhanced AI Analysis：关闭时，关联根本不会运行（设置部分也会被隐藏）。
  2. 检查证据标准：档案需要达到最少关联到访次数（默认 8 次）。In Pipeline 选项卡会显示每个档案的进度（"N/M visits"）；不常来的访客需要数周时间才能积累足够的证据。
  3. 签到记录必须正在同步：没有签到数据就无法关联。请使用 insights_checkins MCP 工具或查看您的 Partner 集成状态进行核实。
  4. "No Match" 选项卡中的记录较多，通常是总是一起到达的伴侣/搭档：系统拒绝在两位候选人之间猜测。请手动识别其中一人。
  5. "Unable to Link" 选项卡中的记录较多，说明会员系统的数据质量存在问题：通常是记录缺少完成关联所需的字段。

合并、识别或删除似乎卡住了

这些操作作为受跟踪的后台进程运行，重新归属较长的检测历史需要时间。卡片会显示临时状态（"PROCESSING"、"DELETING..."）；合并会显示 "Processing N of M…"，部分失败时提供 "Retry Failed" 选项；删除失败时会显示 "DELETE FAILED - RETRY"。请先重试一次，如仍无效，再提供人员 ID（"Copy Person ID"）联系支持团队。

联系支持团队时

请提供：设施名称、Person ID（可从任意图块菜单或档案中复制）、涉及的摄像头、日期/时间窗口，以及（对于识别问题）该会员的照片状态是否有效。附上悬停弹出框（显示相似度分数）的匿名化截图，可以加快大多数匹配问题的调查。