HBAI-Ltd/Toonflow-app · 上手攻略
- 仓库：HBAI-Ltd/Toonflow-app
- 链接：https://github.com/HBAI-Ltd/Toonflow-app
- 分类：multimodal / AI 视频生成
- 作者：Jay
- 更新：2026-07-08
这是什么
Toonflow（动画流）是一款开源一站式 AI 短剧创作工具，将小说或剧本快速转化为动画短剧。集成 AI 编剧（ScriptAgent）、智能分镜（ProductionAgent）、角色管理和视频生成，覆盖"策划 → 编剧 → 分镜 → 出片"全流程，官方称创作效率提升 10 倍以上。
官网：https://toonflow.app 文档：https://github.com/HBAI-Ltd/Toonflow-app（README 内置详细说明）
解决什么问题
传统短剧制作流程需要：编剧改编 → 分镜设计 → 美术作图 → 视频剪辑，每步都要专业人员和大量时间。Toonflow 用三层 Agent 协作体系把这四步压缩成端到端的 AI 流水线：
- ScriptAgent：接收原著小说，自动提取章节事件图谱，生成改编策略和结构化剧本
- ProductionAgent：基于剧本在无限画布上编排分镜、素材与视频节点
- 监督层 Agent：质量审阅与修订反馈，提升成片一致性
典型案例全程约 2 小时完成一部 2 分钟短剧，模型费用约 ¥130（视频模型为主）。
快速安装
方式一：下载官方发行包（最简）
直接下载对应平台的安装包，Windows / Linux / macOS 均有官方 Release：
https://github.com/HBAI-Ltd/Toonflow-app/releases
下载后启动即可，首次登录账号密码：
- 用户名：admin
- 密码：admin123
⚠️ 请在部署后第一时间修改默认密码！
方式二：Docker 部署
# 克隆仓库
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
# Docker Compose 启动
docker compose up -d
# 访问 http://localhost:10588
方式三：源码构建（适合开发者）
前置环境： - Node.js 23.11.1+（官方推荐 24.x） - Yarn - PM2（生产环境进程管理）
# 安装 Node.js（建议用 nvm）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 24
# 安装 Yarn 和 PM2
npm install -g yarn pm2
# 克隆项目
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
# 国内可用 Gitee 镜像加速
# git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
# 安装依赖
yarn install
# 开发模式（Electron 桌面窗口）
yarn dev:gui
# 或仅启动后端 API（端口 10588）
yarn dev
# 生产构建
yarn build
创建 PM2 配置（pm2.json）：
{
"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 start pm2.json
pm2 startup # 设置开机自启
pm2 save
核心用法
1. 配置 AI 模型供应商
Toonflow 支持可编程供应商系统，在设置中心直接编写 TypeScript 逻辑，无需改源码。
支持的模型类型：
| 类型 | 示例 |
|---|---|
| 语言模型 | Claude Opus 4.6、DeepSeek、智谱、GPT-4o、MiniMax 等 |
| 图片模型 | GPT Image 2、Nano Banana Pro 等 |
| 视频模型 | Seedance 2.0、Sora、豆包视频等 |
⚠️ 必须自备相应 API Key（Toonflow 本身不提供模型服务）
2. 新建项目并导入原著
- 新建项目 → 导入小说文本（txt/epub 等）
- 执行"章节事件提取"，Toonflow 自动构建事件图谱
- 剧本改编按事件图谱精准调用上下文，减少长文本信息丢失
3. ScriptAgent 生成剧本
ScriptAgent 会： - 分析原著章节事件 - 生成故事骨架和改编策略 - 输出结构化剧本（分场分镜脚本）
4. ProductionAgent 分镜编排
在无限画布上组织： - 分镜节点 - 角色素材 - 视频节点 - 可自由编排、回溯、并行生产
5. 精调与视频导出
- 对分镜图进行节点化精调
- 回流工作台完成视频拼接
- 导出最终成片
典型成本参考（官方 Demo）
| 消耗项 | 费用 |
|---|---|
| 语言模型 | ~¥10 |
| 视频模型（全量） | ~¥120 |
| 图片模型 | <¥1 |
| 合计 | ~¥130 |
典型适用场景
| 场景 | 说明 |
|---|---|
| 短视频内容创作 | 网文改编短剧、流量变现 |
| 小说影视化实验 | 文字作品快速可视化 |
| AI 文学改编工具 | 编剧辅助、降本增效 |
| 剧本快速原型 | 短视频团队快速出样片 |
| 视频素材生成 | 广告、宣传片素材 |
坑与注意
- 需要自备模型 API：Toonflow 是工作台，不包含模型服务，需要额外付费接入
- 视频模型费用高：Demo 视频费用 ¥120/部，主要成本在视频生成
- Node.js 版本要求高：必须 23.11.1+，部分系统默认源版本过低
- Docker 部署说明不完整：README 中 Docker 步骤有缺失（"待完善"），建议用发行包或源码构建
- 商业授权条款：面向 2 个以上独立第三方分发需商业授权（≤5 法人内部使用免授权）
- 前端仓库独立：如需二次开发前端，需额外部署 Toonflow-web 仓库
- Linux Release 说明缺失：GitHub Release 页面未明确标注 Linux 对应哪个文件，需查看文件后缀判断
- 生产部署需配置 OSSURL：如静态资源访问有问题，检查 OSSURL 环境变量
与同类对比
| 项目 | 核心能力 | 部署 | 费用 | 特色 |
|---|---|---|---|---|
| Toonflow | 小说→短剧全流程 | 桌面/服务器 | 模型 API 费 | 全流程 AI 化，无限画布 |
| Runway | 文生视频 | 纯云 | 订阅制 | 通用视频，剧本需另外写 |
| Pika | 文字/图片生视频 | 纯云 | 订阅制 | 快但非全流程 |
| 腾讯混元3D | 3D 视频生成 | API | 按量 | 3D 能力强，非全流程 |
| 剪映 | 视频剪辑+AI | 桌面 | 免费 | 通用剪辑，非剧本驱动 |
结论：Toonflow 是目前唯一开源的"小说→动画短剧"端到端工具链，适合网文创作者、短视频团队和 MCV 机构快速试错。
一句话推荐结论
有大量网文 IP 想影视化变现？Toonflow 是目前唯一开源的端到端 AI 短剧工作台，一本书进去、两小时短剧出来，适合个人创作者和小型工作室。
Stars 11202 · 周增 +217（截至 2026-07-08）