Toonflow:开源 AI 短剧与漫剧视频生成平台,剧本、分镜、资产与镜头在同一张无限画布上成片

一句话定位

Toonflow(HBAI-Ltd/Toonflow-app)是面向短剧、漫剧与短视频创作的开源 AI 创作平台:剧本、分镜、角色与场景资产、图片与视频镜头,全部铺在同一张无限画布上,由创作者亲手连线串成从文字到成片的完整产线。采集时仓库 18,468 stars、3,283 forks,MIT 许可,主语言 TypeScript,运行时 Bun 1.3.14,建仓于 2026-01-29,至今保持高频更新。

它与「又一个文生视频套壳」的区别,在于把一部短剧的制作链路整体产品化成画布节点:文本节点写剧本与分镜,图片生成节点出角色三视图与场景图,视频生成节点按参考素材逐镜头出片,音频节点管配音与音效,3D 导演台负责机位预演;模型层完全开放,用哪家供应商、接不接本地 ComfyUI,由创作者自己决定。

数据面

项	值
仓库	HBAI-Ltd/Toonflow-app(MIT,TypeScript monorepo)
Stars / Forks / Watchers(采集时快照)	18,468 / 3,283 / 82
建仓	2026-01-29
运行时与前端	Bun 1.3.14 + Express(server)、Vue 3(web)、Electrobun(桌面)
客户端形态	Windows / macOS / Android ARM64 / Docker / Linux 服务器
界面语言	21 种
来源	GitHub 主干 depth-1 clone(2026-10-20)+ README、仓库 AGENTS.md 与 packages 源码精读

一张画布拍完一部短剧:四步工作流

官方 README 给出的制作流程是四步,且四步都发生在同一张画布上:

1. 编写剧本与分镜:在文本节点里整理故事、人物设定与镜头描述,由语言模型辅助创作,再人工审阅修改;
2. 准备角色与场景素材:导入参考图,或用图片生成节点制作角色三视图、场景图与分镜图,把全片视觉基调锁死;
3. 生成视频镜头:把文本与图片参考连进视频生成节点,选择视频模型与生成模式,按镜头逐条生成视频片段;
4. 预览、整理与下载:在画布中预览与组织图片、视频片段,导出素材交下游剪辑收尾。

每一步支持的参考素材数量、时长、分辨率与音频能力,完全取决于当次选择的模型与供应商 —— Toonflow 不假装自己有一层统一的能力面,README 把这句话写进了 FAQ。

节点体系:八个内置节点,其余交给插件市场

monorepo 的 packages/nodes 下有八个内置节点,恰好覆盖「文、图、视频、音频,加一位导演」:

节点	职责
textNode	剧本、分镜、设定等文本创作与语言模型辅助改写
imageNode / imageGenerationNode	参考图管理,与角色三视图、场景图、分镜图的图片生成
videoNode / videoGenerationNode	镜头片段管理,与多参考素材的视频生成
audioNode / audioGenerationNode	音频素材管理,与配音、音效的音频生成
director3dNode	3D 导演台:在虚拟场景里摆机位与角色,先预演镜头再交给视频生成

节点之外是三层脚手架边界:packages/nodeScaffold 只提供通用节点基础能力与宿主接口,跨插件共享的组件与业务逻辑收进独立包 packages/nodeShared,插件专属的组件、提示词与预设必须留在插件自己里面 —— 仓库自带的 AGENTS.md 把这条边界写成硬规则。再往上是插件市场:故事板、全景图、时间轴,甚至小游戏都能塞进画布,插件化是设计而不是 hack。

模型供应商层:自选、可接 ComfyUI,官方中转也一并开源

packages/providers 是第三次重构后的一套供应商系统:页内可配置第三方 API Key,也可以通过自定义供应商适配接入本地 ComfyUI 工作流与本地 LLM。官方自营的模型中转平台 TF-Router 单独成仓开源(HBAI-Ltd/TF-Router),可自行部署审计;团队自己与火山签了 Seedance 年框,活动期间 Seedance 2.0 平进平出不赚差价。

README 自报了一个真实制作案例,可以校准这套工具的成本量级:

环节	模型	案例记录
语言(剧本与分镜辅写)	Claude Opus 4.6	约 ¥10
图片(角色与场景图)	GPT Image 2	不足 ¥1
视频(镜头片段)	Seedance 2.0	约 ¥120
合计	约 2 小时制作、成片约 2 分钟(演示为 480p 压缩版)	约 ¥130

把创作流程开放给机器:Agent、MCP、Skills

Toonflow 的「开放 Agent」开放三样东西:提示词、工具与 A2A —— 既可以自定义 Agent 行为,也可以与外部 Agent 协作。packages/teams 里的 storyboardTeam 是内置的分镜团队协作;packages/skills 把画布与工作流经验沉淀成可复用技能(canvas / workflow / v118workflow 三套);packages/mcp 加上 server 侧的 utils/mcp 把画布能力做成 MCP 的工具与资源,外部工具与服务按 MCP 协议接进来。同一张画布,人可以操作,机器也可以驱动。

部署形态:四端共用一份数据目录

形态	说明
Windows / macOS 桌面	Electrobun 客户端;Windows 安装器自动检测安装 WebView2,macOS Apple Silicon 拖入即开
Android ARM64	APK 内置本地 Bun 后端可独立运行;也可「设备互联」扫码连接已共享的电脑或远程后端(局域网与公网)
Docker	compose 一条命令起 Web + Server,镜像基于 Bun 1.3.14 且内置 FFmpeg;配置、插件与项目在命名卷 toonflowData(容器内 /app/data/),docker compose down -v 会删数据卷
Linux 服务器	Bun 1.3.14 直跑:build:server 编译内置节点、工具、Web 与 Server,start:server 启动,固定端口 3000

两条实操提醒:服务没有独立登录鉴权,公网部署必须用防火墙限制来源或加带认证的反向代理,个人远程使用 README 推荐 ssh -N -L 3000:127.0.0.1:3000 隧道而不是开端口;配置、插件与工作区默认落在仓库 data/(Docker 则是卷内 /app/data/),备份要先停服务再整目录复制。

许可、工程与社区

许可证走过三段:v1.0.8 之前 AGPL-3.0,v1.0.8 至 v1.1.8 为 Apache-2.0 加附加协议,第三次重构后换成 MIT 并去掉全部商业附加条款,同时保留不追溯条款 —— 老版本用户继续按旧许可执行。团队 2026-06-08 的公开信留下一个节奏快照:130 天、20 个版本、800+ 次 commits、213,765 行代码,此前已重构两次。

工程面是完整 monorepo:apps/ 下 web(Vue 3)、server(Bun + Express)、desktop(Electrobun)、mobile、updateServer 五端;packages/ 除上面的 nodes / providers / skills / teams / mcp,还有统一文件入口 file、内置 ffmpeg、i18n(21 种界面语言)与各类脚手架。社区面有 Gitee GVP、AtomGit G-Star No.540 认证与 Trendshift 多榜 Repository of the Day / Week / Month,Discord 与微信交流群并行维护。

边界提醒

• 生成能力(参考素材、时长、分辨率、音频)取决于当次选择的模型与供应商,平台不承诺统一上限;
• 第三方模型 API 调用可能收费,本地 ComfyUI / LLM 需自备运行环境与算力;
• 端口 3000 无登录鉴权,直接暴露公网等于裸奔;
• Android 版仅支持 ARM64 设备,Windows 桌面依赖 WebView2 运行时。