🎬 Toonflow：开源AI短剧工具 小说变视频 一站式短剧工厂

小说一键变动画短剧？Toonflow 是开源 AI 短剧工厂，小说导入后自动完成剧本改编、分镜制作、视频生成，三层 Agent 协作+无限画布工作台，2 小时即可产出 2 分钟成片。Windows/macOS/Linux 全平台，12,263 Stars 验证，Apache-2.0 开源。

🎤 引言

把一篇几万字的小说拍成动画短剧，传统流程需要编剧改编、美术设定、分镜制作、视频剪辑——一个完整短剧团队至少要几个人干好几天。

Toonflow（GitHub 12,263 Stars）是 HBAI 公司开源的 AI 短剧创作工具，定位是"一站式短剧工厂"。输入小说文本，工具自动完成剧本改编、章节事件提取、角色生成、分镜制作，最后输出视频素材。官方 Demo 展示了一段约 2 分钟的 AI 短剧，全程从导入小说到导出成片实测只用了 2 小时，总成本约 ¥130。

如果你想做短剧但不想养团队，或者想快速验证小说 IP 的视频化效果，Toonflow 可能是目前门槛最低的开源方案。

⭐ 核心功能

🏭 "策划 → 编剧 → 分镜 → 出片"全流程闭环

Toonflow 围绕一个完整短剧生产周期设计，不是单一功能的 AI 工具，而是覆盖从原始文本到最终视频素材的全流程工作台。

核心模块：

• ScriptAgent：负责剧本改编，将小说文本拆解为章节事件、生成故事骨架、输出结构化剧本
• ProductionAgent：负责分镜制作，组织角色、分镜图、素材节点，完成视频拼接与导出
• 三层 Agent 协作：决策层（总控）+ 执行层（生成）+ 监督层（质量审阅），减少单 Agent 的随机性

🖼️ 无限画布工作台

类 Figma/Miro 的无限画布设计，在画布上自由组织剧本节点、角色卡片、分镜画面、视频素材。不受线性流程限制，可以随时回溯、调整顺序、并行推进多个章节。

🧠 持久化 Agent 记忆

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

• 短期记忆：当前会话内的消息上下文
• 长期摘要：自动生成章节级别的记忆摘要
• 语义召回：根据当前任务语义从历史记忆中检索相关内容

多轮创作时，Agent 能记住之前的角色设定和剧情走向，保持一致性。

🔧 可编程供应商系统

在设置中心直接编写供应商 TypeScript 逻辑，无需修改源码或重启应用即可即时生效。适合：

• 接入私有模型服务
• 替换默认模型供应商
• 调试不同模型的生成效果

📚 章节事件图谱驱动改编

长篇小说改编时，Toonflow 会自动提取各章节的核心事件，构建事件图谱。剧本改编按图谱精准调用上下文，避免长文本在多轮对话中丢失关键信息。这是比简单 RAG 更适合"小说改编"场景的设计。

🛠️ Skill 文件化配置

ScriptAgent 和 ProductionAgent 的核心提示词以 Markdown Skill 文件形式存在，支持在线编辑和热加载。不用改代码，直接调 Skill 参数就能改变 Agent 的行为风格。

📺 官方 Demo 实测数据

官方发布了一段完整 Demo 短剧，记录了每个环节的成本和时间：

成本明细：

130 元出一段 2 分钟的 AI 短剧，vs 传统流程（编剧+美术+剪辑+配音）成本，轻松省下几千元。

📥 安装使用

全平台桌面端

⚠️ macOS 首次打开需要到「设置 → 隐私与安全性」信任证书，否则会因签名问题无法启动。

Docker 部署

git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app

# 本地构建 + 启动
yarn docker:local

# 或手动
docker build -t toonflow .
docker run -d -p 10588:10588 \
  -v /your/data/path:/app/data \
  toonflow

# 访问 http://localhost:10588/web/index.html

前置条件

Toonflow 本身免费，但需要自行准备：

