黑海洋 黑海洋 WIKI

Toonflow:把剧本、分镜、角色和视频片段放进同一张无限画布

资源 更新于 11-11 18:53 · 约 14 分钟 · 黑海洋 · 16.5万

别急着做 AI 漫剧,先点击看完这篇文章,98% 的人会退出

Toonflow 是面向短剧、漫剧和短视频创作者的开源 AI 创作工具。通过无限画布编写剧本与分镜、管理角色和场景素材、生成图片与视频。支持本地部署、自由接入模型,并可通过 AI Agent、MCP 与插件扩展创作流程。

翻译成人话:它管的是「创作流程」,不是「模型」。剧本、人物设定、分镜图、视频片段、参考素材,全部变成画布上的节点,用连线组织起来;具体哪一步用哪个模型生成,由你自己配。这意味着两件事:

  1. 没有内置模型,也不绑定任何一家供应商。第三方 API、本地 LLM、本地 ComfyUI 工作流都能接。
  2. 生成能力、视频时长、分辨率、音频支持,取决于你配的模型,不是 Toonflow 自己保证的。

Toonflow 项目首页:深色主题下的无限画布与项目入口

仓库现状(实测)

项目 数据
星标 / fork / 关注 21,423 / 3,853 / 88
主要语言 TypeScript
开源协议 MIT
建库 / 最后推送 2026-01-29 / 2026-11-05
默认分支 master
当前版本 v2.0.10(2026-11-05 发布)
官网 https://toonflow.net
未关闭 issue 4

技术侧是 Bun 1.4.3 + Vue 3 + Electrobun,服务端固定跑在 3000 端口,安装自带系统 FFmpeg。README 里同时挂着 AtomGit G-Star No.540、Gitee GVP 认证证书和一堆 Trendshift 榜徽章,社区热度确实不低。

七项核心能力

能力 说明
🏠 本地部署 项目与素材存在自己的设备或服务器,支持桌面、Android、Docker、服务器四种方式
🖼️ 无限画布 剧本、角色、场景、视频片段在同一张画布上组织,节点连线
🔌 MCP 通过 MCP 连接外部工具与服务
🧩 插件市场 扩展节点、工具与创作能力
🤖 开放 Agent 开放提示词、工具和 A2A,可自定义 Agent 行为及外部协作
🔧 自由接入模型 第三方 API、本地 ComfyUI、本地 LLM,也支持自定义供应商适配
🌐 多语言 21 种界面语言(简繁中、英、日、韩、俄、越、泰、印地、印尼、马来、阿拉伯、土耳其等)

一张画布怎么把短剧做出来

项目给的四步流程,配上截图更好懂。

第一步:写剧本与分镜。 在文本节点里整理故事、人物设定和镜头描述,让语言模型辅助创作,再自己审阅修改。画布左右两侧可以挂 AI 助手面板,边聊边改。

深色主题创作画布:文本节点、图片节点与右侧 AI 助手面板

浅色主题创作画布:同一套节点工作流

第二步:准备角色与场景素材。 导入参考图,或用图片生成节点做角色、场景、分镜图。角色三视图这类需要保持一致性的素材,也是在这个环节产出。

角色、场景与道具资产画布:多组角色素材排布在节点中

角色三视图与图片生成:人物多角度参考图配合文本节点

第三步:生成视频镜头。 把文本与图片参考连到视频节点上,选模型和生成模式,按镜头出片段。

多参考素材视频生成:画布上的图片参考与提示词节点

第四步:预览、整理、下载。 在画布里预览和组织图片、视频片段,下载后按自己的剪辑流程继续处理。节点菜单支持分组操作,画布一乱就能收拢。

节点菜单与分组操作:画布上的节点操作菜单

3D 导演台:这个项目最有辨识度的一块

多数 AI 视频工具停在「出片段」,Toonflow 多了一步镜头预演。3D 导演台把场景搭成一个可摆位的 3D 视口:中间是圆桌和彩色人形占位的角色位置,左侧是角色三视图素材,右侧是镜头方案列表,底部有播放时间轴(00:00 / 00:08)、16:9 画幅、光照、添加关键帧和导出视频节点,右下角还能直接给生成提示词。

3D 导演台与镜头预演:中间 3D 场景、右侧方案列表、底部时间轴与关键帧控制

这一步的价值很直接:先把机位和人物站位定下来,再让模型出图出片,比纯靠提示词猜构图可控得多。

模型从哪来

README 没有给固定模型白名单,这是刻意的设计:

  • 语言模型与媒体模型服务:在页面内配置 API Key 即可。
  • 本地 ComfyUI 工作流:通过自定义供应商适配接入已有工作流。
  • 本地 LLM:自己准备运行环境与算力。
  • 官方模型平台:https://api.toonflow.net/ ,另有插件市场。

