前言
做短剧、漫画解说、小说改编视频的创作者,大多都有一套繁琐流程:手动拆小说剧本、手绘分镜、反复生成统一人设、逐段配音、剪辑合成,跨 N 个工具来回切换,人物崩坏、画面割裂、配音不同步是常态。
今天给大家推荐一款完全开源、支持本地私有化部署、一站式 AI 影视制作工具——waoowaoo(仓库地址:https://github.com/waooAI/waoowaoo),从小说文本到完整成片全链路自动化,无需切换多个 AI 平台,个人创作者、工作室都能本地私有化搭建,数据完全自己掌控。
一、项目基础概况
waoowaoo 是 waooAI 团队开源的 AI 短剧 / 漫画视频一体化 Studio,当前最新稳定版本为 v0.4.1(2026-04-03 更新),整体由单人独立开发持续迭代,更新频率极高,目标打造全行业最强本地 AI 影视创作工作流手机搜狐网。
基础信息
- 仓库地址:https://github.com/waooAI/waoowaoo
- 开发语言:TypeScript 97.4%,轻量化前端后端一体化
- 技术栈:Next.js15 + React19 + MySQL (PrismaORM) + Redis 队列 + TailwindCSS
- 部署方式:Docker 一键部署 / 源码本地开发双模式,小白也能快速搭建
- 模型支持:内置适配 Wan 2.7 视频大模型,图文视频生成一体化
二、核心一站式功能,覆盖短剧全生产链路
1. AI 剧本智能解析(核心亮点)
直接上传整本小说 / 长篇文案,AI 自动完成结构化拆解:
- 自动提取全部角色人设、外貌特征、性格标签;
- 划分完整剧情章节、关键场景、对话台词;
- 智能生成标准化影视分镜脚本,标注镜头、景别、运镜; 省去人工拆书、写剧本数小时工作量,长篇网文适配性极强。
2. 统一风格角色 & 场景 AI 生成
解决大部分 AI 视频人物 “一张一张脸不一样” 的痛点:
- 根据剧本角色描述,批量生成固定人设立绘,全程画面人物一致性可控;
- 自动匹配剧情场景,生成配套室内、户外、古风 / 现代 / 科幻等背景素材;
- 素材本地存储,无需上传第三方平台,隐私安全可控。
3. 自动分镜合成视频
基于解析后的分镜脚本,自动串联图片素材生成连贯视频:
- 自带镜头切换、运镜逻辑,自动匹配剧情节奏;
- 深度适配 Wan 2.7 视频模型,优化画面动态流畅度;
- 批量批量生成多条短片,适合短剧矩阵批量产出。
4. 多角色 AI 智能配音
区分剧中不同人物对话,自动分配对应音色:
- 多角色独立语音合成,旁白、男主、女主、配角音色区分清晰;
- 支持中英文双语语音,适配海外短剧、漫画解说;
- 音频自动和视频画面对齐,省去后期对轨操作。
5. 双语界面 + 私有化本地部署
- 前端内置中文 / 英文一键切换,海外创作者友好;
- 全部数据存在本地 MySQL、MinIO 对象存储,不上传第三方云端;
- 支持 Caddy 一键开启 HTTPS,解决本地网页并发卡顿问题。
三、三种部署方案,小白 / 开发者按需选择
项目提供三套部署方式,从零代码一键启动到源码二次开发全覆盖,前置仅需安装 Docker Desktop。
方案 1:Docker 镜像一键部署(推荐新手)
无需下载源码,一行命令拉起完整服务,最省事:
bash
运行
# 拉取配置文件
curl -O https://raw.githubusercontent.com/saturndec/waoowaoo/main/docker-compose.yml
# 后台启动全部服务
docker compose up -d
版本升级注意:测试版数据库不兼容,更新前必须清空旧容器数据,官方提供完整清理脚本。
方案 2:克隆仓库本地构建(可控性更高)
适合想自定义配置、修改静态资源的用户:
bash
运行
git clone https://github.com/saturndec/waoowaoo.git
cd waoowaoo
docker compose up -d
更新执行:git pull && docker compose down && docker compose up -d --build
方案 3:源码本地开发模式(二次开发开发者)
可直接修改前端、后端逻辑,完整开发环境:
- 克隆仓库,复制环境配置:
cp .env.example .env,填入自己的 AI 大模型 API Key; - 安装依赖
npm install; - 单独启动数据库、Redis、存储服务;
- 执行数据库初始化
npx prisma db push(必执行,否则启动报错); - 启动开发服务
npm run dev,访问:http://localhost:3000
四、API 配置与使用注意事项
- 模型接入:后台设置中心填入各大 AI 服务商官方 API Key,内置图文教程引导配置;
- 兼容提示:现阶段优先使用官方原生 API,OpenAI 兼容格式适配还在持续优化;
- 性能优化:本地 HTTP 访问并发有限,可使用项目内置 Caddy 配置开启 HTTPS,大幅缓解网页卡顿;
- 测试版提醒:项目目前单人开发迭代,存在少量 bug,官方支持 Github Issue 反馈需求与问题,持续高频更新迭代。
五、适合哪些人群使用?
- 短剧 / 小说改编自媒体博主:批量把网文自动生成短视频,日更批量产出;
- 漫画、动态漫创作者:自动分镜 + 统一人物,省去大量绘图、剪辑时间;
- 小型影视工作室:本地私有化部署,素材、剧本不外流,保护原创版权;
- AI 开发爱好者:开源完整 Next.js 全栈项目,可基于项目二次开发定制专属视频工具;
- 跨境内容创作者:中英文双语界面,适配海外小说、海外短视频平台。
六、项目优缺点总结
优势
- 全链路闭环:小说→剧本→分镜→图生素材→视频→配音一体化,不用多工具切换;
- 本地开源私有化:所有素材、剧本存在本地,无云端隐私泄露风险;
- Docker 开箱即用,极低部署门槛,新手也能快速跑通;
- 持续高速迭代,支持 Wan2.7 主流视频大模型,紧跟 AI 生成技术;
- 完全开源免费,无付费订阅、无水印、无素材数量限制。
现阶段不足
- 单人开发维护,部分功能仍在完善,存在少量测试版 Bug;
- 第三方兼容 API 适配尚未完全成熟,优先官方大模型接口;
- 本地部署需要一定硬件资源,批量生成视频对显卡、内存有要求。
七、参与共建与反馈渠道
- Bug 反馈、功能需求:提交 Github Issue;
- 代码贡献:可提交 PR,团队会审阅思路,自主整合优化;
- 内测体验:项目提供在线网页内测候补通道,可提前体验云端版本;
- 开源协议:已开源完整 LICENSE,个人商用、二次修改均开放。
结尾
如果你长期做小说改编短剧、动态漫画、AI 影视内容,又厌烦多个工具来回切换、素材上传云端担心泄露,那这款开源本地一站式工具 waoowaoo 绝对值得尝试。
从文字到成片的全自动化工作流,搭配 Docker 极简部署,个人创作者零成本搭建专属 AI 影视工作室,后续版本还会持续新增更多视频生成、后期剪辑功能,感兴趣可以直接拉取仓库本地部署体验。