单人本机使用的短视频配音工具:上传一段已有视频,填入旁白文案,生成配音后的成片,并在视频库里查看和删除。页面不再触发 AI 视频生成;创作部分请在外部 agent 中完成。
- Python 3.12+(本机实测 3.13.14),Node.js 22+,npm。
ffmpeg与ffprobe在 PATH 中。- 本机
.mpt-venv/Scripts/edge-tts.exe可用(音色注册表见backend/app/providers/voices.py)。 - 配音合成需要联网(Edge 在线 TTS 服务)。
cd backend
uv venv .venv
uv pip install --python .venv/Scripts/python.exe -r requirements.txt
cd ../frontend
npm ci
npm run buildWindows 双击 start.bat,或:
cd backend
.venv/Scripts/python.exe -m uvicorn app.main:app --host 127.0.0.1 --port 8000浏览器打开 http://127.0.0.1:8000。服务只监听回环地址。
前端开发时可另开终端运行 cd frontend && npm run dev,Vite 会把 /api 代理到 8000 端口。
- 「视频配音」页选择源视频(mp4/mov/mkv/avi/webm/flv),粘贴旁白文案,选音色、语速、音调、音量。
- 点「开始配音」并等待完成;合成过程依赖联网,通常需要几十秒。
- 成功后自动跳到「视频库」,可播放成片;删除需要输入文件名确认。
配音会替换整条原音轨,画面保持原样;旁白短于视频时用静音补齐,长于视频时按视频时长截断。
config/.env:可选,样例见config/env.example;不要提交。data/:SQLite 数据库与输入数据;output/videos/:成片;logs/:日志。这些目录不进 Git。- 常用变量:
HF_DUBBING_TTS_COMMAND、HF_DUBBING_FFMPEG、HF_DUBBING_TIMEOUT、HF_TRUSTED_HOSTS、HF_TRUSTED_ORIGINS。
cd backend && .venv/Scripts/python.exe -m pytest
cd frontend && npm run typecheck && npm run build本项目只在本机运行:没有 Docker 镜像、没有 Worker/队列,也没有视频生成链路。