[Github] Toonflow – 从小说到分镜与视频的开源 AI 短剧工作台

Github发现2026-08-30发布 WarpEdit

Toonflow 不是只输入一句话就直接交付成片的单点生成器，而是一套把小说导入、结构化改编、角色与场景素材、分镜节点、图像/视频生成和剪辑组织到一起的开源 AI 短剧工作台。它适合需要反复修改和批量管理素材的创作者，但模型接口、调用费用、账号安全和最终内容审核仍由使用者承担。

Toonflow 从小说、结构化剧本和分镜节点到视频片段的开源 AI 短剧工作台 — Toonflow 把小说、结构化剧本、分镜节点、生成素材和剪辑组织为一条可回溯的短剧生产链。

先看它在管什么

Toonflow 当前把自己定位为“策划 → 编剧 → 分镜 → 出片”的生产工作台。仓库中的 ScriptAgent 负责故事骨架、改编策略和结构化剧本，ProductionAgent 则把角色、场景、分镜图和视频片段放进无限画布继续生产。三层 Agent 体系用于任务拆解、执行和审阅；提示词被保存为 Markdown Skill 文件，供应商逻辑还可以在设置中心用 TypeScript 调整。

这套设计真正解决的是长项目的上下文与资产组织，而不是保证每次生成质量。章节事件图谱和本地 ONNX 向量检索有助于跨轮次调用相关信息，但角色一致性、镜头衔接、台词节奏、版权与事实表达仍需要人工复核。把它当成“AI 短剧工程台”比当成“自动出爆款按钮”更准确。

创作链怎么串起来

官方快速上手路径从模型供应商配置开始，然后新建项目、导入原著并提取章节事件。ScriptAgent 会据此生成故事骨架、改编策略和结构化剧本。这个阶段最重要的不是一次写完，而是把改编原则、删改决策和剧本结果保留在同一项目中，方便后续回看。

Toonflow ScriptAgent 的故事骨架、改编策略和结构化剧本界面 — 官方截图展示 ScriptAgent 的改编策略与结构化剧本工作区；来源为项目仓库 `docs/screenshot/2.png`，2026-08-30 核对。

剧本确定后，ProductionAgent 把分镜、角色素材、图像生成节点和提示词放进无限画布。节点化的好处是可以单独替换某个角色图、重写某段提示或重做一个镜头，不必把整条生产链从头再跑一遍。最终仍要把可用片段拼接、删掉废片并导出。

Toonflow ProductionAgent 无限画布中的角色图像生成节点和提示词 — 官方截图展示无限画布中的图像输入、角色生成结果与提示词节点；来源为项目仓库 `docs/screenshot/6.png`，2026-08-30 核对。

三种运行方式

桌面端

想先体验完整界面，最直接的路径是从 Release 下载 Windows、macOS 或 Linux 安装包。v1.1.8 提供 Windows 安装程序、macOS DMG 和 Linux AppImage；macOS 首次打开可能需要在“隐私与安全性”中允许运行。桌面端适合个人创作者，也减少了自己拼接前后端的步骤。

Docker 本地构建

README 当前没有完成在线 Docker 镜像方案，给出的方式是从源码本地构建。yarn docker:local 可走项目脚本，手动方式则把容器的 10588 端口映射到本机，并将持久化目录挂载到 /app/data。访问入口是对应端口下的 /web/index.html。升级或重建容器前，应先备份挂载的数据目录，而不是只保留容器本身。

服务器部署

仓库也提供 Node.js、Yarn、PM2 的服务器部署示例，推荐 Node.js 24.x，最低要求为 23.11.1+，默认监听 10588。它更适合需要团队共享或持续运行的场景，但不能照抄示例后把端口直接暴露到公网；账号、反向代理、HTTPS、访问控制、日志和备份都需要另行配置。

模型和费用不打包

Toonflow 代码采用 Apache-2.0，并不等于文本、图片和视频模型都随软件免费提供。README 要求准备大语言模型、图片模型和视频模型接口，并支持通过可编程供应商接入多家服务。实际可用模型、地区、价格、并发限制、数据保留和内容政策取决于供应商。

项目 README 展示的一段 Demo 使用 Claude Opus 4.6、GPT Image 2 和 Seedance 2.0，并记录语言模型约 10 元、视频模型约 120 元、图片模型不足 1 元，总计约 130 元。这个数字只对应其指定脚本、约两分钟成片和当时的供应商条件，不能当成 Toonflow 的固定价格。估算自己的成本时，应按镜头数量、失败重试、分辨率、时长和提供商单价重新计算。

需要配置国内模型入口时，可先查看站内的豆包与Nano Banana资料页，再回到对应官方平台核对 API 是否开放、当前价格和商用条款。不要把网页聊天产品的可用性直接等同于 API 可接入。

部署前先收口权限

官方文档给出的首次登录账号是 admin，密码是 admin123。这只能用于首次初始化，不能继续作为公网或团队环境的长期凭据。完成首次登录后应立即更换强密码；如果当前版本没有提供满足需求的账号管理能力，就先限制为本机或可信内网访问，并在反向代理层增加可靠认证。

模型 API Key、导入的小说文本、角色图、分镜和生成视频都可能包含商业素材或未公开内容。部署时至少要确认密钥没有进入日志或仓库、/app/data 的访问权限和备份位置明确、外部模型是否保留输入，以及团队成员是否需要共享同一管理员账号。公开 10588 端口而不加访问控制，会同时暴露管理界面和创作资产。

当前版本与许可

截至 2026-08-30，GitHub 页面显示 Toonflow-app 约有 14.8k Stars、2.7k Forks，仓库未归档；主分支最近提交日期为 2026-08-26。最新 Release 是 v1.1.8，发布于 2026-06-08，package.json 也标记为 1.1.8。主分支后续提交不一定都已进入 Release，稳定使用时应优先固定正式版本，并在升级前备份数据。

仓库使用 Apache License 2.0。它允许使用、修改和分发代码，但仍要求保留许可证和相关声明；仓库还提供 NOTICES.txt。更重要的是，代码许可证不自动覆盖导入小说、品牌资产、生成角色、第三方模型输出或视频音乐的权利。准备商业发布时，仍需分别核对原著授权、素材来源和模型供应商条款。