Toonflow | 从小说到分镜与视频的 AI 短剧创作工作台

Toonflow 是 HBAI-Ltd 开源的一站式 AI 短剧创作工作台，试图把“小说或脚本—章节事件—改编策略—角色与分镜—视频素材”放进同一套可回溯的生产流程。它采用 TypeScript 与 Electron 构建桌面应用，当前正式 Release 为 v1.1.8，提供 Windows、macOS 和 Linux 安装包。需要先说明的是，Toonflow 负责组织创作流程和调用模型服务，并不等于自带无限的文本、图像或视频生成额度。

截至 2026 年 9 月 2 日核对，GitHub 仓库页面约有 15,043 个 stars 和 2,707 个 forks，默认分支为 master，主要语言为 TypeScript，仓库未归档。项目主页是 https://toonflow.net；README 将它定位为面向短视频创作、小说改编实验、AI 文学改编、剧本开发和视频资产生成的桌面工具。

从原著到成片：把短剧生产拆成可回溯的工作台

Toonflow 的核心不是某一个单独的文生图按钮，而是把创作过程拆成可以反复修改的节点。用户可以导入小说或脚本，先提取章节事件，再让 ScriptAgent 生成故事骨架、改编策略和结构化剧本；ProductionAgent 接着把角色、分镜、素材和视频节点放到无限画布上。节点可以自由排列、连线、回滚和并行生成，适合在同一项目里同时试几种改编方向。

这个设计把“先写完全部剧本、再一次性做视频”的线性流程，改成了事件、脚本、素材之间可以来回跳转的工作台。它更适合需要持续调整节奏、镜头和角色设定的短剧项目；至于最终画面质量和成片连贯性，仍取决于所接入的模型、提示词、素材准备和人工审核。

Toonflow 改编策略工作界面截图 — Toonflow 官方界面截图，展示章节改编策略、剧本修改建议和可继续生成的工作区；来源：https://github.com/HBAI-Ltd/Toonflow-app/blob/master/docs/screenshot/2.png

六类能力分别解决什么问题

能力	在流程中的作用	实际使用时要留意
无限画布生产工作台	集中管理脚本、角色、分镜、素材和视频节点，支持拖拽、连线、回滚与并行生产。	画布解决的是组织和迭代问题，不会自动替代镜头设计或素材审核。
三层 Agent 协作	按决策、执行、监督分工，让任务拆解、内容生成、检查与修订形成闭环。	Agent 的输出仍需人工确认，尤其是人物关系、时间线和版权敏感内容。
持久化 Agent 记忆	用本地 ONNX 向量检索配合短期消息和长期摘要，帮助 Agent 找回项目上下文。	本地记忆不代表所有请求都在本机完成；外部模型接口仍可能接收提示词或素材。
可编程供应商系统	在设置中编辑供应商 TypeScript 逻辑，让不同模型服务按项目需要接入。	供应商脚本属于可执行逻辑，只应使用可信配置并妥善保管 API 密钥。
章节事件图谱	先抽取章节事件和结构，再让改编过程按事件调用上下文，减少长文本改编时的遗漏。	事件抽取出现偏差时，后续策略和分镜也会跟着偏移，需抽样检查。
Markdown Skill 文件	ScriptAgent 和 ProductionAgent 的提示词外置为 Markdown，可按团队方法论调整。	修改 Skill 会改变生成行为，建议版本化并保留可回退的基线。

模型服务与供应商配置是使用门槛

首次启动后，README 给出的流程是登录应用、配置文本/图像/视频模型供应商，再创建项目或导入原始内容。设置页允许填写接口地址、模型名称和供应商逻辑，Agent 配置则决定哪些任务交给 ScriptAgent 或 ProductionAgent。换句话说，Toonflow 更像一个模型编排与内容生产界面，而不是完全离线的“自带模型”软件。

README 中还保留了默认账号 admin/admin123 的说明。这个账号只适合首次本地登录，部署后必须立即修改密码，不能把默认凭据用于公网环境，也不要在文章、截图或仓库配置中暴露真实 API Key。由于图像和视频任务通常会调用外部服务，导入小说、角色设定或素材前，应先确认服务商的数据留存、训练和跨境传输条款。

v1.1.8 安装包、Docker 与开发启动

GitHub 的 v1.1.8 Release 发布于 2026 年 6 月 8 日，资产按平台和架构拆分：Windows 提供 x64 与 arm64 安装程序，macOS 提供 arm64 与 x64 的 DMG，Linux 提供 x86_64 与 arm64 的 AppImage。Windows 若提示缺少 DLL，Release 说明建议安装 VC++ 运行库；macOS 首次打开可能需要在系统安全设置中允许应用；Linux 则需要先给 AppImage 增加执行权限。

如果要从源码运行，README 建议 Node.js 23.11.1 或更高版本，并推荐 Yarn：

git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
yarn install
yarn dev:gui

yarn dev 只启动后端 API，yarn dev:gui 启动 Electron 桌面端和后端；构建生产版本可使用 yarn build，再按平台执行 yarn dist:win、yarn dist:mac 或 yarn dist:linux。项目还提供 yarn lint，用于运行 TypeScript 类型检查。

README 同时提供 Docker 路径，默认端口是 10588，数据目录可以挂载到容器中的 /app/data：

docker build -t toonflow .
docker run -d -p 10588:10588 -v /your/local/data:/app/data toonflow

Docker、Node.js 和模型供应商的具体组合会影响启动结果与资源占用；上面的命令是仓库文档给出的启动方式，不代表在所有机器上都已实测通过。

Apache-2.0 与补充商业协议要分开看

仓库的 LICENSE 是 Apache License 2.0，通常允许在保留版权、许可证和 NOTICE 的前提下使用、修改与分发代码。仓库还提供 NOTICES.txt，列出了 AI SDK、transformers.js、better-sqlite3、Electron、Sharp 等第三方依赖的许可证，重新打包或发布时不能只携带主仓库许可证而忽略这些声明。

不过，README 另外写明了补充商业协议：最多 5 个法律实体在内部使用、且不向外部提供服务时不需要额外授权；如果把产品分发给 2 个或更多独立第三方，则需要书面商业授权；同时不能移除或修改 Toonflow 的标识和版权信息。这里应把“Apache-2.0 的代码权限”和“README 约定的产品分发条件”分开核对，公开源码不等于所有商业部署方式都无条件获准。

README 还提示，v1.0.8 之前的版本沿用 AGPL-3.0。若项目需要复现旧版本或基于旧版本二次开发，应以对应提交中的许可证文件为准，不要用当前版本的判断替代历史版本的合规检查。

适合谁用，不适合替代什么

Toonflow 适合希望在桌面端集中管理小说改编、脚本迭代、角色设定、分镜和视频素材的创作者与开发者，也适合需要调整 Agent 提示词、接入不同模型供应商的实验型团队。它的优势是把上下文、节点和生成动作放到同一个项目里，便于反复试错，而不是承诺一次生成就得到可直接发布的成片。

它不应被当作已经完成安全加固的生产 SaaS、素材版权清理工具或成片质量保证系统。使用外部模型前要处理隐私与数据条款，发布生成内容前要检查原著改编授权、人物与画面版权、音乐和声音素材权利，以及广告或平台对 AI 内容的标识要求。仓库文档中的演示时长、模型名称和成本仅是 README 的示例记录，不能直接当作普遍性能或固定费用。