CA
返回文档中心

Development Guide

Requirements

  • Node.js 24+
  • npm
  • ffmpeg and ffprobe

On Windows, the app can discover ffmpeg installed through WinGet. You can also set explicit paths:

FFMPEG_PATH=/path/to/ffmpeg
FFPROBE_PATH=/path/to/ffprobe

Local Commands

npm install
npm run dev
npm run lint
npm run build

Storage

Uploaded and generated assets are stored in `storage/projects`. This directory is intentionally ignored by git and should be backed by persistent disk in staging or production.

Testing the MVP Manually

  • Open `/upload`.
  • Upload an `mp4`, `mov`, or `webm`.
  • Wait on `/analyzing/[projectId]`.
  • Verify `/results/[projectId]` shows two exports.
  • Download both videos.
  • Check `/works` lists the project.