docs: add purpose/use case for each visualization type

docs_v1.0/API_V1.0.0/TRACE/TRACE_HEATMAP_SPEC_V1.0.0.md

@@ -215,6 +215,8 @@ Y%
 
 ### V1: Face Thumbnail Timeline (臉孔縮圖時間軸)
 
+**目的**: 快速瀏覽「誰在什麼時間出現」，不需要看影片就能掌握角色出場順序。
+
 水平時間軸直接嵌入 sample 臉孔縮圖，一眼看出誰在什麼時候出現。
 
 ```
@@ -228,6 +230,8 @@ Y%
 
 ### V2: Identity Swimlane (身分泳道圖)
 
+**目的**: 對比多個角色的出場分布 — 誰是主角（出場時間長）、誰是配角（短暫出現）、哪些角色從未同時出現。
+
 每列一個 identity，橫軸為時間，用 bar 顯示該 identity 哪些時段出現在畫面中。
 
 ```
@@ -241,6 +245,8 @@ James Coburn  ░░░░░░░░░░░░████░░░░░░
 
 ### V3: Trace Duration Histogram (持續時間分布圖)
 
+**目的**: 評估 face tracker 品質 — 好的 tracker 會產生少量長 trace（同一人從頭到尾），差的會產生大量短 trace（頻繁丟失重抓）。
+
 顯示 trace 長度分布 — 大多數 trace 很短，少數很長。
 
 ```
@@ -261,6 +267,8 @@ James Coburn  ░░░░░░░░░░░░████░░░░░░
 
 ### V4: Similarity Matrix (相似度矩陣)
 
+**目的**: 自動發現「被鏡頭切斷的同一個人」— 同一演員在不同場景 reappear，trace 被打斷成多段，但 embedding 高度相似。可用來建議合併 trace。
+
 trace vs trace 的 embedding cosine similarity 熱力圖，找出「可能是同一人但被鏡頭切斷」的 traces。
 
 ```
@@ -276,6 +284,8 @@ t5  0.89 0.11 0.09 0.10 1.00
 
 ### V5: 3D Space-Time Cube (3D 時空立方體)
 
+**目的**: MR/VR 空間重現 — 把影片中的移動軌跡變成 3D 空間中的路徑。適合展演、沉浸式回放。
+
 將 trace 的 (x, y) 畫面位置 + 時間 t 以 3D 呈現，可旋轉視角。
 
 ```