# Pipeline 進度報表標準格式

**版本**：v2  
**日期**：2026-05-07  
**提供者**：M5

---

## 報表範本

```
=== Job {id} 完整報表 (frame總量: {total_frames}) ===

── Processors ──
Proc   St   Start End    已產出            已處理
------ ---- ----- -----  -------------- ----------
cut    ✅    04:28 04:43  2,260 scenes   169625
face   ✅    04:29 05:05  1,121 frames   169625
ocr    ✅    04:29 04:51  1,212 frames   169625
pose   ✅    04:29 04:40  4,211 frames   169625
yolo   ⏳    04:28 -      7,852 frames   6,803
asr    ⏳    04:28 -      148 segments   17,969
asrx   ⬜    -     -      -              -
          已處理 4/7

── Post-Processing ──
Stage                Status     已產出            依賴進度狀態
------------------- ---------- -------------- ----------
Rule 1 chunks        ⬜          -              ASR⏳ + ASRX⬜
ANE vectorize        ⬜          0              Rule 1 chunks⬜
Rule 3 scenes        ⬜          -              all 7 processors⬜
face_trace           ⬜          -              all 7 processors⬜
Qdrant face sync     ⬜          0 points       face_trace⬜
TMDb face match      ⬜          0              face_trace⬜
Identity Agent       ⬜          -              face_trace✅ + ASRX✅
5W1H Agent           ⬜          -              Rule 1✅ + Rule 3✅
```

## 欄位說明

### Processors 表

| 欄位 | 說明 |
|------|------|
| Proc | Processor 名稱（cut, face, ocr, pose, yolo, asr, asrx） |
| St | ✅ completed / ⏳ running / ⬜ pending |
| Start | 開始時間（HH:MM） |
| End | 完成時間（HH:MM），running 中顯示 - |
| 已產出 | 該 processor 產出的資料量（scenes/frames/segments） |
| 已處理 | 以 frame 為單位的處理進度（running 中顯示當前 frame） |

### Post-Processing 表

| 階段 | 觸發時機 | 依賴進度狀態 |
|------|---------|-------------|
| Rule 1 chunks | ASR + ASRX 皆 ✅ | 顯示當前 ASR 與 ASRX 的即時狀態 |
| ANE vectorize | Rule 1 chunks 完成後 | 顯示 Rule 1 狀態 |
| Rule 3 scenes | 全部 7 個 processor 皆 ✅ | 顯示每個 processor 的即時完成狀態 |
| face_trace | 全部 7 個 processor 皆 ✅ | 同 Rule 3 |
| Qdrant face sync | face_trace 完成後 | 顯示 face_trace 狀態 |
| TMDb face match | face_trace 完成後 + TMDb enabled | 顯示 face_trace 狀態 |
| Identity Agent | face_trace + ASRX 皆 ✅ | 顯示 face_trace 與 ASRX 的即時狀態 |
| 5W1H Agent | Rule 1 + Rule 3 皆 ✅ | 顯示 Rule 1 與 Rule 3 狀態 |

## Status 標記

| 標記 | 意義 |
|------|------|
| ✅ completed | 已完成 |
| ⏳ running | 執行中 |
| ⬜ pending | 等待條件成立（條件欄位顯示 waiting for...） |
| ❌ failed | 失敗 |
| ⏭️ skipped | 跳過（因依賴失敗） |
