简体中文 | English

融光

Agent 驱动的视频创作平台

---

融光是一款面向视频创作者的 Agent 驱动创作平台，将项目、剧本、分镜、素材以及图片与视频生成整合在统一工作区。创作者可以按分集和场景组织剧本、拆解与调整分镜，并围绕每个镜头完成素材生成和管理。

本仓库包含 Java 后端、Next.js 前端和 Docker Compose 部署配置。首次启动后，按照初始化向导创建管理员账号即可开始使用。

功能

Agent 与工具

内置 Agent 工作区可以结合项目内容持续对话，接收图片、视频、音频和文件等多模态输入，并在界面中展示推理过程、工具调用和任务状态。

Agent 运行基于 AgentScope，支持 Skill、MCP 和子 Agent。会话与运行状态会持久化保存，模型能力和工具权限可按会话配置，适合处理需要多步骤协作的创作任务。

模型与生成协议

模型和 API 接入信息统一在设置页管理，无需将密钥写入源码。对话与 Agent 支持 OpenAI 兼容接口、Anthropic、Gemini、DashScope 和 Ollama 等模型服务；图片与视频生成支持接入多种服务，并按能力在项目中选用相应模型。

具体可用模型取决于服务商账号、接口地址和模型权限。

存储

媒体素材可以保存在本地磁盘或 S3 兼容对象存储中。Agent 工作区同样支持数据库、本地磁盘和对象存储，可根据本地开发、单机部署或云端部署的需要灵活选择。

界面演示

https://github.com/user-attachments/assets/fe71cbb8-f9d9-4351-9a4c-cb8a0a6af7ba

https://github.com/user-attachments/assets/24d9443b-e463-405c-8ada-108236b4d6c2

https://github.com/user-attachments/assets/2f1de26c-5cd5-4be3-ad2e-81be2edd6956

https://github.com/user-attachments/assets/acd26ede-8b77-48c0-91dc-c80c5ed7ceca

https://github.com/user-attachments/assets/8a8ce3cf-4bf8-4f76-ad7c-0af373d16a5b

https://github.com/user-attachments/assets/be99d4c1-dc09-4616-8fba-06cb959c84c8

技术栈

快速部署

Docker Compose

推荐使用 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 backend

Compose 默认启动 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=18080

PUBLIC_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:run

Windows 环境可以运行 .\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

本地地址

配置说明

Docker 环境变量

Docker Compose 会自动读取仓库根目录的 .env。不同启动方式使用的配置如下：

公网部署前必须修改 MySQL root 密码和 Redis 密码；如启用 MySQL 应用账号，也必须设置独立密码。FRONTEND_PORT、BACKEND_PORT 和 PUBLIC_API_URL 仅在组合使用 docker-compose.separated.yml 时生效；CORS_ALLOWED_ORIGIN_PATTERNS 对所有部署方式生效。

使用统一入口部署时，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 build

Flyway 迁移脚本位于 ai-fusion-video/src/main/resources/db/migration/。版本格式、基线和历史迁移约束见 Flyway 迁移说明。

参与贡献

欢迎提交问题反馈、功能建议和代码改进。对于影响范围较大的功能或架构调整，建议先创建 Issue 说明方案，确认方向后再开始开发。

开发流程

1. 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
   

2. 从最新的 main 创建功能分支，请勿直接在 main 或版本开发分支上修改：

   git fetch upstream
   git checkout main
   git pull --ff-only upstream main
   git checkout -b feat/your-change
   

   分支名称建议使用 feat/、fix/ 或 docs/ 前缀，并简要说明改动内容。

3. 完成开发后，根据改动范围运行检查：

   # 后端
   cd ai-fusion-video
   ./mvnw test
   
   # 前端
   cd ../ai-fusion-video-web
   pnpm lint
   pnpm build
   

4. 提交并推送个人分支：

   git add path/to/changed-file
   git commit -m "feat: describe your change"
   git push -u origin feat/your-change
   

5. 创建 Pull Request 时，将目标分支设置为本仓库的 main 分支。

提交前请确保改动范围清晰，不包含密钥、账号或本地环境文件；涉及行为变更时，请同步补充测试和必要文档。

致谢

• 感谢 LinuxDo 社区对项目的支持
• 感谢 waoowaoo 提供的剧本界面设计参考

License

MIT License

_{Built by Stonewu}