ToonFlow：开源AI短剧创作工具技术分析

概述

ToonFlow 是由北京爱阿科技有限公司（HBAI-Ltd）开发的一款开源一站式AI短剧创作工具。该项目于2026年1月29日首次发布，目前版本为 v1.1.8，已获得超过 11,557 个 GitHub Stars。

ToonFlow 的核心定位是将小说、剧本快速转化为动画短剧，围绕"策划 → 编剧 → 分镜 → 出片"构建完整的 AI 创作闭环。其宣传语"动动手指，小说秒变剧集"体现了该项目的目标——通过AI技术将创作效率提升10倍以上。

仓库信息

核心功能特性

1. 无限画布生产工作台

ToonFlow 采用类无限画布的形式组织创作流程，支持：

• 剧本、角色、分镜、素材与视频节点的自由编排
• 历史版本回溯
• 并行生产模式

这种设计为创作者提供了灵活、直观的创作界面，类似于Miro或Figma的设计理念。

2. 三层 Agent 协作体系

ToonFlow 实现了创新的三层AI Agent协作架构：

• 决策层：负责任务拆解和策略制定
• 执行层：负责具体内容生成
• 监督层：负责质量审阅和修订反馈

这种分层设计确保了创作过程的可控性和质量。

3. 持久化 Agent 记忆系统

基于本地 ONNX 向量检索的跨会话记忆系统，支持：

• 短期消息记忆
• 长期摘要记忆
• 语义召回

这使得AI Agent能够在多次创作会话中保持上下文一致性。

4. 可编程供应商系统

ToonFlow 的一个显著特点是其可编程供应商系统：

• 支持在设置中心直接编写供应商 TypeScript 逻辑
• 逻辑即时生效，无需修改源码或重启服务
• 支持多种AI供应商的灵活切换

5. 章节事件图谱驱动改编

创新的事件图谱技术：

• 自动提取原著章节事件
• 结构化存储事件关系
• 按事件图谱精准调用上下文
• 实现智能剧本改编

6. Skill 文件化配置

将核心提示词外化为 Markdown Skill 文件：

• ScriptAgent（剧本Agent）的提示词
• ProductionAgent（生产Agent）的提示词
• 支持在线编辑和快速调优
• 无需修改代码即可优化AI行为

技术架构

技术栈

AI供应商支持

ToonFlow 通过 Vercel AI SDK v6 集成了多家AI供应商：

• OpenAI
• Anthropic
• Google
• DeepSeek
• 智谱（GLM系列）
• MiniMax
• 通义千问
• xAI

这种多供应商支持使得用户可以根据需求选择最合适的AI服务。

项目目录结构

Toonflow-app/├── src/│   ├── agents/           # AI Agent核心模块│   │   ├── scriptAgent   # 剧本Agent│   │   └── productionAgent # 生产Agent│   ├── routes/           # API路由│   │   ├── agents        # 记忆管理│   │   ├── artStyle      # 画风配置│   │   ├── assets        # 素材管理│   │   ├── script        # 剧本生成│   │   ├── production    # 制作管理│   │   └── ...│   ├── socket/           # WebSocket实时通信│   ├── lib/              # 公共库│   ├── middleware/        # 中间件│   └── types/            # TypeScript类型声明├── data/│   ├── skills/           # Agent技能提示词（Markdown）│   ├── models/           # 本地推理模型（ONNX）│   └── oss/              # 对象存储（素材/角色/场景）├── docs/                 # 多语言文档└── data/web/             # 前端编译产物

部署方式

ToonFlow 支持四种部署方式，满足不同场景需求：

1. 本机安装

• 提供 Windows、Linux、macOS 三平台安装包
• 基于 Electron 打包
• 适合个人开发者和小团队

2. Docker 部署

# 构建镜像docker build -t toonflow .# 运行容器docker run -p 10588:10588 toonflow

• 包含完整的 Dockerfile
• 便于在服务器上快速部署

3. 云服务器部署

• 通过 Node.js + PM2 部署
• 支持 Ubuntu/CentOS 等主流Linux发行版
• 适合生产环境

4. 云平台部署

• 与智星云合作
• 提供开箱即用的 GPU 云桌面镜像
• 适合需要GPU加速的场景

默认配置：

• 服务端口：10588
• 默认账号：admin / admin123

应用场景

1. 短视频内容创作

ToonFlow 最适合短视频平台的内容创作：

• 快速生成动画短剧
• 降低视频制作门槛
• 批量生产内容

2. 小说影视化实验

• 将网络小说快速转化为可视化内容
• 测试剧本改编效果
• 探索IP可视化路径

3. AI文学改编工具

• 自动提取原著关键事件
• 智能生成分镜脚本
• 保持原作风格和情节

4. 剧本开发与快速原型

• 快速验证剧本创意
• 生成可视化分镜
• 加速前期开发流程

5. 视频素材批量生成

• 自动化素材生产
• 风格一致性保证
• 高效内容扩展

许可证与商业授权

ToonFlow 基于 Apache 2.0 协议开源，但附有补充商业协议：

免费使用场景

• ✅ 个人学习、研究、非商业用途（永久免费）
• ✅ 5个及以下法人联合内部使用（无需授权）

需要商业授权的场景

• ⚠️ 分发给2个及以上独立第三方（需书面商业授权）
• ⚠️ 商业用途按年销售额分级收费

  • 年收入低于10万元可免费申请授权

  • 具体费用需联系官方

社区与生态

技术生态

• 前端仓库：Toonflow-web^[3]

  • 基于 Vue 3 + Vite 技术栈

  • 与后端配套使用

多语言支持

ToonFlow 支持7种语言界面：

• 简体中文
• 繁体中文
• 英语
• 泰语
• 越南语
• 日语
• 俄语

社区资源

• 视频教程：B站视频教程
• 交流社区：微信交流群、Discord 社区
• 演示案例：约2小时制作一部AI短剧，成本约130元人民币

认证与荣誉

• AtomGit G-Star 认证
• Gitee GVP 认证

技术亮点总结

1. AI-Native 设计

ToonFlow 从底层架构就是为AI驱动的创作流程设计的，而非简单的AI功能叠加。

2. 三层 Agent 架构

创新的决策-执行-监督分层结构，确保了创作过程的可控性和质量。

3. 可扩展的供应商系统

支持多种AI供应商，且可编程设计使得新供应商的集成非常灵活。

4. 本地化记忆系统

基于 ONNX 的向量检索实现了高效的本地记忆管理，保护用户隐私。

5. Skill 文件化

将AI行为配置外化为 Markdown 文件，降低了调优门槛，提升了迭代效率。

总结

ToonFlow 作为一款开源AI短剧创作工具，展现了AI在创意内容生产领域的巨大潜力。其创新的三层Agent架构、可编程供应商系统、以及事件图谱驱动的改编技术，为AI辅助创作提供了新的范式。

该项目特别适合：

• 短视频内容创作者
• 网络文学IP运营方
• 独立动画制作人
• AI技术研究者

随着AI技术的不断发展，ToonFlow 这类工具将极大地降低动画短剧的创作门槛，推动内容创作的民主化进程。

项目链接：

• GitHub: https://github.com/HBAI-Ltd/Toonflow-app^[4]
• 官网: https://toonflow.net^[5]
• 前端仓库: https://github.com/HBAI-Ltd/Toonflow-web^[6]

引用链接