feat: 新增 Job Worker 系統與 API 文檔全面更新

docs/N8N_DEMO_WORKFLOW.md

@@ -1,7 +1,19 @@
 # n8n Video RAG Workflow - Node 設計
 
-> 建立時間: 2026-03-22
-> 目標: 讓 marcom 團隊能夠複製、貼上、修改使用的完整操作指南
+| 項目 | 內容 |
+|------|------|
+| 建立者 | Warren |
+| 建立時間 | 2026-03-22 |
+| 文件版本 | V1.1 |
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 目的 | 操作人 | 工具/模型 |
+|------|------|------|--------|-----------|
+| V1.0 | 2026-03-22 | 創建文件 | Warren | OpenCode / MiniMax M2.5 |
+| V1.1 | 2026-03-25 | 更新API回應格式 (media_url→file_path) 與認證標頭 | OpenCode | deepseek-reasoner |
 
 ---
 
@@ -117,7 +129,7 @@
 │  │                                                                      │  │
 │  │  ⑫ Natural Language Search                                        │  │
 │  │     ↓                                                               │  │
-│  │  ⑬ Get Media URL (含 media_url)                                 │  │
+│  │  ⑬ Get File Path (含 file_path)                                 │  │
 │  │     ↓                                                               │  │
 │  │  ⑭ Build Response                                                 │  │
 │  │     ↓                                                               │  │
@@ -363,7 +375,7 @@ Output:
 }
 ```
 
-**注意**: 只有 asr、asrx、story 三個模組
+> **注意**: API 現在返回 `file_path`（檔案系統路徑）而非 `media_url`（網頁 URL）。如需在網頁中播放影片，請將檔案路徑轉換為可訪問的 URL（例如透過 SFTPGo 分享連結）。
 
 ---
 
@@ -559,7 +571,7 @@ Output:
       "vid": "a1b10138a6bbb0cd",
       "text": "Hello and welcome to the old-time movie show...",
       "score": 0.92,
-      "media_url": "https://wp.momentry.ddns.net/Old_Time_Movie_Show_-_Charade_1963.HD.mov"
+      "file_path": "/Users/accusys/momentry/var/sftpgo/data/demo/video.mp4"
     }
   ]
 }
@@ -642,12 +654,13 @@ Configuration:
 | 項目 | 值 |
 |------|-----|
 | API Base | `http://localhost:3002` |
+| Authentication | `X-API-Key` header (所有 `/api/v1/*` 端點) |
 | Register | `POST /api/v1/register` |
 | Progress | `GET /api/v1/progress/{uuid}` |
 | Search | `POST /api/v1/search` |
 | n8n Search | `POST /api/v1/n8n/search` |
 | Hybrid Search | `POST /api/v1/search/hybrid` |
-| Media Base | `https://wp.momentry.ddns.net` |
+| Media Base | `https://wp.momentry.ddns.net` (僅供參考，API 返回 `file_path` 而非 URL) |
 
 ### Demo 測試資料