Highlight Studio

Web 工作台：上傳/註冊直播影片 → 自動側寫 → 儀表板 → 爆點卡片 → 一鍵派 AI 剪輯。

啟動

# 後端（FastAPI，port 8787；在 repo root 執行）
python3 -m uvicorn backend.main:app --port 8787

# 前端（Vite dev，port 5173/5174，proxy /api /files → 8787）
cd frontend && npm run dev
# 注意：Vite 綁 localhost（IPv6），瀏覽器用 http://localhost:<port>

Production 模式：cd frontend && npm run build 後，後端直接 serve frontend/dist（單 port 8787）。

本 repo 不含 AI 任務所需的外部設定（templates／部署參數）；缺少時後端啟動會明確報錯並提示所需環境變數。

註冊素材（個人工具模式：本機路徑 symlink，不複製大檔）

curl -X POST http://127.0.0.1:8787/api/register \
  -F "video_path=/abs/path/video.mp4" \
  -F "title=標題" \
  -F "log_path=/abs/path/log.csv" \
  -F "creation_time=2026-06-23T09:55:40+00:00" \
  -F "whisper_path=/abs/path/whisper.json"   # 選填：跳過 Whisper

UI 的「新增影片」= 同一件事。無 log/creation_time → 觀眾軌空白、只跑內容軌。

結構

studio/
├── backend/          FastAPI＋SQLite 單 worker job 佇列
│   ├── main.py       API（register/upload/workspaces/signals/jobs/SSE）
│   ├── jobs.py       佇列
│   └── pipeline_jobs.py  job handlers（profile/mine/plan/cut/rerender/translate/qa）
├── frontend/         Vite+React+TS+Tailwind v4（tokens 見 src/index.css）
├── workspace/<id>/   source.mp4(symlink)/log.csv/whisper.json/signals.json/thumb.jpg/meta.json
├── logs/job-<id>.log
└── studio.db

里程碑狀態

• M1 ✅（07-15）：註冊/上傳 → 側寫 job → 素材庫＋總覽儀表板（四訊號＋偵測帶＋ASR 幻覺自動遮罩）＋Jobs Dock
• M2 ✅（07-15）：總覽加播放器＋聊天室（跟隨/跳轉）；mine job（AI 爆點挖掘）→ 31 條 inventory → 爆點卡片牆＋儀表板 P/A 帶
• M3 ✅（07-15）：卡片一鍵「產生企劃」（AI 剪輯企劃）/「Rough-cut」（autocut）＋主題請求＋Plans/Clips 頁＋per-interval 縮圖
• M4 ✅（07-15）：編輯器 /w/:ws/editor/:clipId — 字幕（字級/位置/關鍵字/雙語）、疊加（hook/氣泡/hashtags）、EDL 微調（起點/時長/punch/刪段）、QA（多模態影片模型審查）＋重渲染版本鏈（v1→vN）；translate job（索引對映容錯）；worker 孤兒 job 開機恢復