• ✅ 大语言模型 AI 服务接口地址（Claude / GPT / DeepSeek 等）
• ✅ 视频生成服务接口（Sora / 豆包 / Seedance 等）
• ✅ 图片生成模型服务（GPT Image / FLUX 等）

快速上手流程

1. 启动应用 → 登录（默认账号 admin，密码 admin123）
2. 在「设置中心」配置各模型供应商接口
3. 新建项目 → 导入小说原著 → 执行「章节事件提取」
4. 进入 ScriptAgent → 生成故事骨架 + 结构化剧本
5. 切换 ProductionAgent → 在无限画布中组织分镜、素材、视频节点
6. 精调分镜图 → 回流工作台 → 视频拼接与导出

🎯 适用场景

1. 小说 IP 视频化验证

写完一篇网文，想看看改编成视频效果如何？Toonflow 可以快速把文本变成可视化短剧，比找团队做便宜得多，适合在投入正式影视化之前做概念验证。

2. 短视频内容创作

抖音/快手/B站等平台的短剧内容需求旺盛，Toonflow 的三层 Agent 可以批量生产同风格短剧素材，大幅降低内容生产成本。

3. AI 影视实验

对 AI 生成视频的质量上限感兴趣？Toonflow 是目前最完整的"小说→视频"端到端实验框架，适合研究 AI 影视生成管线。

4. 剧本开发快速原型

编剧或制作人在立项前需要给投资人看"样片"，Toonflow 可以快速生成一段原型视频，比 PPT 有说服力得多。

🔍 对比 / 替代方案

对比要点：

• vs Pika/Runway：这些是纯视频生成工具，输入 prompt 或图片输出视频；Toonflow 的核心差异是"从小说文本到成片"的完整闭环，不只是单镜头生成。
• vs 自建管线：自己组合 Stable Diffusion + ComfyUI + 配音工具 + 剪辑软件，学习成本和技术门槛很高；Toonflow 开箱即用，2 小时出成品。
• 成本：Toonflow 的成本主要是调用 API 的tokens费用，130 元/2分钟已经是 AI 短剧里非常低的门槛了；传统影视化至少几万起步。

⚠️ 注意事项

1. 需自备 API 密钥：Toonflow 本身免费，但需要自己准备大模型、视频生成、图片生成的 API 接口地址和密钥，相关费用由你自行承担。
2. 视频质量有上限：当前 AI 视频生成技术（Seedance/Sora 等）生成的短剧与专业影视作品仍有明显差距，适合概念验证和低成本内容生产，不适合追求高画质的项目。
3. 长篇小说处理能力有限：章节事件图谱可以缓解长文本信息丢失问题，但几十上百万字的超长篇小说仍可能遇到 Agent 上下文窗口限制。
4. macOS 证书问题：macOS 用户首次打开需要在系统设置里手动信任证书才能正常运行。
5. Gitee 暂不提供 Release：因为 OS 环境限制，Release 文件暂未同步到 Gitee，国内用户建议直接用 GitHub 下载。
6. 中文界面为主：UI 默认简体中文，英文用户可能需要参考多语言文档。

✅ 总结

Toonflow 是目前最完整的开源 AI 短剧创作工具——从小说文本到动画短片的全流程闭环、三层 Agent 协作、无限画布工作台、实测 2 小时 ¥130 成本。相比传统影视化门槛，Toonflow 把"拍短剧"这件事从专业团队压缩到了个人创作者可及的范围。

优点：全流程闭环、开源免费、可编程供应商、Skill 热加载、支持 Docker
缺点：需自备 API 密钥、视频质量有上限、超长篇小说处理有挑战
适合：小说 IP 验证、短剧内容创作、AI 影视实验、剧本快速原型

想低成本验证小说 IP 的视频化价值？Toonflow 是目前最值得尝试的开源方案。

⭐ GitHub Stars：12,263（截至 2026-07）
📦 技术栈：Electron + Vue3 + TypeScript + Vite + Node.js + Docker
🌐 官网：toonflow.net
🔗 GitHub：github.com/HBAI-Ltd/Toonflow-app