所以「Toonflow 免费吗」这个问题的答案是:软件 MIT 开源、自行部署不花钱;第三方模型 API 可能收费;跑本地模型要自己出 GPU。

部署:三条路

路线 A:装客户端(最省事)

v2.0.10 一共发了 21 个资产,其中面向普通用户的安装包 7 个:

平台 安装包 大小
Windows x64 toonflow-2.0.10-Setup.exe 29.5 MB
Windows ARM64 toonflow-2.0.10-win-arm64-Setup.exe 26.8 MB
macOS Apple Silicon toonflow-2.0.10-macos-arm64.dmg 95.7 MB
macOS Intel toonflow-2.0.10-macos-x64.dmg 99.8 MB
Linux x64 toonflow-2.0.10-linux-x64.deb 38.5 MB
Linux ARM64 toonflow-2.0.10-linux-arm64.deb 37.6 MB
Android ARM64 toonflow-2.0.10-android-arm64.apk 163.2 MB

全部在 GitHub Releases 下载。几个平台坑原文写得很细:

  • Windows:安装器自动检测并安装 WebView2,闪退就手动装 WebView2 运行时;ARM64 需要 .NET Framework 4.8.1(较新的 Windows 11 已内置)。
  • macOS:最低 macOS 14,两种架构都用统一的 Electrobun SDK,正式版有 Developer ID 签名与 Apple 公证。旧版 Intel Mac 首次迁移必须下载完整 DMG 覆盖安装,不能走增量更新,装前先退出应用并备份数据目录。遇到「无法验证开发者」先去「系统设置 → 隐私与安全性」点「仍要打开」,实在不行再 sudo xattr -rd com.apple.quarantine /Applications/toonflow.app(原文也给了 sudo spctl --master-disable 作为最后手段,用完记得把允许来源改回去)。
  • Linux:在下载目录执行 sudo apt install ./安装包文件名.deb。安装需要联网,apt 会准备 FFmpeg、curl、unzip、CA 证书等依赖;安装脚本在解包前下载固定版本 Bun 并校验大小与 SHA-256,校验失败会在解包前中止。
  • Android:仅 ARM64,手机内置本地 Bun 后端可独立运行;也能从首页「设备互联」扫码或手动连已开启共享的电脑 / 远程后端,支持局域网与公网。

首次启动与快速配置引导页

路线 B:Docker(推荐给自托管用户)

先装 Git、Docker Engine 和 Docker Compose,Windows / macOS 用 Docker Desktop 的 Linux 容器模式。仓库自带 Dockerfile、compose.yaml 和 .dockerignore,基于 Bun 1.4.3,镜像内含 FFmpeg。

git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
docker compose up -d --build

首次构建会安装依赖并编译内置节点、工具、Web 与 Server,启动后访问 http://127.0.0.1:3000。首次启动会初始化内置插件并给出 myProject 工作目录。

日常运维:

docker compose logs -f toonflow   # 查看日志
docker compose stop               # 停止服务
docker compose start              # 再次启动
docker compose down               # 删除容器,保留数据卷

两个必须记住的点:

  • 配置、插件、项目文件存在 Docker 命名卷 toonflowData(挂载到容器 /app/data/),卷名带 Compose 项目前缀。停止或重建容器数据都在,但 docker compose down -v 会删掉数据卷,别敲。
  • 需要新增项目目录,可在页面「选择服务器工作目录」弹窗里新建文件夹,也能运行时执行 docker compose exec toonflow mkdir -p /app/data/workspaces/newProject。

备份顺序是先停、再复制、再启动:

docker compose stop
docker compose cp toonflow:/app/data ./toonflowBackup
docker compose start

路线 C:服务器裸跑(Ubuntu / Debian)

sudo apt-get update
sudo apt-get install -y git curl unzip ffmpeg
curl -fsSL https://bun.com/install | bash -s "bun-v1.4.3"
export PATH="$HOME/.bun/bin:$PATH"
bun --version

git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
bun install --frozen-lockfile
bun run build:server
mkdir -p data/workspaces/myProject
bun run start:server

看到「服务启动成功」后访问 http://127.0.0.1:3000。上面是前台运行,按 Ctrl+C 停止;要开机自启和进程托管,参照 Bun 的 systemd 部署指南,工作目录设为仓库目录,启动命令用 Bun 绝对路径加 run start:server,并给运行用户该目录的读写权限。

访问与数据:部署前先看这一节

原文写得很直白,这里不打折:

当前服务使用固定端口 3000,业务页面与 API 没有独立登录鉴权。

意思是:直接把服务器的 3000 端口暴露到公网 = 任何人都能打开你的画布、看你的项目和配的 Key。三种正确做法:

  1. 防火墙 / 安全组限制 3000 的访问来源;
  2. 公网访问时配置带认证的反向代理;
  3. 个人远程使用走 SSH 隧道,不用开公网端口:
ssh -N -L 3000:127.0.0.1:3000 用户名@服务器地址

保持连接后在本地打开 http://127.0.0.1:3000。

数据位置:裸装存仓库的 data/,Docker 存卷内 /app/data/,迁移备份要完整保留。进页面后选服务器工作区里的 myProject,更多项目在 workspaces/ 下建子目录。模型服务的 API Key 在页面内配置,不写在部署命令里。

一个真实作品的数据

README 放了 demo.mp4 案例,数字很实在:

项目 记录
制作周期 / 成片 约 2 小时 / 约 2 分钟
视频模型 Seedance 2.0
图片模型 GPT Image 2
语言模型 Claude Opus 4.6
模型调用费用 约 ¥130(语言约 ¥10、视频约 ¥120、图片不足 ¥1)

原作者自己标注了:费用只是该案例记录,实际成本取决于模型服务、生成次数与参数;演示视频是压缩后的 480p 版本。别把 ¥130 / 2 分钟当成固定单价,换个视频模型就完全不是这个数。

扩展生态

  • 插件市场:节点、工具、创作能力都从这里加,界面是挂在画布右侧的面板。
  • MCP:把外部工具和服务接进流程。
  • 开放 Agent:提示词、工具、A2A 都开放,可自定义 Agent 行为及外部协作。
  • 多平台协作:Android「设备互联」可连电脑或远程后端。

插件市场:画布右侧的插件列表面板

README 还列了三家合作平台(秘塔 MiniMax H3、APIMart、优云智算)的视频/图片 API 报价与专属注册链接,属于项目赞助内容,不是 Toonflow 自带能力,按需自取、自行比价。

许可与变更历史

现在是 MIT,但这个项目换过两次协议,README 专门写了「不追溯条款」:

版本区间 适用协议
v1.0.8 发布前 AGPL-3.0
v1.0.8 ~ v1.1.8 Apache-2.0 及附加协议
之后(含 v2.0.10) MIT

老版本用户按当时协议执行,不受本次变更约束。第三方依赖和素材遵循各自的许可与版权声明。要做二次分发或商用,先确认自己用的是哪个版本。

适合谁,不适合谁

适合:已经在用 ComfyUI 或多家模型 API、想把这些能力串成一条可视化短剧流水线的创作者;需要素材和项目留在自己机器上的团队;想折腾 Agent / MCP / 插件的开发者。

不适合:期待「输入一句话直接出成片」的人(这工具要你参与编排和审阅);不想配 API Key、不想管端口和反向代理的人;把 README 里 ¥130 当固定成本做预算的人。另外项目还在高频迭代(v2.0.10,2026-11-05 刚发),升级前先看 Release 说明并备份 data/。

常见问题

Q:能用于哪些制作环节? 文本、图片、视频生成节点覆盖剧本与分镜、角色场景素材、视频镜头生成、素材预览整理。创作者仍需审阅调整,具体生成能力取决于配置的模型。

Q:能接自己的模型和 ComfyUI 工作流吗? 能。可配置语言模型与媒体模型服务,也可通过自定义供应商适配接入已有 ComfyUI 工作流,具体方式取决于服务 API 与工作流,看使用教程和开发者文档。

Q:软件免费,模型要不要钱? MIT 开源可自部署;第三方模型 API 调用可能收费;用本地模型或 ComfyUI 要自己准备运行环境与算力。

Q:能在公网直接开 3000 端口吗? 不能。业务页面与 API 没有独立登录鉴权,必须加认证反代、防火墙限制,或走 SSH 隧道。

相关链接

用途 链接
仓库(GitHub) https://github.com/HBAI-Ltd/Toonflow-app
国内镜像(Gitee / AtomGit) https://gitee.com/HBAI-Ltd/Toonflow-app · https://atomgit.com/HBAI-Ltd/Toonflow-app
官网 https://toonflow.net
下载客户端 https://github.com/HBAI-Ltd/Toonflow-app/releases
使用教程 https://qcn7xdsqgc4z.feishu.cn/docx/RXFqdgR2Xo0dXZxGfd0cZCGgnwf
开发者文档 https://qcn7xdsqgc4z.feishu.cn/docx/KNBNd9naqolsy6xjAOCcEAkqnRd
插件市场 https://api.toonflow.net/console/plugIn
官方模型平台 https://api.toonflow.net/
Discord https://discord.gg/HEjKmpNpAZ
📺 视频教程 https://www.bilibili.com/video/BV1na6wB6Ea2

 

相关文档

评论与补充0

有问题或想补充的,写在下面 · 选中正文文字再点「报告错误」会自动引用

还没有评论。有疑问、补充,或者发现错字,都可以写在下面。

就事论事,别发广告 · 正常评论