项目档案应用项目

Toonflow AI短剧创作工具：从小说到视频的全流程自动化解决方案（含安装使用指南）

Toonflow 是一款 AI 短剧创作工具，能将小说自动转化为剧本、分镜和视频，实现全流程自动化。本文详细介绍其功能特性、解决的核心问题、适用场景、安装前置条件、具体安装步骤、使用流程以及技术架构特点，帮助用户快速上手这款提升 10 倍效率的短剧制作工具。

15,791TypeScriptStar 于 2026年2月7日2026年9月19日更新

查看 GitHub 仓库打开项目主页

AI 总结

Toonflow 是一款 AI 短剧创作工具，通过三层 Agent 协作体系将小说自动转化为剧本、分镜和视频，实现从文本到影像的全流程自动化，显著降低短剧制作门槛并提升效率。

中文项目介绍

Toonflow 是一款面向短剧生产的 AI 工作台，核心定位为“AI 短剧工厂”，旨在实现从小说到视频的全流程自动化创作。它通过三层 Agent 协作体系（决策层、执行层、监督层）覆盖任务拆解、内容生成、质量审阅等环节，结合无限画布工作台和持久化记忆系统，让用户能够零门槛完成短剧制作。该工具主要解决传统短剧创作中流程繁琐、效率低下的问题。传统方式需要专业编剧、分镜师、视频剪辑师多人协作，周期长、成本高。Toonflow 利用 AI 技术自动化完成剧本改编、分镜设计、素材生成和视频合成，将创作效率提升 10 倍以上，同时降低对专业技能的依赖。适用场景广泛：短视频内容创作者可快速生成剧情视频；文学爱好者可将小说实验性影视化；AI 研究者可探索文学改编工具；专业编剧可用于剧本开发与快速原型验证；视频素材生成平台可集成其能力。技术层面，Toonflow 基于 Electron 构建跨平台桌面应用，后端采用 Node.js + Express，通过 Socket.IO 实现实时通信。集成多 AI 提供商（OpenAI、Anthropic、DeepSeek 等），使用 AI SDK 统一调用。数据存储采用 SQLite，通过 knex 进行迁移管理。创新特性包括：可编程供应商系统（支持 TypeScript 动态配置）、章节事件图谱驱动改编、Skill 文件化提示词管理、本地 ONNX 向量检索的记忆系统。

详细信息与使用说明

1. 项目定位与用途

Toonflow 是一款 AI 短剧创作工具，定位为“AI 短剧工厂”，致力于实现从文本到影像的全流程自动化。它通过三层 Agent 协作体系（决策层、执行层、监督层）和无限画布工作台，将小说自动转化为剧本、分镜和视频，让用户“动动手指”即可完成短剧制作。核心用途是降低短剧创作门槛，提升生产效率，适用于短视频创作、小说影视化实验、剧本开发等场景。项目采用 Electron 跨平台架构，支持 Windows、Linux 和 macOS 系统，提供多语言界面（简体中文、繁体中文、英文、泰文、越南文、日文、俄文）。

2. 解决的问题

Toonflow 主要解决传统短剧创作中的三大痛点：流程繁琐、效率低下、专业门槛高。传统方式需要编剧、分镜师、视频剪辑师等多角色协作，周期长、成本高。Toonflow 通过 AI 自动化实现：1）剧本生成：将小说自动转化为结构化剧本；2）分镜设计：基于剧本生成视觉分镜；3）素材生产：AI 生成图片和视频素材；4）视频合成：自动拼接导出成片。这将创作效率提升 10 倍以上，同时让非专业用户也能参与短剧制作，实现“0 门槛全流程 AI 化”。

3. 适用场景

Toonflow 适用于多种创作场景：短视频内容创作者可快速生成剧情视频，丰富内容形式；文学爱好者与小说作者可实验性将作品影视化，探索 IP 改编可能性；AI 研究者与开发者可将其作为文学改编工具，研究 AI 叙事能力；专业编剧可用于剧本开发与快速原型验证，加速创意迭代；视频素材生成平台可集成其能力，提供自动化内容生产服务。此外，教育机构可用于影视教学演示，企业可用于广告创意快速产出。

