Update README with full documentation

README.md

@@ -1,3 +1,86 @@
-# video_player
+# Video YOLO Player
 
-影片播放器前端/後端
+一個使用 OpenCV 和 YOLO 物體檢測的視頻播放器，支持實時檢測和預掃描數據顯示。
+
+## 功能特點
+
+- 視頻播放（使用 OpenCV）
+- YOLO 物體檢測覆蓋層
+  - 實時檢測（藍色框）
+  - 預掃描數據顯示（綠色框）
+- 三個窗口布局
+  - 原始視頻窗口
+  - YOLO 檢測窗口
+  - 命令窗口
+- 時間碼和幀信息狀態欄
+- 音頻播放控制
+
+## 系統需求
+
+- Python 3.7+
+- OpenCV (cv2)
+- NumPy
+- Ultralytics YOLO
+- ffplay（用於音頻播放）
+
+## 安裝
+
+```bash
+pip install opencv-python numpy ultralytics
+```
+
+確保已安裝 `ffplay`（macOS: `brew install ffmpeg`, Ubuntu: `sudo apt-get install ffmpeg`）
+
+## 使用方法
+
+```bash
+python video_player.py <video_path> <yolo_model_path>
+```
+
+### 示例
+
+```bash
+python video_player.py video.mp4 yolov8n.pt
+```
+
+## 快捷鍵
+
+| 按鍵 | 功能 |
+|------|------|
+| `y` / `Y` | 切換實時 YOLO 檢測（藍框） |
+| `p` / `P` | 切換預掃描 YOLO 數據（綠框） |
+| `Space` | 暫停/恢復 |
+| `s` / `S` | 切換聲音 |
+| `b` / `B` | 切換狀態欄顯示 |
+| `h` / `H` | 隱藏當前窗口 |
+| `1` | 切換原始視頻窗口 |
+| `2` | 切換 YOLO 檢測窗口 |
+| `3` | 切換命令窗口 |
+| `←` / `→` | 快進/快退 ±5 秒 |
+| `Shift + ←` / `Shift + →` | 快進/快退 ±30 秒 |
+| `q` / `ESC` | 退出 |
+
+## 命令輸入
+
+在命令窗口中可輸入：
+
+- **幀號**：直接輸入數字跳轉到指定幀
+- **時間格式**：`hh:mm:ss.ff` 跳轉到指定時間
+- **相對跳轉**：`+10` 或 `-5` 秒
+- **探針信息**：輸入 `i` 顯示視頻詳細信息
+
+## 相關文件
+
+播放器會嘗試加載以下輔助文件（與視頻同名）：
+
+- `.probe.json` - 視頻探針信息
+- `.yolo.json` - 預掃描的 YOLO 檢測數據
+
+## 版本信息
+
+- 版本：2.0.0
+- 構建時間：2026-03-06
+
+## 許可證
+
+MIT License