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

docs/N8N_DEMO.md

@@ -1,11 +1,29 @@
 # n8n 整合範例
 
+| 項目 | 內容 |
+|------|------|
+| 建立者 | Warren |
+| 建立時間 | 2026-03-18 |
+| 文件版本 | V1.1 |
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 目的 | 操作人 | 工具/模型 |
+|------|------|------|--------|-----------|
+| V1.0 | 2026-03-18 | 創建文件 | Warren | OpenCode / MiniMax M2.5 |
+| V1.1 | 2026-03-25 | 更新API回應格式 (media_url→file_path) 與認證標頭 | OpenCode | deepseek-reasoner |
+
+---
+
 ## 基本設定
 
 ### API 端點
 - **Base URL:** `http://localhost:3002/api/v1`
 - **Method:** `POST`
 - **Content-Type:** `application/json`
+- **Authentication:** `X-API-Key: YOUR_API_KEY` (所有 `/api/v1/*` 端點皆需要)
 
 ---
 
@@ -36,7 +54,8 @@
   },
   "options": {
     "headers": {
-      "Content-Type": "application/json"
+      "Content-Type": "application/json",
+      "X-API-Key": "YOUR_API_KEY"
     }
   }
 }
@@ -62,7 +81,7 @@ return results.map(r => ({
 
 ## Workflow 2: n8n 專用格式
 
-使用 `/n8n/search` 端點（已包含 media_url）
+使用 `/n8n/search` 端點（已包含 file_path）
 
 ### HTTP Request
 ```json
@@ -72,6 +91,12 @@ return results.map(r => ({
   "body": {
     "query": "={{ $json.searchTerm }}",
     "limit": 5
+  },
+  "options": {
+    "headers": {
+      "Content-Type": "application/json",
+      "X-API-Key": "YOUR_API_KEY"
+    }
   }
 }
 ```
@@ -90,12 +115,14 @@ return results.map(r => ({
       "title": "Chunk sentence_0006",
       "text": "fun plot twists...",
       "score": 0.526,
-      "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"
     }
   ]
 }
 ```
 
+> **注意**: API 現在返回 `file_path`（檔案系統路徑）而非 `media_url`（網頁 URL）。如需在網頁中播放影片，請將檔案路徑轉換為可訪問的 URL（例如透過 SFTPGo 分享連結）。
+
 ---
 
 ## Workflow 3: 訊息機器人整合
@@ -205,16 +232,18 @@ return {
 # 基本搜尋
 curl -X POST http://localhost:3002/api/v1/search \
   -H "Content-Type: application/json" \
+  -H "X-API-Key: YOUR_API_KEY" \
   -d '{"query": "charade", "limit": 3}'
 
 # n8n 格式
 curl -X POST http://localhost:3002/api/v1/n8n/search \
   -H "Content-Type: application/json" \
+  -H "X-API-Key: YOUR_API_KEY" \
   -d '{"query": "charade", "limit": 3}'
 
 # 取得影片列表
-curl http://localhost:3002/api/v1/videos
+curl -H "X-API-Key: YOUR_API_KEY" http://localhost:3002/api/v1/videos
 
 # 取得特定影片的區塊
-curl http://localhost:3002/api/v1/videos/a1b10138a6bbb0cd/chunks
+curl -H "X-API-Key: YOUR_API_KEY" http://localhost:3002/api/v1/videos/a1b10138a6bbb0cd/chunks
 ```