简体中文 | English
Agent 驱动的视频创作平台
| 想让你的品牌出现在这里？联系我 |
| 联系作者 | 加入交流群 | 请作者喝杯咖啡 |
|---|---|---|
|
|
|
微信群超过 200 人后无法扫码加入。请添加作者微信并备注“融光”。
融光是一款面向视频创作者的 Agent 驱动创作平台，将项目、剧本、分镜、素材以及图片与视频生成整合在统一工作区。创作者可以按分集和场景组织剧本、拆解与调整分镜，并围绕每个镜头完成素材生成和管理。
本仓库包含 Java 后端、Next.js 前端和 Docker Compose 部署配置。首次启动后，按照初始化向导创建管理员账号即可开始使用。
| 模块 | 当前能力 |
|---|---|
| 项目与团队 | 管理创作项目、项目成员和协作角色 |
| 剧本创作 | 按分集和场景组织剧本，并将项目上下文交给 Agent |
| 分镜制作 | 从剧本整理分镜，编辑镜头内容、参考素材和生成结果 |
| 图片与视频 | 根据文本或参考素材生成图片与视频，并持续跟踪后台任务进度 |
| 素材管理 | 统一管理项目素材和可复用的图片、视频资源 |
| Agent 工作区 | 支持流式对话、多模态上下文、工具权限、Skill、MCP 与子 Agent |
| 模型与存储 | 集中配置文本、图片和视频模型，并选择本地或对象存储 |
| 系统管理 | 提供初始化向导、用户与角色管理、密码重置和版本检查 |
内置 Agent 工作区可以结合项目内容持续对话，接收图片、视频、音频和文件等多模态输入，并在界面中展示推理过程、工具调用和任务状态。
Agent 运行基于 AgentScope，支持 Skill、MCP 和子 Agent。会话与运行状态会持久化保存，模型能力和工具权限可按会话配置，适合处理需要多步骤协作的创作任务。
模型和 API 接入信息统一在设置页管理，无需将密钥写入源码。对话与 Agent 支持 OpenAI 兼容接口、Anthropic、Gemini、DashScope 和 Ollama 等模型服务；图片与视频生成支持接入多种服务，并按能力在项目中选用相应模型。
具体可用模型取决于服务商账号、接口地址和模型权限。
媒体素材可以保存在本地磁盘或 S3 兼容对象存储中。Agent 工作区同样支持数据库、本地磁盘和对象存储，可根据本地开发、单机部署或云端部署的需要灵活选择。
default.mp4
default.mp4
-.mp4
-.mp4
-.mp4
-.mp4
| 层级 | 技术 |
|---|---|
| 前端 | Next.js 16、React 19、TypeScript、Tailwind CSS 4、Base UI / Shadcn、Zustand |
| 后端 | Java 21、Spring Boot 3.5、Spring Security、Spring AI、AgentScope、MyBatis-Plus |
| 数据 | MySQL 8、Redis、Flyway |
| 媒体 | FFmpeg、FFprobe、本地存储或 S3 兼容对象存储 |
| 部署 | Docker Compose、Nginx |
推荐使用 Docker Compose 部署。安装 Docker Engine 和 Docker Compose 后，执行：
git clone https://github.com/Stonewuu/ai-fusion-video.git
cd ai-fusion-video
cp .env.example .env
docker compose up -d如需自定义端口、密码或部署方式，请以 .env.example 为模板创建根目录 .env。该文件已被 Git 忽略，更新项目时无需修改 docker-compose.yml。
启动完成后访问 http://localhost:8080，按照页面提示创建管理员账号。查看服务状态或跟踪后端日志，可以运行：
docker compose ps
docker compose logs -f backendCompose 默认启动 MySQL、Redis、后端、前端和 Nginx。Nginx 作为统一访问入口，并将 /api/** 和 /media/** 请求转发到后端。公网部署前，请通过 .env 修改默认数据库与 Redis 密码。
如需从当前源码构建前后端镜像，执行：
docker compose -f docker-compose.build.yml up -d --build如果前端与后端分别使用不同的公网域名，请在 .env 中配置：
PUBLIC_API_URL=https://api.example.com
CORS_ALLOWED_ORIGIN_PATTERNS=https://app.example.com
FRONTEND_PORT=3000
BACKEND_PORT=18080PUBLIC_API_URL 应填写后端根地址，末尾不要添加 /api。后端默认全局允许跨域；生产环境建议像示例一样将 CORS_ALLOWED_ORIGIN_PATTERNS 限制为实际前端来源，多个来源使用英文逗号分隔。
使用预构建镜像：
docker compose -f docker-compose.yml -f docker-compose.separated.yml up -d从源码构建镜像：
docker compose -f docker-compose.build.yml -f docker-compose.separated.yml up -d --build前后端独立部署不会启动仓库内置的 Nginx。请分别为前端和后端配置 HTTPS 反向代理，并在“系统设置 > 通用”中确认站点公网地址和后端资源公网地址。
- JDK 21
- Node.js 20 和 pnpm 10
- Docker，用于启动本地 MySQL 与 Redis
- FFmpeg 和 FFprobe，用于视频合成与媒体探测
cd ai-fusion-video
docker compose -f docker-compose-middleware.yml up -d
./mvnw spring-boot:runWindows 环境可以运行 .\mvnw.cmd spring-boot:run。
后端默认使用 local 配置，相关设置位于 ai-fusion-video/src/main/resources/application-local.yaml。如果 FFmpeg 和 FFprobe 不在默认路径，请通过 VIDEO_COMPOSE_FFMPEG_PATH 和 VIDEO_COMPOSE_FFPROBE_PATH 指定实际位置。
另开一个终端，在仓库根目录执行：
cd ai-fusion-video-web
pnpm install
pnpm dev前端开发服务器会读取 ai-fusion-video-web/.env.development，并将 /api/** 和 /media/** 代理到 http://localhost:18080。如果后端监听其他端口，可以在 .env.local 中覆盖代理地址：
DEV_BACKEND_URL=http://localhost:18081| 服务 | 地址 |
|---|---|
| 前端 | http://localhost:3000 |
| 后端 | http://localhost:18080 |
| Swagger UI | http://localhost:18080/swagger-ui.html |
| MySQL | localhost:43306 |
| Redis | localhost:46379 |
Docker Compose 会自动读取仓库根目录的 .env。不同启动方式使用的配置如下：
| 部署方式 | Compose 文件 | 需要关注的变量 |
|---|---|---|
| 默认统一入口 | docker-compose.yml |
必须关注 MySQL root 密码和 Redis 密码；应用账号可选；可按需修改 MYSQL_DATABASE、APP_PORT、JAVA_OPTS 和 CORS 白名单；PUBLIC_API_URL 保持为空 |
| 本地构建统一入口 | docker-compose.build.yml |
与默认统一入口相同，仅镜像改为本地构建 |
| 前后端独立部署 | 基础 Compose 文件 + docker-compose.separated.yml |
必须填写 PUBLIC_API_URL；生产环境建议填写 CORS_ALLOWED_ORIGIN_PATTERNS；可按需修改 FRONTEND_PORT、BACKEND_PORT；APP_PORT 不生效 |
公网部署前必须修改 MySQL root 密码和 Redis 密码；如启用 MySQL 应用账号，也必须设置独立密码。FRONTEND_PORT、BACKEND_PORT 和 PUBLIC_API_URL 仅在组合使用 docker-compose.separated.yml 时生效；CORS_ALLOWED_ORIGIN_PATTERNS 对所有部署方式生效。
| 变量 | 默认值 | 用途 |
|---|---|---|
MYSQL_ROOT_PASSWORD |
123456 |
MySQL root 管理密码，公网部署前必须修改 |
REDIS_PASSWORD |
123456 |
Redis 访问密码，公网部署前必须修改 |
MYSQL_DATABASE |
ai_fusion_video |
MySQL 数据库名，通常无需修改 |
APP_PORT |
8080 |
默认统一入口端口，启动后访问 http://localhost:8080 |
FRONTEND_PORT |
3000 |
前后端独立部署时暴露的前端端口 |
BACKEND_PORT |
18080 |
前后端独立部署时暴露的后端端口 |
PUBLIC_API_URL |
空 | 前后端独立部署时的后端公网根地址，不包含 /api |
CORS_ALLOWED_ORIGIN_PATTERNS |
* |
允许访问后端的浏览器来源；* 表示全部，生产环境建议配置明确来源，多个来源用英文逗号分隔 |
JAVA_OPTS |
-Xms512m -Xmx1024m |
后端 JVM 参数，通常无需修改 |
MYSQL_USERNAME |
空 | 可选的 MySQL 应用账号，不能设置为 root；留空时沿用 root 账号 |
MYSQL_PASSWORD |
空 | 可选的 MySQL 应用账号密码，必须与 MYSQL_USERNAME 同时配置 |
使用统一入口部署时，PUBLIC_API_URL 必须保持为空；CORS_ALLOWED_ORIGIN_PATTERNS 可保留 *，也可限制为站点的实际来源。
MYSQL_USERNAME 和 MYSQL_PASSWORD 必须同时配置或同时留空。直接复制 .env.example 时，这两个变量为空，后端仍使用 root 和 MYSQL_ROOT_PASSWORD，与历史版本默认行为一致。对于全新数据库，如在首次启动前填写这两个变量，MySQL 会自动创建普通账号并授予 MYSQL_DATABASE 的访问权限。已有数据库如需改用普通账号，请先在 MySQL 中创建用户并授权，再填写这两个变量；修改 .env 不会自动变更已有数据库账号。
默认部署不会向宿主机发布 MySQL 或 Redis 端口。如需使用本机工具直接访问，请在所用的 Compose 文件中取消对应 ports 配置的注释；示例端口仅绑定到宿主机 127.0.0.1。
云端图片或视频模型通常无法读取 localhost 或局域网中的参考素材。请使用公网对象存储，或将后端资源端点安全地暴露到公网，然后在“系统设置 > 通用”中保存对应的公网地址。
站点公网地址用于密码重置邮件和页面链接，后端资源公网地址用于媒体链接和 Agent 引用；两者可以配置为不同域名。
.
├─ ai-fusion-video/ Java 后端、Flyway 迁移与后端测试
├─ ai-fusion-video-web/ Next.js 前端
├─ docker/ Nginx 配置
├─ docker-compose.yml 预构建镜像部署
├─ docker-compose.build.yml
└─ docker-compose.separated.yml
后端：
cd ai-fusion-video
./mvnw test
./mvnw -Dtest=FlywayMigrationNamingTests test
./mvnw -Pagentscope-integration verify前端：
cd ai-fusion-video-web
pnpm lint
pnpm buildFlyway 迁移脚本位于 ai-fusion-video/src/main/resources/db/migration/。版本格式、基线和历史迁移约束见 Flyway 迁移说明。
欢迎提交问题反馈、功能建议和代码改进。对于影响范围较大的功能或架构调整，建议先创建 Issue 说明方案，确认方向后再开始开发。
-
Fork 本仓库并克隆到本地，然后将本仓库添加为
upstream：git clone https://github.com/YOUR-USERNAME/ai-fusion-video.git cd ai-fusion-video git remote add upstream https://github.com/Stonewuu/ai-fusion-video.git -
从最新的
main创建功能分支，请勿直接在main或版本开发分支上修改：git fetch upstream git checkout main git pull --ff-only upstream main git checkout -b feat/your-change
分支名称建议使用
feat/、fix/或docs/前缀，并简要说明改动内容。 -
完成开发后，根据改动范围运行检查：
# 后端 cd ai-fusion-video ./mvnw test # 前端 cd ../ai-fusion-video-web pnpm lint pnpm build
-
提交并推送个人分支：
git add path/to/changed-file git commit -m "feat: describe your change" git push -u origin feat/your-change -
创建 Pull Request 时，将目标分支设置为本仓库的
main分支。
提交前请确保改动范围清晰，不包含密钥、账号或本地环境文件；涉及行为变更时，请同步补充测试和必要文档。
Built by Stonewu
