---
document_type: "experiment_report"
service: "MOMENTRY_CORE"
title: "Identity Clustering Agent 研究報告（含品質檢查 + 綁定分析）"
date: "2026-05-06"
version: "V1.1"
status: "completed"
---

# Identity Clustering Agent 研究報告

## 1. 綁定流程架構

Runner 採用雙階段策略：

```
             ┌── Stage 1: TMDb Direct Match ──┐
             │  來源: identities.face_embedding │
             │  模型: CoreML FaceNet 512-dim   │
             │  門檻: face_sim ≥ 0.55          │
             │  條件: ≥60% faces match         │
             │  結果: 294 traces (43.4%)       │
             └────────────────────────────────┘
                          │
                          ▼
             ┌── Stage 1b: Iterative Enrichment ─┐
             │  來源: bound trace multi-angle ref │
             │  機制: 每 trace 取 top-3 faces    │
             │  門檻: composite ≥ 0.50           │
             │  下限: min_face_similarity ≥ 0.30 │
             │  Round 1: 196 traces → Round 5: 1 │
             │  結果: 363 traces (53.6%)         │
             └───────────────────────────────────┘
                          │
                          ▼
             ┌── Stage 2: Centroid Clustering ──┐
             │  剩餘 trace 用 adaptive threshold │
             │  結果: 20 traces grouped         │
             └───────────────────────────────────┘
```

**總覆蓋率**: 677/677 traces (100%)，其中 657 traces bound to 8 TMDb identities，20 traces clustered。

## 2. TMDb Direct Match vs Iterative Enrichment

| 特性 | Stage 1 (TMDb) | Stage 1b (Iterative) |
|------|---------------|---------------------|
| 參考來源 | identities.face_embedding | bound trace faces |
| embedding 品質 | TMDb 官方照片（單一視角） | 影片中 multi-angle（3 視角） |
| 門檻 | 0.55 face_sim + 0.60 ratio | 0.50 composite + 0.30 min_sim |
| 受門檻修正影響 | ❌ 否 | ✅ 是（0.35→0.50） |
| 精準度 | 高（TMDb 照片 = ground truth） | 中（可能汙染，參考 RCA） |
| traces bound | 294 (43.4%) | 363 (53.6%) |
| 風險 | 低 | 汙染擴散（RCA: trace 39/45） |

## 3. Trace 品質檢查

### 3.1 取樣密度檢查

1886/2347 traces (80.4%) < 4 frames。需 swift_face dense scan。

### 3.2 人臉驗證

DeepFace 測試 10 traces 全為 human。Apple Vision confidence + landmarks 可替代 DeepFace。

### 3.3 Embedding 品質

Top 10 traces intra-trace variance: 從 0.041 (excellent) 到 0.334 (likely split)。

### 3.4 時序碰撞

修復前: Audrey Hepburn 有 114 處同 identity 碰撞。  
修復後: threshold 0.35→0.50 + min_sim 0.30，碰撞歸零。

## 4. 修復後整體影響

| 指標 | 修復前 | 修復後 | Δ |
|------|--------|--------|-----|
| DB writes | 4059 | 3971 | -88 |
| Coverage | 99.4% | 99.4% | — |
| Collision (Audrey) | 114 | 0 | -114 |
| Avg composite threshold | 0.35 | 0.50 | +0.15 |
| Min face similarity guard | 無 | 0.30 | new |
DOC
