momentry_playground/README.md

MoMentry Playground

統一媒體播放、檢視、監控平台

功能

• 多格式媒體播放（視頻、音頻、圖片）
• Frame-精確的視頻控制
• ASR 字幕顯示（可開關）
• YOLO 檢測框疊加（可開關）
• Chunk 導航標記（可開關）
• Zoom/Pan 畫面控制
• 自然語言搜尋
• 與 momentry_core 進度監控

安裝依賴

# FFmpeg (必需)
brew install ffmpeg

# yt-dlp (YouTube 支援)
brew install yt-dlp

構建

cargo build --release

運行

# 基本運行
cargo run

# 開啟視頻
cargo run -- --video "/path/to/video.mov"

# 開啟視頻 + ASR 字幕
cargo run -- \
  --video "/Users/accusys/test_video/Old_Time_Movie_Show_-_Charade_1963.HD.mov" \
  --asr "/Users/accusys/momentry_core_0.1/output/39567a0eb16f39fd.asr.json" \
  --yolo "/Users/accusys/test_video/Old_Time_Movie_Show_-_Charade_1963.HD.yolo.json"

# 指定窗口大小
cargo run -- --width 1280 --height 720 --video video.mp4

快捷鍵

快捷鍵	功能
Space	播放/暫停
← / →	上一幀/下一幀
Shift+←/→	後退/前進 1 秒
S	開關字幕
Y	開關 YOLO 疊加
C	開關 Chunk 標記
M	靜音
+ / -	放大/縮小
0	重置縮放
R	重置視圖
F	全屏
[ / ]	上一塊/下一塊
/	開啟搜尋
Esc	關閉面板

命令列參數

-v, --video <PATH>      視頻文件路徑
-a, --asr <PATH>       ASR JSON 文件路徑
-y, --yolo <PATH>       YOLO JSON 文件路徑
-w, --width <N>         窗口寬度 (default: 1280)
-h, --height <N>        窗口高度 (default: 720)
--fullscreen            全屏模式啟動
--locale <LANG>         UI 語言 (en, zh-TW)

測試數據

VIDEO="/Users/accusys/test_video/Old_Time_Movie_Show_-_Charade_1963.HD.mov"
ASR="/Users/accusys/momentry_core_0.1/output/39567a0eb16f39fd.asr.json"
YOLO="/Users/accusys/test_video/Old_Time_Movie_Show_-_Charade_1963.HD.yolo.json"

開發

# 格式化
cargo fmt

# Lint
cargo clippy

# 測試
cargo test

技術棧

• 語言: Rust 2021
• 桌面: tao + wry
• 視頻: SDL2 + FFmpeg
• 前端: HTML/CSS/JS (WebView)
• 緩存: LRU (YOLO frame cache)

服務連接

服務	地址
PostgreSQL	localhost:5432
Redis	localhost:6379
Qdrant	localhost:6333
API Server	127.0.0.1:3002
Ollama	localhost:11434

項目結構

momentry_playground/
├── Cargo.toml
├── src/
│   ├── main.rs              # 入口
│   ├── lib.rs               # 模組導出
│   ├── config.rs            # 命令列解析
│   ├── player/              # 視頻播放
│   │   ├── video.rs         # 播放控制
│   │   ├── ffmpeg.rs       # FFmpeg 解碼
│   │   ├── renderer.rs      # SDL2 渲染
│   │   └── state.rs        # 播放狀態
│   ├── overlay/             # 疊加層
│   │   ├── asr.rs          # ASR 載入
│   │   └── yolo.rs         # YOLO 載入 (LRU cache)
│   └── web/                 # WebView
│       └── bridge.rs        # JS <-> Rust IPC
├── web/
│   ├── index.html           # 主 UI
│   ├── styles.css           # 樣式
│   └── app.js              # 前端邏輯
└── AGENTS.md               # 開發文檔