4. 安装方式

Toonflow 提供跨平台安装包，支持 Windows、Linux 和 macOS。安装前需准备前置条件：大语言模型 AI 服务接口地址（如 OpenAI、Claude 等）、视频生成服务接口地址（支持 Sora 或豆包）、图片生成模型服务接口（Nano Banana Pro）。安装步骤：1）从 GitHub、Atomgit 或夸克网盘下载对应系统的安装包；2）运行安装程序完成安装；3）首次启动使用默认账号 admin/admin123 登录。开发环境需 Node.js 和 yarn，通过 yarn install 安装依赖，yarn dev 启动开发服务器，yarn build 构建，yarn dist 打包分发。仓库中未明确给出 Docker 部署的具体命令。

5. 使用方式

Toonflow 的使用流程分为六个步骤：1）启动应用并登录（默认账号 admin/admin123）；2）在设置中心完成模型供应商配置，填入文本、图像、视频模型的 API 地址；3）新建项目并导入原著小说，执行章节事件提取；4）进入 ScriptAgent 生成故事骨架、改编策略与结构化剧本；5）切换到 ProductionAgent，在无限画布中组织分镜、素材与视频节点，支持自由编排；6）对分镜图进行节点化精调后回流工作台，完成视频拼接与导出。系统还提供 Bilibili 视频教程和微信扫码观看方式。

6. 补充说明与实现特点

Toonflow 具有多项创新实现特点：三层 Agent 协作体系确保任务拆解、生成与审阅的稳定性；持久化 Agent 记忆基于本地 ONNX 向量检索，支持短期消息、长期摘要和语义召回，保证多轮创作连续性；可编程供应商系统允许在设置中心直接编写 TypeScript 逻辑并即时生效，便于私有化和多模型接入；章节事件图谱驱动改编自动提取原著事件并结构化存储，减少长文本信息丢失；Skill 文件化配置将核心提示词外化为 Markdown，支持在线编辑与快速调优。项目采用 Apache-2.0 开源协议，代码托管于 GitHub、Gitee 和 Atomgit。仓库中未明确给出详细的 API 文档或插件开发指南。

思维导图

Toonflow

核心架构

Electron 桌面应用

Node.js 后端服务

Socket.IO 实时通信

SQLite 持久化存储

主要模块

ScriptAgent（剧本生成）

ProductionAgent（生产执行）

无限画布工作台

记忆管理系统

供应商系统

Skill 配置系统

技术栈

TypeScript

AI SDK（多提供商）

@huggingface/transformers

knex 数据库工具

express 框架

工作流程

小说导入 → 事件提取

剧本生成（ScriptAgent）

分镜设计（ProductionAgent）

素材生成 → 视频合成

常见问题

Toonflow 是什么？

如何安装 Toonflow？

从 GitHub、Atomgit 或夸克网盘下载对应操作系统（Windows/Linux/macOS）的安装包，运行安装程序即可。开发环境需 Node.js 和 yarn，通过 yarn install 安装依赖，yarn dev 启动开发，yarn dist 打包。

使用 Toonflow 需要哪些前置条件？

需要准备大语言模型 AI 服务接口地址、视频生成服务接口地址（支持 Sora 或豆包）、图片生成模型服务接口（Nano Banana Pro），并在设置中心完成配置后方可使用完整功能。

Toonflow 支持哪些 AI 模型？

Toonflow 集成多 AI 提供商，包括 OpenAI、Anthropic、DeepSeek、Google、xAI 等，通过 AI SDK 统一调用。用户可在设置中心配置供应商，支持可编程供应商系统动态扩展。

如何使用 Toonflow 创作短剧？

登录后新建项目导入原著，使用 ScriptAgent 生成剧本，再通过 ProductionAgent 在无限画布中组织分镜和素材，最后精调并导出视频。详细步骤见本文使用方式章节，也提供 Bilibili 视频教程。