基于 openvideodev/react-video-editor 的衍生版本，增加了中文界面、AIFilm 素材库集成、离线 Docker 部署等功能。
Fork 声明：本项目 fork 自 openvideodev/react-video-editor，版权归 OpenVideoDev 所有，遵循 AGPL-3.0 协议。本版本的修改部分版权归本项目贡献者所有，同样遵循 AGPL-3.0。
| 功能 | 说明 |
|---|---|
| 中文 UI | 媒体面板、工具栏、操作提示汉化 |
| AIFilm 素材库 | 通过同源代理接入 AIFilm 媒体库，与本地上传合并展示 |
| 视频插入优化 | 插入时自动顺延后续片段（ripple insert） |
| 转场修复 | 支持选中 1 段或 2 段两种方式；增加容差；跨轨保护 |
| 音乐轨道修复 | 修复上传按钮无响应、音频导出失败问题 |
| 关闭/恢复原声 | 轨道工具栏批量静音/取消静音视频轨道 |
| WebCodecs 检测 | 区分 secure context 缺失与 API 缺失，阻止无效渲染 |
| 本地优先存储 | 未登录时自动降级至 IndexedDB，无缝使用 |
| 素材打包下载 | 一键将所有素材（本地 + 远端）打包为 ZIP 下载 |
| 离线 Docker 部署 | 支持内网隔离环境完整部署 |
- AI 助手：对话式编辑，通过自然语言控制时间轴
- 文字转语音：ElevenLabs 高质量配音
- 自动字幕：Deepgram 语音转文字
- 多轨时间轴：视频、音频、图片、文字多轨管理
- 客户端渲染：基于 WebCodecs API，无需上传到服务器
- 丰富编辑操作：裁剪、分割、缩放、旋转、位置调整
- 转场与特效：内置转场库与视觉特效
- 素材库：Pexels 免版权图片/视频
- 本地上传：拖拽上传视频、图片、音频
- 云存储：S3/R2 兼容对象存储
- 高质量导出：MP4 格式，最高 4K
- Node.js v18+
- pnpm
git clone <本仓库地址>
cd react-video-editor
pnpm installcp .env.sample .env.local最小启动（无需数据库，使用本地 IndexedDB 存储）：
无需填写任何变量，直接启动即可在本地模式下使用。
完整配置参考 .env.sample 和下方环境变量说明。
pnpm prisma migrate devpnpm dev
# 访问 http://localhost:5000注意：编辑器依赖 WebCodecs，需要在 HTTPS 或
localhost下运行。局域网http://IP访问会导致编辑器不可用。
复制并填写 Docker 配置：
cp .env.docker.example .env.docker
# 编辑 .env.docker，至少填写 BETTER_AUTH_SECRET启动：
docker compose -f docker-compose.offline.yml --env-file .env.docker up -d# 1. 在联网机器上打包
pnpm offline:pack
# 2. 将 offline-bundle/ 目录拷贝到目标机器
# 3. 在目标机器上部署
pnpm offline:deploy
# 4. 验证
pnpm offline:verify| 变量 | 说明 | 必填 |
|---|---|---|
DATABASE_URL |
PostgreSQL 连接字符串 | 账号功能必填 |
DIRECT_URL |
PostgreSQL 直连字符串（Prisma 用） | 同上 |
BETTER_AUTH_URL |
应用访问地址，如 http://localhost:5000 |
同上 |
BETTER_AUTH_SECRET |
随机长字符串，用于签名 session | 同上 |
| 变量 | 说明 |
|---|---|
GOOGLE_GENAI_API_KEY |
Gemini AI 助手 |
DEEPGRAM_API_KEY |
字幕/语音转文字 |
DEEPGRAM_URL |
Deepgram 接口地址（默认 https://api.deepgram.com/v1） |
ELEVENLABS_API_KEY |
AI 配音 |
ELEVENLABS_URL |
ElevenLabs 接口地址（默认 https://api.elevenlabs.io） |
| 变量 | 说明 |
|---|---|
PEXELS_API_KEY |
Pexels 图片/视频素材 |
AIFILM_API_BASE_URL |
AIFilm 素材库后端地址（可选） |
AIFILM_DEV_USER_ID |
开发调试用，AIFilm 模拟用户 ID |
| 变量 | 说明 |
|---|---|
R2_BUCKET_NAME |
Cloudflare R2 存储桶名称 |
R2_ACCESS_KEY_ID |
R2 Access Key |
R2_SECRET_ACCESS_KEY |
R2 Secret Key |
R2_ACCOUNT_ID |
Cloudflare 账号 ID |
R2_PUBLIC_DOMAIN |
R2 公共访问域名 |
| 变量 | 说明 |
|---|---|
GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET |
Google 登录 |
GITHUB_CLIENT_ID / GITHUB_CLIENT_SECRET |
GitHub 登录 |
RESEND_API_KEY |
邮件发送（邮箱验证码） |
| 变量 | 说明 | 默认值 |
|---|---|---|
BATCH_EXPORT_DIR |
批量导出文件写入目录 | ./exports |
本项目通过 Next.js 同源代理访问 AIFilm，不在前端直接跨域请求：
Browser → /api/aifilm/* → AIFilm 后端
这样可以保证 cookie 鉴权、Range 请求和 Docker 交付的一致性。配置 AIFILM_API_BASE_URL 即可启用。
git remote add upstream https://github.com/openvideodev/react-video-editor
git fetch upstream
git merge upstream/main本项目遵循 GNU AGPL-3.0 协议开源。
- 原项目版权：Copyright (c) 2026 OpenVideoDev
- 本版本修改部分：Copyright (c) 2026 本项目贡献者
商业授权（绕过 AGPL 要求）请联系原项目：hello@openvideo.dev
欢迎提交 Pull Request 和 Issue！