
01 一句话定位:小说到短剧的“一站式流水线”
Toonflow 是北京爱阿科技有限公司(HBAI-Ltd)开源的一款 AI 短剧创作工具,目标是把小说、剧本快速转化为动画短剧。它把“策划→编剧→分镜→出片”串成一条可本地运行的桌面流水线,并宣称能将创作效率提升 10 倍以上。项目在 2026 年 1 月底创建,8 月底仍有更新,目前 GitHub 15,149 Stars、2,727 Forks,用 TypeScript 写成,采用 Apache-2.0 协议开源,但附带了一份补充商业授权条款。

02 核心工作流:策划→编剧→分镜→出片
Toonflow 的整个界面都围绕“策划→编剧→分镜→出片”这个闭环设计。你可以把一本小说导入项目,先由 ScriptAgent 提取章节事件并生成故事骨架和结构化剧本;再切换到 ProductionAgent,在一张无限画布上组织分镜、角色、素材和视频节点;最后把分镜图精调后回流工作台,完成视频拼接与导出。
这个流程不是线性的。无限画布允许你随时回到任意节点修改,比如发现某句台词不对,可以倒回剧本层改完再重新生成对应分镜,而不必从头跑一遍。

03 三层 Agent 协作体系
Toonflow 不是单个大模型在跑,而是把任务拆给了三层 Agent:决策层负责拆解任务和制定改编策略;执行层负责内容生成、分镜绘制、视频合成;监督层则做质量审阅与修订反馈。这种结构的作用是让长文本改编和跨模态生成的稳定性更高,减少“写到一半跑偏”的问题。
在代码层面,项目结构里能看到 src/agents/scriptAgent 和 src/agents/productionAgent 两个目录,分别对应剧本改编和生产制作两类 Agent。
04 六个让长剧作更稳定的工程亮点
除了工作流和 Agent 架构,Toonflow 还有几个比较务实的设计,能显著降低“AI 写了一半忘设定”的概率。
| 亮点 | 作用 |
|---|---|
| 无限画布生产工作台 | 剧本、角色、分镜、素材以节点形式自由编排,支持并行生产和回溯。 |
| 持久化 Agent 记忆 | 基于本地 ONNX 向量检索,分短期消息、长期摘要和语义召回,跨会话也能记住上下文。 |
| 可编程供应商系统 | 在设置中心直接写 TypeScript 逻辑接入私有模型,保存即生效,无需改源码或重启。 |
| 章节事件图谱 | 先把原著章节事件结构化,改编时按事件图谱调用上下文,减少长文本信息丢失。 |
| Skill 文件化配置 | 核心提示词外化为 Markdown Skill 文件,可在线编辑、快速调优。 |
| 多模型集成 | Vercel AI SDK 支持 OpenAI、Anthropic、Google、DeepSeek、智谱、MiniMax、通义千问、xAI 等多家模型。 |

05 安装与部署:桌面包、Docker、云服务器三种姿势
Toonflow 提供三种运行方式,对应不同用户场景。
方式一:Release 安装包(最省事)。最新版是 v1.1.8,2026 年 6 月发布,提供 Windows、macOS、Linux 安装包,下载安装后启动即可。首次登录默认账号为 admin,密码 admin123。
方式二:Docker 本地构建。克隆仓库后执行 yarn docker:local,或手动 docker build -t toonflow . 后运行,默认暴露 10588 端口。
方式三:云服务器部署。推荐 Node.js 24.x,安装 yarn 和 pm2 后,yarn install、yarn build、pm2 start pm2.json。内存建议 2GB 以上。

06 现实边界:授权、模型费用与上手门槛
虽然 Toonflow 源码以 Apache-2.0 开源,但 README 里明确附加了商业授权条款:如果把软件以产品形式分发给 2 个及以上独立第三方使用,需要取得 HBAI-Ltd 的书面商业授权。≤5 个法人内部联合运营、个人学习研究、用 Toonflow 制作内容获得平台分账,或二次开发供自己团队内部使用,则永久免费。
另外,Toonflow 本身免费,但它不包模型 API 费用。文本、图像、视频生成都要调用第三方模型,这意味着跑一个 Demo 可能仍要花模型费。官方给出的参考数据是:一个约 2 分钟成片、原始素材 3 分钟、剪除废片约 1 分钟的 Demo,模型总成本约 ¥130(语言模型约 ¥10,视频模型约 ¥120,图片模型不足 ¥1)。
总结来说,Toonflow 把一个原本需要多工具切换的短剧创作流程,收敛到了一个可本地运行的桌面应用里。如果你手里有小说版权、有模型 API 预算、并且接受其授权条款,它确实能把“文本→动画短剧”的链路大幅缩短。但对于只想免费白嫖模型出片的用户,模型费和商用授权仍是绕不开的门槛。

AI智汇具 - AI工具推荐与技能教程_好用的AI工具大全






