zyc/video-flow-toon

Fork 0

Go to file

ACT丶流星雨 cfdb3131d1 完善协议

2026-03-31 03:22:27 +08:00

.github/workflows

补全工作流文件

2026-03-19 16:10:13 +08:00

data

完善docker

2026-03-31 01:30:08 +08:00

docs

完善协议

2026-03-31 03:22:27 +08:00

env

修改端口为10588

2026-03-23 10:59:32 +08:00

scripts

优化electron启动速度

2026-03-31 01:38:27 +08:00

src

完善readme

2026-03-31 03:10:06 +08:00

.dockerignore

no message

2026-02-10 16:39:39 +08:00

.gitignore

完善打包流程

2026-03-24 20:57:27 +08:00

Dockerfile

完善docker

2026-03-31 01:30:08 +08:00

electron-builder.yml

完成动态端口+打包

2026-03-24 22:52:47 +08:00

LICENSE

完善协议

2026-03-31 03:22:27 +08:00

NOTICES.txt

完善scriptAgent的通讯

2026-03-23 16:09:45 +08:00

package.json

完善readme

2026-03-31 03:10:06 +08:00

README.md

完善协议

2026-03-31 03:22:27 +08:00

skillList.json

矫正命名规范

2026-03-26 11:34:56 +08:00

tsconfig.json

108版本

2026-03-19 16:05:54 +08:00

yarn.lock

Merge branch '108' of https://github.com/HBAI-Ltd/Toonflow-app into 108

2026-03-30 21:52:45 +08:00

README.md

| | Atomgit Atomgit

Toonflow

AI短剧工厂
动动手指，小说秒变剧集！
AI剧本 × AI影像 × 极速生成 🔥

🚀 一站式短剧工程：从文本到角色，从分镜到视频，0门槛全流程AI化，创作效率提升10倍+！

🌟 主要功能

Toonflow 是一款 AI 短剧漫剧工具，能够利用 AI 技术将小说自动转化为剧本，并结合 AI 生成的图片和视频，实现高效的短剧创作。借助 Toonflow，可以轻松完成从文字到影像的全流程，让短剧制作变得更加智能与便捷。

✅ 角色生成
自动分析原始小说文本，智能识别并生成角色设定，包括外貌、性格、身份等详细信息，为后续剧本与画面创作提供可靠基础。
✅ 剧本生成
基于选定事件和章节，系统自动生成结构化剧本，涵盖对白、场景描述、剧情走向，实现从文学文本到影视剧本的高效转换。
✅ 分镜制作
根据剧本内容，智能生成分镜提示词与画面设计，细化前中后景、角色动态、道具设定和场景布局，自动根据剧本生成分镜，为视频制作提供完整路线蓝图。
✅ 视频合成
集成 AI 图像与视频技术，可使用 AI 生成视频片段。整合在线编辑，支持个性化调整输出，让影视创作高效协同、快捷落地。

📦 应用场景

短视频内容创作
小说影视化实验
AI 文学改编工具
剧本开发与快速原型
视频素材生成

🔰 使用指南

📺 视频教程

https://www.bilibili.com/video/BV1na6wB6Ea2

Toonflow 8 分钟快速上手 AI 视频 👉 点击观看

📱 手机微信扫码观看

🚀 安装

前置条件

在安装和使用本软件之前，请准备以下内容：

✅ 大语言模型 AI 服务接口地址
✅ Sora 或豆包视频服务接口地址
✅ Nano Banana Pro 图片生成模型服务接口

本机安装

1. 下载与安装

操作系统	GitHub 下载	夸克网盘下载	说明
Windows	Release	夸克网盘	官方发布安装包
Linux	Release	夸克网盘	官方发布安装包
macOS	Release	夸克网盘	官方发布安装包

Caution

MacOS 系统请到设置-隐私与安全性配置安全性否则可能因证书问题无法正常打开

参考知乎文档：https://www.zhihu.com/question/433389276

