Stonewuu/ai-fusion-video

项目介绍

融光是一个可自托管的 AI 视频创作平台，面向短剧、漫剧和类似内容的创作者。它把项目、剧本、分镜、素材以及图片和视频生成放进同一个工作区，让每个镜头从剧本拆解到生成结果都处在一条流程上。

主要能力包括：无限画布上用节点组织剧本、分镜、角色和素材，并把生成、合成、导出连起来；项目内的融光助手可以引用剧本、分镜、资产或选中节点，改写内容、整理分镜或生成素材，也能调用通过 MCP 接入的外部工具，或把分项任务交给子智能体，工具权限按会话授权；系统设置中可连接 ComfyUI，导入 API 格式工作流 JSON，校验并试运行后发布，再关联到图片或视频模型。

模型接入信息统一在设置页管理，不必写进源码。对话与 Agent 支持 OpenAI 兼容接口、Anthropic、Gemini、DashScope 和 Ollama 等服务；图片和视频生成支持多种服务，具体可用模型取决于服务商账号、接口地址和模型权限。媒体和 Agent 工作区都可以使用本地磁盘或 S3 兼容对象存储。

快速使用

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

这会启动 MySQL、Redis、后端、前端和 Nginx。启动完成后访问 http://localhost:8080，按页面提示创建管理员账号。查看服务状态或跟踪后端日志：

docker compose ps
docker compose logs -f backend

端口、密码和部署方式以 .env.example 为模板在根目录 .env 中调整。进入系统后先配置模型接口和密钥；如果要使用 ComfyUI 工作流，再在「系统设置 → AI 配置」中连接服务、导入工作流并绑定模型。

源码开发

从源码运行需要 JDK 21、Node.js 20 和 pnpm 10、用于启动 MySQL 与 Redis 的 Docker，以及用于视频合成和媒体探测的 FFmpeg、FFprobe。先运行 docker compose -f docker-compose-middleware.yml up -d 启动中间件，再在后端目录执行 ./mvnw spring-boot:run，Windows 下使用 mvnw.cmd。另一个终端进入 ai-fusion-video-web，执行 pnpm install 和 pnpm dev。前端会把 /api/** 和 /media/** 代理到 18080 端口，后端 Swagger UI 位于 http://localhost:18080/swagger-ui.html。

使用约束

• 公网部署前必须修改默认的 MySQL root 密码和 Redis 密码，默认值只适合本地使用。
• 统一入口部署时 PUBLIC_API_URL 必须保持为空，只有前后端使用不同公网域名时才填写。
• 前后端独立部署时，PUBLIC_API_URL 填后端根地址，不加 /api；生产环境的 CORS 来源应限制为实际前端域名，而不是 *。
• 云端图片或视频模型通常读不到 localhost 或局域网中的参考素材，需要改用公网对象存储，或把后端资源端点安全地暴露到公网，并在系统设置中保存对应地址。
• 默认 Compose 不向宿主机发布 MySQL 和 Redis 端口，本机工具直连需要取消对应 ports 配置的注释。

HotRepo 点评

该项目在 2026-11-05 进入 Java 日榜，当天最好名次为第 9，Star 总数 1,711，当日新增 10。这只是一次快照，不足以判断趋势，但说明它当天在 Java 语言榜内获得了关注。README 开头先放赞助商横幅和二维码，再进入产品说明，阅读时需要注意这一顺序；不过仓库本身给出了 Java 后端、Next.js 前端、部署方式和源码开发流程等实质性内容。对评估者来说，技术栈和配置细节比赞助商段落更有参考价值。

项目源码与说明