fix(头像): 人物头像改为'出现事件画面'而非视频首帧 - 新增 /api/oracle/person/avatar（在该人物所有出现事件中返回第一个有截图的事件画面，JSON 精确匹配）；撤销 event_thumb 的视频首帧兜底（首帧可能无人/非本人）；fam-ui 人物页改调 avatar 接口

fam-edge/src/fam_edge/api_gateway/api_gateway.py

@@ -141,27 +141,41 @@ def event_thumb(event_id):
 
     由 video_processor 处理成功后按事件时间戳定位视频帧生成：
     /opt/fam-edge/thumbs/ev_{event_id}.jpg
-    若该事件截图缺失（如旧事件/未生成），兜底返回所属视频的首帧缩略图
-    thumbs/{video_id}.jpg，避免前端图片空白。
+    截图缺失返回 404（前端隐藏，不拿视频首帧冒充该事件画面）。
     """
     if not _check_token():
         return jsonify({"error": "unauthorized"}), 401
     path = f"/opt/fam-edge/thumbs/ev_{event_id}.jpg"
     if not os.path.isfile(path):
-        # 兜底：查事件所属视频，返回视频首帧缩略图
-        try:
-            row = state.get_db()._conn.execute(
-                "SELECT video_id FROM events WHERE id=?", (event_id,)).fetchone()
-            if row and row['video_id']:
-                vpath = f"/opt/fam-edge/thumbs/{row['video_id']}.jpg"
-                if os.path.isfile(vpath):
-                    return send_file(vpath, mimetype='image/jpeg')
-        except Exception:
-            pass
         return jsonify({"error": "thumb_not_found"}), 404
     return send_file(path, mimetype='image/jpeg')
 
 
+@api_bp.route('/api/oracle/person/avatar', methods=['GET'])
+def person_avatar():
+    """人物代表画面（头像）：在该人物出现的所有事件中，返回第一个有截图的事件画面。
+
+    人物出现在多个视频/事件中，任选一个截图存在的即可（比视频首帧准确——
+    首帧可能根本没有该人物）。
+    参数: label=人物标识（如 人物A）；匹配 person_list_json 数组中的元素。
+    """
+    if not _check_token():
+        return jsonify({"error": "unauthorized"}), 401
+    label = (request.args.get('label') or '').strip()
+    if not label:
+        return jsonify({"error": "缺少 label"}), 400
+    # JSON 数组元素精确匹配（person_list_json 形如 ["人物A","人物C"]）
+    pat = f'%"{label}"%'
+    rows = state.get_db()._conn.execute(
+        "SELECT id FROM events WHERE person_list_json LIKE ? "
+        "ORDER BY id DESC", (pat,)).fetchall()
+    for r in rows:
+        p = f"/opt/fam-edge/thumbs/ev_{r['id']}.jpg"
+        if os.path.isfile(p):
+            return send_file(p, mimetype='image/jpeg')
+    return jsonify({"error": "no_avatar_found"}), 404
+
+
 @api_bp.route('/api/oracle/activity', methods=['GET'])
 def activity():
     """实时服务状态 + 最近活动流（token 校验）。