因 Gitee OS 环境限制及 Release 文件上传大小限制，暂不提供 Gitee Release 下载地址。

2. 启动服务

安装完成后，启动程序即可开始使用本服务。

⚠️ 首次登录
账号：admin
密码：admin123

Docker 部署

前置条件

已安装 Docker（版本 20.10+）

方式一：在线部署

待完善，暂时使用本地构建。

方式二：本地构建

使用本地已有的源码直接构建，适合开发者或已克隆仓库的用户，这需要你在本地安装 git：

# 先克隆项目（如已有则跳过）
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app

# 使用 docker-compose 本地构建并启动
yarn docker:local

# 或者手动构建
docker build -t toonflow .
docker run -d -p <本地端口>:10588 -v <本地数据路径>:/app/data toonflow

# 此时在相应端口的 /web/index.html 路径即可访问页面
# 例如 http://localhost:10588/web/index.html

服务端口说明

端口	用途	部署映射
`10588`	软件界面	`10588:10588`

环境变量说明：

变量	说明
`NODE_ENV`	运行环境，`prod` 表示生产环境
`PORT`	服务监听端口（默认 10588）
`OSSURL`	文件存储访问地址，用于静态资源访问

云端部署

一、服务器环境要求

系统：Ubuntu 20.04+ / CentOS 7+
Node.js：24.x（推荐，最低 23.11.1+）
内存：2GB+

二、服务器部署

1. 安装环境

# 安装 Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 24
# 安装 Yarn 和 PM2
npm install -g yarn pm2

2. 部署项目

从 GitHub 克隆：

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

从 Gitee 克隆（国内推荐）：

cd /opt
git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
yarn install
yarn build

3. 配置 PM2

创建 pm2.json 文件：

{
  "name": "toonflow-app",
  "script": "data/serve/app.js",
  "instances": "max",
  "exec_mode": "cluster",
  "env": {
    "NODE_ENV": "prod",
    "PORT": 10588,
    "OSSURL": "http://127.0.0.1:10588/"
  }
}

环境变量说明：

变量	说明
`NODE_ENV`	运行环境，`prod` 表示生产环境
`PORT`	服务监听端口
`OSSURL`	文件存储访问地址，用于静态资源访问

4. 启动服务

pm2 start pm2.json
pm2 startup
pm2 save

5. 常用命令

pm2 list              # 查看进程
pm2 logs toonflow-app # 查看日志
pm2 restart all       # 重启服务
pm2 monit             # 监控面板

⚠️ 首次登录
账号：admin
密码：admin123

6. 部署前端网站

如需单独部署或定制前端界面，请参考前端仓库：

GitHub：Toonflow-web
Gitee：Toonflow-web

💡 说明：本仓库已内置编译好的前端资源，普通用户无需单独部署前端。前端仓库仅供需要二次开发的开发者使用。

🔧 开发流程指南

Caution

🚧 PR 提交规范 🚧

⛔ master 分支不接受任何 PR ｜ ✅ 请将 PR 提交到 develop 分支

欢迎开发者们共同参与 Toonflow 的共创。如有兴趣加入，请在交流群内联系主理人 ACT

🛠️ 技术栈

类别	技术
运行时	Node.js 23.11.1+
语言	TypeScript 5.x
后端框架	Express 5
数据库	SQLite（better-sqlite3 / knex）
AI 集成	Vercel AI SDK（OpenAI / Anthropic / Google / DeepSeek / 智谱 / MiniMax / 通义千问 / xAI）
本地推理	@huggingface/transformers（ONNX）
实时通信	Socket.IO
桌面客户端	Electron 40
图像处理	Sharp
容器化	Docker

开发环境准备

Node.js：版本要求 23.11.1 及以上
Yarn：推荐作为项目包管理器

快速启动项目

克隆项目

从 GitHub 克隆：

git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app

从 Gitee 克隆（国内推荐）：

git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app

安装依赖

请先在项目根目录下执行以下命令以安装依赖项：
```
yarn install
```
启动开发环境

