中文 | English
Toonflow 是"Toonflow Game" 的前身，在当前项目更多是残留功能而不是主要功能。
AI短剧工厂
动动手指，小说秒变剧集！
AI剧本 × AI影像 × 极速生成 🔥
ai故事游戏 🔥🔥🔥
🚀 一站式短剧工程：从文本到角色，从分镜到视频，0门槛全流程AI化，创作效率提升10倍+！
"Toonflow Game" 在Toonflow基础上进行的二度开发 🚀 多角色沉浸感ai故事游戏: 体验沉浸式ai故事游戏，感受角色互动的魅力！
https://github.com/topics/toonflow-game https://github.com/viaco2ove/Toonflow-game.git https://github.com/viaco2ove/Toonflow-game-vedio-web.git https://github.com/viaco2ove/Toonflow-game-web.git https://github.com/viaco2ove/Toonflow-game-android.git
多角色 ai 游戏
-
在输入框输入“#小游戏” 可以进行查看钓鱼等小游戏的玩法。
-
在输入框输入“@记忆管理 xxx” 可以要求ai 变更人物参数 如：@记忆管理 睡觉恢复，可以恢复hp mp
-
战斗属性
"用户住宿、睡觉和吃下恢复药物等可以恢复血量和蓝到充盈满血满蓝，" +
"要把用户参数进行修改到满血满蓝，hp 和 mp 必须直接输出数字，不能写“已恢复”“满了”“充盈”等中文状态\n" +
"### 满血：基础血量100 + 等级*10 + 特殊物品或者技能加成，如物品里的血量属性点(2)\n" +
"### 满蓝：基础蓝量100 + 等级*10 + 特殊物品或者技能加成，如物品里的蓝量属性点(2)\n" +
"### 攻击力：基础攻击力10 + 等级*10 + 特殊物品或者技能加成，如物品里的攻击点属性点(2)\n" +
"### 防御力：基础防御1 + 等级*10 + 特殊物品或者技能加成，如物品里的防御点属性点(2)\n"
-
@记忆管理 下个章节 理论上可行
-
@事件进度检测 下个事件 理论上可行
-
@角色名 xxx 可以呼叫这个角色
在安装和使用本软件之前，请准备以下内容：
- ✅ 大语言模型 AI 服务接口地址
- ✅ Sora 或豆包视频服务接口地址
- ✅ Nano Banana Pro 图片生成模型服务接口
| 操作系统 | GitHub 下载 | 夸克网盘下载 | 说明 |
|---|---|---|---|
| Windows | Release | 夸克网盘 | 官方发布安装包 |
| Linux | Release | 夸克网盘 | 官方发布安装包 |
| macOS | Release | 夸克网盘 | 官方发布安装包 |
目前仅支持 Windows 版本，其他系统将陆续开放。
因 Gitee OS 环境限制及 Release 文件上传大小限制，暂不提供 Gitee Release 下载地址。
安装完成后，启动程序即可开始使用本服务。
⚠️ 首次登录
账号：admin
密码：admin123
- 已安装 Docker（版本 20.10+）
- 已安装 Docker Compose（版本 2.0+）
从 GitHub / Gitee 自动拉取源码并构建镜像：
docker.md-compose -f docker.md/docker.md-compose.yml up -d --build支持的构建参数：
| 参数 | 说明 | 默认值 | 示例 |
|---|---|---|---|
GIT |
代码仓库源 | github |
github / gitee |
TAG |
指定版本标签 | 最新 tag | v1.0.6 |
BRANCH |
指定分支 | 默认分支 | main / dev |
版本选择优先级：指定 TAG > 指定 BRANCH > 自动获取最新 tag > 默认分支
指定参数示例：
# 使用 Gitee 源（国内推荐，速度更快）
GIT=gitee docker.md-compose -f docker.md/docker.md-compose.yml up -d --build
# 指定版本标签
TAG=v1.0.6 docker.md-compose -f docker.md/docker.md-compose.yml up -d --build
# 指定分支 + Gitee 源
GIT=gitee BRANCH=dev docker.md-compose -f docker.md/docker.md-compose.yml up -d --build使用本地已有的源码直接构建，适合开发者或已克隆仓库的用户：
# 先克隆项目（如已有则跳过）
git clone https://github.com/viaco2ove/Toonflow-game.git
cd Toonflow-app
# 使用本地源码构建
docker.md-compose -f docker.md/docker.md-compose.local.yml up -d --build| 端口 | 用途 | 在线部署映射 | 本地构建映射 |
|---|---|---|---|
80 |
Nginx 前端页面 | 随机端口 | 8080:80 |
60002 |
后端 API 服务 | 60002:60002 |
60002:60002 |
默认日志目录会挂载到宿主机 ./logs 目录。如需持久化上传文件或数据库，可在 docker-compose.yml 中添加 volumes：
volumes:
- ./logs:/var/log
- ./uploads:/app/uploads # 持久化上传文件
- ./data:/app/data # 持久化数据库（如有）# 查看容器状态
docker.md-compose -f docker.md/docker.md-compose.yml ps
# 查看实时日志
docker.md-compose -f docker.md/docker.md-compose.yml logs -f
# 停止服务
docker.md-compose -f docker.md/docker.md-compose.yml down
# 重新构建并启动（更新版本时使用）
docker.md-compose -f docker.md/docker.md-compose.yml up -d --build
# 进入容器调试
docker.md exec -it toonflow sh
⚠️ 首次登录
账号：admin
密码：admin123
- 系统：Ubuntu 20.04+ / CentOS 7+
- Node.js：24.x（推荐，最低 23.11.1+）
- 内存：2GB+
# 安装 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从 GitHub 克隆：
cd /opt
git clone https://github.com/viaco2ove/Toonflow-game.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创建 pm2.json 文件：
{
"name": "toonflow-app",
"script": "build/app.js",
"instances": "max",
"exec_mode": "cluster",
"env": {
"NODE_ENV": "prod",
"PORT": 60002,
"OSSURL": "http://127.0.0.1:60002/"
}
}环境变量说明：
| 变量 | 说明 |
|---|---|
NODE_ENV |
运行环境，prod 表示生产环境 |
PORT |
服务监听端口 |
OSSURL |
文件存储访问地址，用于静态资源访问 |
pm2 start pm2.json
pm2 startup
pm2 savepm2 list # 查看进程
pm2 logs toonflow-app # 查看日志
pm2 restart all # 重启服务
pm2 monit # 监控面板
⚠️ 首次登录
账号：admin
密码：admin123
如需单独部署或定制前端界面，请参考前端仓库：
- GitHub：Toonflow-web
- Gitee：Toonflow-web
💡 说明：本仓库已内置编译好的前端资源，普通用户无需单独部署前端。前端仓库仅供需要二次开发的开发者使用。
Caution
🚧 PR 提交规范 🚧
⛔ master 分支不接受任何 PR ｜ ✅ 请将 PR 提交到 develop 分支
- Node.js：版本要求 23.11.1 及以上
- Yarn：推荐作为项目包管理器
-
克隆项目
从 GitHub 克隆：
git clone https://github.com/viaco2ove/Toonflow-game.git cd Toonflow-app从 Gitee 克隆（国内推荐）：
git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app -
安装依赖
请先在项目根目录下执行以下命令以安装依赖项：
yarn install
-
启动开发环境
本项目包含 后端 API 服务 和 前端页面 两部分，请根据需要选择启动方式：
-
方式一：仅启动后端服务（开发调试用）
yarn dev
⚠️ 此命令仅启动后端 API 服务（端口 60002），不包含前端页面。直接访问http://localhost:60002只能调用 API 接口，无法看到完整的网页界面。如需同时使用前端页面，请配合前端项目单独启动，或使用下方的 GUI 模式。 -
方式二：启动 Electron 桌面客户端（推荐完整体验）
yarn dev:gui
此命令会同时启动后端服务和 Electron 桌面窗口，自带内置前端页面，开箱即用，无需额外配置。适合想要完整体验所有功能的开发者。
两种模式对比：
命令 启动内容 前端页面 适用场景 yarn dev仅后端 API（端口 60002） ❌ 无 后端开发调试、配合前端项目联调 yarn dev:gui后端 + Electron 桌面端 ✅ 内置 完整功能体验、桌面客户端开发调试 -
-
项目打包
-
编译并生成 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 目录内容复制到本项目的 scripts/web 目录即可集成。
📂 docker/ # Docker 配置文件
📂 docs/ # 文档资源
📂 scripts/ # 构建脚本与静态资源
│ └─ 📂 web/ # 前端编译产物（内置）
📂 src/
├─ 📂 agents/ # AI Agent 模块
├─ 📂 lib/ # 公共库（数据库初始化、响应格式）
├─ 📂 middleware/ # 中间件
├─ 📂 routes/ # 路由模块
│ ├─ 📂 assets/ # 素材管理
│ ├─ 📂 index/ # 首页
│ ├─ 📂 novel/ # 小说管理
│ ├─ 📂 other/ # 其他功能
│ ├─ 📂 outline/ # 大纲管理
│ ├─ 📂 project/ # 项目管理
│ ├─ 📂 prompt/ # 提示词管理
│ ├─ 📂 script/ # 剧本生成
│ ├─ 📂 setting/ # 系统设置
│ ├─ 📂 storyboard/ # 分镜管理
│ ├─ 📂 task/ # 任务管理
│ ├─ 📂 user/ # 用户管理
│ └─ 📂 video/ # 视频生成
├─ 📂 types/ # TypeScript 类型声明
├─ 📂 utils/ # 工具函数
├─ 📄 app.ts # 应用入口
├─ 📄 core.ts # 路由核心
├─ 📄 env.ts # 环境变量处理
├─ 📄 err.ts # 错误处理
├─ 📄 router.ts # 路由注册
└─ 📄 utils.ts # 通用工具
📂 uploads/ # 上传文件目录
📄 LICENSE # 许可证
📄 NOTICES.txt # 第三方依赖声明
📄 package.json # 项目配置
📄 README.md # 项目说明
📄 tsconfig.json # TypeScript 配置
| 仓库 | 说明 | GitHub | Gitee |
|---|---|---|---|
| Toonflow-app | 完整客户端（本仓库，推荐普通用户） | GitHub | Gitee |
| Toonflow-web | 前端源代码（适合前端开发者） | GitHub | Gitee |
💡 提示：如果您只是想使用 Toonflow，直接下载本仓库的客户端即可。前端仓库仅供需要二次开发或定制前端界面的开发者使用。
我们正持续优化产品，以下为近期开发重点：
- 核心功能升级
🧩 提示词润色生成 Agent基于 AI 智能润色视频提示词，自动拆解生成分镜脚本，支持多镜头智能融合与平滑过渡📄 多格式文本支持扩展小说以外的剧本、漫画脚本、游戏对话文本等多种格式的智能解析
- 生产流程优化
👗 角色服化道管理强化长篇内容中角色的服装、化妆、道具一致性，支持多剧集关联记忆和着装自动生成📦 批量处理/任务队列支持多章节同时处理，后台任务管理，进度实时监控和中断恢复
- 视觉生成增强
🎭 多风格模板库内置多种视觉风格包，支持一键风格转换和用户自定义风格保存⏱️ 智能节奏分析/优化分析剧情情绪曲线，自动建议高潮点和节奏变化，优化分镜安排生产流程优化
交流群 1
交流群 2
交流群 3
交流群 4
交流群 5
交流群 6
交流群 7
交流群 8
交流群 9
交流群 10
交流群 11
交流群 12
交流群 13
拉群小助手:
Toonflow 基于 AGPL-3.0 协议开源发布，许可证详情：https://www.gnu.org/licenses/agpl-3.0.html
您可以在遵循 AGPL-3.0 相关条款与条件的情况下，将 Toonflow 用于包括商业目的在内的各类用途。
如需获得免于 AGPL-3.0 限制的专有商业许可，请通过邮箱与我们联系。
最低配置（开发/测试环境）
配置项 │ 建议值
──────────────────────────────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────────────
CPU │ 2 核
内存 │ 4 GB
硬盘 │ 40 GB SSD
带宽 │ 5 Mbps
操作系统 │ Ubuntu 22.04 LTS / Debian 12
推荐配置（生产环境）
配置项 │ 建议值
──────────────────────────────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────────────
CPU │ 4 核
内存 │ 8 GB
硬盘 │ 80 GB SSD
带宽 │ 10 Mbps+
操作系统 │ Ubuntu 22.04 LTS / Debian 12
项目依赖分析 技术栈：
- 后端：Node.js 24 + Express + TypeScript
- 数据库：SQLite（better-sqlite3）
- 前端：构建后为静态 HTML，通过 Nginx 提供服务
- 进程管理：PM2 + Supervisor
- AI 服务：依赖多个 AI Provider（OpenAI、DeepSeek、Google、Anthropic 等）
- 图像处理：Sharp（图片处理库）
关键依赖：
- 需要调用外部 AI API（OpenAI、DeepSeek、智谱等）
- 图片处理（Sharp 库需要编译原生模块）
- 文件存储（阿里云 COS、腾讯云 COS）
内存2g :单人轻度使用
感谢以下开源项目为 Toonflow 提供强大支持：
- Express - 快速、开放、极简的 Node.js Web 框架
- AI - 面向 TypeScript 的 AI 工具包
- Better-SQLite3 - 高性能 SQLite3 绑定库
- Sharp - 高性能 Node.js 图像处理库
- Axios - 基于 Promise 的 HTTP 客户端
- Zod - TypeScript 优先的模式验证库
- Aigne - LLM API 统一管理与接入中间件
- Electron - 跨平台桌面应用开发框架
感谢以下组织/单位/个人为 Toonflow 提供支持：
|
算能云 提供算力赞助 [官网] |
完整的第三方依赖清单请查阅 NOTICES.txt