1. 项目概述
Toonflow是一款开源的一站式AI短剧创作工具,能够将小说、剧本快速转化为动画短剧。这个系统集成了AI编剧、智能分镜、角色与视频生成等功能,采用跨平台桌面端轻量部署方式,帮助创作者实现低成本批量产出视觉内容。
作为一个完整的短剧生产工作台,Toonflow围绕"策划→编剧→分镜→出片"构建了完整的创作闭环。它最大的特点是支持本地化、可编程、可持续迭代的生产流程,让创作者能够完全掌控整个创作过程。
2. 核心功能解析
2.1 无限画布生产工作台
Toonflow采用类无限画布的形式组织剧本、角色、分镜、素材与视频节点。这种设计打破了传统线性创作流程的限制,支持自由编排、回溯与并行生产。创作者可以像在真实工作台上一样,随意调整各个元素的位置和关系。
提示:无限画布特别适合处理复杂的多线叙事结构,可以直观地看到故事各个部分的关系。
2.2 三层Agent协作体系
系统采用了决策层、执行层、监督层三层Agent协同工作的架构:
- 决策层:负责任务拆解和整体规划
- 执行层:具体负责内容生成
- 监督层:进行质量审阅与修订反馈
这种架构显著提升了系统的稳定性与成片的一致性,避免了传统AI创作中常见的逻辑断裂问题。
2.3 持久化Agent记忆
基于本地ONNX向量检索的跨会话记忆系统是Toonflow的一大亮点。它支持:
- 短期消息记忆
- 长期摘要存储
- 语义召回功能
这个系统确保了在多轮创作过程中,AI能够保持连贯的创作思路和风格一致性。
2.4 可编程供应商系统
在设置中心,用户可以直接编写供应商TypeScript逻辑并即时生效,无需修改源码或重启系统。这个特性特别适合:
- 私有化部署场景
- 多模型接入需求
- 特定业务逻辑定制
2.5 章节事件图谱驱动改编
系统能够自动提取原著章节事件并结构化存储,剧本改编时按事件图谱精准调用上下文。这种方法有效减少了长文本信息丢失的问题,特别适合小说改编场景。
3. 技术架构详解
3.1 技术栈组成
Toonflow采用了现代化的全栈技术架构:
后端技术:
- 运行时:Node.js 23.11.1+
- 语言:TypeScript 5.x
- 框架:Express 5
- 数据库:SQLite(better-sqlite3 / knex)
AI集成:
- Vercel AI SDK(支持多种主流模型)
- 本地推理:@huggingface/transformers(ONNX)
客户端技术:
- 桌面客户端:Electron 40
- 实时通信:Socket.IO
- 图像处理:Sharp
3.2 系统架构设计
系统采用模块化设计,主要分为以下几个核心模块:
-
Agent模块:
- ScriptAgent:负责剧本生成
- ProductionAgent:负责生产流程控制
-
核心服务模块:
- 项目管理
- 素材管理
- 分镜管理
- 视频合成
-
基础设施模块:
- 数据库服务
- 文件存储
- 模型管理
这种架构设计确保了系统的高内聚低耦合,便于功能扩展和维护。
4. 安装与部署指南
4.1 本地安装
Windows系统:
- 从GitHub Release页面下载最新安装包
- 双击安装程序完成安装
- 启动应用,使用默认账号登录(admin/admin123)
macOS系统:
- 下载dmg安装包
- 拖拽应用到Applications文件夹
- 首次运行时需在"系统偏好设置→安全性与隐私"中授权
Linux系统:
bash复制# 下载AppImage文件
chmod +x Toonflow-*.AppImage
./Toonflow-*.AppImage
4.2 Docker部署
bash复制# 克隆项目
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
# 构建镜像
docker build -t toonflow .
# 运行容器
docker run -d -p 10588:10588 -v ./data:/app/data toonflow
4.3 云端部署
服务器要求:
- 系统:Ubuntu 20.04+/CentOS 7+
- Node.js:24.x
- 内存:2GB+
部署步骤:
bash复制# 安装Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 24
# 安装依赖
npm install -g yarn pm2
# 克隆项目
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
yarn install
yarn build
# 配置PM2
echo '{
"name": "toonflow-app",
"script": "data/serve/app.js",
"instances": "max",
"exec_mode": "cluster",
"env": {
"NODE_ENV": "prod",
"PORT": 10588,
"OSSURL": "http://127.0.0.1:10588/"
}
}' > pm2.json
# 启动服务
pm2 start pm2.json
pm2 startup
pm2 save
5. 使用教程
5.1 快速入门
- 启动应用并登录(默认账号:admin/admin123)
- 在设置中心完成模型供应商配置
- 新建项目并导入原著
- 执行章节事件提取
- 使用ScriptAgent生成故事骨架和剧本
- 切换到ProductionAgent组织分镜和素材
- 对分镜进行节点化精调
- 完成视频拼接与导出
5.2 模型配置指南
Toonflow支持多种AI模型接入:
-
文本模型:
- OpenAI系列
- Claude系列
- 国内大模型(通义千问、智谱等)
-
图像模型:
- Stable Diffusion系列
- DALL·E
- Midjourney(需通过API)
-
视频模型:
- Sora
- Runway
- Pika
配置示例(OpenAI):
code复制API密钥:sk-xxxxxxxxxxxxxxxxxxxxxxxx
请求地址:https://api.openai.com/v1
模型名称:gpt-4-turbo
5.3 创作流程详解
完整创作流程:
-
素材准备阶段:
- 导入原著文本
- 提取关键事件
- 设定角色属性
-
剧本生成阶段:
- 生成故事大纲
- 编写详细剧本
- 调整剧情节奏
-
分镜制作阶段:
- 自动生成分镜草图
- 手动调整分镜细节
- 添加转场效果
-
视频生成阶段:
- 生成角色动画
- 合成背景场景
- 添加音效和字幕
-
后期处理阶段:
- 视频剪辑
- 色彩校正
- 最终输出
6. 商用授权说明
6.1 许可证类型
Toonflow采用Apache-2.0协议开源,并附有补充商业协议。主要授权条款包括:
-
免费使用场景:
- 个人学习、研究
- 非商业用途
- 制作内容获得平台分账
- ≤5个法人联合内部使用
-
需要商业授权场景:
- 以产品形式分发给2个及以上第三方
- 商业性批量生产内容
- 集成到商业软件中
6.2 商业授权定价
| 阶段 | 年销售额 | 年费 |
|---|---|---|
| 扶持期 | <¥10万 | 免费 |
| 初创期 | ¥10-50万 | ¥5,000 |
| 成长期 | ¥50-150万 | ¥20,000 |
| 规模期 | ¥150-500万 | ¥80,000 |
| 企业级 | >¥500万 | 面议 |
7. 常见问题与解决方案
7.1 安装问题
问题1:macOS系统提示"无法验证开发者"
- 解决方案:前往"系统偏好设置→安全性与隐私",点击"仍要打开"
问题2:Windows系统安装失败
- 解决方案:以管理员身份运行安装程序,关闭杀毒软件临时
7.2 使用问题
问题1:模型调用失败
- 检查API密钥是否正确
- 验证网络连接是否正常
- 确认模型服务是否可用
问题2:视频生成质量不佳
- 调整提示词精确度
- 尝试不同视频模型
- 增加生成时长参数
7.3 性能优化建议
-
硬件配置:
- 推荐使用NVIDIA显卡(至少4GB显存)
- 内存建议16GB以上
- SSD存储提升IO性能
-
软件配置:
- 关闭不必要的后台程序
- 定期清理缓存文件
- 使用最新版本驱动
8. 二次开发指南
8.1 开发环境准备
- 安装Node.js 23.11.1+
- 安装Yarn包管理器
- 克隆仓库:
bash复制git clone https://github.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app yarn install
8.2 代码结构说明
主要目录结构:
code复制src/
├─ agents/ # AI Agent模块
├─ lib/ # 公共库
├─ middleware/ # 中间件
├─ routes/ # 路由模块
├─ socket/ # WebSocket通信
├─ types/ # 类型定义
└─ utils/ # 工具函数
8.3 自定义开发示例
添加新模型供应商:
- 在
src/routes/modelSelect/下创建新文件 - 实现模型调用接口
- 在设置界面添加配置选项
修改AI提示词:
- 编辑
data/skills/下的Markdown文件 - 调整提示词结构和内容
- 无需重启即可生效
9. 项目资源与社区
9.1 官方资源
-
GitHub仓库:
- 主仓库:https://github.com/HBAI-Ltd/Toonflow-app
- 前端仓库:https://github.com/HBAI-Ltd/Toonflow-web
-
文档与教程:
- 官方文档:https://toonflow.net/docs
- 视频教程:B站搜索"Toonflow"
9.2 社区支持
-
交流群:
- 微信:添加小助手加入
- Discord:https://discord.gg/HEjKmpNpAZ
-
问题反馈:
- GitHub Issues
- 邮箱:ltlctools@outlook.com
10. 实际应用案例
10.1 短剧创作案例
项目背景:
某MCN机构需要批量生产竖屏短剧,传统方式成本高、周期长。
解决方案:
- 使用Toonflow导入网络小说
- 自动生成剧本和分镜
- 批量生成视频素材
- 人工进行后期精修
成果:
- 制作周期从2周缩短到2天
- 单集成本降低80%
- 日均产出从1集提升到5集
10.2 教育领域应用
应用场景:
将教材内容转化为动画微课
实施流程:
- 导入教材文本
- 设置教学目标和重点
- 生成讲解动画
- 添加互动问答环节
效果评估:
- 学生理解度提升40%
- 教师备课时间减少60%
- 课程更新效率提高3倍
11. 未来发展方向
-
技术优化方向:
- 提升视频生成质量
- 减少人工干预需求
- 优化资源占用
-
功能扩展计划:
- 增加多语言支持
- 开发移动端应用
- 强化协作功能
-
生态建设目标:
- 建立素材市场
- 发展插件系统
- 培育开发者社区
在实际使用Toonflow的过程中,我发现合理规划项目结构、提前准备好高质量的原始素材,能够显著提升最终成片的质量。同时,建议初次使用者从小型项目开始,逐步熟悉系统的工作流程和各项功能,这样可以避免因操作不当导致的时间浪费。