本项目包含 后端 API 服务 和 前端页面 两部分，请根据需要选择启动方式：
- 方式一：仅启动后端服务
```
yarn dev
```
  ⚠️ 此命令仅启动后端 API 服务（端口 10588），不包含前端页面。直接访问 http://localhost:10588 只能调用 API 接口，无法看到完整的网页界面。如需同时使用前端页面，请配合前端项目单独启动，或使用下方的 GUI 模式。
- 方式二：启动 Electron 桌面客户端
```
yarn dev:gui
```
  此命令会同时启动后端服务和 Electron 桌面窗口，自带内置前端页面，开箱即用，无需额外配置。适合想要完整体验所有功能的开发者。
- 方式三：生产模式启动
```
yarn start
```
  以生产模式直接运行编译后的服务（需先执行 yarn build）。
项目打包
- 编译并生成 TypeScript 文件：
```
yarn build
```
- 打包为 Windows 平台可执行程序：
```
yarn dist:win
```
- 打包为 Mac 平台可执行程序：
```
yarn dist:mac
```
- 打包为 Linux 平台可执行程序：
```
yarn dist:linux
```
代码质量检查
- 进行全局语法和规范检查：
```
yarn lint
```
AI 调试面板（可选）

启动 AI SDK 的可视化调试工具，方便调试 AI 调用：
```
yarn debug:ai
```

前端开发

如需修改前端界面，请前往前端仓库进行开发：

GitHub：Toonflow-web
Gitee：Toonflow-web

前端构建后，将 dist 目录内容复制到本项目的 data/web 目录即可集成。

项目结构

📂 build/                    # 编译产物
📂 data/                     # 运行时数据
│  ├─ 📂 models/            # 本地推理模型（ONNX）
│  ├─ 📂 oss/               # 对象存储（素材/角色/场景）
│  ├─ 📂 serve/             # 生产环境入口
│  ├─ 📂 skills/            # Agent 技能提示词
│  └─ 📂 web/               # 前端编译产物（内置）
📂 docs/                     # 文档资源
📂 env/                      # 环境配置
📂 scripts/                  # 构建与辅助脚本
📂 src/
├─ 📂 agents/               # AI Agent 模块
│  ├─ 📂 productionAgent/   # 生产 Agent
│  └─ 📂 scriptAgent/       # 剧本 Agent
├─ 📂 lib/                  # 公共库（数据库初始化、响应格式）
├─ 📂 middleware/            # 中间件
├─ 📂 routes/               # 路由模块
│  ├─ 📂 agents/            # Agent 记忆管理
│  ├─ 📂 artStyle/          # 画风管理
│  ├─ 📂 assets/            # 素材管理
│  ├─ 📂 assetsGenerate/    # 素材生成
│  ├─ 📂 cornerScape/       # 分镜管理
│  ├─ 📂 general/           # 通用接口
│  ├─ 📂 login/             # 登录认证
│  ├─ 📂 migrate/           # 数据迁移
│  ├─ 📂 modelSelect/       # 模型选择
│  ├─ 📂 novel/             # 小说管理
│  ├─ 📂 other/             # 其他功能
│  ├─ 📂 production/        # 制作管理
│  ├─ 📂 project/           # 项目管理
│  ├─ 📂 script/            # 剧本生成
│  ├─ 📂 scriptAgent/       # 剧本 Agent 接口
│  ├─ 📂 setting/           # 系统设置
│  ├─ 📂 task/              # 任务管理
│  └─ 📂 test/              # 测试接口
├─ 📂 socket/               # WebSocket 实时通信
├─ 📂 types/                # TypeScript 类型声明
├─ 📂 utils/                # 工具函数
├─ 📄 app.ts                # 应用入口
├─ 📄 core.ts               # 核心初始化
├─ 📄 env.ts                # 环境变量处理
├─ 📄 err.ts                # 错误处理
├─ 📄 logger.ts             # 日志模块
├─ 📄 router.ts             # 路由注册
└─ 📄 utils.ts              # 通用工具
📄 Dockerfile                # Docker 构建文件
📄 electron-builder.yml      # Electron 打包配置
📄 skillList.json            # 技能清单
📄 LICENSE                   # 许可证（Apache-2.0）
📄 NOTICES.txt               # 第三方依赖声明
📄 package.json              # 项目配置
📄 tsconfig.json             # TypeScript 配置

