|
|
f43786f6af
|
docs: 新增 Pipeline 四階段進度更新說明 (Core Team)
新增文件:
- docs/PIPELINE_PROGRESS_UPDATE_FOR_CORE.md
目的:
說明 Momentry Studio 前端對 Pipeline 進度顯示的實現和需求，供 Core Team 參考實現後端 API。
文件內容:
1. 四階段架構說明
- 階段 1: 處理器 (30%) - ASR、ASRX、FACE、Face Tracing、OCR、CUT
- 階段 2: 知識圖譜 (35%) - TKG Nodes、TKG Edges
- 階段 3: 片段提取 (6%) - VLM Summary、Scene VLM、Moment Chunks
- 階段 4: 資料整合 (29%) - Rule1、Rule2、Face Dedup
2. 關鍵更新說明
- ASRX 處理器: 說話人向量化 (VOD)
- Face Tracing: 從階段 4 移至階段 1
- 向量入庫: 文字、說話人、人臉
3. 進度計算方式
- 總體進度 = 加權平均
- 計算範例
4. 需要的 API 端點
- GET /api/v1/pipeline/phases (主要)
- GET /api/v1/file/{uuid}/progress (快速輪詢)
- GET /api/v1/file/{uuid}/scene-vlm-stats (已實現)
5. API 回應格式
- 完整的 JSON 結構
- 狀態值定義
- 進度範例
6. 前端實現說明
- 顯示位置
- 顯示內容
- 更新機制
7. 處理器完整列表
- 名稱、功能、輸出
8. 建議實現順序
- Phase 1-4 實現步驟
9. 驗收標準
- API 驗收
- 進度更新驗收
- 前端顯示驗收
用途:
- Core Team 實現後端 API 的參考文件
- 前後端協作規範
- 測試驗收標準
|
2026-10-15 14:08:50 +08:00 |
|
