chore: backup before migration to new repo

2026-04-23 16:46:02 +08:00
parent 13dd3b30f3
commit 59809dae1f
40 changed files with 5566 additions and 1783 deletions
--- a/docs_v1.0/IMPLEMENTATION/SCENE_API_INTEGRATION.md
+++ b/docs_v1.0/IMPLEMENTATION/SCENE_API_INTEGRATION.md
@@ -1,141 +0,0 @@
-# 場景識別 API 整合指南
-
-## 概述
-
-本文檔說明如何在 Playground (port 3003) 中使用場景識別功能。
-
-## API Endpoint
-
-### 場景識別
-
-**Endpoint**: `GET /api/v1/scene/:uuid`
-
-**描述**: 對指定影片執行場景識別
-
-**參數**:
- `uuid` (path): 影片 UUID
-
-**回應格式**:
-```json
-{
-  "video_uuid": "384b0ff44aaaa1f1",
-  "scenes": [
-    {
-      "start_time": 0.0,
-      "end_time": 156.0,
-      "scene_type": "office",
-      "scene_type_zh": "辦公室",
-      "confidence": 0.87,
-      "duration": 156.0
-    }
-  ],
-  "processing_time": 1.3
-}
-```
-
-## 使用方式
-
-### 1. 啟動 Playground 伺服器
-
-```bash
-# 使用 port 3003
-cargo run --bin momentry_playground -- server --host 0.0.0.0 --port 3003
-```
-
-### 2. 測試場景識別
-
-```bash
-# 使用測試腳本
-python3 scripts/test_scene_api.py <video_uuid>
-
-# 範例
-python3 scripts/test_scene_api.py 384b0ff44aaaa1f1
-```
-
-### 3. 直接使用 curl
-
-```bash
-curl -H "X-API-Key: muser_68600856036340bcafc01930eb4bd839_1774418104_97221b69" \
-  "http://localhost:3003/api/v1/scene/384b0ff44aaaa1f1"
-```
-
-## Python 整合範例
-
-```python
-import requests
-
-API_KEY = "muser_68600856036340bcafc01930eb4bd839_1774418104_97221b69"
-BASE_URL = "http://localhost:3003"
-
-def classify_scene(video_uuid):
-    """執行場景識別"""
-    response = requests.get(
-        f"{BASE_URL}/api/v1/scene/{video_uuid}",
-        headers={"X-API-Key": API_KEY}
-    )
-    
-    if response.status_code == 200:
-        return response.json()
-    else:
-        raise Exception(f"API error: {response.status_code}")
-
-# 使用範例
-result = classify_scene("384b0ff44aaaa1f1")
-print(f"場景數量：{len(result['scenes'])}")
-for scene in result['scenes']:
-    print(f"  - {scene['scene_type']} ({scene['confidence']*100:.1f}%)")
-```
-
-## 目前狀態
-
-### 已完成 ✅
- ✅ 場景識別 Python 腳本 (`scripts/scene_classifier.py`)
- ✅ Places365 380 個場景類別
- ✅ API 測試腳本 (`scripts/test_scene_api.py`)
- ✅ Rust API handler 設計
-
-### 進行中 ⏳
- ⏳ Rust API endpoint 完整實作
- ⏳ 與資料庫整合
- ⏳ 錯誤處理優化
-
-### 已知限制
- Rust API endpoint 需要完整實作以支援資料庫查詢
- 目前建議使用 Python 腳本直接測試
-
-## 故障排除
-
-### 問題：API 回應 404
-
-**可能原因**:
- 影片 UUID 不存在
- Playground 伺服器未啟動
-
-**解決方案**:
-```bash
-# 檢查伺服器狀態
-curl http://localhost:3003/health
-
-# 檢查影片是否存在
-curl -H "X-API-Key: ..." "http://localhost:3003/api/v1/videos"
-```
-
-### 問題：處理時間過長
-
-**建議**:
- 減少取樣頻率 (`--sample-interval`)
- 增加最小場景持續時間 (`--min-scene-duration`)
- 使用 Places365 Core ML 模型（而非 PyTorch）
-
-## 相關文檔
-
- `docs_v1.0/IMPLEMENTATION/SCENE_CLASSIFICATION_MODULE.md` - 模組使用手冊
- `docs_v1.0/IMPLEMENTATION/PLACES365_INSTALLATION.md` - 模型安裝指南
- `docs_v1.0/TESTING/SCENE_CLASSIFICATION_TEST_REPORT_2026_04_01.md` - 測試報告
-
-## 下一步
-
-1. 完成 Rust API endpoint 實作
-2. 整合資料庫查詢
-3. 添加異步處理支援
-4. 優化效能和記憶體使用