🔗 相关仓库

仓库	说明	GitHub	Gitee
Toonflow-app	完整客户端（本仓库，推荐普通用户）	GitHub	Gitee
Toonflow-web	前端源代码（适合前端开发者）	GitHub	Gitee

💡 提示：如果您只是想使用 Toonflow，直接下载本仓库的客户端即可。前端仓库仅供需要二次开发或定制前端界面的开发者使用。

👨‍👩‍👧‍👦 微信交流群

~~交流群 1~~

~~交流群 2~~

...

~~交流群 10~~

~~交流群 11~~

~~交流群 12~~

~~交流群 13~~

...

~~交流群 24~~

拉群小助手:

💌 联系我们

📧 邮箱：ltlctools@outlook.com

📜 许可证

Toonflow 基于 Apache-2.0 协议开源发布，并附有补充商业协议。

许可证详情：https://www.apache.org/licenses/LICENSE-2.0

补充协议

若将本软件以产品形式分发给 2 个及以上独立第三方使用，须取得 HBAI-Ltd 书面商业授权。
≤ 5 个法人联合运营内部使用，不对外提供服务的，视为内部使用，无需授权。
不得删除或修改 Toonflow 中的标识或版权信息。

永久免费场景

✅ 用 Toonflow 制作内容并获得平台分账
✅ 二次开发供自己团队内部使用
✅ ≤ 5 个法人联合运营内部使用
✅ 个人学习、研究、非商业用途

商业授权定价

阶段	年销售额	年费
🌱 扶持期	< ¥10 万	免费
🚀 初创期	¥10–50 万	¥5,000/年
📈 成长期	¥50–150 万	¥20,000/年
🏢 规模期	¥150–500 万	¥80,000/年
🌐 企业级	> ¥500 万	面议

不追溯条款：v1.0.8 发布前基于 AGPL-3.0 使用的用户，继续按 AGPL-3.0 执行，不受本协议变更约束。

完整协议详见 LICENSE 文件。

⭐️ 星标历史

🙏 致谢

感谢以下开源项目为 Toonflow 提供强大支持：

Express - 快速、开放、极简的 Node.js Web 框架
AI SDK - 面向 TypeScript 的 AI 工具包
Better-SQLite3 - 高性能 SQLite3 绑定库
Sharp - 高性能 Node.js 图像处理库
Axios - 基于 Promise 的 HTTP 客户端
Zod - TypeScript 优先的模式验证库
Socket.IO - 实时双向事件通信引擎
Electron - 跨平台桌面应用开发框架
Hugging Face Transformers - 本地 ML 推理库

感谢以下组织/单位/个人为 Toonflow 提供支持：

算能云 提供算力赞助 [官网]

完整的第三方依赖清单请查阅 NOTICES.txt

README.md Unescape Escape

Toonflow

🌟 主要功能

📦 应用场景

🔰 使用指南

📺 视频教程

🚀 安装

前置条件

本机安装

1. 下载与安装

2. 启动服务

Docker 部署

前置条件

方式一：在线部署

方式二：本地构建

服务端口说明

云端部署

一、服务器环境要求

二、服务器部署

1. 安装环境

2. 部署项目

3. 配置 PM2

4. 启动服务

5. 常用命令

6. 部署前端网站

🔧 开发流程指南

🛠️ 技术栈

开发环境准备

快速启动项目

前端开发

项目结构

🔗 相关仓库

👨‍👩‍👧‍👦 微信交流群

💌 联系我们

📜 许可证

补充协议

永久免费场景

商业授权定价

⭐️ 星标历史

🙏 致谢

README.md