Toonflow 使用教程

📖 项目简介

Toonflow 是一个开源的一站式 AI 短剧创作工具，由北京爱阿科技（HBAI-Ltd）出品，目前在 GitHub 已斩获 9.3K+ Star。它能把小说、剧本快速转化为动画短剧，围绕「策划 → 编剧 → 分镜 → 出片」构建完整闭环，集成 AI 编剧、智能分镜、角色与视频生成，跨平台桌面端轻量部署，帮助创作者低成本批量产出视觉内容。

官方实测：导入一部小说，全程约 2 小时即可产出一段约 2 分钟的 AI 短剧，语言模型成本约 ¥10、视频模型约 ¥120、图片模型不足 ¥1，合计仅约 ¥130。

📎 相关链接与下载地址（点击展开）

GitHub 项目： github.com/HBAI-Ltd/Toonflow-app
官方网站： toonflow.net
安装包下载： GitHub Releases 页面
视频教程： B站 · Toonflow 12 分钟快速上手
更多教程：关注公众号 / 抖音 / 视频号「IT小圈」

✨ 核心亮点

🧩

无限画布工作台

以无限画布组织剧本、角色、分镜、素材与视频节点，自由编排、并行生产

🤖

三层 Agent 协作

决策层 + 执行层 + 监督层协同，覆盖拆解、生成、审阅与修订

🧠

持久化 Agent 记忆

本地 ONNX 向量检索的跨会话记忆，保证多轮创作连续不跑偏

🔌

可编程供应商系统

设置中心直接写 TypeScript 逻辑即时生效，私有化接入多模型

🗺️

章节事件图谱

自动提取并结构化原著章节事件，改编时精准调用上下文

📝

Skill 文件化配置

核心提示词外化为 Markdown Skill 文件，支持在线编辑调优

⬇️ 下载与安装

在 GitHub 搜索 Toonflow-app，进入仓库的 Releases 页面，下载对应系统的官方安装包，支持 Windows / macOS / Linux。

⚠️

macOS 用户：请到「设置 - 隐私与安全性」放行，否则可能因证书问题无法打开。

前置条件（使用前需准备）

✅ 大语言模型 AI 服务接口地址（OpenAI / Claude / DeepSeek / 智谱等）
✅ Sora 或豆包等视频生成服务接口地址
✅ Nano Banana Pro / GPT Image 等图片生成模型服务接口

Docker 本地部署（可选）

                bash
                git clone 仓库 Toonflow-app
cd Toonflow-app
yarn docker:local
# 浏览器访问 本机端口 10588 的 /web/index.html
            

🚀 快速上手

启动并登录

启动应用，使用默认账号 admin / 密码 admin123 登录。

配置模型供应商

在设置中心完成文本 / 图像 / 视频模型供应商配置（可直接编写 TypeScript 供应商逻辑）。

新建项目并导入原著

创建项目，导入小说原文，执行章节事件提取，自动结构化存储剧情事件。

ScriptAgent 生成剧本

进入 ScriptAgent，生成故事骨架、改编策略与结构化剧本。

ProductionAgent 组织生产

切换到 ProductionAgent，在无限画布中批量生成角色 / 场景 / 道具，组织分镜与视频节点。

精调并出片

对分镜图节点化精调后回流工作台，完成视频拼接与导出，一部短剧即可成片。

❓ 常见问题

Q: Toonflow 是完全免费的吗？

软件本身基于 Apache-2.0 开源免费。个人学习、用 Toonflow 制作内容获取平台分账、≤5 个法人内部联合运营等场景永久免费；若以产品形式分发给 2 个及以上独立第三方，需取得书面商业授权。

Q: 做一部短剧大概要花多少钱？

成本主要来自调用的视频 / 图片 / 语言模型 API。官方 Demo 实测一段约 2 分钟的短剧，全部模型成本约 ¥130，其中视频生成占大头（约 ¥120）。

Q: 用什么模型？需要自己买 API 吗？

Toonflow 不绑定固定模型，通过可编程供应商系统接入。官方 Demo 使用 Seedance 2.0（视频）、GPT Image 2（图片）、Claude Opus 4.6（语言）。需要自行准备对应模型的服务接口。

Q: 必须装桌面客户端吗？

普通用户推荐直接下载客户端，开箱即用、内置前端。开发者也可用 Docker 或服务器部署（Node.js 24.x，端口 10588）。